ENSDb Concepts
This section explains the core concepts of ENSDb. Understanding these fundamentals will help you work effectively with ENSDb, whether you’re querying data, integrating with third-party services, or operating an ENSNode instance.
Core Concepts
Section titled “Core Concepts” Glossary Terminology and definitions used throughout ENSDb documentation
Architecture How ENSDb works as a bi-directional open standard, including the writer/reader pattern and data flow
Database Schemas Detailed explanation of all schemas: Ponder Schema, ENSNode Schema, and the 5 modular sub-schemas of ENSIndexer Schema
Indexing Lifecycle How indexing works, from Backfill to Following, and how it affects database behavior
What is ENSDb?
Section titled “What is ENSDb?”ENSDb is an open standard for bi-directional ENS integration. It represents a new category of integration point for building on ENS:
- Open Standard — Anyone can build writers or readers following the schema specifications
- Bi-Directional — Write operations produce an ENSDb, read operations consume it
- Language Agnostic — Any programming language with PostgreSQL support
- Complete State — The entire onchain ENS state, in your database
Read the What is ENSDb? overview for the full vision.
Who Should Read This
Section titled “Who Should Read This”- Developers integrating with ENSDb — Understand the schema structure to write effective queries
- DevOps operators running ENSNode — Understand how ENSDb behaves during different indexing phases
- Anyone building custom writers or readers — Learn the architecture for implementing the standard
Next Steps
Section titled “Next Steps”After understanding these concepts:
- Query ENSDb with SQL — Language-agnostic SQL examples
- Use the TypeScript SDK — Type-safe database access
- Build an Integration — Create custom writers or readers
- Explore Use Cases — See what others are building