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_ACTION_NOT_ALLOWED

What HCA_ACTION_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 HCA session policy does not allow this call.

What to show users

TitleMessageAction
Not allowedYour session does not allow this action.Approve it from your wallet instead.

How to fix

Sessions may register names, deploy the session resolver and set its records; send other calls as the owner.

Retry safety

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

Actions that throw it

ActionWhen
hca.checkSessionCallsfor the first call outside the policy.

Catch it

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

Was this page helpful?