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

Errors

Look up all 103 error codes ensforge throws, grouped by 20 error classes, with what each means and how to fix it. Each code has its own page.

103 codes · 20 classes

Every error ensforge throws has a class (_tag) and a code. Each code has its own page, the one error.docsUrl points to. See How errors work.

Classes

CommitmentError

4 codes. A .eth commit-reveal registration step is out of order or out of time.

ConfigError

8 codes. The ensforge client or a call is configured incorrectly.

ContractRevertError

1 codes. A contract reverted with an error ensforge does not map to a more specific class.

DnsError

4 codes. Importing or reading a DNS name failed.

GatewayError

3 codes. Off-chain resolution (CCIP-Read, ERC-3668) failed.

IndexerError

6 codes. An indexer request failed, or the indexer cannot serve the query (INDEXER_UNSUPPORTED).

InsufficientFundsError

2 codes. The account cannot pay for the operation.

InternalError

1 codes. Something failed that ensforge does not recognise.

InvalidInputError

10 codes. An argument is invalid.

MigrationError

5 codes. ENSv1 to ENSv2 migration is blocked for this name.

NameStateError

12 codes. The name is in the wrong state for this operation (registered, expired, locked, …).

NetworkError

4 codes. The RPC provider could not be reached or rejected the request.

NotFoundError

7 codes. Something the call requires does not exist.

PlanError

5 codes. A prepared or saved plan can no longer be sent as-is.

TransactionError

3 codes. A submitted transaction failed, conflicted with another, or did not confirm in time.

UnauthorizedError

8 codes. The account lacks ownership, approval or roles for this change, or the signature that should authorize it is invalid or expired.

UnsupportedError

6 codes. The operation is not available for this name, resolver, deployment or wallet.

UserRejectedError

1 codes. The user declined the request in their wallet.

WalletError

2 codes. The wallet is not in a state to sign: wrong chain or no account.

HcaError

11 codes. An HCA (Hosted Contract Account) operation failed: the account, its session, an executor (bundler, Rhinestone) or the DAO's upgrade set.

Codes

