Errors

The assistant-safe error envelope, the assistantHint field, and the implemented assistant-facing error codes.

Assistant-safe errors use a structured envelope with an optional assistantHint.

{
  "error": {
    "code": "MISSING_REQUIRED_FIELD",
    "message": "recipientWallet is required.",
    "assistantHint": "Ask the user for the recipient wallet before creating the invoice intent."
  }
}

Implemented assistant-facing codes include MISSING_REQUIRED_FIELD, INVALID_WALLET, UNSUPPORTED_TOKEN, EMPTY_LINE_ITEMS, POLICY_LIMIT_EXCEEDED, INTENT_EXPIRED, SIGNATURE_REQUIRED, INVOICE_NOT_READY, and RATE_LIMITED. Some merchant API endpoints still use the older error.message/error.code shape.