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 options: implement your own ENSDb Writer or ENSDb Reader in any language, or use the initial reference implementations provided by ENSNode — ENSIndexer as an ENSDb Writer and ENSApi as an ENSDb Reader.

What You Get

Section titled “What You Get”

Complete ENS State

Section titled “Complete ENS State”

An ENSDb instance contains the live 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”
Get inspired Discover the wide range of applications you can build with ENSDb, from analytics dashboards to custom APIs and more.

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

What’s next

Section titled “What’s next”
Section titled “Related Projects”