CodeClassMeaning
COMMITMENT_TOO_NEWCommitmentErrorThe registration commitment is not ready yet.
COMMITMENT_TOO_OLDCommitmentErrorThe registration commitment has expired.
COMMITMENT_EXISTSCommitmentErrorAn unexpired commitment with the same data already exists.
COMMITMENT_NOT_FOUNDCommitmentErrorNo commitment was found for this registration.
UNKNOWN_CHAINConfigErrorensforge has no ENS deployment for this chain.
INVALID_DEPLOYMENTConfigErrorThe deployment profile is invalid.
CONTRACT_NOT_DEPLOYEDConfigErrorNo contract is deployed at the called address.
WALLET_NOT_CONFIGUREDConfigErrorThis action needs a wallet client with an account.
INDEXER_NOT_CONFIGUREDConfigErrorThis action needs an indexer.
CCIP_READ_DISABLEDConfigErrorThis name resolves off-chain, and CCIP-Read is disabled.
INVALID_ACTION_GROUPConfigErrorA decorator added an action group with a reserved name.
CHAIN_NOT_CONFIGUREDConfigErrorThe client has no clients for chain ?.
CONTRACT_REVERTEDContractRevertErrorThe contract call reverted.
DNS_RECORD_MISSINGDnsErrorThe _ens TXT record is missing.
DNSSEC_PROOF_FAILEDDnsErrorThe DNSSEC proof could not be built or verified.
PROOF_STALEDnsErrorThe DNSSEC proof is older than the one on-chain.
TLD_NOT_PUBLICDnsErrorThe top-level domain is not a public suffix and cannot be imported.
GATEWAY_REQUEST_FAILEDGatewayErrorThe off-chain gateway request failed.
GATEWAY_RESPONSE_INVALIDGatewayErrorThe off-chain gateway returned an invalid response.
OFFCHAIN_LOOKUP_INVALIDGatewayErrorThe resolver requested an off-chain lookup from an unexpected sender.
INDEXER_UNAVAILABLEIndexerErrorThe indexer is unavailable.
INDEXER_RATE_LIMITEDIndexerErrorThe indexer is rate limiting requests.
INDEXER_RESPONSE_INVALIDIndexerErrorThe indexer returned an unexpected response.
INDEXER_REQUEST_REJECTEDIndexerErrorThe indexer rejected the request.
INDEXER_BEHINDIndexerErrorThe indexer is behind the chain.
INDEXER_UNSUPPORTEDIndexerErrorThe indexer does not support this query.
INSUFFICIENT_ETHInsufficientFundsErrorThe account does not have enough ETH.
INSUFFICIENT_TOKEN_BALANCEInsufficientFundsErrorThe account does not have enough of the payment token.
UNEXPECTEDInternalErrorAn unexpected error occurred.
INVALID_NAMEInvalidInputErrorundefined is not a valid ENS name.
INVALID_ADDRESSInvalidInputErrorundefined is not a valid address.
INVALID_COIN_TYPEInvalidInputErrorundefined is not a known coin type.
INVALID_CONTENT_HASHInvalidInputErrorundefined is not a valid content hash.
INVALID_RECORD_VALUEInvalidInputErrorundefined is not a valid record value.
INVALID_DURATIONInvalidInputErrorundefined is not a valid duration.
DURATION_TOO_SHORTInvalidInputErrorThe duration is shorter than the registrar's minimum.
INVALID_EXPIRYInvalidInputErrorThe expiry cannot be in the past or earlier than the current expiry.
INVALID_ROLESInvalidInputErrorundefined is not a valid role bitmap.
SALT_TAKENInvalidInputErrorA contract was already deployed with this salt.
NOT_ELIGIBLEMigrationErrorThe name cannot be migrated to ENSv2 yet.
ALREADY_MIGRATEDMigrationErrorThe name is already on ENSv2.
NAME_NOT_LOCKEDMigrationErrorThe wrapped name is not locked, so it cannot use the locked migration route.
RECORDS_UNKNOWNMigrationErrorThe name's records are not known, so they cannot be copied to its new resolver.
VERIFICATION_FAILEDMigrationErrorThe migration was sent, but the name's ENSv2 state differs from the plan.
NAME_NOT_AVAILABLENameStateErrorThe name is already registered.
NAME_NOT_REGISTEREDNameStateErrorThe name is not registered.
NAME_RESERVEDNameStateErrorThe name is reserved.
NAME_EXPIREDNameStateErrorThe name has expired.
NAME_NOT_RENEWABLENameStateErrorThe name cannot be renewed.
NAME_LOCKEDNameStateErrorThe name is locked.
NAME_NOT_WRAPPEDNameStateErrorThe name is not wrapped in the NameWrapper.
NAME_WRAPPEDNameStateErrorThe name is already wrapped in the NameWrapper.
NAME_UNREACHABLENameStateErrorENSv2 resolution no longer reaches this ENSv1 name.
NAME_REQUIRES_MIGRATIONNameStateErrorThe name must be migrated to ENSv2 first.
PARENT_NOT_MIGRATEDNameStateErrorThe parent name has not been migrated to ENSv2.
REGISTRY_NOT_EMANCIPATEDNameStateErrorThe registry is not emancipated, so this transfer is unsafe.
RPC_REQUEST_FAILEDNetworkErrorThe RPC request failed.
RPC_TIMEOUTNetworkErrorThe RPC request timed out.
RATE_LIMITEDNetworkErrorThe RPC provider is rate limiting requests.
LOG_RANGE_TOO_LARGENetworkErrorThe RPC provider's eth_getLogs limits make this block range too expensive.
RESOLVER_NOT_FOUNDNotFoundErrorThe name has no resolver.
RECORD_NOT_FOUNDNotFoundErrorThe record is not set.
PRIMARY_NAME_NOT_SETNotFoundErrorThe address has no primary name.
PRIMARY_NAME_MISMATCHNotFoundErrorThe primary name does not resolve back to this address.
REGISTRY_NOT_FOUNDNotFoundErrorNo registry was found for this name.
PLAN_NOT_FOUNDNotFoundErrorNo saved plan was found with this id.
INDEXER_NOT_FOUNDNotFoundErrorThe indexer has no record of this resource.
PLAN_STALEPlanErrorThe plan no longer matches on-chain state.
PLAN_CHAIN_MISMATCHPlanErrorThe plan was prepared for another chain.
PLAN_ACCOUNT_MISMATCHPlanErrorThe plan was prepared for another account.
PLAN_INVALIDPlanErrorThe text is not a serialized ensforge plan.
PLAN_ROUTE_REQUIREDPlanErrorPart of this plan was sent through a route (via), which resuming needs again.
TRANSACTION_REVERTEDTransactionErrorThe transaction reverted on-chain.
RECEIPT_TIMEOUTTransactionErrorTimed out waiting for the transaction receipt.
NONCE_CONFLICTTransactionErrorThe transaction nonce conflicts with another transaction.
NOT_OWNERUnauthorizedErrorThe account does not own this name.
MISSING_ROLESUnauthorizedErrorThe account is missing the roles this change needs.
CANNOT_GRANT_ROLESUnauthorizedErrorThe account cannot grant or revoke these roles.
NOT_APPROVEDUnauthorizedErrorThe account is not approved to manage this name.
FUSE_BURNEDUnauthorizedErrorA burned NameWrapper fuse forbids this change.
TRANSFER_DISALLOWEDUnauthorizedErrorThis name cannot be transferred right now.
SIGNATURE_INVALIDUnauthorizedErrorThe signature does not authorize this change.
SIGNATURE_EXPIREDUnauthorizedErrorThe signature has expired.
UNSUPPORTED_PROTOCOLUnsupportedErrorThis operation is not supported for this names.
UNSUPPORTED_ON_DEPLOYMENTUnsupportedErrorThis feature is not available on this deployment.
RESOLVER_PROFILE_UNSUPPORTEDUnsupportedErrorThe resolver does not support this record type.
PAYMENT_TOKEN_UNSUPPORTEDUnsupportedErrorThe registrar does not accept this payment token.
UPGRADE_NOT_APPROVEDUnsupportedErrorThe upgrade target is not an approved implementation.
WALLET_BATCH_UNSUPPORTEDUnsupportedErrorThe wallet cannot send calls as one batch.
USER_REJECTEDUserRejectedErrorThe user rejected the request.
CHAIN_MISMATCHWalletErrorThe wallet is on chain ?, expected ?.
ACCOUNT_NOT_FOUNDWalletErrorThe wallet has no account to sign with.
HCA_UNAVAILABLEHcaErrorThis chain has no ENS HCA deployment.
HCA_NOT_VERIFIEDHcaErrorThe account is not a verified ENS HCA of this owner.
HCA_EXECUTOR_UNSUPPORTEDHcaErrorNo configured executor can run this HCA operation.
HCA_ACTION_NOT_ALLOWEDHcaErrorThe HCA session policy does not allow this call.
HCA_SESSION_INVALIDHcaErrorThe HCA session is expired, revoked or for another resolver.
HCA_BUNDLER_REJECTEDHcaErrorThe bundler rejected the HCA UserOperation.
HCA_PAYMASTER_REJECTEDHcaErrorThe paymaster refused to sponsor the HCA UserOperation.
HCA_EXECUTION_FAILEDHcaErrorThe HCA execution failed.
HCA_EXECUTION_TIMEOUTHcaErrorThe HCA execution was not included in time.
HCA_UPGRADE_NOT_ALLOWEDHcaErrorThe upgrade set or the new implementation's canUpgradeFrom check does not allow this HCA upgrade.
HCA_SDK_UNSUPPORTEDHcaErrorThe Rhinestone SDK does not support the standalone ENS HCA.

Was this page helpful?

On this page