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.getResolvers

Lists the ENSv2 resolvers on which an address holds roles. Parameters, return value, errors and examples for indexer.getResolvers in @ensforge/sdk.

ReadBatchablestable
Since v1.0.0View source

Lists the ENSv2 resolvers on which an address holds roles.

When to use

Use to find every resolver an account can edit, e.g. for a records dashboard.

Details

  • bigname v0.14 and later; other indexers, and older bigname servers, fail with INDEXER_UNSUPPORTED, so fallback() moves on to the next indexer.

Signature

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

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

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

Parameters

OptionTypeDefaultDescription
limitnumberRows per page, 1–200. @default 50
cursorstringThe previous page's cursor.
includeTotalbooleanCount every row (totalCount); slower.
chainIdnumber
roleHolder (required)stringThe account holding roles.

Also takes the read options.

Returns

Resolves to Page<RoleHolderResolver>. One page of resolvers.

Errors

ErrorCodesWhen
InvalidInputErrorINVALID_ADDRESSan invalid address.
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

Listing an account's resolvers
const page = await ens.indexer.getResolvers({ roleHolder: account })

Example response

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

await ens.indexer.getResolvers({ roleHolder: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", limit: 3 })
{
  "asOf": {
    "chainId": 1,
    "blockNumber": "26443964n",
    "blockHash": "0xe75c58ea2f28bd7c6cc53c28a5ab4fc02023f3563661f0a7236a36b779e3ac86",
    "timestamp": "1795029143n"
  },
  "snapshots": {
    "1": {
      "chainId": 1,
      "blockNumber": "26443964n",
      "blockHash": "0xe75c58ea2f28bd7c6cc53c28a5ab4fc02023f3563661f0a7236a36b779e3ac86",
      "timestamp": "1795029143n"
    }
  },
  "asOfToken": null,
  "completeness": "full",
  "unsupportedReason": null,
  "unsupportedFields": [],
  "origin": null,
  "indexer": "bigname",
  "items": [],
  "cursor": null,
  "hasMore": false,
  "totalCount": null
}

Was this page helpful?