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

UNSUPPORTED_ON_DEPLOYMENT

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

UnsupportedErrorNot retryable
@ensforge/sdk

What happened

This feature is not available on this deployment.

What to show users

TitleMessageAction
Not supportedThis action is not available on this network.

Retry safety

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

Actions that throw it

ActionWhen
approval.getOperatorfor ENSv1 contracts without ENSv1.
approval.setOperatorfor ENSv1 contracts without ENSv1.
dns.getOffchainResolverwithout a DNSSEC gateway or gatewayUrls.
dns.getProofwithout a DNSSEC gateway or gatewayUrls.
dns.getStatuswithout a DNSSEC gateway or gatewayUrls.
migration.getwhere ENSv2 is not deployed.
migration.migratewhere ENSv2 is not deployed.
name.getLabelwithout an ENSv2 deployment.
primaryName.setfor a chain without an L2 reverse registrar.
primaryName.signClaimfor a chain without an L2 reverse registrar.
registration.commitfor an unaccepted token or without ENSv2.
registration.getCommitmentStatuswithout ENSv2.
registration.getParameterswithout ENSv2.
registration.getPricefor an unaccepted token or without ENSv2.
registration.getRenewalPricefor an unaccepted token or without ENSv2.
registration.isAvailablewithout ENSv2.
registration.registerfor an unaccepted token or without ENSv2.
registration.renewfor an unaccepted token or without ENSv2.
registry.deploywithout ENSv2, or for an ENSv1 attachTo.
resolver.createwithout ENSv2, or for records a PermissionedResolver cannot store.
wrapper.getFuseswithout ENSv1.

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

Catch it

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

Was this page helpful?