Docs / recovery
One failure. One bounded action.
Every recovery message names the next safe action and says whether retrying is allowed. It never hides settlement uncertainty and never silently creates a second authorization.
Recovery
Whether a retry is safe is part of the error.
Refused means nothing executed and nothing was charged, so the request can be corrected and sent again. Unresolved means execution began and the settlement state is not known, so it is reconciled rather than retried.
insufficient funds
refusedAdd enough of the quoted asset on the quoted network, then request a fresh quote.
Retry is safe once the action above is taken.
wrong network or asset
refusedSwitch to the quote's exact network and asset, then request a fresh quote.
Retry is safe once the action above is taken.
expired quote
refusedRequest a fresh quote and never reuse the expired authorization.
Retry is safe once the action above is taken.
rejected
refusedReview the maximum charge and approve again only if you still intend to pay.
Retry is safe once the action above is taken.
timeout
unresolvedReconcile the existing idempotency key before deciding whether to retry.
Retry is prohibited until the settlement state is reconciled.
unknown settlement
unresolvedReconcile the existing operation and do not authorize or retry until settlement is definitive.
Retry is prohibited until the settlement state is reconciled.
Frozen interface
What these guides describe.
- Release candidate
- clervo-private-core-2026-08-02.2
- Interface hash
- sha256:2773690eda2ed6c89461c98f1537fccc5ae648f37845eb7a5a620952647a39b4
- Public callable
- yes