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

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

​
داخلي: Pool كأوراكل

بالنسبة لـ AMM v4 وCPMM وCLMM، تُشتق تعريف البروتوكول للسعر الحالي من حالة الـ Pool وحدها:
  • AMM v4 / CPMM: price = vaultB_balance / vaultA_balance (مع الأخذ في الاعتبار الكسور العشرية).
  • CLMM: price = (sqrtPriceX64 / 2^64)^2 × 10^(decimalsA - decimalsB).
لا يتم استشارة أي أوراكل خارجي أثناء المبادلة أو الإيداع أو السحب. هذا هو الجزء “الموثوق” من تصميم AMM: إذا كان رياضيات الـ Pool صحيحة، فلا يمكن لأي تلاعب خارجي بمصدر السعر أن يفسدها.

​
CLMM ObservationState كأوراكل TWAP

تحتفظ بركات CLMM بحساب ObservationState الذي يسجل لقطات sqrt_price تاريخية. يمكن لبرامج أخرى أن تقترن بهذا لاستخراج متوسط السعر المرجح بالوقت المقاوم للتلاعب: 
// A simplified TWAP: average of (current, N slots ago).
let obs_now  = load_observation(pool, Clock::slot());
let obs_past = load_observation(pool, Clock::slot() - 300);  // ~2 min ago
let twap = (obs_now.price_cumulative - obs_past.price_cumulative)
         / (obs_now.slot - obs_past.slot);
هذا نفس النمط الذي يستخدمه Uniswap V3. التلاعب قصير الأجل بالسعر (حيتان تدفع الـ Pool مؤقتاً) لا يفسد TWAP لأنه يتم حسابه بمتوسط مئات الـ Slots. يجب على البرامج التي تحتاج إلى مصدر سعر أكثر أماناً لعملات CLMM (أوراكل التصفية، تسعير الخيارات، إلخ) استخدام TWAP في ObservationState بدلاً من الأسعار الفورية. لا تستخدم أسعار CLMM الفورية للقابلية للتركيب. يمكن لمبادلة واحدة كبيرة أن تدفع السعر الفوري بنسبة 10%+ على بركة ضحلة؛ TWAP يخفف هذا. انظر products/clmm/accounts#observation-state لتخطيط البيانات.

​
خارجي: تسعير بالدولار الأمريكي على واجهة المستخدم / API

تعرض واجهة Raydium الأمامية و api-v3.raydium.io القيم بالدولار الأمريكي (TVL, APR الرسوم, حجم $). تأتي هذه من:
  • Pyth كأوراكل أساسي للعملات الرئيسية.
  • سعر مجمع Jupiter كخيار بديل.
  • السعر المشتق من الـ Pool لعملات الذيل الطويل بدون تغطية أوراكل خارجية.
عروض الدولار الأمريكي تجميلية تماماً — العمليات على السلسلة لا تقرأ Pyth مطلقاً، وعدم استخدام الدولار في رياضيات Pool. إذا توقف Pyth عن توفير البيانات لعملة، تعرض واجهة المستخدم ”—”؛ يحافظ الـ Pool على عمله.

​
تلاعب الأوراكل غير قابل للتطبيق على بركات Raydium

لأن حالة الـ Pool هي الأوراكل، لا توجد “هجمة أوراكل” بالمعنى الذي تعنيه أدبيات bug bounty — لا توجد مصادر بيانات خارجية قابلة للتلاعب يمكن للمهاجم أن يفسدها. الهجمات الاقتصادية على حالة الـ Pool (تلاعب على غرار القروض الفورية) مغطاة في security/attack-vectors.

​
مخاطر امتدادات Token-2022

يضيف SPL Token-2022 (ويُعرف أيضاً باسم “Token Extensions”) السلوك القابل للتكوين إلى الـ Mints عبر الامتدادات. تغير بعض الامتدادات خصائص الثقة للـ Pools التي تتضمنها. تتعامل برامج Raydium مع البعض تلقائياً وتعرض الآخر كتحذيرات للمستخدم.

​
رسوم التحويل

