Skip to content
ENSNode

Getting started with ENSDb

Vision

Section titled “Vision”

Get the whole, live 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 ENS onchain state in a PostgreSQL database — making the data accessible from any programming language.

The ENSDb standard is implementation-agnostic, so you have two options: implement your own ENSDb Writer and ENSDb Reader in any language, or use the reference implementations provided by ENSNode — ENSIndexer as the ENSDb Writer and ENSApi as the ENSDb Reader.

What You Get

Section titled “What You Get”

Complete ENS State

Section titled “Complete ENS State”

An ENSDb instance contains the onchain state of ENS, including:

  • Domains (ENSv1 and ENSv2)
  • Registrations and renewals
  • Resolver records and text records
  • Events and ownership history
  • NFT/token data for names
  • … and more!

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:

Custom APIs

Build specialized GraphQL or REST APIs tailored to your use case. Query exactly the data you need with full SQL power.

Analytics & Dashboards

Create real-time dashboards and analytics pipelines. Better than Dune — you have the live ENS state locally with sub-second query latency.

CLIs & Developer Tools

Build command-line tools for ENS operations. Query domains, and any specialized lookup — all from your terminal.

Event-Based Engines

Build reactive systems that respond to ENS state changes. Respond to registration lifecycle updates, ownership transfers, resolver updates.

Data Pipelines

Feed ENS data into your existing data infrastructure. Sync to data warehouses, trigger webhooks, populate search indexes.

AI Agents

Build AI agents that can query the ENS state and perform actions based on that data.

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
Section titled “Related Projects”