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
ensforge

CHAIN_MISMATCH

What CHAIN_MISMATCH means, why WalletError throws it, what to show users and how to fix it in ensforge. Also covers retry safety and the actions that throw it.

WalletErrorNot retryable
@ensforge/sdk

What happened

The wallet is on chain ?, expected ?.

What to show users

TitleMessageAction
Wrong networkYour wallet is connected to a different network.Switch networks in your wallet.

How to fix

Switch the wallet's network, then retry.

Retry safety

Retrying the same call fails the same way until the cause is fixed (retryable: false).

Actions that throw it

ActionWhen
approval.setDelegatewhen the wallet is on another chain or has no account to sign with.
approval.setOperatorwhen the wallet is on another chain or has no account to sign with.
approval.setTokenwhen the wallet is on another chain or has no account to sign with.
dns.claimwhen the wallet is on another chain or has no account to sign with.
dns.setRecordswhen the wallet is on another chain or has no account to sign with.
migration.migratewhen the wallet is on another chain or has no account to sign with.
name.reclaimwhen the wallet is on another chain or has no account to sign with.
name.setManagerwhen the wallet is on another chain or has no account to sign with.
name.setTtlwhen the wallet is on another chain or has no account to sign with.
name.transferwhen the wallet is on another chain or has no account to sign with.
permission.setRecordAccesswhen the wallet is on another chain or has no account to sign with.
plan.sendwhen the wallet is on another chain or has no account to sign with.
primaryName.setwhen the wallet is on another chain or has no account to sign with.
primaryName.signClaimwhen the wallet is on another chain or has no account to sign with.
record.setwhen the wallet is on another chain or has no account to sign with.
registration.commitwhen the wallet is on another chain or has no account to sign with.
registration.registerwhen the wallet is on another chain or has no account to sign with.
registration.renewwhen the wallet is on another chain or has no account to sign with.
registry.attachwhen the wallet is on another chain or has no account to sign with.
registry.deploywhen the wallet is on another chain or has no account to sign with.
registry.setUriwhen the wallet is on another chain or has no account to sign with.
registry.upgradewhen the wallet is on another chain or has no account to sign with.
resolver.createwhen the wallet is on another chain or has no account to sign with.
resolver.linkwhen the wallet is on another chain or has no account to sign with.
resolver.setwhen the wallet is on another chain or has no account to sign with.
resolver.upgradewhen the wallet is on another chain or has no account to sign with.
role.grantwhen the wallet is on another chain or has no account to sign with.
role.revokewhen the wallet is on another chain or has no account to sign with.
subname.createwhen the wallet is on another chain or has no account to sign with.
subname.removewhen the wallet is on another chain or has no account to sign with.
subname.updatewhen the wallet is on another chain or has no account to sign with.
wrapper.setChildFuseswhen the wallet is on another chain or has no account to sign with.
wrapper.setFuseswhen the wallet is on another chain or has no account to sign with.
wrapper.unwrapwhen the wallet is on another chain or has no account to sign with.
wrapper.wrapwhen the wallet is on another chain or has no account to sign with.

Any write can fail with WalletError: it is part of Errors.WriteError.

Catch it

Errors.hasCode("CHAIN_MISMATCH") narrows to this error. See Handle errors.

Was this page helpful?