الانتقال إلى المحتوى الرئيسي

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.

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

Mainnet-beta

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

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

البرنامجمعرّف البرنامجالمصدر
AMM v4 (Hybrid AMM + OpenBook)675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8raydium-amm
CPMM (Standard AMM)CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1Craydium-cp-swap
CLMM (Concentrated Liquidity)CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqKraydium-clmm
Stable AMM (StableSwap-style curve)5quBtoiQqxF9Jv6KYKctB59NT3gtJD2Y65kdnB1Uev3hالمصدر غير متاح علنًا
Farm v3 (legacy RAY staking)EhhTKczWMGQt46ynNeRX1WfeagwwJd7ufHvCDjRxjo5Qالمصدر غير متاح علنًا
Farm v5 (legacy ecosystem farms)9KEPoZmtHUrBbhWN1v1KWLMkkvwY6WLtAVUCPRtRjP4zالمصدر غير متاح علنًا
Farm v6 (current ecosystem farms)FarmqiPv5eAj3j1GMdMCMUGXqPUvmquZtMy86QH6rzhGالمصدر غير متاح علنًا
LaunchLabLanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3ujالمصدر غير متاح علنًا
AMM Routing (جهاز التوجيه على السلسلة من Raydium)routeUGWgWzqBWFcrCfv8tritsqukccJPu3q5GPP3xSالمصدر غير متاح علنًا
Burn & Earn / LP LockLockrWmn6K5twhz3y9w1dQERbmgSaRkfnTeTKbpofwEالمصدر غير متاح علنًا
ملاحظات:
  • يتم الاحتفاظ بـ AMM v4 و Farm v3/v5 للأجنحة والمراكز الموجودة. يوجّه واجهة Raydium و SDK إنشاء الأجنحة الجديدة والمزارع البيئية الجديدة إلى CPMM و CLMM و Farm v6 على التوالي — راجع protocol-overview/versions-and-migration.
  • معرّف Farm v3 أعلاه يعمل أيضًا كبرنامج الرهن ذي الأصل الواحد لـ $RAY. السلوك متطابق مع Farm v3 لرهن LP.
  • Stable AMM هو برنامج منفصل يمكن لجهاز التوجيه أن يستهدفه جنبًا إلى جنب مع 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 غير متاحة علنًا — تحقق منها مقابل واجهة API المباشرة و bytecode على السلسلة و IDLs المنشورة في raydium-io/raydium-idl بدلاً من ذلك.

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

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

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

تكشف عدة برامج Raydium عن حسابات الإعدادات التي تكون مفاتيحها العامة مستقرة والمدرجة في واجهة API العامة. فضّل بحث API على الترميز المباشر:
# تكوينات رسوم CPMM (تُرجع صفيفة من {id, index, tradeFeeRate, ...})
GET https://api-v3.raydium.io/main/cpmm-config

# تكوينات رسوم CLMM
GET https://api-v3.raydium.io/main/clmm-config
معاملات رسوم CPMM AmmConfig الفهرس الافتراضي 0 (مجموعة قياسية بنسبة 0.25%)، كمرجع:
الحقلالقيمةالمعنى
trade_fee_rate25000.25% من حجم التداول
protocol_fee_rate12000012% من رسوم التداول (وليس الحجم) الموجهة إلى البروتوكول
fund_fee_rate400004% من رسوم التداول الموجهة إلى محفظة الصندوق
creator_fee_rate5000.05% من حجم التداول إلى منشئ المجموعة (اختياري)
راجع products/cpmm/fees لمعرفة كيفية تكوين الانقسامات، و reference/fee-comparison لمصفوفة المنتجات المتقاطعة.

بذور PDA

البذور أدناه رسمية ويستخدمها كل من SDK و CPIs على السلسلة. احسب دائمًا PDAs؛ لا ترمز العناوين المشتقة مباشرة.
// CPMM — جميع البذور عبارة عن سلاسل ASCII ثابتة ما لم يُذكر خلاف ذلك.
const [ammConfig]   = PublicKey.findProgramAddressSync(
  [Buffer.from("amm_config"), u16ToBytes(index)],
  CPMM_PROGRAM_ID,
);
const [authority]   = PublicKey.findProgramAddressSync(
  [Buffer.from("vault_and_lp_mint_auth_seed")],
  CPMM_PROGRAM_ID,
);
const [poolState]   = PublicKey.findProgramAddressSync(
  [Buffer.from("pool"), ammConfig.toBuffer(), token0Mint.toBuffer(), token1Mint.toBuffer()],
  CPMM_PROGRAM_ID,
);
const [lpMint]      = PublicKey.findProgramAddressSync(
  [Buffer.from("pool_lp_mint"), poolState.toBuffer()],
  CPMM_PROGRAM_ID,
);
const [vault0]      = PublicKey.findProgramAddressSync(
  [Buffer.from("pool_vault"), poolState.toBuffer(), token0Mint.toBuffer()],
  CPMM_PROGRAM_ID,
);
const [vault1]      = PublicKey.findProgramAddressSync(
  [Buffer.from("pool_vault"), poolState.toBuffer(), token1Mint.toBuffer()],
  CPMM_PROGRAM_ID,
);
const [observation] = PublicKey.findProgramAddressSync(
  [Buffer.from("observation"), poolState.toBuffer()],
  CPMM_PROGRAM_ID,
);
token0Mint / token1Mint مرتبة حسب ترتيب البايت للمفتاح العام (token0 < token1) قبل الهاش. الخطأ في هذا ينتج عنه PDA صالح لمجموعة غير موجودة. تتبع بذور CLMM المكافئة نفس الأسلوب؛ راجع products/clmm/accounts.

Devnet

البرنامجمعرّف البرنامج
AMM v4DRaya7Kj3aMWQSy19kSjvmuwq9docCHofyP9kanQGaav
CPMMDRaycpLY18LhpbydsBWbVJtxpNv9oXPgjRSfpF2bWpYb
CLMMDRayAUgENGQBKVaX8owNhgzkEDyoHTGVEGHVJT1E9pfH
Stable AMMDRayDdXc1NZQ9C3hRWmoSf8zK4iapgMnjdNZWrfwsP8m
LaunchLabDRay6fNdQ5J82H7xV6uq2aV3mNrUZ1J4PgSKsWgptcm6
AMM RoutingDRaybByLpbUL57LJARs3j8BitTxVfzBg351EaMr5UTCd
Burn & Earn / LP LockDLockwT7X7sxtLmGH9g5kmfcjaBtncdbUmi738m5bvQC
Farm v3 / v5 / v6لم يتم نشره بشكل موثوق لـ devnet — تأكد عبر واجهة API المباشرة (https://api-v3-devnet.raydium.io/main/info) قبل الاستخدام.
قاعدة REST API لـ 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 loader و سلطة الترقية وطول البيانات. سجل هذه في كتاب تشغيلك.
  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 وتأكد من أنه يطابق محفظة Raydium الحالية المنشورة في security/admin-and-multisig.
إذا اختلف أي من الفحوصات الأربعة أعلاه مع هذه الصفحة، اعتبر هذه الصفحة خاطئة وافتح مشكلة قبل كتابة كود جديد ضد العناوين.

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

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