Documentation for agents: an index at /llms.txt, every docs page in one file at /llms-full.txt, and Markdown for any docs page by adding .md to its URL.

Skip to Content
ensforgeSDK

indexer.getResolver

Reads a resolver and one page of the names bound to it. Parameters, return value, errors and examples for indexer.getResolver in @ensforge/sdk.

ReadBatchablestable
Since v1.0.0View source

Reads a resolver and one page of the names bound to it.

When to use

Use to see which names use a resolver before changing or replacing it.

Details

  • Bound names are paged: pass the answer's cursor for more.
  • ENSv1 compatibility resolvers report the registry they mirror (mirrors).

Signature

function getResolver(
  client: Like,
  options: getResolver.Options,
): Promise<getResolver.ReturnType>

Call it as ens.indexer.getResolver(options) on a client, or Actions.indexer.getResolver(client, options).

indexer.getResolver.request(options) builds a deferred read for Actions.batch. See Look up many at once.

Parameters

OptionTypeDefaultDescription
at{ readonly token: string } | { readonly timestamp: bigint | Date }Read at a snapshot: an earlier answer's asOfToken, or a time.
finality"latest" | "safe" | "finalized""latest"How settled the data must be: latest, safe or finalized.
limitnumberRows per page, 1–200. @default 50
cursorstringThe previous page's cursor.
includeTotalbooleanCount every row (totalCount); slower.
address (required)stringContract address.
chainIdnumberChain of the contract. @default the client's chain

Also takes the read options.

Returns

Resolves to Result<IndexedResolver> | null. The resolver, or null when the indexer does not know it.

Errors

ErrorCodesWhen
InvalidInputErrorINVALID_ADDRESSan invalid address.
NotFoundErrorINDEXER_NOT_FOUNDwith strict: true when the indexer does not know the contract.
ConfigErrorINDEXER_NOT_CONFIGUREDthe client has no indexer.
IndexerErrorINDEXER_UNSUPPORTEDthe indexer does not serve the query or its namespace.
IndexerErrorINDEXER_UNAVAILABLE, INDEXER_RATE_LIMITED, INDEXER_BEHIND, INDEXER_REQUEST_REJECTED, INDEXER_RESPONSE_INVALIDthe indexer is unavailable, rate limiting, behind, rejects the request or answers unexpectedly.

It can also fail with the errors every read can (Errors.CommonError: ConfigError, ContractRevertError, InternalError, NetworkError).

See How errors work.

Examples

Reading a resolver
const resolver = await ens.indexer.getResolver({ address: "0xF4f1…" })

Example response

Recorded from Ethereum mainnet on 2026-11-18 at block 26443964. Values change as the chain does.

await ens.indexer.getResolver({ address: "0xF29100983E058B709F3D539b0c765937B804AC15", chainId: 1, limit: 3 })
{
  "chainId": 1,
  "address": "0xF29100983E058B709F3D539b0c765937B804AC15",
  "names": [
    "$$$$$$$$$$$.eth",
    "$-$-$.eth",
    "$$0$$.eth"
  ],
  "cursor": "7b2276657273696f6e223a312c22736f7274223a226e616d655f617363222c2266696c74657273223a7b22636861696e5f6964223a2231222c226e616d657370616365223a22222c227265736f6c766572223a22307866323931303039383365303538623730396633643533396230633736353933376238303461633135227d2c226c6173745f6974656d223a7b226e616d6568617368223a22307834356637383564353561643462313234613366356231653865376238353661363438623838376261386462653961613166313437393962373533636663633037222c226e616d657370616365223a22656e73222c226f726465725f6e616d65223a2224243024242e657468222c22736f72745f76616c7565223a2224243024242e657468227d2c22736e617073686f74223a6e756c6c7d",
  "hasMore": true,
  "mirrors": null,
  "asOf": {
    "chainId": 1,
    "blockNumber": "26443964n",
    "blockHash": "0xe75c58ea2f28bd7c6cc53c28a5ab4fc02023f3563661f0a7236a36b779e3ac86",
    "timestamp": "1795029143n"
  },
  "snapshots": {
    "1": {
      "chainId": 1,
      "blockNumber": "26443964n",
      "blockHash": "0xe75c58ea2f28bd7c6cc53c28a5ab4fc02023f3563661f0a7236a36b779e3ac86",
      "timestamp": "1795029143n"
    }
  },
  "asOfToken": "7b22657468657265756d223a7b22626c6f636b5f68617368223a22307865373563353865613266323862643763366363353363323861356162346663303230323366333536333636316630613732333661333662373739653361633836222c22626c6f636b5f6e756d626572223a32363434333936342c22636861696e5f6964223a22657468657265756d2d6d61696e6e6574222c2274696d657374616d70223a22323032362d31312d31385431393a31323a32335a227d7d",
  "completeness": "full",
  "unsupportedReason": null,
  "unsupportedFields": [],
  "origin": null,
  "indexer": "bigname"
}

See also

Was this page helpful?