wrapper.setChildFuses
Burns fuses on, or extends, a wrapped ENSv1 subname as its parent's owner. Options, result, errors and examples for wrapper.setChildFuses.
Burns fuses on, or extends, a wrapped ENSv1 subname as its parent's owner. Resolves once the transaction is submitted.
When to use
Use to emancipate a subname (parentCannotControl), let it renew itself (canExtendExpiry), or extend it. Use setChildFusesSync to wait for the receipt.
Details
- Sent by the owner of the wrapped parent.
expiryonly grows, and is capped at the parent's expiry. BurningparentCannotControlwithoutexpiryuses the parent's expiry, so the emancipated name does not expire at once.
Gotchas
- Burning
parentCannotControlorcanExtendExpiryneedscannotUnwrapon the parent (INVALID_RECORD_VALUE).parentCannotControlgives up the parent's control of the subname until it expires: the parent can then only extend it (FUSE_BURNEDfor new fuses).
Signature
function setChildFuses(
client: Like,
options: setChildFuses.Options & Write.Options,
): Promise<setChildFuses.ReturnType>Call it as ens.wrapper.setChildFuses(options) on a client, or Actions.wrapper.setChildFuses(client, options).
Parameters
| Option | Type | Default | Description |
|---|---|---|---|
name (required) | string | Wrapped ENSv1 subname. Normalized automatically. | |
fuses | readonly Fuse.Name[] | Fuses to burn, including the parent-controlled ones. | |
expiry | bigint | New expiry as a Unix timestamp. |
Also takes the write options.
Returns
Resolves to Write.Result. Submitted transaction hashes and the plan that produced them.
| Field | Type | Description |
|---|---|---|
hash | Hex | Hash of the last transaction. |
hashes | readonly Hex[] | Every submitted transaction, in order. |
id | string | EIP-5792 bundle id when the calls were sent as one batch. |
plan | Plan | The plan the write executed: its steps, in order, as they were submitted. |
Errors
| Error | Codes | When |
|---|---|---|
InvalidInputError | INVALID_NAME, INVALID_RECORD_VALUE, INVALID_EXPIRY | invalid input or fuses. |
NameStateError | NAME_EXPIRED, NAME_NOT_REGISTERED, NAME_NOT_WRAPPED | the name is not wrapped. |
NameStateError | NAME_UNREACHABLE | ENSv2 resolution no longer reaches the name. |
UnsupportedError | UNSUPPORTED_PROTOCOL | ENSv2 names; migrated names have no NameWrapper. |
UnauthorizedError | NOT_OWNER, FUSE_BURNED | the account may not change it. |
UserRejectedError | USER_REJECTED | the user rejects the request. |
WalletError | CHAIN_MISMATCH, ACCOUNT_NOT_FOUND | the wallet is on another chain or has no account to sign with. |
UnsupportedError | WALLET_BATCH_UNSUPPORTED | with mode: "batch" or a paymaster when the wallet cannot send calls as one batch. |
It can also fail with the errors every write can (Errors.WriteError: the common errors plus InsufficientFundsError, TransactionError, UnsupportedError, UserRejectedError, WalletError).
See How errors work.
Examples
const { hash } = await ens.wrapper.setChildFuses({ name: "pay.alice.eth", fuses: ["parentCannotControl"], expiry: 1_900_000_000n })Plan methods
Each method takes the same options as wrapper.setChildFuses and sends nothing. See Preview before sending.
| Method | Description |
|---|---|
wrapper.setChildFuses.prepare(options) | Builds the plan without sending anything. |
wrapper.setChildFuses.simulate(options) | Simulates the plan with eth_call, reporting each step. |
wrapper.setChildFuses.estimateGas(options) | Estimates the gas and ETH the plan needs. |
Wait for the receipt with setChildFusesSync
Burns fuses on, or extends, a wrapped ENSv1 subname as its parent's owner. Resolves once the receipt is in.
Use when the next step depends on the change being on-chain.
wrapper.setChildFusesSync takes the same options plus confirmations and timeout.
Resolves to Write.SyncResult. Receipts plus the submitted hashes and plan.
const { receipt } = await ens.wrapper.setChildFusesSync({ name: "pay.alice.eth", fuses: ["parentCannotControl"], expiry: 1_900_000_000n })See also
wrapper.getFusesto read them
Was this page helpful?