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

Lists the role grants on an ENSv2 resolver. Parameters, return value, errors and examples for indexer.getResolverRoles in @ensforge/sdk.

ReadBatchablestable
Since v1.0.0View source

Lists the role grants on an ENSv2 resolver.

When to use

Use to audit who can edit the records a resolver holds.

Details

  • Powers use the indexer's vocabulary (set_text, admin_set_addr, …).

Signature

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

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

indexer.getResolverRoles.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 Page<ResolverRole>. One page of grants.

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 a resolver's roles
const page = await ens.indexer.getResolverRoles({ address: "0xF4f1…" })

Example response

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

await ens.indexer.getResolverRoles({ address: "0xF29100983E058B709F3D539b0c765937B804AC15", chainId: 1, limit: 3 })
{
  "asOf": {
    "chainId": 1,
    "blockNumber": "26443964n",
    "blockHash": "0xe75c58ea2f28bd7c6cc53c28a5ab4fc02023f3563661f0a7236a36b779e3ac86",
    "timestamp": "1795029143n"
  },
  "snapshots": {
    "1": {
      "chainId": 1,
      "blockNumber": "26443964n",
      "blockHash": "0xe75c58ea2f28bd7c6cc53c28a5ab4fc02023f3563661f0a7236a36b779e3ac86",
      "timestamp": "1795029143n"
    }
  },
  "asOfToken": "7b22657468657265756d223a7b22626c6f636b5f68617368223a22307865373563353865613266323862643763366363353363323861356162346663303230323366333536333636316630613732333661333662373739653361633836222c22626c6f636b5f6e756d626572223a32363434333936342c22636861696e5f6964223a22657468657265756d2d6d61696e6e6574222c2274696d657374616d70223a22323032362d31312d31385431393a31323a32335a227d7d",
  "completeness": "unsupported",
  "unsupportedReason": "binding_enumeration_not_supported",
  "unsupportedFields": [
    "roles"
  ],
  "origin": null,
  "indexer": "bigname",
  "items": [],
  "cursor": null,
  "hasMore": false,
  "totalCount": null
}

See also

Was this page helpful?