registration.getParameters
Reads the .eth registration settings: contracts, commitment window, minimum duration, grace period and accepted payment tokens.
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.
| Field | Type | Description |
|---|---|---|
registrar | Address | |
renewer | Address | |
priceOracle | Address | |
minCommitmentAge | bigint | |
maxCommitmentAge | bigint | |
minDuration | bigint | |
gracePeriod | bigint | |
paymentTokens | readonly TokenInfo[] | Tokens listed for the deployment that the price oracle currently accepts. |
Errors
| Error | Codes | When |
|---|---|---|
UnsupportedError | UNSUPPORTED_ON_DEPLOYMENT | without ENSv2. |
NetworkError | RPC_REQUEST_FAILED, RPC_TIMEOUT, RATE_LIMITED | the RPC request fails. |
It can also fail with the errors every read can (Errors.CommonError: ConfigError, ContractRevertError, InternalError, NetworkError).
See How errors work.
Examples
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
registration.registerto register
Was this page helpful?