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

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.

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

​
مفهومان مختلفان

غالباً ما يتم الخلط بين تأثير السعر والانزلاق في واجهات المستخدم، لكنهما يشيران إلى أشياء مختلفة.
  • تأثير السعر هو خاصية حتمية لتداول ضد حالة معينة للمجموعة. بمعرفة (Δin, reserves)، يمكن حساب تأثير السعر بشكل كامل قبل تقديم التداول.
  • الانزلاق هو الفرق المتحقق بين السعر الذي توقعته وقت الاقتباس والسعر الذي حصلت عليه فعلياً وقت التنفيذ. إنه دالة للكمون والمعاملات المتزامنة وترتيب إدراج الكتل — وليس من رياضيات المجموعة.
اقتباس بنسبة 1% مقابل مجموعة خاملة بخلاف ذلك له انزلاق بنسبة 0% إذا هبط في الكتلة التالية؛ النسبة 1% كانت تأثير السعر. ينخفض نفس الاقتباس بنسبة 0.2% إذا ضربت عملية تجارية أخرى المجموعة أولاً — النسبة الإضافية 0.2% هي الانزلاق.

​
التعريفات الرسمية

​
تأثير السعر

p_before = pool.spot_price()
p_after  = pool.spot_price_if_trade(Δin) applied
impact   = (p_before − p_after) / p_before       // can be signed
بالنسبة لـ CPMM: impact ≈ 2 · Δin / reserve_in للتجارات الصغيرة. بالنسبة لـ CLMM: يعتمد على عدد الـ ticks التي يعبرها التداول؛ غالباً ما يكون ثابتاً ضمن نطاق الـ tick الحالي، مع قفزات عند كل عبور tick.

​
الانزلاق المتحقق

quoted_out = amount_out computed at quote time
actual_out = amount_out observed on-chain
slippage   = (quoted_out − actual_out) / quoted_out
الانزلاق دائماً غير سالب (أو صفر)، بافتراض أن الاقتباس كان صادقاً. القيمة السالبة تعني أنك حصلت على أكثر من المقتبس — ممكن إذا تحركت حالة المجموعة لصالحك بين الاقتباس والتنفيذ.

​
تحديد حجم minAmountOut و maxAmountIn

كل عملية swap في Raydium تأخذ حد حماية من الانزلاق:
  • SwapBaseInput(amount_in, min_amount_out) — إدخال دقيق، حد أدنى للمخرجات.
  • SwapBaseOutput(max_amount_in, amount_out) — إخراج دقيق، حد أقصى للمدخلات.
يحسبها SDK كما يلي: 
const computed = raydium.<pool_type>.computeAmountOut({
  poolInfo,
  amountIn,
  mintIn,
  mintOut,
  slippage: 0.005,     // 0.5% tolerance
});

// computed.amountOut         — the "expected" quote
// computed.minAmountOut      — amountOut × (1 − slippage), used as the on-chain bound
// computed.priceImpact       — deterministic, pool-state-only
// computed.fee               — total fee charged (all components summed)
تحمل الانزلاق هو مخزن مؤقت حول تأثير السعر، وليس تأثير السعر نفسه. تحمل بنسبة 0.5% يعني “قبول الأسوأ بما لا يزيد عن 0.5% من اقتباسي” — بغض النظر عما إذا كان تأثير السعر 0.01% (تجارة صغيرة) أو 2% (تجارة كبيرة). بالنسبة لتجارة بتأثير سعر 2% وتحمل 0.5%، يكون minAmountOut أقل من سعر الفوري قبل التداول بـ 2.5% — مجموع التأثير والتحمل، بشكل أساسي.

​
تحملات الانزلاق الموصى بها

لا يوجد رقم واحد صحيح؛ الحد الصحيح يعتمد على:
  1. استقرار الزوج. مجموعات العملات المستقرة يمكنها استخدام 0.1% بأمان. مجموعات الرموز المتقلبة غالباً ما تحتاج إلى 3-5% فقط للهبوط بشكل موثوق.
  2. حجم التجارة. التجارات الأكبر لها تأثيرات سعرية أكبر، لذا يحتاج التحمل إلى التوسع معها لتجنب الانعكاس. افتراضيات التوسيع التلقائي للـ SDK حول max(0.5%, 2 × price_impact) لهذا السبب.
  3. كمون إدراج الكتلة. المعاملات التي تجلس في mempool لعدة كتل معرضة لمزيد من التجارات المتزامنة. حزم Jito ورسوم الأولوية تقلل هذا.
قواعد التجربة (افتراضيات واجهة Raydium):
نوع الزوجالتحمل الافتراضي
مستقر-مستقر (USDC-USDT، USDC-USDS)0.1%
مستقر-رئيسي (USDC-SOL، USDC-BTC)0.5%
رئيسي-رئيسي (SOL-BTC، SOL-ETH)1%
متقلب (رموز meme، ذيل طويل غير سيال)3–5%

​
الفروقات عبر أنواع AMM

​
CPMM

تأثير السعر سلس ومستمر (نموذج مغلق 2 · Δin / reserve_in). تحمل الانزلاق يتوسع خطياً مع حجم التجارة.

​
AMM v4

