Error Codes

try {
  const result = await client.createLightningToEvmSwap({
    targetAddress: "0x...",
    targetToken: "usdc_pol",
    targetChain: "polygon",
    sourceAmount: 100000,
  });
} catch (error) {
  console.error("Swap failed:", error.message);
  // Error messages include machine-readable codes like:
  // "insufficient_balance", "amount_too_low", "rate_limit_exceeded"
}

// API error response structure
interface ApiError {
  error: {
    code: string; // Machine-readable code
    message: string; // Human-readable message
    details?: object; // Additional context
  };
}

// Example error response
{
  "error": {
    "code": "insufficient_balance",
    "message": "Insufficient balance for swap",
    "details": {
      "required": 100000,
      "available": 50000,
      "currency": "sats"
    }
  }
}