TypeScript SDK

​

التثبيت

npm install @raydium-io/raydium-sdk-v2 @solana/web3.js @solana/spl-token
# أو
pnpm add @raydium-io/raydium-sdk-v2 @solana/web3.js @solana/spl-token

​

التهيئة

import { Raydium } from "@raydium-io/raydium-sdk-v2";
import { Connection, Keypair, clusterApiUrl } from "@solana/web3.js";

const connection = new Connection(process.env.RPC_URL ?? clusterApiUrl("mainnet-beta"));
const owner      = Keypair.fromSecretKey(/* ... */);

const raydium = await Raydium.load({
  owner,
  connection,
  cluster: "mainnet",           // "mainnet" | "devnet"
  disableFeatureCheck: true,    // skip the SDK's startup feature-detect API call
  blockhashCommitment: "confirmed",
});

​

واجهات الوحدات الأربع

raydium.cpmm       // CPMM pools: createPool, addLiquidity, withdrawLiquidity, swap, ...
raydium.clmm       // CLMM pools: createPool, openPositionFromBase, increasePositionFromBase,
                   //             decreaseLiquidity, harvestAllRewards, swap, ...
raydium.liquidity  // AMM v4 pools: computeAmountOut, swap, addLiquidity, removeLiquidity, ...
raydium.farm       // Farm v3/v5/v6: deposit, withdraw, harvestAllRewards, create, setRewards
raydium.launchpad  // LaunchLab: createLaunchpad, buyExactIn, sellExactIn, graduate, ...
raydium.trade      // Multi-pool routing: quotes, route-execution (beta in 0.2.41)
raydium.token      // Helpers: get token list, metadata, ATA creation

​

منشئو المعاملات

const { execute, builder, transaction, innerTransactions, extInfo } =
  await raydium.cpmm.addLiquidity({
    poolInfo,
    amountInA,
    amountInB,
    slippage: 0.005,
    txVersion: TxVersion.V0,
  });

• execute — دالة راحة توقّع + ترسل. معادل لـ builder.execute.
• builder — مثيل TxBuilder مع جميع التعليمات والموقّعين المتراكمين. استدعِ .build() للحصول على VersionedTransaction[]؛ مفيد عندما تحتاج إلى حقن تعليماتك الخاصة أو التوقيع بموقّعين خارجيين.
• transaction / innerTransactions — مصفوفات التعليمات الخام. استخدم عند بناء معاملات متعددة البرامج المركبة.
• extInfo — إضافات خاصة بالمنتج. على سبيل المثال، createPool يعيد extInfo.poolId؛ createLaunchpad يعيد PDA حالة الإطلاق الجديدة.

​

لماذا منشئو غير متزامنين؟

​

إضافات وحدة CLMM (الإصدار الأخير)

• raydium.clmm.createCustomizablePool — مجموعة شاملة من createPool التي تقبل collectFeeOn وenableDynamicFee وdynamicFeeConfigId. استخدم هذا لأي مجموعة جديدة تحتاج إلى الأزرار الجديدة؛ createPool الكلاسيكي يستمر في العمل لمجموعات الرسوم الافتراضية.
• raydium.clmm.openLimitOrder — افتح أمر حد أحادي التجزئة على مجموعة تدعمها. يأخذ poolInfo وpoolKeys وlimitOrderConfig (من /main/clmm-limit-order-config) وinputMint وinputAmount وtick الهدف.
• raydium.clmm.increaseLimitOrder / decreaseLimitOrder — اضبط الجزء غير المملوء من أمر موجود. يؤدي الانخفاض إلى الانعكاس على أمر مملوء بالكامل مع InvalidOrderPhase.
• raydium.clmm.settleLimitOrder / settleAllLimitOrder — اكسح الإخراج المملوء إلى ATA المالك. يمكن لمالك الأمر أو حارس limit_order_admin للمجموعة استدعاؤهما.
• raydium.clmm.closeLimitOrder / closeAllLimitOrder — أغلق الأوامر المستقرة بالكامل لاسترجاع الإيجار.
• raydium.api.getClmmDynamicConfigs() / getClmmLimitOrderConfigs() — مساعدات REST التي تضرب نقاط النهاية الجديدة /main/clmm-dynamic-config و/main/clmm-limit-order-config.

​

المشاكل الشائعة

​

1. عدم تطابق الكتلة

​

2. نسيان إنشاء ATAs مسبقاً

​

3. poolInfo قديم

​

4. رسوم الأولوية

const { execute } = await raydium.cpmm.swap({
  poolInfo,
  inputAmount: new BN(...),
  swapResult: ...,
  slippage: 0.005,
  txVersion: TxVersion.V0,
  computeBudgetConfig: {
    units: 250_000,          // CU limit
    microLamports: 50_000,   // priority fee per CU
  },
});

​

5. تحمل الانزلاق يجب أن يطابق نوع المجموعة

​

6. BN مقابل number

​

سياسة الإصدار

• @raydium-io/raydium-sdk-v2 هو SDK الوحيد الذي تحتفظ به Raydium. جميع الوثائق والعينات والإرشادات التكاملية تستهدفه.
• توجد حزمة v1 أقدم (@raydium-io/raydium-sdk) على npm لأسباب تاريخية. انتهت الصيانة بعد شحن CPMM و LaunchLab (لم تكتسب v1 أبداً دعماً لأي منهما)، ولم تكن هناك إصدارات v1 منذ 2024. تعامل مع v1 كنهاية الحياة: لا تستخدمه لكود جديد، وهاجر أي تكاملات v1 متبقية إلى v2.
• SDK v2 في مرحلة ما قبل 1.0. التغييرات الكسرية بين إصدارات 0.x الثانوية ممكنة؛ ثبّت الإصدار الذي تحققت منه وتحقق من ملاحظات إصدار GitHub عند الترقية.

​

الترقية

1. أعد فحص نوع الإرجاع لكل استدعاء طفرة — تغييرات الشكل (مثل extInfo) تهبط بشكل متكرر.
2. أعد إنشاء توقيعات جلب poolInfo — قد تكون حقل قد أعيدت تسميته.
3. أعد التحقق من معالجة الانزلاق الخاصة بك؛ تحول SDK بين السلوكيات المرتبطة تلقائياً والمرتبطة بالاختيار عبر الإصدارات.
4. إذا كنت تستخدم raydium.trade (التوجيه)، أعد التحقق من شكل المسار — إنه الجزء الأكثر عدم استقراراً من السطح.

​

الحصول على المساعدة

• مشاكل GitHub — قدّم في github.com/raydium-io/raydium-sdk-V2/issues للأخطاء والطلبات الميزة. يراقب فريق Raydium بنشاط.
• Discord — قناة #dev-support في discord.gg/raydium للمساعدة المتزامنة.
• Telegram — دردشة المطورين المرتبطة من raydium.io (تجنب مجموعات Telegram غير المتحققة).

​

مؤشرات

• sdk-api/rest-api — المكمل HTTP للـ SDK.
• sdk-api/trade-api — معاملات المبادلة المدمجة من الخادم.
• sdk-api/anchor-idl — إعادة إنشاء العملاء مباشرة من IDLs البرنامج.
• sdk-api/python-integration — المكافئ Python عبر solana-py.
• integration-guides/priority-fee-tuning — تحجيم computeBudgetConfig.

• مصدر Raydium SDK v2
• ملاحظات إصدار Raydium SDK.