ما هي: رسوم قابلة للتكوين (نسبة مئوية من التحويل، تصل إلى حد maximum_fee بالشروط المطلقة) يدفعها المرسل إلى سلطة الـ Mint عند كل تحويل. المخاطر: يمكن تغيير الرسوم بواسطة سلطة تكوين الرسوم الخاصة بالـ Mint. إذا أودعت السيولة عندما تكون الرسوم 1%، وترفع السلطة إلى 50%، ستعود المبادلات اللاحقة بأقل بكثير من المتوقع. التخفيف في Raydium: تقرأ البركات transferFeeConfig الحالية وقت المبادلة وتعدل الرياضيات. الـ Pool نفسه لا يفسد، لكن المستخدمون يرون مخرجات أسوأ. يمكن لسلطة الرسوم أيضاً جدولة تغيير رسوم مؤجل؛ تشير واجهة Raydium إلى البركات ذات تغييرات الرسوم الوشيكة. المخاطر المتبقية: إذا غيرت سلطة رسوم خبيثة الرسوم أثناء مبادلتك الجارية، فإن minimumAmountOut يحمي الجانب السفلي — الـ tx ينقلب. إذا وثقت بمُصدر الـ Mint، فهذا بخير؛ إذا لم تثق، فلا تودع السيولة.

​
خطاف النقل

ما هي: يستدعي التحويل برنامج منفصل (الـ “خطاف”) لتشغيل التحقق المخصص أو التأثيرات الجانبية. المخاطر: يمكن للخطاف أن يمنع أي تحويل، بما في ذلك التحويلات الداخلية للـ Pool أثناء المبادلة. يمكن للخطاف القابل للترقية أن يصبح خبيثاً لاحقاً — ما كان آمناً وقت الإيداع يمكن أن يصبح غير قابل للمبادلة عند السحب. التخفيف في Raydium: Raydium يسرد معرف برنامج الخطاف في حالة الـ Pool. يجب على التكاملات عرض معرف برنامج الخطاف للمستخدمين حتى يتمكنوا من التحقق من أنه البرنامج المتوقع (غير قابل للترقية، مدقق عليه). المخاطر المتبقية: إذا كان الخطاف قابلاً للترقية وأصبحت سلطته معادية، يمكن تجميد الـ Pool. Raydium لا يمنع الـ Pools ذات خطاف النقل، لكنه يشير إليها. أودع السيولة في بركة خطاف نقل فقط إذا تم التحقق من أن الخطاف آمن.

​
سلطة التجميد

ما هي: يمكن لسلطة تجميد الـ Mint تجميد أي حساب رموز يحمل تلك الـ Mint، مما يمنع جميع التحويلات. المخاطر: تجميد سلطة لديها القدرة على تجميد حساب الـ Vault الخاص بالـ Pool يغلق الـ Pool فعلياً — لا يمكن للمستخدمين السحب، ولا يمكن للتجار المبادلة. ينطبق هذا على SPL Token و Token-2022؛ إنه ليس جديداً مع Token-2022، لكنه لا يزال مخاطرة. التخفيف في Raydium: لا توجد على مستوى البرنامج — تجميد SPL Token معتم بالنسبة للـ Pool. تحذر واجهة Raydium من الـ Pools ذات الـ Mints القابلة للتجميد. يجب على المستخدمين المودعين التحقق من أن سلطة التجميد خالية أو متعدد التوقيع تثق به (USDC لديه سلطة تجميد؛ إنها Circle المُصدِر). المخاطر المتبقية: اقبل أن الـ Mints القابلة للتجميد يمكن تجميدها. الـ Mints الرئيسية (USDC, USDT, USDY) لديها سلطات تجميد تحتفظ بها المُصدِر وتستخدم فقط للامتثال التنظيمي؛ هذا عادة ما يكون مقبولاً.

​
الوكيل الدائم

ما هي: امتدادات Token-2022 الذي يعين وكيلاً دائماً يمكنه نقل الرموز من أي مالك بدون موافقة. المخاطر: يمكن للوكيل الدائم أن يستنزف الـ Vault الخاص بالـ Pool في أي وقت. التخفيف في Raydium: CPMM و CLMM يرفضان إنشاء البركات مع الـ Mints التي لديها وكيل دائم. ينقلب التهيئة. لا بركة Raydium قيد التشغيل لديها عملة وكيل دائم. المخاطر المتبقية: صفر (طالما الفحص صحيح، الذي تحقق منه كلا التدقيقات).

​
غير قابل للنقل

ما هي: Mints التي لا يمكن نقلها من قبل المالكين. المخاطر: تعتمد البركات على نقابلية النقل لنقل الرموز بين ATAs المستخدم وأوعية الـ Pool. Mints غير القابلة للنقل تكسر البركات ببساطة. التخفيف في Raydium: ينقلب إنشاء الـ Pool على الـ Mints غير القابلة للنقل. تحافظ المزارع أيضاً على رفض الـ Mints غير القابلة للنقل في الرهن.

