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

wrapper.setChildFuses

Burns fuses on, or extends, a wrapped ENSv1 subname as its parent's owner. Options, result, errors and examples for wrapper.setChildFuses.

Writestable
Since v1.0.0View source

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.
  • expiry only grows, and is capped at the parent's expiry. Burning parentCannotControl without expiry uses the parent's expiry, so the emancipated name does not expire at once.

Gotchas

  • Burning parentCannotControl or canExtendExpiry needs cannotUnwrap on the parent (INVALID_RECORD_VALUE). parentCannotControl gives up the parent's control of the subname until it expires: the parent can then only extend it (FUSE_BURNED for 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

OptionTypeDefaultDescription
name (required)stringWrapped ENSv1 subname. Normalized automatically.
fusesreadonly Fuse.Name[]Fuses to burn, including the parent-controlled ones.
expirybigintNew expiry as a Unix timestamp.

Also takes the write options.

Returns

Resolves to Write.Result. Submitted transaction hashes and the plan that produced them.

FieldTypeDescription
hashHexHash of the last transaction.
hashesreadonly Hex[]Every submitted transaction, in order.
idstringEIP-5792 bundle id when the calls were sent as one batch.
planPlanThe plan the write executed: its steps, in order, as they were submitted.

Errors

ErrorCodesWhen
InvalidInputErrorINVALID_NAME, INVALID_RECORD_VALUE, INVALID_EXPIRYinvalid input or fuses.
NameStateErrorNAME_EXPIRED, NAME_NOT_REGISTERED, NAME_NOT_WRAPPEDthe name is not wrapped.
NameStateErrorNAME_UNREACHABLEENSv2 resolution no longer reaches the name.
UnsupportedErrorUNSUPPORTED_PROTOCOLENSv2 names; migrated names have no NameWrapper.
UnauthorizedErrorNOT_OWNER, FUSE_BURNEDthe account may not change it.
UserRejectedErrorUSER_REJECTEDthe user rejects the request.
WalletErrorCHAIN_MISMATCH, ACCOUNT_NOT_FOUNDthe wallet is on another chain or has no account to sign with.
UnsupportedErrorWALLET_BATCH_UNSUPPORTEDwith 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

Emancipating a subname
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.

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

Emancipating a subname and waiting
const { receipt } = await ens.wrapper.setChildFusesSync({ name: "pay.alice.eth", fuses: ["parentCannotControl"], expiry: 1_900_000_000n })

See also

Was this page helpful?