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_NOT_VERIFIED

What HCA_NOT_VERIFIED 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

The account is not a verified ENS HCA of this owner.

What to show users

TitleMessageAction
Account not recognizedThis is not a verified ENS account for your wallet.

How to fix

Check the address, or let ensforge derive the owner's HCA.

Retry safety

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

Actions that throw it

ActionWhen
hca.executewhen the HCA or executor cannot run them.
hca.revokeSessionswhen the HCA is not deployed.
hca.verifywhen a check fails.

Catch it

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

Was this page helpful?