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

PLAN_STALE

What PLAN_STALE means, why PlanError throws it, what to show users and how to fix it in ensforge. Also covers retry safety and the actions that throw it.

PlanErrorNot retryable
@ensforge/sdk

What happened

The plan no longer matches on-chain state.

What to show users

TitleMessageAction
Out of dateSomething changed since this was prepared.Start again.

How to fix

Prepare the plan again.

Retry safety

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

Actions that throw it

ActionWhen
plan.sendwhen a token it transfers was reissued since it was prepared.

Catch it

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

Was this page helpful?