الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

هذه الصفحة مُترجَمة آليًا بواسطة الذكاء الاصطناعي. النسخة الإنجليزية هي المرجع المعتمد.عرض النسخة الإنجليزية →
المبادلة هي أكثر العمليات شيوعًا للمستخدمين. تشرح هذه الصفحة تدفق واجهة Raydium، والإعدادات التي يمكنك التحكم فيها، وطرق الفشل المحتملة.

المدخلات

كل مبادلة تحتاج إلى:
  • الرمز المُدخَل (عنوان التعريف + الكمية)
  • الرمز المُخرَج (عنوان التعريف)
  • تفاوت الانزلاق (القيمة الافتراضية 0.5% في الواجهة؛ 1% على الأزواج المتقلبة)
  • رسم الأولوية (يتم التحجيم تلقائيًا افتراضيًا)
يتم تحديد الكمية إما كـ “exact-in” (تحدد ما تدفعه؛ الناتج محسوب) أو “exact-out” (تحدد ما تحصل عليه؛ الإدخال محسوب). تفترض الواجهة الافتراضية exact-in.

شرح الواجهة

على raydium.io/swap:
  1. أدخل الكميات. اختر رموز الإدخال والإخراج؛ اكتب كمية في أي من الحقلين. سيُملأ الآخر تلقائيًا باستخدام السعر الحالي.
  2. راجع المسار. تعرض لوحة المسار أي مجموعة سائلة اختارتها Raydium:
    • مجموعة واحدة (الأكثر شيوعًا): “SOL → USDC via CLMM 0.05%”
    • قفزات متعددة: “SOL → USDC via CPMM, then USDC → RAY via CLMM”
    • مقسمة: “SOL → USDC via 60% CLMM 0.05%, 40% CPMM 0.25%”
    لكل قفزة: القيمة المقفلة الإجمالية، والرسم، والتأثير المتوقع. تُظهر التجارات الكبيرة تحذيرًا بارزًا عندما يتجاوز التأثير 1%.
  3. تحقق من الانزلاق. القيمة الافتراضية هي 0.5%. لأزواج مستقرة 0.1%؛ لرموز الميمات 2–5%. إذا تغير السعر أثناء مراجعتك له (تتقلب الأسعار)، فإن الواجهة تعيد الاقتباس كل 10 ثوان وتومض.
  4. عيّن رسم الأولوية. تلقائي افتراضيًا؛ ثلاث مستويات:
    • عادي (النسبة المئوية 50) — افتراضي
    • سريع (النسبة المئوية 75)
    • توربو (النسبة المئوية 95) يمكن للمستخدمين المتقدمين إدخال رقم محدد من الميكروية-لامبورت/CU.
  5. أكمل وقع. تُرسل المعاملة؛ تتابع الواجهة التأكيد. الوقت المتوقع 5–15 ثانية عند الازدحام العادي.
  6. بعد المبادلة. تعرض الواجهة الكمية المستقبلة فعليًا (قد تختلف عن السعر بما يصل إلى الانزلاق)؛ انقر للعثور على مستكشف tx للتفاصيل الكاملة.

كيف يختار التوجيه مجموعة

عندما تكون هناك عدة مجموعات للزوج نفسه، يختار موجّه Raydium حسب:
  1. أعلى amountOut بعد الرسوم. احسب السعر لكل مجموعة مؤهلة؛ اختر الذي يعطي أكثر ناتج.
  2. كسر التعادل حسب TVL. يعني TVL أعلى تأثيرًا أصغر على التجارة التالية — مقاوم لتقلب السعر بين السعر والإرسال.
  3. فضّل مجموعة واحدة على قفزات متعددة. تُركب القفزات المتعددة الرسوم والانزلاق؛ يختار الموجّه القفزات المتعددة فقط إذا تفوقت على مجموعة واحدة بـ >5 bps.
  4. انقسام إذا كان كبيرًا. للتجارات الكبيرة نسبيًا إلى TVL للمجموعة، قد ينقسم المسار عبر المجموعات لتقليل تأثير السعر.
منتجات مقارنة على الأزواج النموذجية:
  • مجموعات CPMM تهيمن عند TVL منخفض (<$1M) لأنها رخيصة الإنشاء وتمويل رسم المبادلة لـ LPs مباشرة.
  • مجموعات CLMM تهيمن عند TVL متوسط/مرتفع للأزواج المتقلبة — السيولة المركزة تعني أسعارًا أفضل ضمن نطاق السعر الشائع.
  • مجموعات AMM v4 تهيمن على الأزواج الراسخة مع التكامل العميق مع OpenBook (SOL-USDC, RAY-USDC). لا تلمس معظم الأزواج الجديدة AMM v4 أبدًا.

