هذه الصفحة مُترجَمة آليًا بواسطة الذكاء الاصطناعي. النسخة الإنجليزية هي المرجع المعتمد.عرض النسخة الإنجليزية →
هذا هو سجل التغييرات الخاص بالتوثيق — وهو سجل التحديثات على هذه الصفحات منذ إطلاق المشروع. يرتبط كل إصدار أدناه بإدخاله الخاص؛ افتح أحدها للحصول على الملخص الكامل والفصول المتأثرة وتاريخ التحقق. للحصول على الخط الزمني التاريخي للبروتوكول نفسه، انظر
introduction/history-and-milestones.الإصدارات
CLMM: CreateCustomizablePoolV2 يفتح إنشاء مجموعات متعددة للجميع
تمت إعادة تسمية
CreatePermissionedPool إلى CreateCustomizablePoolV2 وفقدت بوابة Permission PDA الخاصة بها، لذا يمكن لأي دافع إنشاء مجموعات إضافية لنفس الزوج ومستوى الرسوم في عنوان مشتق من seed_index. الحجج واشتقاق عنوان المجموعة لم تتغير، لكن المميز يتغير وحساب permission يترك الفتحة 3، لذا يجب إعادة بناء العملاء المبنيين مقابل التعليمات القديمة. pool_creator غير مصرح، لذا فإن owner للمجموعة V2 ليس إثباتًا لمن أنشأها. تم حذف حساب Permission وCreatePermissionPda وClosePermissionPda ومفتاح permission_pda_admin؛ حسابات Permission PDAs التي تم إنشاؤها مسبقًا تبقى على السلسلة كبيانات خاملة. لم يتغير تخطيط الحساب أو رمز الخطأ. ينخفض IDL إلى 37 تعليمة.اقرأ الإدخال الكامل →CLMM: Anchor 1.0، استرجاع lamports الزائدة، وأصحاب الرسوم الثابتة
ينتقل CLMM إلى Anchor
1.0.2 على Agave 3.1.10، نفس الانتقال الذي قام به CPMM و LaunchLab في 2026-09-09. كلا صناديق CPI العامة تثبت الآن =1.0.2، لذا يمكن لبرنامج واحد أن يقوم بـ CPI إلى CPMM و CLMM. تعليمة إدارية جديدة CollectExcessLamports تعيد الإيجار المحرر بواسطة SIMD-0437. تمسح مجموعة واحدة لكل استدعاء: PDA PoolState توقع على أقبيتها الخاصة وأقبية المكافآت، تذهب أقبية wSOL عبر جولة SyncNative / UnwrapLamports، وأي حساب مملوك لـ CLMM في remaining_accounts يتم خصمه إلى الحد الأدنى للإيجار. CreateAmmConfig الآن يكتب مفاتيح protocol_fee_owner وfund_fee_owner المشفرة بدلاً من الموقّع. على mainnet هذه هي المفاتيح المخزنة بالفعل على جميع 21 إعدادًا، والإعدادات الموجودة لا تتم إعادة كتابتها. تم إلحاق 6052. لم تتغير أي تعليمة أو تخطيط حساب يواجه المستخدم.اقرأ الإدخال الكامل →CPMM: البروتوكول يأخذ حصة من رسوم المنشئ
يمكن لـ CPMM الآن الاحتفاظ بجزء من رسوم المنشئ. يتم تطبيق التقسيم عند جمع الرسوم، وليس عند فرضها: المبادلة لا تزال تجمع رسوم المنشئ بالكامل إلى
creator_fees_token*، وCollectCreatorFee / CollectCreatorFeePermissionless ثم تنقل حصة إلى عدادات protocol_fees_token* الموجودة في المجموعة وتدفع للمنشئ الباقي — مع التقريب لأسفل، لذا يبقى الغبار مع المنشئ. يأتي المعدل من AmmConfig.creator_fee_share_rate جديد (محفور من الحشو؛ الحساب لا يزال 236 بايت، لكن padding[0] القديم هو الآن حقل نشط) أو من PDA CreatorFeeShare لكل منشئ يتجاوزه، يُدار بواسطة إدارة جديدة CreateCreatorFeeShare / CloseCreatorFeeShare. كسر للعملاء الذين يجمعون الرسوم: كلا تعليمات الجمع تأخذ حسابات جديدة مُلحقة في نهاية قوائمهما — الحسابات الموجودة تحتفظ بمواضعها، لكن الحسابات الجديدة إلزامية، لذا يتم رفض المعاملة السابقة للترقية لحسابات مفقودة. UpdateAmmConfig يكتسب param = 8. PoolState، رياضيات المبادلة وفحص k لم تتغير، ولم يتم إضافة رمز خطأ. يركب معها: إصلاح ترتيب ثنائي المسار في CollectExcessLamports.اقرأ الإدخال الكامل →LaunchLab: Anchor 1.0، استرجاع lamports الزائدة، ونهاية بوابات الانتقال
ينتقل LaunchLab إلى Anchor
1.0.2 على Agave 3.1.10 ويتقاعد من سقالات الانتقال الخاصة به. Initialize المستهجن الآن يفشل بشكل غير مشروط مع NotApproved. MigrateToAmm كسر صعب لمحفظة الهجرة: تم حذف جميع الحجج الثلاثة وتسعة حسابات OpenBook، بعد إزالة OpenBook الخاصة بـ AMM v4، والبرنامج لم يعد يهيئ السوق بواسطة CPI. تم حذف بوابة ساعة get_upgrade_timestamp، لذا يتم طلب remaining_accounts الثلاثة للتداول بشكل غير مشروط (مع التحقق من فتحة system_program الآن)، MigrateToCpswap يأخذ دائمًا مسار CPMM المرخص، وInitializeWithToken2022 يسقط قيد amm_fee_on الخاص به. إدارة جديدة CollectExcessLamports تعيد الإيجار المحرر بواسطة SIMD-0437 — لاحظ أن حسابات المصدر يجب أن تكون مجمعة حسب أي من ثلاثة PDAs لسلطة القبو يمتلكها. تم نقل ثلاثة قيود عنوان MigrateToCpswap إلى جسم التعليمة، مما يغير 2012 إلى 2502. تم إلحاق 6031. لم يتغير تخطيط الحساب أو تعليمة التداول أو سلوك الرسوم.اقرأ الإدخال الكامل →CPMM: Anchor 1.0، استرجاع lamports الزائدة، وأصحاب الرسوم الثابتة
ينتقل CPMM إلى Anchor
1.0.2 على Agave 3.1.10 ويضيف إدارة CollectExcessLamports التي تعيد الإيجار المحرر بواسطة SIMD-0437 من الأقبية وسك LP و PDAs — أقبية SOL المغلفة مشمولة، عبر جولة SyncNative / UnwrapLamports التي تترك الرصيد المغلف دون تغيير. ثلاث تغييرات سلوكية تركب معها: CreateAmmConfig الآن يكتب مفاتيح protocol_fee_owner وfund_fee_owner المشفرة بدلاً من الموقّع (الإعدادات الموجودة لا تتم ترحيلها — اقرأ الحقول)، يتم حذف قائمة MINT_WHITELIST Token-2022 الأربعة المشفرة بحيث تكون PDA سجل SupportMintAssociated هي الالتفافة الوحيدة المتبقية، وClosePermissionPda الآن يقبل سلطة المنحة المخصصة. تم إلحاق 6015. لم تتغير أي تعليمة أو تخطيط حساب يواجه المستخدم.اقرأ الإدخال الكامل →AMM v4: تبعيات Solana 3.0 واسترجاع lamports الزائدة
يعيد بناء AMM v4 مقابل
solana-program 3.0.0، spl-token 9.0.0، spl-associated-token-account 8.0.0 وصندوق solana-system-interface الجديد، ويضيف WithdrawExcessLamports (علامة 18) للمسؤولين فقط يعيد الإيجار المحرر بواسطة SIMD-0437. كل تعليمة موجهة للمتداول و LP تحتفظ بحساباتها وحججها ورياضياتها، ولا شيء في الإصدار كسر: توقف CreateConfigAccount عن قراءة sysvar الإيجار الزائد الخاص به لكنه لا يزال يقبل قائمة الحسابات الخمسة القديمة. يكتسب AmmError الرمز 60 (يرقم من 0، وليس 6000).اقرأ الإدخال الكامل →LaunchLab: قواعد منحنى المنصة تحل محل قائمة معاملات منحنى
تنتقل قيود معاملات الإطلاق من
PlatformConfig إلى حسابات PlatformCurveRule لكل إعداد. تحتفظ القاعدة بما يصل إلى 10 مجموعات فحص تضم ما يصل إلى 25 قيد (field, op, value) على 19 معامل إطلاق، مع Eq / Gte / Lte / Neq — لذا يمكن للمنصة أخيرًا التعبير عن نطاق قيمة، طبقات بديلة، حد تقييم التخرج، أرضية الهجرة، بوابة نوع الرمز، أو مجموعة تتبدل في تاريخ، لا شيء مما كانت قائمة المساواة فقط تستطيع. يحتفظ PlatformConfig بحجمه 944 بايت: restrict_curve_param، curve_rule_manager، وبادئة طول vec المحذوفة تخرج جميعها من الحشو. يجب على فك التشفير إسقاط Vec<PlatformCurveParam> الزائد، وعلى منشئي الإطلاق إلحاق PDA القاعدة بـ remaining_accounts بينما العلم قيد التشغيل. تم حذف تعليمتين، وإضافة أربع، وإضافة متغيرين UpdatePlatformConfig، تم إلحاق 6024–6030. يتطلب تحديث IDL. يشحن SDK فحصين نقيين خارج السلسلة حتى لا يضطر المنشئ أبدًا إلى تعلم قاعدة من معاملة مرفوضة، والإدخال يوثق بروفة devnet قبل تفعيل العلم على mainnet.اقرأ الإدخال الكامل →LaunchLab: المنصة تحتفظ بسلطة السحب المحتفظ بها من إنشاء السك
InitializeWithToken2022 الآن يكتب PlatformConfig.transfer_fee_extension_auth إلى withdraw_withheld_authority للسك الأساسي الجديد بدلاً من PDA authority الإطلاق، لذا يمكن للمنصة كنس رسوم التحويل المحتفظ بها أثناء مرحلة منحنى الربط بدلاً من الانتظار للتخرج — البرنامج نفسه لا يحتوي على تعليمة سحب محتفظ بها. MigrateToCpswap تعيد تعيين تلك السلطة فقط عندما تحتفظ بها PDA، مما يحافظ على عمل التخرج للسك من كلا الأجيال. transfer_fee_config_authority لا تزال تتحرك عند التخرج فقط، لذا فإن تدوير transfer_fee_extension_auth في منتصف الإطلاق يترك بصمت السلطتين على مفاتيح مختلفة. لم يتغير تخطيط الحساب أو التعليمة أو الحجة أو رمز الخطأ.اقرأ الإدخال الكامل →LaunchLab: حد معدل رسوم المنصة مرفوع إلى 500 bps
يتحرك سقف
fee_rate للمنصة إلى 50000 (500 bps) على كلا المسارين اللذين يتحققان منه. تم تحديد CreatePlatformConfig بـ 10000 (100 bps) منذ الإصدار الأول للبرنامج؛ تم تحديد UpdatePlatformConfig بـ 25000 (250 bps) منذ 2026-01-27. يتفق المساران الآن، لذا يمكن تحديث منصة تم إنشاؤها بأي معدل مسموح به بنفس المعدل — بما في ذلك عبر متغير AllInfo الكمي، الذي يعيد التحقق من fee_rate أثناء إعادة كتابة كل حقل آخر. يرفع المساران لا يزالان أخطاء مختلفة (InvalidInput عند الإنشاء، InvalidPlatformInfo عند التحديث). لم يتغير تخطيط الحساب أو التعليمة أو رمز الخطأ، ولا تعيد أي منصة أو إطلاق موجود السعر. يبقى GlobalConfig.max_share_fee_rate عند 100 bps ويحد فقط من share_fee_rate الإحالة لكل معاملة.اقرأ الإدخال الكامل →LaunchLab: سك اقتباسات Token-2022
يمكن الآن الاقتباس من إطلاق في سك Token-2022.
CreateConfig، InitializeV2، InitializeWithToken2022، التعليمات الأربع للمبادلة، وكل مطالبة رسوم تقبل برنامج رمز إما في فتحة برنامج الاقتباس؛ Initialize المستهجن يبقى وحده الإرث. يتم الآن مقارنة حدود انزلاق المبادلة مقابل ما يدفعه أو يستقبله الدافع فعليًا، بعد خصم رسوم التحويل لسك الاقتباس. يصبح بت PoolState.token_program_flag bit1 ذا معنى، لذا فك التشفير الذي يختبر البايت بالكامل مقابل 0 يسيء قراءة سك الأساس الموروث كـ Token-2022. MigrateToCpswap يعيد تسمية حسابات برنامج الرمز الخاصة به إلى token_program / token_program_2022، و6023 يتم إعادة استخدامه لـ CalculateOverflow.اقرأ الإدخال الكامل →LaunchLab: إطلاقات CPMM فقط وعناصر تحكم إعدادات المنصة
يتطلب الآن تهيئة الإطلاق الجديدة CPMM بينما تبقى الحالة المرتبطة بـ AMM v4 الموروثة قابلة للهجرة. قبل هذا الإصدار، أنتج
creator_scale مفتاح رسوم مملوك للمنشئ؛ تعمل هجرات CPMM المنفذة بعد الترقية بدلاً من ذلك على دمج platform_scale + creator_scale في حصة مفتاح رسوم واحدة مملوكة للمنصة. يمكن للمنصات أيضًا تقييد الإطلاقات بـ PDAs PlatformAllowConfig الخاصة بها، وعلى منشئي الهجرة إلحاق كلا PDAs دعم CPMM.اقرأ الإدخال الكامل →CLMM: تجميد NFT موضع المُصدر المقيد
تستخدم سك NFT موضع CLMM الجديدة مجموعتها كسلطة تجميد، لكن حسابات الرمز الخاصة بها تبقى غير مجمدة بشكل افتراضي. يحدث التجميد فقط على
OpenPositionV2 أو OpenPositionWithToken22Nft عندما تطابق سلطة التجميد لأي من سك القبو الأساسي قائمة المُصدر المقيد. لا يمكن لموضع مطابق نقل أو تغيير المالك لكن يمكنه لا يزال إدارة السيولة. يجب أن يلحق استدعاء ClosePosition الخاص به المجموعة حتى يتمكن CLMM من إذابة وحرق وإغلاق بشكل ذري. تبقى المواضع الموجودة دون تغيير.اقرأ الإدخال الكامل →CPMM: جمع رسوم المنشئ بدون إذن
تعليمة
CollectCreatorFeePermissionless الإضافية تسمح لأي دافع بكنس جميع رسوم المنشئ المتراكمة، مع تقييد المستفيد وكلا وجهات الرمز إلى PoolState.pool_creator و ATAs الكنسي للمنشئ. يبقى المسار الموقّع من قبل المنشئ الأصلي دون تغيير. CreatePermissionPda أيضًا يقبل سلطة منحة مخصصة، بينما ClosePermissionPda يبقى للمسؤولين فقط.اقرأ الإدخال الكامل →CLMM: مجموعات متعددة مرخصة وحماية حساب مجمد لأوامر الحد
تحديثا برنامج CLMM إضافيان وعكسيان متوافقان.
CreatePermissionedPool يطوي seed_index غير صفري يوفره العميل في بذور PDA للمجموعة، مما يسمح لمشغل مدرج في القائمة البيضاء (واحد يحتفظ بـ PDA Permission) بإنشاء مجموعات متعددة لكل (config, mint0, mint1) — لذا فإن معرف المجموعة لم يعد قانونيًا لزوج. تعليمات إدارية جديدة CreatePermissionPda / ClosePermissionPda تدير تلك المنح، وPoolState يكتسب حقل seed_index (محفور من الحشو، لا تغيير الحجم). بشكل منفصل، OpenLimitOrder الآن يأخذ حسابات جانب الإخراج ويرفض الأوامر التي يكون حساب الرمز الخاص بها على جانب الإدخال أو الإخراج مجمدًا (NotApproved).اقرأ الإدخال الكامل →AMM v4: إزالة تبعية OpenBook / Serum
يزيل AMM v4 تبعيته الخاملة منذ فترة طويلة OpenBook/Serum، وجميع CPIs لدفتر الطلبات، والتعليمات الميتة لصنع السوق.
SwapBaseIn / SwapBaseOut، Deposit، وWithdraw تحتفظ بتخطيطاتها (حسابات السوق المحذوفة يتم تجاهلها الآن، لا يتم التحقق منها)؛ WithdrawPnl كسر صعب (17 → 10، لا توافق)، وSetParams (حسابات مخفضة + param معاد ترقيمه)؛ وInitialize، PreInitialize، MonitorStep، MigrateToOpenBook، WithdrawSrm، SimulateInfo، AdminCancelOrders لم تعد قابلة للاستدعاء. تخطيطات الحساب على السلسلة ورموز الخطأ تبقى مستقرة؛ ترحيل المبادلات إلى نقاط الدخول V2.اقرأ الإدخال الكامل →Stable AMM: إزالة رمز OpenBook الميت (السوق)
يزيل Stable AMM حسابات صنع السوق OpenBook الخاملة منذ فترة طويلة والرمز. تخطيطات أصغر
SwapBaseIn / SwapBaseOut (18 → 9)، Deposit (14 → 12)، وWithdraw (21/22 → 12) (التخطيطات القديمة لا تزال متوافقة)؛ تغيير WithdrawPnl كسر صعب (16 → 10، لا توافق)؛ رسوم الإحالة المتقاعدة؛ وصيغة أصل مجموعة مبسطة تقتصر على القبو. معظم تعليمات Stable الأخرى لم تعد قابلة للاستدعاء.اقرأ الإدخال الكامل →CLMM: أوامر الحد، رسوم أحادية الجانب، رسوم ديناميكية
ثلاث قدرات CLMM اختيارية وعكسية متوافقة: أوامر حد من الدرجة الأولى (مع حارس تسوية
limit_order_admin)، جمع رسوم أحادي الجانب (CollectFeeOn)، ورسوم ديناميكية تتبع التقلب. يضيف CreateCustomizablePool، إعادة تشكيل PoolState (تغيير كسر الفهرس)، حقول TickState جديدة، أحد عشر رمز خطأ جديد (مع تحول رقمي)، وإضافات SDK / API مطابقة.اقرأ الإدخال الكامل →النشر الأولي
الإصدار العام الأول من مجموعة توثيق Raydium، تم التحقق منه مقابل نشرات mainnet-beta المباشرة و
@raydium-io/raydium-sdk-v2@0.2.42-alpha.اقرأ الإدخال الكامل →اتفاقيات التوثيق
- إدارة الإصدارات: يستخدم هذا التوثيق إدارة إصدارات قائمة على التقويم (YYYY-MM-DD). كل تحديث يضيف صفحة إدخال جديدة وصفًا جديدًا في أعلى الخط الزمني أعلاه.
- صفحة واحدة لكل إصدار: كل ملخص إصدار يعيش على صفحته الخاصة تحت
reference/changelog/، لذا يبقى هذا الفهرس قصيرًا وكل إدخال قابل للربط بشكل مستقل. - التاريخ المُتحقق منه: كل إدخال يسجل متى تم التحقق من المحتوى آخر مرة مقابل حالة السلسلة / API ومصدر البرنامج. إذا لم يُذكر، افترض التاريخ الرئيسي للإدخال.
- التغييرات الجذرية: يتم تمييزها في تحذير مربع على الصفحات المتأثرة وتُوسم في الإدخال.
- التغطية: يغطي هذا السجل مجموعة التوثيق نفسها. الخط الزمني التاريخي للبروتوكول نفسه يعيش في
introduction/history-and-milestonesوهو مصدر الحقيقة لـ “متى حدث X على Raydium”.
التصحيحات
إذا وجدت خطأ في هذا التوثيق، يرجى فتح مشكلة أو طلب دمج في مستودع التوثيق. يتم تسجيل التصحيحات كإدخالات في السجل.المؤشرات
introduction/history-and-milestones— الخط الزمني للبروتوكول نفسه.security/audits— سجل التدقيق.ray/protocol-fees— توزيعات رسوم البروتوكول.reference/program-addresses— مصدر الحقيقة لمعرفات البرنامج.