نفس رياضيات المنحنى مثل CPMM، لكن “الاحتياطيات الفعالة” تشمل أوامر الحد المنشورة على OpenBook للمجموعة. عملياً هذا يعني:
  • الاقتباس على أرصدة الخزانة الخام يقلل من تقدير الاحتياطيات وبالتالي يبالغ في تقدير التأثير.
  • يجلب SDK AmmInfo ويجمع vault + on_book.free + on_book.locked للحصول على الرقم الصحيح.
  • حالة OpenBook القديمة (crank مسدود) يمكنها أن تسبب الاقتباس المقدر للتأثير في الاختلاف عن الواقع على السلسلة. المجمعات روتينياً تقوم بـ pre-crank (permissionless MonitorStep) قبل تجارة AMM-v4 كبيرة.

​
CLMM

تأثير السعر متدرج. ضمن نطاق الـ tick الحالي، التأثير تقريباً خطي في Δin / L. عبور حدود tick يمكنه تغيير L بشكل منفصل، مسبباً قفزة مفاجئة في السعر الهامشي. تجارة تعبر عدة ticks نادرة الأهمية يمكنها أن يكون لها تأثير أكثر بكثير مما يقترحه القاعدة الأساسية 2 · Δin / reserve. اقتباس SDK لـ CLMM يكرر خطوة الـ swap بشكل حتمي لإرجاع amountOut متوقع دقيق، لذا minAmountOut = amountOut · (1 − slippage) صحيح. لكن قيمة priceImpact المرجعة يجب تفسيرها كـ “الفارق بين سعر ما قبل التداول والسعر بعد التداول”، والذي على CLMM يمكنه أن يكون أكبر بكثير من الانزلاق الفعلي للمبادلة لمستخدم يهتم فقط بـ amount_out.

​
منحنى LaunchLab

مشابه لـ CPMM لكن مع منحنى غير متماثل (تربيعي أو احتياطيات افتراضية). يزداد التأثير بشكل أسرع للمشترين الأواخر حيث يشتد المنحنى نحو التخرج. واجهات المشترين الأوائل يجب أن تحذر عندما يتوقع الشراء دفع المنحنى أكثر من ~5% من quote_reserve_target في معاملة واحدة.

​
اعتبارات MEV

على Solana، استخراج MEV ضد عمليات المبادلة غالباً ما يأخذ شكل هجمات الشطيرة: يضع bot معاملة back-run تتداول بعدك، بالإضافة إلى front-run يتداول قبلك، كلاهما في نفس الـ slot. تملأ تجارتك بسعر أسوأ مما كانت ستملأ بدون الشطيرة؛ تلتقط back-run الفرق. التخفيف:
  1. minAmountOut ضيق. حدود انزلاق عدوانية تسبب معاملة الضحية في الانعكاس إذا تم عمل sandwich بشكل ثقيل، حماية الأموال (لكن إهدار الغاز). على Solana هذا ممارسة قياسية — الرفض رخيص.
  2. حزم Jito. التقديم عبر Jito مع نصيحة مجمعة تستبعد الوسطاء من إعادة ترتيب tx الخاص بك. الحزم تهبط كتطبيقات ذرية.
  3. رسوم الأولوية. رسم أولوية عالي يزيد من فرصة هبوط تجارتك في كتلة الـ leader الحالية قبل أن يتمكن sandwicher من الرد. أقل قوة من الحزم، أكثر معياراً.
  4. RPC خاص. التقديم عبر RPC خاص (أو عبر نقطة نهاية المدقق المباشرة) يقلل من النافذة التي يمكن فيها لـ mempool sandwicher ملاحظة معاملتك.
SDK Raydium لا يقوم بالدمج؛ المدمجون عادة ما يطبقون Jito في الأعلى. راجع integration-guides/routing-and-mev للأنماط.

​
الانزلاق للمسارات متعددة القفزات

عندما يوجه swap عبر مجموعات متعددة (مثل USDC → SOL → RAY)، يجب تطبيق تحمل الانزلاق لكل قفزة، وليس فقط end-to-end: 
// Bad: 0.5% applied at the end only, so any intermediate hop sliding fails the second hop.
const finalMin = finalAmount * (1 - 0.005);

// Better: each hop enforces its own bound.
const hop1Min  = hop1Amount * (1 - 0.005);
const hop2Min  = hop2Amount * (1 - 0.005);
// End-to-end this is tighter (compound), but atomic — if either hop degrades, the tx reverts early.
يطبق موجه SDK حدود per-hop تلقائياً عندما تستدعي raydium.trade.swap. بالنسبة للموجهات المخصصة، كرر النمط.

​
الإبلاغ للمستخدمين

قواعد التجربة لـ UI swap جيدة:
  • اعرض كلا تأثير السعر المتوقع وتحمل الانزلاق بشكل منفصل.
  • أبرز عندما يتجاوز تأثير السعر ~2% — تحذير “تأثير مرتفع”.
  • أبرز عندما يتجاوز تأثير السعر التحمل — المعاملة من شبه المؤكد أنها ستنعكس.
  • بالنسبة للأزواج المتقلبة، قدم “وضع انزلاق مرتفع” يرخي الحد ويظهر تحذير أقوى.

​
مؤشرات

المصادر:
  • تطبيق Raydium SDK v2 للانزلاق والتأثير.
  • Flashbots / Jito على Solana MEV.