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

TRANSACTION_REVERTED

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

TransactionErrorNot retryable
@ensforge/sdk

What happened

The transaction reverted on-chain.

What to show users

TitleMessageAction
Transaction failedThe transaction was rejected by the network.

Retry safety

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

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.
hca.addDepositwhen confirmation fails.
hca.deploywhen confirmation fails.
hca.executewhen confirmation fails.
hca.revokeSessionswhen confirmation fails.
hca.upgradewhen confirmation fails.
hca.withdrawDepositwhen confirmation fails.
hcaAdmin.grantUpgradeSetRoleswhen confirmation fails.
hcaAdmin.renounceGovernancewhen confirmation fails.
hcaAdmin.revokeUpgradeSetRoleswhen confirmation fails.
hcaAdmin.setDeploymentApprovalwhen confirmation fails.
hcaAdmin.setUpgradeApprovalwhen confirmation fails.
hcaAdmin.transferGovernancewhen confirmation fails.

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

Catch it

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

Was this page helpful?