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_UPGRADE_NOT_ALLOWED

What HCA_UPGRADE_NOT_ALLOWED means, why HcaError throws it, what to show users and how to fix it in ensforge. Also covers retry safety.

HcaErrorNot retryable
@ensforge/hca

What happened

The upgrade set or the new implementation's canUpgradeFrom check does not allow this HCA upgrade.

What to show users

TitleMessageAction
Upgrade unavailableYour ENS account cannot be upgraded to this version.

Retry safety

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

Actions that throw it

ActionWhen
hca.upgradewhen a DAO set does not allow it.

Catch it

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

Was this page helpful?