ENSDb Readers (Custom APIs)

An ENSDb Reader is any service that interacts with ENSDb to read ENS data. This can be anything from a custom GraphQL or REST API, to a data analytics pipeline, to a command-line interface, to a dashboard, and more.

Build your own ENSDb Reader

You can build your own ENSDb Reader in any language, using any framework, as long as you follow the ENSDb Standard. The ENSDb Standard defines rules and constraints for how an ENSDb Reader should read data from an ENSDb instance in a way that maintains the integrity of the data and supports interoperability with any ENSDb Writer.

Current ENSDb Readers

ENSApi

ENSApi is a reference implementation of an ENSDb Reader that includes the following APIs:

• The new ENS Omnigraph GraphQL API that’s built on top of ENSNode Plugins such as unigraph and protocol-acceleration.
• A backwards-compatible ENS Subgraph GraphQL API that’s built on top of ENSNode Plugins such as subgraph, basenames, lineanames, and threedns.
• APIs for various queries related to the metadata stored in ENSDb, such as the indexing status from the ENSDb Writer and metadata about the overall ENSNode stack of services active in the ENSNode instance.

Learn more about ENSApi A reference implementation of ENSDb Reader, built by the NameHash team.

New ENSDb Readers Under Development

Multiple new ENSDb Reader services are planned by the NameHash team. Find out more about each of them below.

Learn more about ensdb-cli A command-line interface for interacting with ENSDb.

Learn more about ENSEngine A push-based web service allowing you to track ENS data changes as they occur.

Learn more about ENSAnalytics (coming soon) A web service that provides analytics and insights on ENS data.

Build your own ENSDb Reader

Creating your own ENSDb Reader service enables you to build your own completely custom APIs and data pipeline services. See related inspiration on the ENSDb integration options page. Use any programming language or framework you wish! If you’d like any help or guidance feel welcome to reach out to the NameHash team on Telegram.