Skip to main content
هذه الصفحة مُترجَمة آليًا بواسطة الذكاء الاصطناعي. النسخة الإنجليزية هي المرجع المعتمد.عرض النسخة الإنجليزية →
مصدر الحقيقة. هذه الصفحة هي الوحيدة في التوثيق التي تسرد عناوين البرامج حرفيًا. تربط الصفحات الأخرى هنا. إذا تغيّر معرّف ما، حدّثه هنا فقط وستبقى كل المراجع في الموقع متسقة.تحقق دائمًا من القيم مقابل واجهة برمجية حية (https://api-v3.raydium.io/main/info) قبل توقيع معاملات حقيقية.

Mainnet-beta

قاعدة عملية: إذا كان معرّف برنامج في البرية لا يطابق الجدول أدناه، لا توقّع المعاملة. معرّف برنامج غير متطابق هو أسهل طريقة لخسارة الأموال على Solana.

البرامج على السلسلة

ملاحظات:
  • يتم الاحتفاظ بـ AMM v4 و Farm v3/v5 للمجموعات والمراكز الموجودة. يوجّه واجهة Raydium والـ SDK إنشاء المجموعات الجديدة والمزارع الإيكوسيستمية الجديدة إلى CPMM و CLMM و Farm v6 على التوالي — انظر protocol-overview/versions-and-migration.
  • معرّف Farm v3 أعلاه يعمل أيضًا كبرنامج staking أحادي الأصل $RAY. السلوك متطابق مع Farm v3 لـ LP staking.
  • Stable AMM هو برنامج منفصل يمكن لبرنامج AMM Routing استهدافه جنبًا إلى جنب مع AMM v4 و CPMM و CLMM. السيولة رقيقة مقارنة بالبرامج الثلاثة الأخرى والـ SDK لا يعرّض واجهة برمجية من الدرجة الأولى لها؛ المدمجون الذين يوجّهون من خلالها عادة ما يفعلون ذلك عبر الموجّه.
  • توفر الكود المصدري. من بين البرامج على السلسلة أعلاه، فقط raydium-amm (AMM v4) و raydium-cp-swap (CPMM) و raydium-clmm (CLMM) تأتي مع مستودعات مصدر عامة تحت github.com/raydium-io. Stable AMM و LaunchLab و AMM Routing و Burn & Earn / LP Lock وبرامج Farm غير متاحة للعموم — تحقق منها مقابل واجهة برمجية حية و bytecode على السلسلة و IDLs المنشورة في raydium-io/raydium-idl بدلاً من ذلك.

سلطة المسؤول المشتركة

كل برنامج Raydium — بما في ذلك AMM v4 — يشارك مفتاح عام واحد مشفّر للمسؤول لتحكم الوصول على مستوى التعليمات إلى مسارات المسؤول. إنه config_feature::amm_owner::ID في AMM v4 (يحد من SetParams و CreateConfigAccount و UpdateConfigAccount ويُستخدم كـ pnl_owner الافتراضي) و admin::ID في برامج Anchor — CLMM و CPMM و LaunchLab و Lock — يحد من مسارات مثل CreateAmmConfig أو UpdatePoolStatus: السلطات التشغيلية على مستوى الحساب (مثل protocol_owner و fund_owner على CPMM/CLMM AmmConfig أو محافظ الهجرة على LaunchLab GlobalConfig) يتم تخزينها على السلسلة وقد تختلف عن مسؤول البرنامج. اقرأها مباشرة من حساب الإعدادات ذي الصلة قبل إرسال معاملات عالية المخاطر.

سلطة منشئ PDA الإذن CPMM

CreatePermissionPda يقبل إما مسؤول البرنامج المشترك أعلاه أو مالك مخصص. منذ ترقية CPMM 2026-09، ClosePermissionPda يقبل نفس الموقّعين؛ قبل ذلك كان مقتصرًا على المسؤول.

سلطات سجل دعم Mint

CreateSupportMintAssociated و CloseSupportMintAssociated يقبلان إما مسؤول البرنامج المشترك أو مالك مخصص للبرنامج أدناه. تسجيل mint يسمح به بعد قائمة السماح بامتداد Token-2022 لهذا البرنامج — انظر reference/token-2022-support. يحتفظ CPMM و CLMM بكل منهما بـ PDA سجل خاص بهما وسلطة خاصة بهما؛ لا يعمل أي من المفاتيح على البرنامج الآخر.

محافظ مالك الرسوم CPMM

منذ ترقية CPMM 2026-09، CreateAmmConfig يكتب هذه المفاتيح الثابتة في protocol_owner و fund_owner للإعدادات الجديدة بدلاً من نسخ مفتاح الموقّع المسؤول. CollectProtocolFee و CollectFundFee يقبلان المفتاح المخزّن على الإعدادات أو مسؤول البرنامج المشترك (|| crate::admin::ID)، لذا يبقى المسؤول موقّعًا مقبولاً — ما تغيّر فقط هو حيث تذهب العائدات افتراضيًا.
هذه هي القيم التي يكتبها البرنامج في الإعدادات الجديدة، وليست وصفًا للإعدادات الموجودة. حسابات AmmConfig التي تم إنشاؤها قبل الترقية تحتفظ بأي شيء مخزّن عليها. اقرأ دائمًا protocol_owner / fund_owner من الحساب قبل بناء معاملة جمع.

محافظ جمع رسوم البروتوكول

حيث يتراكم حصة البروتوكول من رسوم التداول لكل برنامج. هذه محافظ عادية تحمل الرموز، لذا عنوان واحد يحمل مجموعة مختلطة من SPL mints (wSOL و USDC من مجموعات SOL/USDC، wSOL و RAY من مجموعات SOL/RAY، وهكذا). حصة Stable AMM من البروتوكول تتراكم في الخزينة كـ out_put.need_take_pnl_* ويتم مسحها بواسطة WithdrawPnl بدلاً من الجلوس في محفظة دائمة. بالنسبة لـ CPMM، اقرأ protocol_owner من AmmConfig المحدد قبل بناء معاملة جمع — الإعدادات التي تم إنشاؤها قبل ترقية 2026-09 قد تحمل مفتاحًا مختلفًا.

محافظ جمع lamports الزائدة

كل من البرامج الثلاثة التي تمت ترقيتها في 2026-09-09 حصلت على تعليمة مسؤول تعيد lamports المحتفظ بها فوق الحد الأدنى المعفي من الإيجار على الحسابات المتحكم فيها من قبل البرنامج، بعد SIMD-0437 rent reduction. كل برنامج يشفّر محفظة وجهة خاصة به، وكل واحدة مفتاح مخصص — وليس مسؤول البرنامج المشترك. CPMM و LaunchLab يقبلان أيضًا مسؤول البرنامج المشترك كموقّع. AMM v4 يقبل فقط المحفظة أعلاه — لا يوجد لديه بديل مسؤول. AMM v4 أيضًا يجمّع مفتاح testnet منفصل (75KWb5XcqPTgacQyNw9P5QU2HL3xpezEVcgsFCiJgTT) تحت ميزة testnet. هذه التعليمات تنقل lamports فقط؛ لا تلمس أبدًا رصيد الرموز أو تغلق حسابًا أو تغيّر حالة المجموعة. انظر products/amm-v4/instructions و products/cpmm/instructions و products/launchlab/instructions.

منشئ الإعدادات المفوّض LaunchLab

CreateConfig يقبل إما مسؤول البرنامج المشترك أو السلطة المفوّضة أدناه. الدور المفوّض يمكنه إنشاء GlobalConfig جديد؛ لا يمكنه استدعاء مسار UpdateConfig المقتصر على المسؤول لحساب موجود.

سلطات التجميد المقيّدة للمُصدر CLMM

عندما يكون لأي من vault mints في مجموعة CLMM إحدى سلطات التجميد أدناه، المراكز الجديدة المفتوحة من خلال مسار V2 لديها حساب رموز NFT موضعها مجمّد. القائمة هي frozen_position_nft_authorities::IDS في برنامج CLMM، وإدخالها الوحيد هو سلطة المُصدر التي كشف Superstate المحذوف من CLMM أيضًا عليها. هذه سلطات مُصدر الأصول الأساسية المستخدمة فقط كمفاتيح مطابقة. PDA مجموعة CLMM، وليس مفتاح المُصدر، يصبح سلطة التجميد لـ mint NFT الموضع. القائمة مشفّرة في برنامج CLMM. إضافة أو إزالة سلطة تتطلب ترقية برنامج.

اتفاقيات الإعدادات المشتركة / PDA

عدة برامج Raydium تعرّض حسابات إعدادات مفاتيحها العامة مستقرة ومدرجة على واجهة برمجية عامة. فضّل بحث واجهة برمجية على الترميز الثابت:

متلقو رسوم إنشاء المجموعة

كل من CPMM و AMM v4 يتحققان من وجهة رسوم إنشاء المجموعة بالعنوان الدقيق، لذا يجب أن تكون موجودة بالفعل على أي مجموعة تختبر عليها. CLMM لا يوجد لديه رسوم إنشاء مجموعة منفصلة. AMM v4 أيضًا يجمّع 3TRTX4dXUpp2eqxi3tvQDFYUV7SdDJjcPE3Y4mbtftaX تحت ميزة testnet. CPMM يرفض عدم التطابق مع ConstraintAddress من Anchor (2012)؛ AMM v4 مع InvalidFee.

حارس أوامر الحد CLMM

SettleLimitOrder و CloseLimitOrder يقبلان إما owner الأمر نفسه أو مفتاح الحارس على مستوى البرنامج أدناه. الحارس لا يمكنه فتح أو زيادة أو تقليل الأوامر، والمخرجات دائمًا تهبط في حساب مالك الأمر — انظر security/admin-and-multisig. معاملات رسوم AmmConfig الافتراضية CPMM للفهرس 0 (مجموعة 0.25% قياسية)، للمرجعية: انظر products/cpmm/fees لكيفية تكوين الأقسام، و reference/fee-comparison لمصفوفة المنتجات المتقاطعة.

بذور PDA

البذور أدناه رسمية وتُستخدم من قبل كل من SDK و CPIs على السلسلة. احسب PDAs دائمًا؛ لا تشفّر العناوين المشتقة.
token0Mint / token1Mint مرتبة حسب ترتيب بايت المفتاح العام (token0 < token1) قبل التجزئة. الخطأ في هذا ينتج عنه PDA صحيح لمجموعة غير موجودة. بذور CLMM المكافئة تتبع نفس الأسلوب؛ انظر products/clmm/accounts.

Devnet

قاعدة REST API لـ Devnet: https://api-v3-devnet.raydium.io/ (نفس شكل المسار مثل mainnet).

سلطة الترقية

كل برنامج Raydium على mainnet-beta يُنشر تحت BPF Upgradeable Loader مع نفس سلطة الترقية — خزينة multisig ترقية البرنامج من Squads: تم التحقق منه على السلسلة 2026-09-09 لـ AMM v4 و CPMM و CLMM و Stable AMM و Farm v6 و LaunchLab و AMM Routing و Lock — جميع الثمانية تبلّغ عن تلك السلطة، ولا أحد منها غير قابل للتغيير. أعد الفحص مع solana program show <PROGRAM_ID> -u mainnet-beta قبل نشر عالي المخاطر؛ انظر security/admin-and-multisig لعتبة multisig وممارسة التوقيع.

حسابات الإعدادات على مستوى البرنامج

جميع القيم مقروءة من mainnet-beta في 2026-09-09. معدلات الرسوم على هذه الحسابات قابلة للتغيير من قبل المسؤول — اقرأها حية بدلاً من التخزين المؤقت.

كيفية التحقق من عنوان على السلسلة

  1. Solana Explorer. الصق العنوان في explorer.solana.com وتأكد من أنه مُشار إليه كـ Program مع سلطة ترقية حالية. يجب أن يُظهر mainnet-beta عمليات نشر موقّعة من قبل سلطة ترقية Raydium.
  2. CLI. استخدم solana program show <PROGRAM_ID> -u mainnet-beta لفحص فتحة النشر و BPF loader وسلطة الترقية وطول البيانات. سجّل هذه في دليل التشغيل الخاص بك.
  3. إرفاق IDL. anchor idl fetch <PROGRAM_ID> --provider.cluster mainnet يعمل لـ CLMM و LaunchLab و Lock، التي لا تزال تحتفظ بحساب anchor:idl موروث مملوك من قبل البرنامج نفسه. لا يعمل لـ CPMM: IDL على السلسلة لـ CPMM انتقل إلى برنامج Program Metadata (ProgM6JCCvbYkfKqJYHePx4xxSUSqJp7rh8Lyv7nk7S) في ترقية 2026-09، لذا اجلبه من هناك بدلاً من ذلك. AMM v4 و Stable AMM و Farm لا يوجد لديهم IDL على السلسلة. يتم عكس IDLs في github.com/raydium-io/raydium-idl — قارن IDL على السلسلة مقابل المستودع قبل الثقة به.
  4. سلطات الإعدادات/المسؤول. بالنسبة لحسابات إعدادات CPMM/CLMM، اقرأ حقل owner/protocol_owner وتأكد من أنه يطابق multisig Raydium الحالي المنشور في security/admin-and-multisig.
إذا اختلف أي من الفحوصات الأربعة أعلاه مع هذه الصفحة، تعامل مع هذه الصفحة كخاطئة وافتح مشكلة قبل كتابة كود جديد مقابل العناوين.

تحديث هذه الصفحة

  • التغييرات على معرّفات البرامج حساسة للسلامة. لا تشحن تغيير معرّف برنامج دون (أ) الربط بإعلان Raydium، (ب) إضافة إدخال في reference/changelog، و (ج) تشغيل فحص الروابط على التوثيق للتأكد من عدم وجود صفحة تشير إلى القيمة القديمة.
  • الإهمالات تبقى في الجدول مع ملاحظة حالة بدلاً من الحذف — المجموعات الموجودة لا تزال تُحل عبر البرنامج القديم.
المصادر: