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

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.

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

​
ملخص الفقرة الواحدة

يجمّع برنامج التوجيه في AMM المبادلات متعددة المسارات في معاملة واحدة على السلسلة تربط السيولة عبر التجمّعات. توفّر قائمة بالمسارات (قائمة بالتجمّعات والعملات الوسيطة) وتعليمة واحدة مع معاملات الانزلاق؛ ويقوم جهاز التوجيه بتنفيذ جميع N من المسارات بالترتيب، نقل المخرجات من تجمع إلى آخر. لا تكون هناك حاجة إلى منطق موجه على السلسلة منفصل لحساب السعر—يتم التعامل مع رسم كل مسار ومنحناه من خلال برنامج التجمع الخاص به عبر CPI—لكن جهاز التوجيه ينظم تمرير الحسابات وحركة الرموز.

​
لماذا برنامج موجه منفصل؟

يمكن لعملاء Raydium والمجمّعات دائماً خياطة المبادلات متعددة المسارات معاً على جانب العميل دون استخدام جهاز التوجيه: بناء N من تعليمات المبادلة (واحدة لكل تجمع) وتقديمها في معاملة واحدة. إذاً، لماذا توجد برنامج موجه مخصص؟

​
أسباب استخدام جهاز التوجيه

  1. CPI من البرامج الأخرى. إذا احتاج برنامجك الخاص إلى استدعاء مسار كجزء من معاملة أكبر (على سبيل المثال، مدير السيولة الذي يقايض الرسوم بحثاً عن رمز مستهدف)، فإن CPI في جهاز التوجيه أنظف من حزم N من CPIs الفرعية وإدارة جميع حساباتها في عقدك.
  2. حالة الحسابات الذرية. يتم التحقق من قائمة حسابات كل مسار في سياق تعليمة واحد. إذا كانت حالة تجمع وسيط فاسدة أو فشلت التوكيد على سعر الحد، فسيفشل المسار بأكمله بشكل ذري بدون تسوية جزئية.
  3. تكوين تعليمة واحدة. يمكن لمجموعات البرامج والواجهات الأمامية تمثيل مسار متعدد المسارات كعملية منطقية واحدة، وليس كـ N من التعليمات المنفصلة التي تصادف أن تكون متتالية.

​
خياطة جانب العميل لا تزال الإعداد الافتراضي

بالنسبة لمعظم التطبيقات، بناء تعليمات Swap منفصلة لكل تجمع وتقديمها بالترتيب أبسط وأكثر قابلية للتركيب وصحيحة بالتساوي. يفعل Flow Trade.makeSwapTransaction وما شابهها في SDK الخاص بـ Raydium هذا بالضبط بالنسبة لمعظم المسارات. جهاز التوجيه هو بديل، وليس بديل. استخدمه عندما:
  • تقوم بتنفيذ برنامج يحتاج إلى التوجيه كجزء من عملية ذرية أكبر.
  • تقوم ببناء معادل يريد عملية “تقديم هذا المسار” واحدة.

​
كيف يعمل

تحمل تعليمة جهاز التوجيه:
  • معاملات المبادلة: مدخلات دقيقة (amount_in، minimum_amount_out) أو مخرجات دقيقة (maximum_amount_in، amount_out).
  • تحديد المسار: قائمة بـ program_id + حسابات البرنامج الفرعي لكل مسار، بالترتيب. يقرأ جهاز التوجيه الحساب الأول في كل مجموعة مسار لتحديد البرنامج الذي سيتم استدعاؤه.
  • أسعار الحد (لـ CLMM): VecDeque<u128> من حدود sqrt_price_x64. يتم استخدامها فقط لمسارات إلى تجمعات CLMM؛ deque الفارغة تعتبر خطأ للمتغيرات الأقدم من التعليمات.
يقوم جهاز التوجيه بعد ذلك بـ:
  1. تنفيذ المسار الأول: نقل amount_in (أو حساب المدخلات المطلوبة للمخرجات الدقيقة) إلى قبو الإدخال للتجمع الأول، واستدعاء مبادلة ذلك التجمع، وجمع المخرجات.
  2. ربط المسارات اللاحقة: لكل مسار N، استخدم المخرجات من المسار N−1 كمدخل للمسار N.
  3. فرض الانزلاق: في كل مسار CLMM، تحقق من sqrt_price مقابل limit_price المقابل؛ في المسار النهائي، تحقق من إجمالي المخرجات مقابل minimum_amount_out العام.
يمكن للرموز الوسيطة أن تتدفق إما عبر ATAs التي يتحكم فيها المستخدم (واحدة لكل مسار، أبطأ لكن شفافة) أو من خلال حساب مشتق من PDA مشترك (عنوان واحد لجميع المسارات، أسرع، معتم).

​
تفويض التسعير والرسوم

جهاز التوجيه لا يحسب الأسعار بنفسه. يفوّض كل مسار إلى منحنى برنامج الطفل:
  • AMM v4: يستخدم صيغة المنتج الثابت مع تسعير هجين OpenBook.
  • CPMM: يستخدم صيغة المنتج الثابت مع فئة الرسوم المكوّنة.
  • CLMM: يستخدم رياضيات السيولة المركزة مع التسعير المستند إلى الكاشف.
  • Stable: يستخدم منحنى المبادلة المستقرة للرموز المتشابهة.
يتم فرض الرسوم من قبل كل تجمع وفقاً لإعداده الخاص. جهاز التوجيه لا يفرض أي رسم خاص به.

​
متى يتم تجنب جهاز التوجيه

  • عدد المسارات المنخفض (1-2 مسارات). الحد الأدنى من تكلفة تمرير الحسابات؛ فقط استخدم تعليمتي مبادلة منفصلتين.
  • تجمعات غير Raydium. يعرف جهاز التوجيه فقط عن أنواع التجمعات الأربعة في Raydium. بالنسبة للمسارات التي تعبر البرامج الخارجية، قم بخياطة التعليمات في عميلك.
  • التوجيه الشرطي. إذا كنت بحاجة إلى فرع على الأسعار أو حالات التجمع منتصف المسار، فإن التوجيه على السلسلة أقل مرونة من التركيب على جانب العميل.

​
النموذج الذهني

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

​
إلى أين يتجه التالي