Error Codes

{
  "error": {
    "code": "insufficient_balance",
    "message": "Wallet balance too low for this transaction",
    "details": {
      "wallet_id": "wallet_abc123",
      "required": "100.00",
      "available": "50.00",
      "currency": "USDC"
    }
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "Access denied"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Agent not found",
    "details": {
      "agent_id": "agent_xyz789"
    }
  }
}

{
  "error": {
    "code": "already_exists",
    "message": "Wallet already exists",
    "details": {
      "wallet_id": "wallet_abc123"
    }
  }
}

{
  "error": {
    "code": "insufficient_balance",
    "message": "Wallet balance too low for this transaction",
    "details": {
      "wallet_id": "wallet_abc123",
      "required": "100.00",
      "available": "50.00",
      "currency": "USDC"
    }
  }
}

{
  "error": {
    "code": "policy_denied",
    "message": "Transaction exceeds daily spending limit",
    "details": {
      "policy_id": "pol_abc123",
      "reason": "daily_limit_exceeded",
      "daily_limit": "1000.00",
      "spent_today": "950.00",
      "requested": "100.00"
    }
  }
}

{
  "error": {
    "code": "compliance_check_failed",
    "message": "Transaction blocked by compliance screening",
    "details": {
      "reason": "sanctioned_address"
    }
  }
}

{
  "error": {
    "code": "wallet_frozen",
    "message": "Wallet is frozen",
    "details": {
      "wallet_id": "wallet_abc123",
      "frozen_at": "2025-03-01T10:00:00Z",
      "reason": "Suspicious activity detected"
    }
  }
}

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid amount",
    "details": {
      "parameter": "amount",
      "value": "-10.00",
      "constraint": "must be greater than 0"
    }
  }
}

{
  "error": {
    "code": "missing_parameter",
    "message": "Missing required parameter",
    "details": {
      "parameter": "wallet_id"
    }
  }
}

{
  "error": {
    "code": "unsupported_token",
    "message": "Token PYUSD not supported on base",
    "details": {
      "token": "PYUSD",
      "chain": "base",
      "supported_tokens": ["USDC", "EURC"]
    }
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded",
    "details": {
      "limit": 100,
      "window": "1 minute",
      "retry_after": 45
    }
  }
}

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1709467200
Retry-After: 45

{
  "error": {
    "code": "chain_error",
    "message": "Transaction failed on chain",
    "details": {
      "chain": "base",
      "tx_hash": "0x123...",
      "reason": "gas_too_low"
    }
  }
}

{
  "error": {
    "code": "insufficient_gas",
    "message": "Insufficient ETH for gas",
    "details": {
      "chain": "base",
      "required_eth": "0.001",
      "available_eth": "0.0005"
    }
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "An unexpected error occurred",
    "details": {
      "request_id": "req_abc123"
    }
  }
}

{
  "error": {
    "code": "service_unavailable",
    "message": "Service temporarily unavailable",
    "details": {
      "retry_after": 60
    }
  }
}

import time
from sardis_sdk import SardisClient
from sardis_sdk.exceptions import SardisAPIError

client = SardisClient(api_key="sk_live_your_api_key")

def transfer_with_retry(wallet_id, destination, amount, max_retries=3):
    for attempt in range(max_retries):
        try:
            return client.wallets.transfer(
                wallet_id=wallet_id,
                destination=destination,
                amount=amount,
                token="USDC",
                chain="base"
            )
        except SardisAPIError as e:
            if e.code in ["rate_limit_exceeded", "service_unavailable"]:
                if attempt < max_retries - 1:
                    wait_time = (2 ** attempt) + (e.retry_after or 0)
                    time.sleep(wait_time)
                    continue
            raise

import logging

logger = logging.getLogger(__name__)

try:
    tx = client.wallets.transfer(...)
except SardisAPIError as e:
    logger.error(
        "Transfer failed",
        extra={
            "error_code": e.code,
            "error_message": e.message,
            "wallet_id": wallet_id,
            "request_id": e.request_id
        }
    )
    raise

ERROR_MESSAGES = {
    "insufficient_balance": "Your wallet doesn't have enough funds for this purchase.",
    "policy_denied": "This transaction exceeds your spending limits.",
    "compliance_check_failed": "This transaction cannot be completed. Please contact support.",
    "rate_limit_exceeded": "Too many requests. Please try again in a moment.",
}

def get_user_message(error_code):
    return ERROR_MESSAGES.get(error_code, "An unexpected error occurred. Please try again.")

{
  "event": "payment.failed",
  "data": {
    "tx_id": "tx_abc123",
    "wallet_id": "wallet_abc123",
    "amount": "100.00",
    "error": {
      "code": "policy_denied",
      "message": "Transaction exceeds daily spending limit"
    }
  },
  "created_at": "2025-03-03T10:00:00Z"
}