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

INSUFFICIENT_TOKEN_BALANCE

What INSUFFICIENT_TOKEN_BALANCE means, why InsufficientFundsError throws it, what to show users and how to fix it in ensforge.

@ensforge/sdk

What happened

The account does not have enough of the payment token.

What to show users

TitleMessageAction
Insufficient balanceYour wallet does not have enough tokens to pay.

Retry safety

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

Actions that throw it

ActionWhen
registration.registerwhen the signer cannot pay in the payment token.
registration.renewwhen the signer cannot pay in the payment token.

Any write can fail with InsufficientFundsError: it is part of Errors.WriteError.

Catch it

Errors.hasCode("INSUFFICIENT_TOKEN_BALANCE") narrows to this error. See Handle errors.

Was this page helpful?