TypeScript SDK

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.

​

التثبيت

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,    // تخطي استدعاء API الكشف عن الميزات عند بدء التشغيل
  blockhashCommitment: "confirmed",
});

​

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

raydium.cpmm       // تجمعات CPMM: createPool, addLiquidity, withdrawLiquidity, swap, ...
raydium.clmm       // تجمعات CLMM: createPool, openPositionFromBase, increasePositionFromBase,
                   //             decreaseLiquidity, harvestAllRewards, swap, ...
raydium.liquidity  // تجمعات AMM v4: computeAmountOut, swap, addLiquidity, removeLiquidity, ...
raydium.farm       // Farm v3/v5/v6: deposit, withdraw, harvestAllRewards, create, setRewards
raydium.launchpad  // LaunchLab: createLaunchpad, buyExactIn, sellExactIn, graduate, ...
raydium.trade      // توجيه متعدد التجمعات: quotes, route-execution (beta في 0.2.41)
raydium.token      // أدوات مساعدة: الحصول على قائمة الرموز والبيانات الوصفية وإنشاء ATA

​

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

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
    microLamports: 50_000,   // رسم الأولوية لكل 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 — معاملات swap المدمجة على الخادم.
• sdk-api/anchor-idl — إعادة تطبيقات التوليد مباشرة من IDLs البرنامج.
• sdk-api/python-integration — المكافئ Python عبر solana-py.
• integration-guides/priority-fee-tuning — تحديد حجم computeBudgetConfig.

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