Reference

Errors

Every error code the SDK can raise, what it means and what to do.

The SDK raises UnsleptError with a stable code and a message written for people. Policy errors are raised before anything is paid.

Code	Meaning and fix
`PER_CALL_CAP`	The price is above the per-call cap. Raise the cap or skip the request.
`DAILY_CAP`	Today's spending would exceed the daily cap. It resets at 00:00 UTC.
`MAX_AMOUNT`	The price is above the maxAmount you passed for this request.
`PAYEE_NOT_ALLOWED`	The payee is not on the allowlist. Add it from the owner wallet.
`AGENT_PAUSED`	The owner paused the agent. Resume it in the app.
`AGENT_REVOKED`	The signer was revoked. Create a new agent account.
`INSUFFICIENT_COLLATERAL`	The account is not worth enough to cover the payment. Fund it.
`INSUFFICIENT_BUFFER_LIQUIDITY`	The buffer cannot front this payment right now. Retry shortly or fund the account's liquid balance.
`SETTLEMENT_FAILED`	The transaction failed or the server rejected the proof. The message has details.
`CONFIG`	A setting is missing or wrong, such as an address or environment variable.