Codigos de Error

{
  "error": "ERROR_CODE",
  "message": "Descripción legible del error",
  "details": {
    "campo": "información adicional"
  }
}

{
  "error": "UNAUTHORIZED",
  "message": "Invalid or missing API key"
}

// Verificar formato correcto
headers: {
  'Authorization': `Bearer ${apiKey}` // Nota el espacio
}

{
  "error": "FORBIDDEN",
  "message": "Access denied"
}

{
  "error": "INVALID_REQUEST",
  "message": "Invalid request body",
  "details": {
    "field": "amount",
    "issue": "Must be a positive number"
  }
}

{
  "error": "INVALID_WALLET_ID",
  "message": "Wallet ID format is invalid",
  "details": {
    "provided": "wallet123",
    "expected": "pan_wallet_*"
  }
}

{
  "error": "INVALID_CHAIN",
  "message": "Chain not supported",
  "details": {
    "provided": "polygon",
    "supported": ["ethereum", "arbitrum", "base"]
  }
}

{
  "error": "WALLET_NOT_FOUND",
  "message": "Wallet not found for user",
  "details": {
    "userId": "usuario_123"
  }
}

{
  "error": "INTENT_NOT_FOUND",
  "message": "Intent not found",
  "details": {
    "intentId": "intent_xyz789"
  }
}

{
  "error": "WALLET_ALREADY_EXISTS",
  "message": "Wallet already exists for this user",
  "details": {
    "userId": "usuario_123",
    "existingWalletId": "pan_wallet_abc123"
  }
}

{
  "error": "WALLET_LIMIT_EXCEEDED",
  "message": "Maximum wallet limit reached for your plan",
  "details": {
    "limit": 100,
    "current": 100,
    "plan": "free"
  }
}

{
  "error": "RATE_LIMITED",
  "message": "Too many requests",
  "details": {
    "limit": 100,
    "window": "1 minute",
    "retryAfter": 45
  }
}

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

{
  "error": "INSUFFICIENT_CREDITS",
  "message": "Not enough credits for this operation",
  "details": {
    "required": 5,
    "available": 2
  }
}

{
  "error": "INSUFFICIENT_FUNDS",
  "message": "Wallet does not have sufficient funds",
  "details": {
    "asset": "USDC",
    "required": "1000",
    "available": "750",
    "shortfall": "250"
  }
}

{
  "error": "BRIDGE_FAILED",
  "message": "Bridge operation failed",
  "details": {
    "from": "arbitrum",
    "to": "base",
    "reason": "Fill timeout exceeded"
  }
}

{
  "error": "DEPOSIT_FAILED",
  "message": "Deposit to protocol failed",
  "details": {
    "protocol": "aave",
    "chain": "base",
    "reason": "Transaction reverted"
  }
}

{
  "error": "EXECUTION_TIMEOUT",
  "message": "Execution exceeded maximum time",
  "details": {
    "elapsed": "600s",
    "maxAllowed": "600s"
  }
}

{
  "error": "INTERNAL_ERROR",
  "message": "An unexpected error occurred"
}

{
  "error": "SERVICE_UNAVAILABLE",
  "message": "Service temporarily unavailable"
}

async function requestConManejo(fn) {
  try {
    return await fn();
  } catch (error) {
    switch (error.code) {
      case 'RATE_LIMITED':
        const wait = error.details?.retryAfter || 60;
        await sleep(wait * 1000);
        return requestConManejo(fn);

      case 'INSUFFICIENT_FUNDS':
        throw new UserError(`Necesitas ${error.details.shortfall} mas`);

      case 'WALLET_NOT_FOUND':
        // Crear wallet automaticamente
        return await crearWallet(error.details.userId);

      case 'INTERNAL_ERROR':
      case 'SERVICE_UNAVAILABLE':
        // Reintentar con backoff
        await sleep(5000);
        return requestConManejo(fn);

      default:
        throw error;
    }
  }
}