رسوم نقل Token-2022

إذا كان الرمز المُدخَل أو المُخرَج Token-2022 برسم نقل:
  • سعر amountOut هو صافي الكمية المستقبلة للمستخدم بعد الرسم.
  • يتم تقسيم “الرسم” المعروض في الواجهة إلى “رسم المجموعة” (رسم LP) و”رسم النقل” (يُدفع إلى مُصدِر التعريف).
انظر algorithms/token-2022-transfer-fees.

الانزلاق

يحمي الانزلاق من حركة السعر السلبية بين السعر والتنفيذ. تحوّل Raydium نسبة الانزلاق لديك إلى الحد الأدنى للكمية التي يجب أن تستقبلها:
minimumAmountOut = expectedAmountOut × (1 - slippage)
إذا كان الناتج الفعلي أقل، فإن المعاملة ستعود بـ ExceededSlippage. القيم الافتراضية الشائعة:
نوع الزوجالانزلاق
مستقر-مستقر0.01–0.1%
رئيسي-رئيسي (SOL/USDC)0.1–0.5%
متوسط الرأسمالية المتقلبة0.5–1%
رموز الميمات2–5%
Token-2022 برسم النقلأضف رسم النقل إلى الانزلاق
الانزلاق الضيق جدًا يسبب عودات متكررة تحت حركة السعر العادية. الانزلاق الفضفاض جدًا يدعو إلى هجمات الساندويتش (انظر integration-guides/routing-and-mev).

رسوم الأولوية

تدفع رسوم الأولوية للمدققين أكثر لمعالجة معاملتك عند الازدحام. تفترض الواجهة إعدادًا تلقائيًا. استخدم سريع أو توربو عندما تكون الشبكة مشغولة، عندما تبادل زوجًا متقلبًا، أو عندما تنتهي صلاحية معاملة سابقة قبل التأكيد. لا تحسّن رسوم الأولوية الأعلى السعر المقتبس. تحسّن فقط احتمال هبوط معاملتك قبل انتهاء صلاحية السعر.

طرق الفشل الشائعة

المعاملة تعود مع ExceededSlippage

تحرك السعر أكثر من التفاوت بين السعر والتنفيذ. الإصلاحات:
  1. زيادة الانزلاق بالقدر اللازم فقط.
  2. تقليل حجم التجارة (تأثير أقل).
  3. أعد الاقتباس وحاول مجددًا؛ قد يكون السعر عابرًا.
  4. تجنب الانزلاق العالي جدًا على الأزواج الرئيسية، لأنه قد يعرضك لتنفيذ أسوأ.

انتهاء صلاحية المعاملة

رسم الأولوية منخفض جدًا للازدحام الحالي. الإصلاح: رفع رسم الأولوية؛ انظر integration-guides/priority-fee-tuning.

InvalidAccountData على مبادلة CLMM

قد يعتمد المسار على حساب CLMM فشل تحميله أو تغيّر أثناء فتح السعر. حدّث الصفحة، أعد الاقتباس، وحاول مجددًا. إذا استمرت، اختر مسارًا آخر إذا كانت الواجهة توفر واحدًا.

”المجموعة غير موجودة” / بيانات مجموعة قديمة

تم إنشاء المجموعة مؤخرًا ولم يتم فهرستها بعد. أعد الجلب حسب المعرف مباشرة: انتظر بضع دقائق، حدّث التطبيق، وابحث عن المجموعة أو رمز التعريف مجددًا. يمكن أن تستغرق المجموعات التي تم إنشاؤها حديثًا بعض الوقت لتظهر في بحث الواجهة المفهرسة.

الناتج صفر / صغير جدًا

حجم المبادلة يتجاوز سيولة المجموعة. المجموعة ضحلة جدًا؛ قلل حجم التجارة، جرّب مسارًا آخر، أو انتظر سيولة أكثر.

المعاملة هبطت لكن الرصيد لم يتغير

حدّث رصيد محفظتك و Raydium. إذا نجحت المعاملة على المستكشف، تحقق مما إذا كان حساب الرمز المُخرَج مخفيًا في واجهة محفظتك.

التحقق

استخدم رابط المعاملة الذي تعرضه Raydium بعد التأكيد. على Solscan أو SolanaFM، تحقق من:
  • الحالة: نجح.
  • الموقّع: عنوان محفظتك.
  • تغييرات رصيد الرموز: انخفض الرمز المُدخَل، زاد الرمز المُخرَج.
  • البرامج المستدعاة: برنامج مبادلة Raydium بالإضافة إلى برامج الرموز/النظام.

مؤشرات

المصادر: