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

NONCE_CONFLICT

What NONCE_CONFLICT means, why TransactionError throws it, what to show users and how to fix it in ensforge. Also covers retry safety.

@ensforge/sdk

What happened

The transaction nonce conflicts with another transaction.

What to show users

TitleMessageAction
Transaction conflictAnother transaction from your wallet is pending.Wait for it to confirm, then try again.

How to fix

Wait for pending transactions to confirm, then retry.

Retry safety

Retrying the same call can succeed (retryable: true).

Actions that throw it

ActionWhen
approval.setDelegatewhen confirmation fails or the wallet's nonce is already used.
approval.setOperatorwhen confirmation fails or the wallet's nonce is already used.
approval.setTokenwhen confirmation fails or the wallet's nonce is already used.
dns.claimwhen confirmation fails or the wallet's nonce is already used.
dns.setRecordswhen confirmation fails or the wallet's nonce is already used.
migration.migratewhen confirmation fails or the wallet's nonce is already used.
name.reclaimwhen confirmation fails or the wallet's nonce is already used.
name.setManagerwhen confirmation fails or the wallet's nonce is already used.
name.setTtlwhen confirmation fails or the wallet's nonce is already used.
name.transferwhen confirmation fails or the wallet's nonce is already used.
permission.setRecordAccesswhen confirmation fails or the wallet's nonce is already used.
plan.resumewhen confirmation fails or the wallet's nonce is already used.
plan.sendwhen confirmation fails or the wallet's nonce is already used.
primaryName.setwhen confirmation fails or the wallet's nonce is already used.
record.setwhen confirmation fails or the wallet's nonce is already used.
registration.commitwhen confirmation fails or the wallet's nonce is already used.
registration.registerwhen confirmation fails or the wallet's nonce is already used.
registration.renewwhen confirmation fails or the wallet's nonce is already used.
registry.attachwhen confirmation fails or the wallet's nonce is already used.
registry.deploywhen confirmation fails or the wallet's nonce is already used.
registry.setUriwhen confirmation fails or the wallet's nonce is already used.
registry.upgradewhen confirmation fails or the wallet's nonce is already used.
resolver.createwhen confirmation fails or the wallet's nonce is already used.
resolver.linkwhen confirmation fails or the wallet's nonce is already used.
resolver.setwhen confirmation fails or the wallet's nonce is already used.
resolver.upgradewhen confirmation fails or the wallet's nonce is already used.
role.grantwhen confirmation fails or the wallet's nonce is already used.
role.revokewhen confirmation fails or the wallet's nonce is already used.
subname.createwhen confirmation fails or the wallet's nonce is already used.
subname.removewhen confirmation fails or the wallet's nonce is already used.
subname.updatewhen confirmation fails or the wallet's nonce is already used.
wrapper.setChildFuseswhen confirmation fails or the wallet's nonce is already used.
wrapper.setFuseswhen confirmation fails or the wallet's nonce is already used.
wrapper.unwrapwhen confirmation fails or the wallet's nonce is already used.
wrapper.wrapwhen confirmation fails or the wallet's nonce is already used.

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

Catch it

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

Was this page helpful?