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.
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
| Code | Class | Meaning |
|---|---|---|
COMMITMENT_TOO_NEW | CommitmentError | The registration commitment is not ready yet. |
COMMITMENT_TOO_OLD | CommitmentError | The registration commitment has expired. |
COMMITMENT_EXISTS | CommitmentError | An unexpired commitment with the same data already exists. |
COMMITMENT_NOT_FOUND | CommitmentError | No commitment was found for this registration. |
UNKNOWN_CHAIN | ConfigError | ensforge has no ENS deployment for this chain. |
INVALID_DEPLOYMENT | ConfigError | The deployment profile is invalid. |
CONTRACT_NOT_DEPLOYED | ConfigError | No contract is deployed at the called address. |
WALLET_NOT_CONFIGURED | ConfigError | This action needs a wallet client with an account. |
INDEXER_NOT_CONFIGURED | ConfigError | This action needs an indexer. |
CCIP_READ_DISABLED | ConfigError | This name resolves off-chain, and CCIP-Read is disabled. |
INVALID_ACTION_GROUP | ConfigError | A decorator added an action group with a reserved name. |
CHAIN_NOT_CONFIGURED | ConfigError | The client has no clients for chain ?. |
CONTRACT_REVERTED | ContractRevertError | The contract call reverted. |
DNS_RECORD_MISSING | DnsError | The _ens TXT record is missing. |
DNSSEC_PROOF_FAILED | DnsError | The DNSSEC proof could not be built or verified. |
PROOF_STALE | DnsError | The DNSSEC proof is older than the one on-chain. |
TLD_NOT_PUBLIC | DnsError | The top-level domain is not a public suffix and cannot be imported. |
GATEWAY_REQUEST_FAILED | GatewayError | The off-chain gateway request failed. |
GATEWAY_RESPONSE_INVALID | GatewayError | The off-chain gateway returned an invalid response. |
OFFCHAIN_LOOKUP_INVALID | GatewayError | The resolver requested an off-chain lookup from an unexpected sender. |
INDEXER_UNAVAILABLE | IndexerError | The indexer is unavailable. |
INDEXER_RATE_LIMITED | IndexerError | The indexer is rate limiting requests. |
INDEXER_RESPONSE_INVALID | IndexerError | The indexer returned an unexpected response. |
INDEXER_REQUEST_REJECTED | IndexerError | The indexer rejected the request. |
INDEXER_BEHIND | IndexerError | The indexer is behind the chain. |
INDEXER_UNSUPPORTED | IndexerError | The indexer does not support this query. |
INSUFFICIENT_ETH | InsufficientFundsError | The account does not have enough ETH. |
INSUFFICIENT_TOKEN_BALANCE | InsufficientFundsError | The account does not have enough of the payment token. |
UNEXPECTED | InternalError | An unexpected error occurred. |
INVALID_NAME | InvalidInputError | undefined is not a valid ENS name. |
INVALID_ADDRESS | InvalidInputError | undefined is not a valid address. |
INVALID_COIN_TYPE | InvalidInputError | undefined is not a known coin type. |
INVALID_CONTENT_HASH | InvalidInputError | undefined is not a valid content hash. |
INVALID_RECORD_VALUE | InvalidInputError | undefined is not a valid record value. |
INVALID_DURATION | InvalidInputError | undefined is not a valid duration. |
DURATION_TOO_SHORT | InvalidInputError | The duration is shorter than the registrar's minimum. |
INVALID_EXPIRY | InvalidInputError | The expiry cannot be in the past or earlier than the current expiry. |
INVALID_ROLES | InvalidInputError | undefined is not a valid role bitmap. |
SALT_TAKEN | InvalidInputError | A contract was already deployed with this salt. |
NOT_ELIGIBLE | MigrationError | The name cannot be migrated to ENSv2 yet. |
ALREADY_MIGRATED | MigrationError | The name is already on ENSv2. |
NAME_NOT_LOCKED | MigrationError | The wrapped name is not locked, so it cannot use the locked migration route. |
RECORDS_UNKNOWN | MigrationError | The name's records are not known, so they cannot be copied to its new resolver. |
VERIFICATION_FAILED | MigrationError | The migration was sent, but the name's ENSv2 state differs from the plan. |
NAME_NOT_AVAILABLE | NameStateError | The name is already registered. |
NAME_NOT_REGISTERED | NameStateError | The name is not registered. |
NAME_RESERVED | NameStateError | The name is reserved. |
NAME_EXPIRED | NameStateError | The name has expired. |
NAME_NOT_RENEWABLE | NameStateError | The name cannot be renewed. |
NAME_LOCKED | NameStateError | The name is locked. |
NAME_NOT_WRAPPED | NameStateError | The name is not wrapped in the NameWrapper. |
NAME_WRAPPED | NameStateError | The name is already wrapped in the NameWrapper. |
NAME_UNREACHABLE | NameStateError | ENSv2 resolution no longer reaches this ENSv1 name. |
NAME_REQUIRES_MIGRATION | NameStateError | The name must be migrated to ENSv2 first. |
PARENT_NOT_MIGRATED | NameStateError | The parent name has not been migrated to ENSv2. |
REGISTRY_NOT_EMANCIPATED | NameStateError | The registry is not emancipated, so this transfer is unsafe. |
RPC_REQUEST_FAILED | NetworkError | The RPC request failed. |
RPC_TIMEOUT | NetworkError | The RPC request timed out. |
RATE_LIMITED | NetworkError | The RPC provider is rate limiting requests. |
LOG_RANGE_TOO_LARGE | NetworkError | The RPC provider's eth_getLogs limits make this block range too expensive. |
RESOLVER_NOT_FOUND | NotFoundError | The name has no resolver. |
RECORD_NOT_FOUND | NotFoundError | The record is not set. |
PRIMARY_NAME_NOT_SET | NotFoundError | The address has no primary name. |
PRIMARY_NAME_MISMATCH | NotFoundError | The primary name does not resolve back to this address. |
REGISTRY_NOT_FOUND | NotFoundError | No registry was found for this name. |
PLAN_NOT_FOUND | NotFoundError | No saved plan was found with this id. |
INDEXER_NOT_FOUND | NotFoundError | The indexer has no record of this resource. |
PLAN_STALE | PlanError | The plan no longer matches on-chain state. |
PLAN_CHAIN_MISMATCH | PlanError | The plan was prepared for another chain. |
PLAN_ACCOUNT_MISMATCH | PlanError | The plan was prepared for another account. |
PLAN_INVALID | PlanError | The text is not a serialized ensforge plan. |
PLAN_ROUTE_REQUIRED | PlanError | Part of this plan was sent through a route (via), which resuming needs again. |
TRANSACTION_REVERTED | TransactionError | The transaction reverted on-chain. |
RECEIPT_TIMEOUT | TransactionError | Timed out waiting for the transaction receipt. |
NONCE_CONFLICT | TransactionError | The transaction nonce conflicts with another transaction. |
NOT_OWNER | UnauthorizedError | The account does not own this name. |
MISSING_ROLES | UnauthorizedError | The account is missing the roles this change needs. |
CANNOT_GRANT_ROLES | UnauthorizedError | The account cannot grant or revoke these roles. |
NOT_APPROVED | UnauthorizedError | The account is not approved to manage this name. |
FUSE_BURNED | UnauthorizedError | A burned NameWrapper fuse forbids this change. |
TRANSFER_DISALLOWED | UnauthorizedError | This name cannot be transferred right now. |
SIGNATURE_INVALID | UnauthorizedError | The signature does not authorize this change. |
SIGNATURE_EXPIRED | UnauthorizedError | The signature has expired. |
UNSUPPORTED_PROTOCOL | UnsupportedError | This operation is not supported for this names. |
UNSUPPORTED_ON_DEPLOYMENT | UnsupportedError | This feature is not available on this deployment. |
RESOLVER_PROFILE_UNSUPPORTED | UnsupportedError | The resolver does not support this record type. |
PAYMENT_TOKEN_UNSUPPORTED | UnsupportedError | The registrar does not accept this payment token. |
UPGRADE_NOT_APPROVED | UnsupportedError | The upgrade target is not an approved implementation. |
WALLET_BATCH_UNSUPPORTED | UnsupportedError | The wallet cannot send calls as one batch. |
USER_REJECTED | UserRejectedError | The user rejected the request. |
CHAIN_MISMATCH | WalletError | The wallet is on chain ?, expected ?. |
ACCOUNT_NOT_FOUND | WalletError | The wallet has no account to sign with. |
HCA_UNAVAILABLE | HcaError | This chain has no ENS HCA deployment. |
HCA_NOT_VERIFIED | HcaError | The account is not a verified ENS HCA of this owner. |
HCA_EXECUTOR_UNSUPPORTED | HcaError | No configured executor can run this HCA operation. |
HCA_ACTION_NOT_ALLOWED | HcaError | The HCA session policy does not allow this call. |
HCA_SESSION_INVALID | HcaError | The HCA session is expired, revoked or for another resolver. |
HCA_BUNDLER_REJECTED | HcaError | The bundler rejected the HCA UserOperation. |
HCA_PAYMASTER_REJECTED | HcaError | The paymaster refused to sponsor the HCA UserOperation. |
HCA_EXECUTION_FAILED | HcaError | The HCA execution failed. |
HCA_EXECUTION_TIMEOUT | HcaError | The HCA execution was not included in time. |
HCA_UPGRADE_NOT_ALLOWED | HcaError | The upgrade set or the new implementation's canUpgradeFrom check does not allow this HCA upgrade. |
HCA_SDK_UNSUPPORTED | HcaError | The Rhinestone SDK does not support the standalone ENS HCA. |
Was this page helpful?