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 غير متاحة للعموم — تحقق منها مقابل واجهة برمجية التطبيقات المباشرة وبايتكود السلسلة و IDLs المنشورة في raydium-io/raydium-idl بدلاً من ذلك.

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

جميع البرامج المستندة إلى Anchor (CLMM و CPMM و LaunchLab و Lock) تشترك في مفتاح عام واحد مشفّر للمسؤول لتحكم الوصول على مستوى التعليمات إلى مسارات المسؤول (مثل CreateAmmConfig أو UpdatePoolStatus): سلطات التشغيل على مستوى الحساب (مثل protocol_owner و fund_owner على CPMM/CLMM AmmConfig أو محافظ الهجرة على LaunchLab GlobalConfig) يتم تخزينها على السلسلة وقد تختلف عن مسؤول البرنامج. اقرأها مباشرة من حساب الإعدادات ذي الصلة قبل إرسال معاملات عالية المخاطر.

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

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

سلطة سجل دعم العملات في CPMM

CreateSupportMintAssociated و CloseSupportMintAssociated يقبلان إما مسؤول البرنامج المشترك أو المالك المخصص أدناه. تسجيل عملة يسمح لها بتجاوز قائمة السماح بامتدادات Token-2022 في CPMM — انظر reference/token-2022-support.

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

منذ ترقية CPMM في 2026-09، CreateAmmConfig يكتب هذه المفاتيح الثابتة في protocol_owner و fund_owner للإعدادات الجديدة بدلاً من نسخ مفتاح الموقّع المسؤول. هم الموقّعون الذين يقبلهما CollectProtocolFee و CollectFundFee لأي إعدادات تم إنشاؤها من تلك الترقية فصاعدًا.
هذه هي القيم التي يكتبها البرنامج في الإعدادات الجديدة، وليست وصفًا للإعدادات الموجودة. حسابات AmmConfig التي تم إنشاؤها قبل الترقية تحتفظ بأي شيء مخزن عليها. اقرأ دائمًا protocol_owner / fund_owner من الحساب قبل بناء معاملة جمع.

محافظ جمع 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

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

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

عدة برامج Raydium تعرّض حسابات الإعدادات التي مفاتيحها العامة مستقرة ومدرجة في واجهة برمجية التطبيقات العامة. فضّل البحث عبر واجهة برمجية التطبيقات على الترميز المباشر:
متلقي رسوم إنشاء المجموعة في CPMM هو حساب ثابت، وليس مشتقًا أو تم البحث عنه عبر واجهة برمجية التطبيقات: create_pool_fee_reveiver::ID في lib.rs الخاص بـ raydium-cp-swap، حاليًا DNXgeM9EiiaAbaWvwjHj9fQQLAX5ZsfHyvmYUNRAdNC8. تعليمة initialize في CPMM تتحقق منها بالعنوان الدقيق، لذا يجب أن تكون موجودة بالفعل على أي مجموعة تختبر عليها. معاملات رسوم 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 لـ Devnet: https://api-v3-devnet.raydium.io/ (نفس شكل المسار مثل mainnet).

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

  1. Solana Explorer. الصق العنوان في explorer.solana.com وتأكد من أنه مشار إليه بـ Program مع سلطة ترقية حالية. يجب أن يعرض mainnet-beta عمليات نشر موقّعة من قبل سلطة ترقية Raydium.
  2. CLI. استخدم solana program show <PROGRAM_ID> -u mainnet-beta لفحص فتحة النشر وموجّه BPF وسلطة الترقية وطول البيانات. سجّل هذه في دليل التشغيل الخاص بك.
  3. إرفاق IDL. استعلم عن IDL على السلسلة باستخدام anchor idl fetch <PROGRAM_ID> --provider.cluster mainnet. حقل address في IDL يجب أن يطابق. نفس IDLs يتم نسخها في github.com/raydium-io/raydium-idl — قارن IDL على السلسلة مقابل المستودع قبل الثقة به.
  4. سلطات الإعدادات/المسؤول. لحسابات إعدادات CPMM/CLMM، اقرأ حقل owner/protocol_owner وتأكد من أنه يطابق multisig Raydium الحالي المنشور في security/admin-and-multisig.
إذا اختلف أي من الفحوصات الأربعة أعلاه مع هذه الصفحة، اعتبر هذه الصفحة خاطئة وافتح مشكلة قبل كتابة كود جديد مقابل العناوين.

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

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