​
مُجمّد بشكل افتراضي / سلطة الإغلاق / تحمل الفائدة

امتدادات بتأثير أقل يتعامل معها Raydium:
  • مُجمّد بشكل افتراضي: حسابات الرموز الجديدة تحتاج إلى إذابة قبل الاستخدام. يتعامل Raydium مع هذا بشفافية عند إنشاء ATA.
  • سلطة الإغلاق: سلطة معينة يمكنها إغلاق حسابات الرموز. أوعية الـ Pool مملوكة لسلطة البرنامج المشتقة من الـ Pool، لذا سلطة الإغلاق على الـ Mint لا تنطبق على الـ Vault.
  • تحمل الفائدة: الرصيد المعروض يستحق الفائدة؛ amount يبقى ثابتاً لكن uiAmount ينمو. رياضيات Raydium Pool تستخدم amount، وليس الفائدة المستحقة؛ التصميم يعدل بشكل منفصل.

​
سلطة الـ Mint

ليست خطراً محدداً لـ Token-2022، لكن يستحق الملاحظة: إذا احتفظت الـ Mint بسلطة الـ Mint، يمكن للمالك أن يضخم الإمدادات حسب الإرادة. بالنسبة للرموز المُطلقة، هذا يخفف LPs بسعر الـ Pool الحالي. يرفض LaunchLab إنشاء عمليات إطلاق ما لم تكن سلطة الـ Mint خالية.

​
علامات المخاطرة في واجهة المستخدم

تصنف واجهة Raydium الأمامية كل بركة بعلامات المخاطرة المعنية:
  • TRANSFER_FEE — رسوم نقل غير صفرية.
  • TRANSFER_HOOK — امتدادات خطاف النقل نشطة.
  • FREEZE — الـ Mint لديها سلطة تجميد.
  • MINT — الـ Mint لديها سلطة نقود (يمكن لحجم الإمدادات أن ينتفخ).
  • CLOSE — الـ Mint لديها سلطة الإغلاق.
يجب على المجمعات التي تستهلك API Raydium عرض هذه العلامات للمستخدمين.

​
قائمة تحقق المدمج

قبل الاقتران ببركة Raydium:
  • تحقق من امتدادات كل عملة عبر getMint(mint, TOKEN_2022_PROGRAM_ID).
  • تخطي البركات حيث توجد أي عملة permanent_delegate أو non_transferable (هذه لا يجب أن توجد في Raydium، لكن الدفاع بعمق).
  • تحقق من سلطة التجميد لكلا الـ Mints؛ فقط خالية أو سلطة موثوقة.
  • بالنسبة لبركات خطاف النقل، تحقق من معرف برنامج الخطاف ضد قائمة بيضاء.
  • حجم التعرض ضد سيناريوهات رسوم النقل (ماذا لو صعدت الرسوم إلى الحد الأقصى؟).
  • استخدم TWAP CLMM (ObservationState) بدلاً من السعر الفوري لتسعير المشتقات.

​
بيان قبول المخاطرة المتبقية

تفرض برامج Raydium ما يمكن فرضه على مستوى البرنامج:
  • إنشاء الـ Pool يرفض الـ Mints ذات الوكيل الدائم / غير القابلة للنقل.
  • رياضيات المبادلة تعدل بشكل صحيح للرسوم الحالية للنقل.
  • ObservationState توفر أوراكل مقاوم للتلاعب.
المخاطر المتبقية التي يجب على المستخدمين قبولها:
  • سلطة التجميد الخاصة بالـ Mint يمكنها تجميد الـ Pool.
  • سلطة الرسوم الخاصة بالـ Mint يمكنها رفع رسوم النقل (حتى حد maximum_fee) في أي وقت.
  • يمكن ترقية برنامج خطاف النقل إلى كود خبيث.
  • يمكن تغيير معدل استحقاق الفائدة للـ Mint.
الدفاع الصحيح هو الاجتهاد قبل الـ LP: لا تودع في بركات بـ Mints لديها سلطات مركزة لا تثق بها. لا يمكن لـ Raydium أن تقرر الثقة بدلاً عنك؛ يمكنها فقط عرض الحقائق ذات الصلة.

​
مؤشرات

المصادر:
  • SPL Token-2022 extensions docs.
  • منطق التحقق من تهيئة الـ Pool: src/raydium/cpmm/instrument.ts, src/raydium/clmm/instrument.ts.
  • Pyth — أوراكل سعر خارجي مستخدم على واجهة المستخدم.