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 لمدة خمس سنوات. عدة برامج منها في جيلها الثالث أو الرابع. هذه الصفحة توفر رؤية من منظور المشغِّل: أي إصدار من البرنامج يجب أن أستخدم، وما حالة الإصدارات الأقدم، وكيف أنتقل من A إلى B إذا كنت أعمل على الإصدار الأقدم اليوم؟
الحالة في لمحة سريعة
| البرنامج | الحالي | موقوف | التطبيقات الجديدة | الحالات الموجودة |
|---|---|---|---|---|
| AMM v4 | v4 (جيل واحد) | لا | غير مشجع لكن مقبول | يعمل بشكل كامل |
| CPMM | v1 | — | الافتراضي الموصى به | يعمل بشكل كامل |
| CLMM | v1 | — | موصى به لمزودي السيولة ذوي النطاق المحدود | يعمل بشكل كامل |
| Farm | v6 | v3, v5 | v6 فقط | v3 + v5 قيد الإيقاف التدريجي (قراءة فقط في الأساس) |
| LaunchLab | v1 | — | موصى به للإطلاقات الجديدة | يعمل بشكل كامل |
AMM v4 — الحالة والمسار
AMM v4 هو تصميم حمام Raydium الأصلي: تسعير بالمنتج الثابت (x · y = k). تم إطلاقه كـ AMM هجين مع تكامل سجل OpenBook (المعروف سابقًا باسم Serum) الذي عكس أجزاء من المنحنى كأوامر محدودة في سوق مرتبط. تم إيقاف تكامل OpenBook منذ ذلك الحين — لا تشارك الحمامات السيولة لـ OpenBook بعد الآن وجميع المقايضات تُنفذ بشكل نقي ضد المنحنى عبر نقاط الدخول Swap V2. AMM v4 اليوم هو، في الواقع العملي، AMM بمنتج ثابت نقي مع الحفاظ على حسابات OpenBook كحالة خاملة.
ما تم تجميده
- لا مزيد من رسوم جديدة. هيكل رسوم AMM v4 محدد لكل حمام وتم تحديده عند النشر. تقبل الحمامات الجديدة نفس رسم التداول المرمز بشكل ثابت ~0.25%، ~12% للبروتوكول.
- لا توجد أعمال ميزات جديدة. لم تضيف الفريق تعليمات جديدة إلى AMM v4 منذ أن أصبح CPMM الافتراضي الجديد. البرنامج في وضع الرعاية — إصلاحات الأخطاء فقط، لا توسع النطاق.
- لا دعم Token-2022. تمت كتابة AMM v4 قبل وجود Token-2022 ولم يتم تطبيق التكامل بأثر رجعي. يجب على إصدارات Token-2022 أن تستخدم CPMM (أو CLMM، حيث يكون مناسبًا).
- تكامل OpenBook معطل. كل حمام AMM v4 لا يزال مرتبطًا بحساب سوق OpenBook المقابل على السلسلة، لكن الحمام لا ينشر أو يحافظ على الطلبات على هذا السوق. انقطاع OpenBook لا يؤثر بعد الآن على مقايضات AMM v4.
ما الذي لا يزال يعمل
- الحمامات الموجودة تتداول بشكل طبيعي. لم يتم فرض هجرة حالة؛ حمامات v4 المُنشأة في 2021 لا تزال تمثل الساحة النشطة للعديد من الأزواج ذات الحجم الكبير في 2026.
- يمكن لمزودي السيولة الإيداع والسحب وجمع مكافآت المزرعة كالمعتاد. الهجرة إلى CPMM اختيارية.
- المجمِّعات لا تزال تسير عبره. يفهرس Jupiter و Raydium Trade API كلاهما حمامات v4 كساحات من الدرجة الأولى.
متى تستخدم AMM v4 بعد الآن
بصراحة: نادرًا. الحالات التي يكون فيها v4 هو الإجابة الأفضل ضيقة جدًا:- الزوج له بالفعل حمام v4 عميق وتم تداوله جيدًا وتريد إضافة السيولة إلى العمق الموجود بدلاً من تقسيم السوق.
user-flows/choosing-a-pool-type للحصول على شجرة القرار الكاملة.
CPMM — منحنى التبني والهجرة v4 → CPMM
تم نشر CPMM (صانع السوق بالمنتج الثابت، الاسم الداخليraydium-cp-swap) في 2024 كإعادة كتابة بغرفة نظيفة بهدف أن تكون الافتراضي الجديد لحمام المنتج الثابت. إنه هيكليًا الأبسط من برامج Raydium: x · y = k نقي، لا سجل، دعم Token-2022 أصلي، بصمة معاملة أصغر.
ما الذي يعطيك CPMM على AMM v4
- اقتصاديات LP أفضل افتراضيًا. يسير CPMM الافتراضي AmmConfig بـ 100% من رسوم التداول إلى LPs (مع رسم البروتوكول قابل للتبديل لكل مستوى). يرمز AMM v4 ~12% للبروتوكول.
- تكلفة إنشاء حمام أقل. لا حاجة لسوق OpenBook. الإنشاء معاملة واحدة، ~0.15 SOL من الإيجار مقابل ~0.6 SOL لـ v4.
- Token-2022. إصدارات رسم التحويل، إصدارات خطاف التحويل (مع تحفظات)، التحويلات السرية — كل ذلك مدعوم على CPMM، لا شيء على v4.
- سطح متكامل أنظف. يحتوي CPMM على صندوق Anchor-CPI-friendly منشور (
raydium-cp-swap)، قائمة حسابات أبسط، و IDL مستقر. يشحن AMM v4 IDL لكنه لم يكن لديه صندوق Rust CPI مصيان. - قائمة حسابات أصغر لكل مقايضة. ~10 حسابات مقابل ~17 لـ v4 (التي تحمل حسابات سوق OpenBook حتى عند عدم الوصول إليها).
عندما تكون الهجرة تستحق العناء
بالنسبة لحمام يتم تداوله بنشاط، فإن رفع رسوم LP وحده عادة ما يبرر الهجرة في غضون بضعة أشهر. الحساب: حمام يكسب 0.25% × $X حجم يومي يعطي 0.03% للبروتوكول على v4 (الـ 12% المفقودة). على CPMM يعود ذلك إلى LPs. على مدار سنة، ذلك مركب بشكل معنوي. بالنسبة لحمام منخفض الحجم، الهجرة تتعلق أكثر بـ الاستعداد للمستقبل — افتراضيات أفضل، دعم Token-2022 إذا احتجت إليه، تكاملات أسهل.كيف تعمل الهجرة
لا توجد ترقية موضعية. الهجرة عبارة عن تسلسل إنشاء حمام جديد، تصريف الحمام القديم، إعادة تعبئة الحمام الجديد. التفاصيل الكاملة خطوة بخطوة موجودة فيuser-flows/migrate-amm-v4-to-cpmm؛ الشكل عالي المستوى:
- إنشاء حمام CPMM جديد للزوج نفسه، على نفس مستوى الرسم الذي تريد الحفاظ عليه.
- تنسيق LPs: أعلن عن نافذة يتم خلالها تصريف الحمام القديم وتعبئة الحمام الجديد.
- يسحب كل LP من حمام v4 ويودع في حمام CPMM الجديد.
- (اختياري) قم بإعداد مزرعة من جانب CPMM لجذب LPs المحفزة إلى الحمام الجديد.
- راقب هجرة الحجم مع إعادة ترجيح المجمِّعات نحو الحمام الأعمق.
CLMM — برنامج واحد، مستقر عبر الإصدارات
CLMM في إصدار البرنامج الأول. لم يكن هناك v2 — تم شحن التحسينات كترقيات موضعية لنفس معرّف البرنامج (خلف قفل زمني 24 ساعة متعدد التوقيع)، وليس كجيل جديد. هذا يعني أنه لا توجد قصة هجرة CLMM: الأوضاع الموجودة تبقى في مكانها، وقد يتغير سلوك البرنامج بدقة عند شحن ترقية، لكن تخطيطات الحساب و PDAs مستقرة. ما الذي تغير عبر ترقيات CLMM:- تعليمات
SwapV2مضافة لدعم رياضيات رسم تحويل Token-2022 بشكل صحيح.Swapالقديم لا يزال قابلاً للاستدعاء؛ يجب أن تستهدف التكاملات الجديدةSwapV2. - امتدادات تدفق المكافآت — تم زيادة عدد فتحات
RewardInfo(الـ 3 الأصلية → لا تزال 3 حاليًا، لكن نمط الحجز تم تشديده). لا توجد هجرة بيانات مطلوبة. - ضغط مصفوفة القراد — تحسين داخلي لتقليل CU على المقايضة التي تعبر العديد من القراد. غير مرئي خارجيًا.
raydium-idl المخصص (انظر sdk-api/anchor-idl). إذا كنت تشغل SDK أقدم مقابل البرنامج الحالي، فإن أسوأ حالة هي فقدان التعليمات الجديدة.
Farm v3 → v5 → v6
من بين جميع برامج Raydium، يحتوي Farm على أكثر سجل الإصدارات صراحة ومسار الهجرة الوحيد المفروض. الأجيال الثلاثة عبارة عن برامج منفصلة بمعرّفات برامج منفصلة وتخطيطات حالة منفصلة.الأجيال
| الإصدار | تم الإصدار | الحالة | الميزات الرئيسية |
|---|---|---|---|
| v3 | 2021 | الإيقاف التدريجي. المزارع الموجودة تعمل؛ لا توجد مزارع جديدة مقبولة. | تدفق مكافآت واحد. انبعاث بناءً على الفتحة. |
| v5 | أكتوبر 2022 | الإيقاف التدريجي. المزارع الموجودة تعمل؛ لا توجد مزارع جديدة مقبولة. | تدفقات مكافآت تصل إلى 2. انبعاث بناءً على الفتحة. عدد صحيح per_second. |
| v6 | 2024 | الحالية. جميع المزارع الجديدة. | تدفقات مكافآت تصل إلى 5. انبعاث الساعة الجدارية. per_second ذو علامة عائمة Q64.64. دعم Token-2022 للرهن والمكافآت. |
لماذا توجد ثلاثة أجيال
- v3 → v5: احتاجت إلى تدفقات مكافآت متزامنة متعددة (مثل المزارع الثنائية المحفزة). لم يستطع تصميم v3 أحادي التدفق دعمه دون إعادة تصميم.
- v5 → v6: معدل الانبعاث الصحيح
u64في v5 يحد من الحد الأدنى القابل للتعبير عنه من “وحدة رمز واحدة في الثانية.” بالنسبة لنقش 9 عشري، هذا 1 lamport/sec — دقة أقل بكثير من البرامج منخفضة الانبعاث. معدل Q64.64 الجزئي في v6 يصلح هذا. تحسن v6 أيضًا من تحديث قائم على الفتحة إلى ساعة جدارية، وأضاف دعم Token-2022.
ما يبقى كما هو عبر الأجيال
- نمط محاسبة “إيداع LP، تجميع عداد لكل حصة، المطالبة عند السحب” متطابق عبر v3/v5/v6. الرياضيات لا تتغير؛ فقط دقة عداد المعدل وعدد التدفقات المدعومة.
UserStake(v3/v5) وUserLedger(v6) هي سجلات مفاهيمية متطابقة، بتخطيطات مختلفة. SDK يوحد الاثنين.
مسار الهجرة
لا توجد هجرة موضعية بين إصدارات المزرعة. للانتقال من v3/v5 إلى v6:- انتظر انتهاء انبعاثات المزرعة الموجودة (أو قم بتشغيلها).
- المراهنون يسحبون ويطالبون بالمكافآت المعلقة على المزرعة القديمة.
- مشغل المزرعة ينشئ مزرعة v6 جديدة ضد نفس نقش الرهن.
- المراهنون يعودون إلى الرهن في المزرعة الجديدة.
UserLedger (v6) / UserStake (v5).
ماذا تعني “الإيقاف التدريجي” لـ v3 و v5
- برامج v3 و v5 لا تزال مُنشرة وقابلة للاستدعاء. يمكن للمزارع الموجودة بعد الآن توزيع المكافآت المعلقة وقبول الانسحابات.
- واجهة Raydium لا تزال تعرض مزارع v3 و v5 مع المكافآت النشطة؛ بمجرد انتهاء
end_timeلمزرعة v3/v5، تختبئ الواجهة من “نشطة” لكن تبقيها قابلة للمطالبة. - الفريق لن ينشئ مزارع v3/v5 جديدة. مساعدات SDK لـ “إنشاء مزرعة” توجه إلى v6 فقط.
- v3 و v5 هما يتلقيان ترقيات الأمان لكن ليس العمل على الميزات. إذا تم العثور على خطأ حرج، يتم إصلاحه؛ إذا كانت ميزة يمكن أن تكون مفيدة، يتم إضافتها إلى v6 بدلاً من ذلك.
products/farm-staking/accounts و products/farm-staking/instructions.
LaunchLab — برنامج واحد، تكوين متطور
LaunchLab في إصدار البرنامج الأول. مثل CLMM، تم شحن التحسينات كترقيات موضعية خلف قفل زمني 24 ساعة — وليس كأجيال جديدة. ما الذي تطور عبر الترقيات:- فتحة رسم الإنشاء. مضافة بحيث يمكن للإطلاقات توجيه جزء من رسوم CPMM ما بعد التخرج إلى المُنشئ الأصلي. انظر
products/launchlab/creator-fees. - قابلية تكوين صيغة المنحنى. في الأصل مرمز تربيعي؛ الآن
LaunchConfigيختار من مجموعة صغيرة من أشكال المنحنى.
توافق إصدار البرنامج المتقاطع
بعض ملاحظات التوافق بين المنتجات التي يواجهها المدمجون بانتظام:SwapV2CLMM ليس نفس تعليماتSwap. إذا كان عميلك يتحدثSwapفقط، فسيساء فهم رسوم تحويل Token-2022 بصمت — الرياضيات خاطئة بمقدار الرسم. قم بالتحديث إلىSwapV2.- Farm v6 الرهن مع أوضاع CLMM غير مدعوم الطريقة التي يعمل بها رهن رمز LP. أوضاع CLMM عبارة عن NFTs، وليست رموز LP قابلة للاستبدال. يحتوي CLMM على آلية مكافأة أصلية خاصة بدلاً من ذلك — انظر
products/clmm/fees. - حمامات CPMM المدعومة برموز Token-2022 تعمل في المزارع فقط على Farm v6. v3 و v5 ترفض رموز رهن Token-2022.
- حمامات AMM v4 لا تملك أبدًا رموز LP بـ Token-2022. إذا رأيت واحدة، فهي مزيفة — AMM v4 لا يدعم هذا الجمع.
أين تقرأ أكثر
introduction/history-and-milestones— الخط الزمني الكرونولوجي للإصدار وسبب وصول كل إصدار عندما وصل.user-flows/migrate-amm-v4-to-cpmm— دفتر تشغيل المشغل لحركة v4 → CPMM.user-flows/choosing-a-pool-type— شجرة القرار لتطبيقات حمام جديدة.products/farm-staking/accounts— مخطط جنبًا إلى جنب لـ v3 / v5 / v6.reference/changelog— ما الذي تغير في هذه التوثيق مع تطور إصدارات البرنامج.
- صفحات فصل المنتج المذكورة بشكل مضمن أعلاه.
- Raydium SDK v2 — منطق الإرسال الذي يعي الإصدار يؤكد أي برنامج ينتمي إليه حمام معين.
reference/program-addresses— معرّفات موثوقة لكل إصدار.