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

​
الأوراكل في Raydium

​
داخلي: المجمع هو الأوراكل

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

​
ObservationState في CLMM كأوراكل TWAP

تحتفظ مجمعات CLMM بحساب ObservationState يسجل لقطات sqrt_price تاريخية. يمكن لبرامج أخرى أن تتكون مع هذا لاشتقاق متوسط سعر مرجح زمني مقاوم للمعالجة:
هذا هو نفس النمط الذي يستخدمه Uniswap V3. معالجة سعر قصيرة الأجل (حوت يدفع المجمع مؤقتًا) لا تفسد TWAP لأنه يتم حسابه بمتوسط على مئات الفتحات. يجب على البرامج التي تحتاج إلى مصدر سعر أكثر أمانًا لرموز CLMM (أوراكل التصفية، تسعير الخيارات، إلخ) أن تستخدم TWAP من ObservationState بدلاً من الأسعار الفورية. لا تستخدم أسعار CLMM الفورية للقابلية للتكوين. يمكن لمبادلة واحدة كبيرة أن تدفع السعر الفوري بنسبة 10% أو أكثر على مجمع ضحل؛ يخفف TWAP من هذا. انظر products/clmm/accounts#observation-state لتخطيط البيانات.

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

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

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

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

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

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

​
رسوم النقل

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

​
خطاف النقل

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

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

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

​
NFTs موضع المُصدر المقيد في CLMM

يطبق CLMM تحكمًا إضافيًا لسلطات التجميد للمُصدرين المقيدين بـ KYC المختارة. عندما تطابق سلطة التجميد لأي من رموز المجمع القائمة المدرجة في البرنامج، فإن المواضع الجديدة المفتوحة من خلال OpenPositionV2 أو OpenPositionWithToken22Nft لديها حساب رمز NFT الخاص بها مجمدًا على الفور. PDA المجمع المقابل هو سلطة التجميد لرمز NFT الموضع. يمنع هذا نقل الموضع إلى محفظة غير موافق عليها أو من تغيير مالك حساب الرمز الخاص به. إنه لا يعطي مُصدر الرمز الأساسي التحكم في NFT الموضع: فقط CLMM pool PDA هو سلطة التجميد لرمز NFT الموضع، والبرنامج يستخدمه لإذابة فقط كجزء من ClosePosition قبل الحرق. تتطلب إدارة السيولة وجمع الرسوم أو المكافآت مالك NFT. تبقى المواضع الموجودة مذابة. يجب على المدمجين التعامل مع القابلية للنقل كحالة خاصة بالموضع وقراءة علم isFrozen لحساب رمز NFT.

​
المفوض الدائم

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

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

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

​
المجمد افتراضيًا / سلطة الإغلاق / تحمل الفائدة

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

​
سلطة الرمز

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

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

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

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

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

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

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

​
مؤشرات

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