Custom APIs
Build specialized GraphQL or REST APIs tailored to your use case. Query exactly the data you need with full SQL power.
Getting started with ENSDb
Vision
Section titled “Vision”Get the whole onchain state of ENS in your database.
Core Philosophy
Section titled “Core Philosophy”Open Standard
Section titled “Open Standard”ENSDb is an open standard for bi-directional ENS integration. It defines a carefully crafted set of database schema designs, rules, and constraints for storing the entire ENS onchain state in a PostgreSQL database — making the data accessible from any programming language.
Any app following the standard can:
- Perform write operations to produce an ENSDb instance.
- Perform read operations against the ENSDb instance.
What You Get
Section titled “What You Get”Complete ENS State
Section titled “Complete ENS State”An ENSDb instance contains the entire onchain state of ENS:
- All domains (ENSv1 and ENSv2)
- All registrations and renewals
- All resolver records and text records
- All events and ownership history
- All NFT/token data for names
PostgreSQL Benefits
Section titled “PostgreSQL Benefits”By building on a PostgreSQL database, ENSDb inherits world-class capabilities:
- ACID transactions — Data integrity guarantees
- Complex queries — Joins, aggregations, window functions
- Scalability — Replication, sharding, connection pooling
- Ecosystem — Mature tools, ORMs, dashboards, analytics platforms
- Reliability — Decades of production-proven technology
What You Can Build
Section titled “What You Can Build”ENSDb unlocks a new universe of ENS applications:
Analytics & Dashboards
Create real-time dashboards and analytics pipelines. Better than Dune — you have the full ENS state locally with sub-second query latency.
CLIs & Developer Tools
Build command-line tools for ENS operations. Query domains, check expiration, analyze name patterns — all from your terminal.
Event-Based Engines
Build reactive systems that respond to ENS state changes. Monitor registration lifecycles, ownership transfers, resolver updates.
Data Pipelines
Feed ENS data into your existing data infrastructure. Sync to data warehouses, trigger webhooks, populate search indexes.
AI & ML Models
Train machine learning models on complete ENS datasets. Predict name values, detect patterns, analyze market trends.
Quick Start
Section titled “Quick Start” Use the ENSDb SDK Quick start with the TypeScript SDK for ENSDb, providing type-safe database access and utilities for working with ENSDb.
Use the SQL Interface Quick start with the SQL interface for ENSDb, allowing you to interact with your ENSDb instance using any PostgreSQL client and SQL queries.
Documentation Structure
Section titled “Documentation Structure” Concepts Understand ENSDb architecture, schemas, and data flow
Usage Learn how to use ENSDb with the SDK and SQL interface
Integrations Learn how to integrate ENSDb with other systems and tools
FAQ Frequently asked questions about ENSDb
Related Projects
Section titled “Related Projects”- ENSIndexer — The reference ENSDb Writer implementation
- ENSApi — The reference ENSDb Reader implementation