gskril/ens-indexer

A simpler, less complete version of the ENS Subgraph. Work in progress.

ENS Indexer

A simpler, less complete version of the ENS Subgraph. Built with Ponder.

Indexes the following contracts:

Name	Contract Address
Registry	0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e
Base Registrar	0x57f1887a8BF19b14fC0dF6Fd9B2acc9Af147eA85
Legacy ETH Registrar Controller	0x283Af0B28c62C092C9727F1Ee09c02CA627EB7F5
ETH Registrar Controller	0x253553366Da8546fC250F225fe3d25d0C782303b
Name Wrapper	0xD4416b13d2b3a9aBae7AcD5D6C2BbDBE25686401

Example queries

Get all names owned by an address:

{
  names(
    where: {
      OR: [
        { owner: "0x179A862703a4adfb29896552DF9e307980D19285" }
        { wrappedOwner: "0x179A862703a4adfb29896552DF9e307980D19285" }
      ]
    }
  ) {
    items {
      id
      name
      resolver
      createdAt
      expiresAt
    }
  }
}

Get all subnames of a given node:

{
  names(
    where: {
      parentId: "0x4e34d3a81dc3a20f71bbdf2160492ddaa17ee7e5523757d47153379c13cb46df" # namehash('ens.eth')
    }
  ) {
    items {
      id
      name
      createdAt
    }
  }
}

You can also access the database directly for more complex SQL queries. Learn more here.

Notes to self while building

• The first record of a .eth 2LD onchain is a Transfer event from the Base Registrar

  • Example from latest ETH Registrar Controller
  • Example from Legacy ETH Registrar Controller

• The first record of a 3LD+ onchain is a NewOwner event from the Registry

  • Example

• Trace of a .eth registration from the latest ETH Registrar ontroller:

  • user calls controller.register
    • controller calls nameWrapper.registerAndWrapETH2LD
      • wrapper calls registrar.register
        • registrar emits Transfer (from ERC721), this is the first time the name is recorded onchain
        • registrar calls registry.setSubnodeOwner
          • registry emits Transfer
          • registry emits NewOwner
        • registrar emits NameRegistered
    • controller emits NameRegistered

• tokenId from the Transfer event of the Base Registrar is the uint256 representation of the labelhash of the 2LD, where the parent is always eth

• label from all events is the labelhash

• name from the registrar controller events is the label as a string

• name from the Name Wrapper events is a base64 encoded string of the full name