هذه الصفحة مُترجَمة آليًا بواسطة الذكاء الاصطناعي. النسخة الإنجليزية هي المرجع المعتمد.عرض النسخة الإنجليزية →
تفترض كل المعلومات في هذه التوثيق وجود سلسلة أدوات تطوير Solana تعمل بشكل صحيح. تسرد هذه الصفحة الأدوات والإصدارات المعروفة بأنها تعمل مع Raydium اعتبارًا من سبتمبر 2026، والمشاكل المحددة في الإعداد. ابدأ من هنا قبل تشغيل أي من أمثلة الكود في الفصول اللاحقة.مجموعتان من الإصدارات مهمتان، وهما ليستا متطابقتين. لـ بناء أو نسخ برامج Raydium تحتاج إلى سلسلة الأدوات الدقيقة التي تثبتها — Rust 1.91.0، Agave 3.1.10، Anchor 1.0.2 اعتبارًا من ترقية 2026-09-09. لـ التكامل ضد البرامج المنشورة من TypeScript أو Python تحتاج فقط إلى مكتبة عميل حديثة بما يكفي للتحدث معها، والتثبيتات استشارية. يحدد كل قسم أدناه الحالة التي يغطيها.
الأدوات الأساسية
Solana CLI
واجهة سطر الأوامر الرسمية للتفاعل مع مجموعات Solana — إدارة المحفظة، استدعاءات RPC، نشر البرامج. التثبيت:انتقل مضيف التثبيت. كان قد يسلمك هذا المثبت إصدار Anchor مختلف عن الذي تثبته برامج Raydium — تحقق من
release.solana.com تابعًا لـ Solana Labs؛ يتم الآن الحفاظ على العميل بواسطة Anza باسم Agave، والإصدارات تُقدم من release.anza.xyz. الملف الثنائي للتحديث الذاتي هو agave-install (solana-install يُحتفظ به كاسم مستعار قديم)، لذا agave-install update و agave-install init <version> هي الصيغ الحالية. توفر مستندات Solana أيضًا مثبتًا بأمر واحد يسحب CLI و Rust و Anchor معًا:anchor --version بعد ذلك.SPL Token CLI
واجهة سطر الأوامر الرسمية لعمليات SPL Token / Token-2022 — إنشاء mints، صك الرموز، التحويل. التثبيت (مضمن مع Solana CLI):Anchor CLI
مطلوب لجلب IDLs الخاصة بـ Raydium، وبناء العملاء، والتحقق من البرامج. التثبيت:انتقل Anchor إلى مستودع وإصدار رئيسي جديد. المستودع الرسمي الآن
github.com/solana-foundation/anchor (كان coral-xyz/anchor)، و Anchor 1.0 هو أول سطر إصدار تستخدمه برامج Raydium — يثبت كل من CPMM و LaunchLab anchor-lang/anchor-spl =1.0.2 اعتبارًا من ترقية 2026-09-09، بارتفاع من 0.32.1. يمكن لـ avm الاحتفاظ بعدة إصدارات؛ avm use 1.0.2 هو ما يجعل anchor build يعيد إنتاج القطع الأثرية الخاصة بـ Raydium. يوجد Anchor 1.1 و 1.2 ويبنيان بشكل جيد لبرامجك الخاصة، لكن صندوق CPI مترجم ضد anchor-lang ثانوي مختلف عن الذي يثبته البرنامج الهدف لن يرتبط — انظر sdk-api/rust-cpi.إعداد TypeScript
مسار التكامل الأساسي لـ Raydium.الحزم
@anchor-lang/core مجمد؛ الحزمة الآن @anchor-lang/core. توقف @anchor-lang/core عند 0.32.1 عندما انتقل Anchor إلى Solana Foundation. ينشر Anchor 1.x باسم @anchor-lang/core، وحولت مستودعات برامج Raydium الخاصة بها مجموعات الاختبار إليه في ترقية 2026-09-09. الواردات التي تستخدمها فعليًا لم تتغير — import { Program, BN, AnchorProvider } from "@anchor-lang/core" — لذا الترحيل هو إعادة تسمية الحزمة بالإضافة إلى تحديث ملف القفل.ملاحظتان سلوكيتان إذا كنت تنتقل من 0.3x: .accounts({...}) الآن يقبل فقط الحسابات التي لا يمكن لـ Anchor حلها بنفسه، لذا يجب على المنشئ الذي يمرر المجموعة الكاملة استدعاء .accountsPartial({...}) بدلاً من ذلك؛ و @anchor-lang/core/dist/cjs/utils/token هو حيث انتقلت المساعدات مثل ASSOCIATED_PROGRAM_ID.سكريبت بسيط
sdk-api/typescript-sdk للحصول على مرجع SDK الكامل.
إعداد Rust
للتكامل CPI والبرامج على السلسلة.سلسلة الأدوات
cargo build-sbf (الصيغة القديمة cargo build-bpf اختفت).
Program Cargo.toml لتكامل Raydium CPI
anchor-lang و anchor-spl باستخدام = للإصدار الذي يثبته البرنامج الهدف. اعتبارًا من 2026-09 يثبت CPMM =1.0.2 و CLMM لا يزال يثبت =0.32.1، لذا لا يمكن لصندوق واحد أن يقوم بـ CPI في كليهما — انظر sdk-api/rust-cpi.
ميزة "cpi" تستورد وحدة cpi مع مساعدات CPI (حتى تتمكن من raydium_cp_swap::cpi::swap_base_input(...)). انظر sdk-api/rust-cpi.
إعداد Python
مسار التكامل الثانوي — شائع لمطوري البوتات.الحزم
فخان تسمية. يتم استيراد عميل RPC باسم
solana لكن المشروع يُسمى solana-py — pip install solana-py لا يثبت أي شيء مفيد. وليس هناك حزمة raydium-py على PyPI: مساعد Raydium المجتمعي هو مستودع تستنسخه، AL-THE-BOT-FATHER/raydium_py، وليس توزيعًا منشورًا. قائمة الإصدارات السابقة من هذه الصفحة pip install raydium-py التي لم تعمل أبدًا.سكريبت بسيط
sdk-api/python-integration.
نقاط نهاية RPC
RPC الشبكة الرئيسية العام (api.mainnet-beta.solana.com) محدود بشدة ويخنق تحت أي حمل. للاستخدام غير التافه، احصل على نقطة نهاية خاصة:
التكوين:
getProgramAccounts— المسح غير المقيد مكلف؛ بعض المزودين يحدون أو يفرضون رسومًا لكل مسح.getPriorityFeeEstimate— نقطة نهاية خاصة بـ Helius؛ للآخرين معادلات.geyser/ WebSocket streaming — مطلوب للبوتات منخفضة الكمون؛ لا جميع المزودين يكشفونها.
Devnet و localnet
Devnet
مجموعة اختبار عام Solana. لدى Raydium نشر devnet جزئي:- توجد بعض حمامات CPMM للاختبار.
- AMM v4 لديه حمامات devnet تاريخية.
- CLMM لديه بعض حمامات العرض التوضيحي.
- Farm v6 مُنشر.
cluster: "devnet":
Localnet مع حالة mainnet مشعبة
للاختبار الواقعي، شعب حالة mainnet إلى محقق محلي:- اختبار وحدة تكامل CPI الخاص بك ضد برنامج Raydium حقيقي.
- إعادة تشغيل معاملة مع معامل معدل للتصحيح.
- اختبار الإجهاد مع أحجام اصطناعية كبيرة.
قوالب المشروع
مبدئ تكامل TypeScript
package.json بسيط:
مبدئ برنامج Anchor CPI
أدوات CLI مفيدة
solana-keygen
قراءة أي حساب
سجلات البرنامج
فحص المعاملة
نظافة البيئة
محافظ منفصلة لكل غرض
- محفظة التطوير: تحتفظ بـ testnet SOL، تُستخدم للبناء.
- محفظة الإنتاج: تحتفظ بـ SOL حقيقي، تُستخدم فقط للنشر / تقديمات multisig.
- محفظة ساخنة للبوتات: رصيد صغير، أذونات ضيقة.
نمط .env
تثبيت الإصدار
قفل جميع تبعيات نظام Solana البيئي. يتحرك النظام البيئي بسرعة؛ قد يقدم تحديث الإصدار الثانوي لـ@solana/web3.js تغييرات كسر سابقة. استخدم package-lock.json / Cargo.lock بدينة.
مؤشرات
sdk-api/typescript-sdk— مرجع TypeScript SDK.sdk-api/rust-cpi— استخدام Rust CPI.sdk-api/python-integration— إعداد Python.solana-fundamentals/programs-and-anchor— خلفية Anchor.

