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

registration.getParameters

Reads the .eth registration settings: contracts, commitment window, minimum duration, grace period and accepted payment tokens.

ReadBatchablestable
Since v1.0.0View source

Reads the .eth registration settings: contracts, commitment window, minimum duration, grace period and accepted payment tokens.

When to use

Use to build registration UIs: the commitment wait, the shortest duration, and which tokens to offer.

Signature

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

Call it as ens.registration.getParameters(options) on a client, or Actions.registration.getParameters(client, options).

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

Parameters

Also takes the read options.

Returns

Resolves to getParameters.ReturnType. Registration settings; durations and ages are in seconds.

FieldTypeDescription
registrarAddress
renewerAddress
priceOracleAddress
minCommitmentAgebigint
maxCommitmentAgebigint
minDurationbigint
gracePeriodbigint
paymentTokensreadonly TokenInfo[]Tokens listed for the deployment that the price oracle currently accepts.

Errors

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

See How errors work.

Examples

Reading the settings
const { minCommitmentAge, paymentTokens } = await ens.registration.getParameters()

Example response

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

await ens.registration.getParameters({})
{
  "registrar": "0xD6D8369e55c94Ae8AFA714E6cF7AB5bE54D5CC81",
  "renewer": "0x56c447F308F463A01121C41E72b0E7e7557fCb68",
  "priceOracle": "0x76F29609A363a8A1a2a6abe2e859C0F8916Af469",
  "minCommitmentAge": "60n",
  "maxCommitmentAge": "86400n",
  "minDuration": "2419200n",
  "gracePeriod": "2419200n",
  "paymentTokens": [
    {
      "address": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
      "symbol": "DAI",
      "decimals": 18
    },
    {
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "symbol": "USDC",
      "decimals": 6
    }
  ]
}

See also

Was this page helpful?