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, limit orders, ...
raydium.liquidity  // AMM v4 pools: computeAmountOut, swap, addLiquidity, removeLiquidity, ...
raydium.farm       // Farm v3/v5/v6: deposit, withdraw, harvestAllRewards, create,
                   //                restartReward(s), addNewRewardToken(s)
raydium.launchpad  // LaunchLab: createLaunchpad, buyToken, buyTokenExactOut, sellToken,
                   //            claimCreatorFee, curve-rule and platform-config builders, ...
raydium.tradeV2    // Multi-pool routing: route discovery, compute, route-execution
raydium.marketV2   // OpenBook market creation (legacy)
raydium.utils1216  // One-off historical-claim helpers
raydium.token      // Token list + metadata: load(), getTokenInfo()
raydium.account    // Wallet token accounts, ATA lookup and creation
raydium.api        // The REST client (fetchPoolById, getCpmmConfigs, fetchLaunchConfigs, ...)

​

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

import { Percent } from "@raydium-io/raydium-sdk-v2";

const { execute, builder, transaction, instructionTypes, signers, extInfo } =
  await raydium.cpmm.addLiquidity({
    poolInfo,
    inputAmount,              // BN — one side, not a pair
    baseIn: true,
    slippage: new Percent(1, 100),   // a Percent, not a number
    txVersion: TxVersion.V0,
  });

• execute — دالة راحة توقّع + ترسل. معادل لـ builder.execute.
• builder — مثيل TxBuilder مع جميع التعليمات والموقّعين المتراكمين. تُعيد builder.build() كائن TxBuildData تكون transaction فيه معاملة Transaction قديمة واحدة؛ وتُعيد builder.buildV0() كائن TxV0BuildData بمعاملة VersionedTransaction واحدة. ولا تنتج مصفوفة إلا buildMultiTx / buildMultiTxV0.
• transaction — المعاملة المبنية Transaction / VersionedTransaction.
• instructionTypes / signers — تسميات التعليمات المتراكمة ومجموعة الموقّعين.
• extInfo — إضافات خاصة بالمنتج. على سبيل المثال، يعيد cpmm.createPool القيمة extInfo.address.{poolId, lpMint, vaultA, vaultB}؛ ويعيد launchpad.createLaunchpad القيمة extInfo.address (كائن LaunchpadPoolInfo بالإضافة إلى poolId).

​

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

​

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

• raydium.clmm.createCustomizablePool — مجموعة شاملة من createPool تقبل collectFeeOn و dynamicFeeConfig (وهو PublicKey حساب التكوين). وتمرير dynamicFeeConfig هو ما يُمكّن الرسوم الديناميكية؛ فلا يوجد علم منفصل enableDynamicFee ولا dynamicFeeConfigId. ويستمر createPool الكلاسيكي في العمل لمجمعات الرسوم الافتراضية.
• raydium.clmm.openLimitOrder — فتح أمر حد أحادي التكة. يأخذ poolInfo و baseIn (الاتجاه) و orderTick و amount، واختياريًا tickArrayBitmap و noneIndex و ownerInfo. استخدم المساعد المُصدَّر getOrderTick({ baseIn, mintADecimal, mintBDecimal, tickSpacing, price }) لتكميم التكة.
• raydium.clmm.increaseLimitOrder / decreaseLimitOrder — اضبط الجزء غير المملوء من أمر موجود. وكلاهما يأخذ { poolInfo, limitOrder, amount }؛ ويضيف decreaseLimitOrder معامل slippage اختياريًا. والتقليل يعود بخطأ InvalidOrderPhase على أمر مملوء بالكامل.
• raydium.clmm.settleLimitOrder / settleAllLimitOrder — كسح المخرج المملوء إلى ATA المالك. و settleLimitOrder تأخذ { limitOrder } فقط — بلا poolInfo. ويمكن أن يستدعيها إما مالك الأمر أو حافظ البرنامج limit_order_admin.
• raydium.clmm.closeLimitOrder / closeAllLimitOrder — أغلق الأوامر المسوّاة بالكامل لاسترجاع الإيجار.
• raydium.api.getClmmDynamicConfigs() — مساعد REST يضرب نقطة النهاية الجديدة /main/clmm-dynamic-config. (ولا يوجد مساعد أو نقطة نهاية لتكوين أوامر الحد: فأوامر الحد مفتاحها التكة، لا حساب تكوين لكل مجمع.)

​

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

​

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

​

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

​

3. poolInfo قديم

​

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

const { execute } = await raydium.cpmm.swap({
  poolInfo,
  baseIn,                    // required: which side inputAmount is denominated in
  inputAmount: new BN(...),
  swapResult: ...,           // required: from CurveCalculator.swapBaseInput/Output
  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.tradeV2 (التوجيه)، أعد التحقق من شكل المسار — إنه الجزء الأكثر عدم استقراراً من السطح. ولاحظ أن الواجهة أُعيدت تسميتها من trade إلى tradeV2؛ والاسم القديم لم يعد موجودًا.

​

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

• مشاكل 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.