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

HcaError

What HcaError means, which codes it carries and how to catch it in ensforge. Lists its fields and every code. Includes how to catch it.

Error class11 codes · @ensforge/hca

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

Fields

FieldTypeDescription
executorstringExecutor that failed, e.g. pimlico.

Codes

CodeMeaningRetryable
HCA_UNAVAILABLEThis chain has no ENS HCA deployment.No
HCA_NOT_VERIFIEDThe account is not a verified ENS HCA of this owner.No
HCA_EXECUTOR_UNSUPPORTEDNo configured executor can run this HCA operation.No
HCA_ACTION_NOT_ALLOWEDThe HCA session policy does not allow this call.No
HCA_SESSION_INVALIDThe HCA session is expired, revoked or for another resolver.No
HCA_BUNDLER_REJECTEDThe bundler rejected the HCA UserOperation.Yes
HCA_PAYMASTER_REJECTEDThe paymaster refused to sponsor the HCA UserOperation.No
HCA_EXECUTION_FAILEDThe HCA execution failed.No
HCA_EXECUTION_TIMEOUTThe HCA execution was not included in time.No
HCA_UPGRADE_NOT_ALLOWEDThe upgrade set or the new implementation's canUpgradeFrom check does not allow this HCA upgrade.No
HCA_SDK_UNSUPPORTEDThe Rhinestone SDK does not support the standalone ENS HCA.No

Catch it

error instanceof HcaError. See Handle errors.

Was this page helpful?