الإصدارات والترحيل

​

الحالة في لمحة

أهم نقطة من هذا الجدول: AMM v4 ليس موقوفًا، وCPMM هو الافتراضي الجديد — لكنهما يتعايشان بشكل مقصود. تجمعات AMM v4 لها سنوات من سجل التداول ولا يتم ترحيلها بالقوة. اختيار البرنامج لإطلاق تجمع جديد هو توصية، وليس قيد.

​

AMM v4 — الحالة والمسار

AMM v4 هو تصميم تجمع Raydium الأصلي: تسعير المنتج الثابت (x · y = k). تم إطلاقه كـ AMM هجين مع تكامل دفتر طلبات OpenBook (سابقًا Serum) الذي عكس أجزاء من المنحنى كأوامر محدودة في سوق مرتبطة. تم إيقاف تكامل OpenBook منذ ذلك الحين — لا تشارك التجمعات السيولة مع OpenBook وتنفذ جميع المبادلات بشكل نقي ضد المنحنى عبر نقاط الدخول 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 عميق وموثوق التداول وتريد إضافة سيولة إلى العمق الموجود بدلاً من تقسيم السوق.

(التوجيه المتكامل مع OpenBook لم يعد سببًا لاختيار AMM v4 — هذا التكامل معطل.) في كل حالة أخرى، أطلق تجمعات جديدة على CPMM. انظر user-flows/choosing-a-pool-type للحصول على شجرة القرار الكاملة.

​

CPMM — منحنى التبني والترحيل v4 → CPMM

تم نشر CPMM (صانع السوق ذو المنتج الثابت، الاسم الداخلي raydium-cp-swap) في 2024 كإعادة كتابة غرفة نظيفة مقصودة لتكون الافتراضي الجديد لتجمع المنتج الثابت. إنه هيكليًا الأبسط من برامج Raydium: x · y = k نقي، بدون دفتر طلبات، دعم Token-2022 أصلي، بصمة معاملة أصغر.

​

ما يحصل عليه CPMM على AMM v4

