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
| Title | Message | Action |
|---|---|---|
| Network not supported | ENS 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
| Action | When |
|---|---|
hca.addDeposit | on chains without an HCA deployment. |
hca.authorizeSession | on chains without an HCA deployment. |
hca.checkSessionCalls | on chains without an HCA deployment. |
hca.deploy | on chains without an HCA deployment. |
hca.execute | on chains without an HCA deployment. |
hca.get | on chains without an HCA deployment. |
hca.getDeposit | on chains without an HCA deployment. |
hca.getSession | on chains without an HCA deployment. |
hca.getUpgrade | on chains without an HCA deployment. |
hca.predictAddress | on chains without an HCA deployment. |
hca.revokeSessions | on chains without an HCA deployment. |
hca.upgrade | on chains without an HCA deployment. |
hca.verify | on chains without an HCA deployment. |
hca.withdrawDeposit | on chains without an HCA deployment. |
hcaAdmin.getGovernance | on chains without an HCA deployment. |
hcaAdmin.grantUpgradeSetRoles | on chains without an HCA deployment. |
hcaAdmin.renounceGovernance | on chains without an HCA deployment. |
hcaAdmin.revokeUpgradeSetRoles | on chains without an HCA deployment. |
hcaAdmin.setDeploymentApproval | on chains without an HCA deployment. |
hcaAdmin.setUpgradeApproval | on chains without an HCA deployment. |
hcaAdmin.transferGovernance | on chains without an HCA deployment. |
Catch it
Check error instanceof HcaError && error.code === "HCA_UNAVAILABLE". See Handle errors.
Was this page helpful?