معالجة الأخطاء

​

رموز حالة HTTP

​

مغلفات الاستجابة

​

نجاح

{
  "status": "ok",
  "tx": "base64-encoded unsigned transaction",
  "route": { "market_type": "pumpswap", "pool_id": "..." }
}

​

سوق غير مدعوم

{
  "status": "unsupported",
  "reason": "no_route",
  "message": "No supported market found for this mint. Supported DEXs: PumpSwap, Raydium (CPMM, Launchpad), Meteora (DBC, DAMM v2), Pump.fun."
}

​

لم يُفهرس

{
  "status": "not_indexed",
  "mint": "So11111111111111111111111111111111111111112",
  "reason": "mint not indexed yet; try again shortly"
}

​

خطأ

{
  "error": "descriptive error message"
}

​

أنواع ExitApiError

​

التحقق من قابلية إعادة المحاولة

import { ExitApiError } from "@lasersell/lasersell-sdk";

try {
  const response = await client.buildSellTx(request);
} catch (error) {
  if (error instanceof ExitApiError) {
    console.log("Kind:", error.kind);
    console.log("Retryable:", error.isRetryable());
    console.log("HTTP status:", error.status);
    console.log("Body:", error.body);
  }
}

​

سلوك إعادة المحاولة المدمج

​

تخصيص سياسة إعادة المحاولة

const client = ExitApiClient.withOptions("YOUR_API_KEY", {
  attempt_timeout_ms: 2000,
  retry_policy: {
    max_attempts: 3,
    initial_backoff_ms: 50,
    max_backoff_ms: 200,
    jitter_ms: 50,
  },
});

​

أفضل الممارسات

• لا تعد المحاولة لأخطاء 400 أو 401 أو 422. هذه تشير إلى مشكلة في الطلب أو المصادقة يجب إصلاحها في الكود.
• لا تعد المحاولة لـ 404 مع "status": "unsupported". الرمز ليس لديه سوق مدعوم.
• أعد المحاولة مرة لـ 404 مع "status": "not_indexed". قد يحتاج الرمز لحظة للحل.
• تراجع أسياً عند استجابات 429. تتعامل إعادة المحاولة المدمجة مع هذا تلقائياً.
• أعد المحاولة مع تراجع عند أخطاء 502 و503. هذه مشاكل بنية تحتية عابرة.
• سجّل تفاصيل الأخطاء بما في ذلك kind وstatus وbody للتصحيح.
• إذا رأيت أخطاء envelope_status متكررة، تحقق من صحة عنوان mint وuser_pubkey.