• اقتصاديات LP أفضل بشكل افتراضي. يوجه AmmConfig الافتراضي لـ CPMM 100% من رسوم التداول إلى LPs (مع إمكانية تبديل رسوم البروتوكول لكل طبقة). يشفر AMM v4 ~12% للبروتوكول.
• تكلفة إنشاء تجمع أقل. لا حاجة لسوق OpenBook. الإنشاء معاملة واحدة، ~0.15 SOL من الإيجار مقابل ~0.6 SOL لـ v4.
• Token-2022. عملات رسوم التحويل، عملات خطاف التحويل (مع تحفظات)، التحويلات السرية — كل ذلك مدعوم على CPMM، لا شيء على v4.
• سطح دمج أنظف. يحتوي CPMM على صندوق منشور صديق لـ Anchor-CPI (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؛ الشكل عالي المستوى:

1. أنشئ تجمع CPMM جديد للزوج نفسه، على طبقة الرسوم نفسها التي تريد الحفاظ عليها.
2. نسق مع LPs: أعلن عن نافذة يتم خلالها تصريف التجمع القديم وبذر التجمع الجديد.
3. يسحب كل LP من تجمع v4 ويودع في تجمع CPMM الجديد.
4. (اختياري) قم بإعداد مزرعة جانب CPMM لجذب LPs المحفزة إلى التجمع الجديد.
5. راقب هجرة الحجم مع إعادة وزن المجمعات نحو التجمع الأعمق.

السلسلة نفسها لا تفرض أيًا من هذا — تفضل API و واجهة Raydium ببساطة أيهما التجمع الأعمق، والمجمعات توجه من خلال أيهما الأرخص للمستخدم.

​

CLMM — برنامج واحد، مستقر عبر الإصدارات

CLMM في إصدار برنامجه الأول. لم يكن هناك v2 — تم شحن التحسينات كترقيات في المكان لنفس معرف البرنامج (خلف القفل الزمني متعدد التوقيع 24 ساعة)، وليس كجيل جديد. هذا يعني أنه لا توجد قصة ترحيل CLMM: المراكز الموجودة تبقى حيث هي، وقد يتغير سلوك البرنامج بدقة عند شحن ترقية، لكن تخطيطات الحسابات و PDAs مستقرة. ما تغير عبر ترقيات CLMM:

• تعليمة SwapV2 تمت إضافتها لدعم رياضيات رسوم نقل Token-2022 بشكل صحيح. Swap القديم لا يزال قابلاً للاستدعاء؛ يجب أن تستهدف التكاملات الجديدة SwapV2.
• امتدادات تدفق المكافآت — تم زيادة عدد فتحات RewardInfo (الأصلي 3 → لا يزال 3 حاليًا، لكن تم تشديد نمط الحجز). لا حاجة لترحيل البيانات.
• ضغط مصفوفة Tick — تحسين داخلي لتقليل CU على المبادلة التي تعبر العديد من الحدود. غير مرئي خارجيًا.
• إعادة بناء Anchor 1.0 (2026-09-30): الانتقال من Anchor 0.32.1 إلى 1.0.2 وإضافة CollectExcessLamports للمسؤول. لم تتغير أي تعليمة أو تخطيط حساب يواجه المستخدم. انظر إدخال السجل.

يعيش IDL في مستودع raydium-idl المخصص (انظر sdk-api/anchor-idl). إذا كنت تشغل SDK أقدم ضد البرنامج الحالي، فإن أسوأ حالة هي فقدان التعليمات الجديدة.

​

Farm v3 → v5 → v6

من بين جميع برامج Raydium، لدى Farm أكثر سجل إصدارات صريح ومسار ترحيل مفروض الوحيد. الأجيال الثلاثة هي برامج منفصلة بمعرفات برامج منفصلة وتخطيطات حالة منفصلة.

​

الأجيال

​

لماذا توجد ثلاثة أجيال

• v3 → v5: احتاج إلى تدفقات مكافآت متزامنة متعددة (مثل مزارع الحوافز المزدوجة). لم يتمكن تصميم v3 ذو التدفق الواحد من دعمه بدون إعادة تصميم.
• v5 → v6: حد معدل الانبعاث u64 الصحيح في v5 الحد الأدنى القابل للتعبير عنه عند “1 وحدة رمز في الثانية.” بالنسبة لعملة 9 عشرية، هذا 1 lamport/sec — دقيق جدًا لبرامج الانبعاث المنخفض. يصلح معدل Q64.64 الكسري في v6 هذا. v6 أيضًا رفع التحديث القائم على الفتحة إلى الساعة، وأضاف دعم Token-2022.

​

ما يبقى كما هو عبر الأجيال

• نمط المحاسبة “إيداع LP، تراكم عداد لكل حصة، المطالبة عند السحب” متطابق عبر v3/v5/v6. الرياضيات لا تتغير؛ فقط دقة عداد المعدل وعدد التدفقات المدعومة.
• UserStake (v3/v5) و UserLedger (v6) هي مفهوميًا نفس السجل، بتخطيطات مختلفة. SDK يطبع كليهما.

​

مسار الترحيل

لا يوجد ترحيل في المكان بين إصدارات المزرعة. للانتقال من v3/v5 إلى v6:

1. انتظر انتهاء انبعاثات المزرعة الموجودة (أو قم بتشغيلها).
2. يسحب المراهنون والمطالبات المكافآت المعلقة على المزرعة القديمة.
3. ينشئ مشغل المزرعة مزرعة v6 جديدة ضد نفس عملة الرهن.
4. يعيد المراهنون الرهن في المزرعة الجديدة.

الواقع على السلسلة هو حسابا مزرعة غير مرتبطين. المستخدم الذي لديه حصة في كليهما لديه سجلات 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 يختار من مجموعة صغيرة من أشكال المنحنى.

إطلاقات LaunchLab الموجودة لا تتأثر بالترقيات — بمجرد تهيئة الإطلاق، يتم تجميد معاملاته حتى التخرج.

​

توافق الإصدار عبر البرامج

بعض ملاحظات التوافق عبر المنتجات التي يواجهها المدمجون بشكل روتيني:

• CLMM SwapV2 ليست نفس تعليمة 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 — معرفات قانونية لكل إصدار.