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

HCA_UNAVAILABLE

What HCA_UNAVAILABLE means, why HcaError throws it, what to show users and how to fix it in ensforge. Also covers retry safety and the actions that throw it.

HcaErrorNot retryable
@ensforge/hca

What happened

This chain has no ENS HCA deployment.

What to show users

TitleMessageAction
Network not supportedENS accounts are not available on this network.Switch to Ethereum mainnet or Sepolia.

How to fix

Use mainnet or Sepolia, or pass a deployment with an hca group.

Retry safety

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

Actions that throw it

ActionWhen
hca.addDepositon chains without an HCA deployment.
hca.authorizeSessionon chains without an HCA deployment.
hca.checkSessionCallson chains without an HCA deployment.
hca.deployon chains without an HCA deployment.
hca.executeon chains without an HCA deployment.
hca.geton chains without an HCA deployment.
hca.getDepositon chains without an HCA deployment.
hca.getSessionon chains without an HCA deployment.
hca.getUpgradeon chains without an HCA deployment.
hca.predictAddresson chains without an HCA deployment.
hca.revokeSessionson chains without an HCA deployment.
hca.upgradeon chains without an HCA deployment.
hca.verifyon chains without an HCA deployment.
hca.withdrawDepositon chains without an HCA deployment.
hcaAdmin.getGovernanceon chains without an HCA deployment.
hcaAdmin.grantUpgradeSetRoleson chains without an HCA deployment.
hcaAdmin.renounceGovernanceon chains without an HCA deployment.
hcaAdmin.revokeUpgradeSetRoleson chains without an HCA deployment.
hcaAdmin.setDeploymentApprovalon chains without an HCA deployment.
hcaAdmin.setUpgradeApprovalon chains without an HCA deployment.
hcaAdmin.transferGovernanceon chains without an HCA deployment.

Catch it

Check error instanceof HcaError && error.code === "HCA_UNAVAILABLE". See Handle errors.

Was this page helpful?