أمثلة أكواد CLMM

هذه الصفحة مُترجَمة آليًا بواسطة الذكاء الاصطناعي. النسخة الإنجليزية هي المرجع المعتمد.عرض النسخة الإنجليزية →

الإعداد

npm install @raydium-io/raydium-sdk-v2 @solana/web3.js @solana/spl-token bn.js decimal.js

كل مثال على هذه الصفحة يطابق ملفًا في raydium-sdk-V2-demo/src/clmm، ويظهر رابط GitHub بجوار كل قسم. تُهيَّأ البيئة وفق ملف config.ts.template في مستودع الأمثلة (المصدر)، ويُنصح بضبط disableFeatureCheck: true في أي تكامل غير بسيط:

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

const connection = new Connection(process.env.RPC_URL ?? clusterApiUrl("mainnet-beta"));
const owner = Keypair.fromSecretKey(
  new Uint8Array(JSON.parse(fs.readFileSync(process.env.KEYPAIR!, "utf8"))),
);
const raydium = await Raydium.load({
  owner,
  connection,
  cluster: "mainnet",
  disableFeatureCheck: true,
  blockhashCommitment: "finalized",
});
export const txVersion = TxVersion.V0;

إنشاء CLMM pool

المصدر: src/clmm/createPool.ts

import { PublicKey } from "@solana/web3.js";
import { CLMM_PROGRAM_ID } from "@raydium-io/raydium-sdk-v2";
import BN from "bn.js";
import Decimal from "decimal.js";

const mintA = await raydium.token.getTokenInfo(
  new PublicKey("So11111111111111111111111111111111111111112"));   // wSOL
const mintB = await raydium.token.getTokenInfo(
  new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"));   // USDC

// getClmmConfigs() returns ApiClmmConfigInfo (id is a string). createPool wants
// ClmmConfigInfo, which needs a PublicKey id plus fundOwner/description — convert:
const clmmConfigs = await raydium.api.getClmmConfigs();
const picked = clmmConfigs.find((c) => c.index === 1)!;        // 0.05% tier
const ammConfig = { ...picked, id: new PublicKey(picked.id), fundOwner: "", description: "" };

const initialPrice = new Decimal(160);        // 160 USDC per SOL
const { execute, extInfo } = await raydium.clmm.createPool({
  programId: CLMM_PROGRAM_ID,
  mint1:     mintA,
  mint2:     mintB,
  ammConfig,
  initialPrice,
  txVersion: TxVersion.V0,   // no `startTime` — CreateConcentratedPool has no such field
});

const { txId } = await execute({ sendAndConfirm: true });
console.log("Pool:", extInfo.address.id, "tx:", txId);   // already a base58 string

يقوم الـ SDK بما يلي:

يرتّب mint1 وmint2 حسب ترتيب البايتات قبل الاشتقاق.
يحسب sqrt_price_x64 = floor(sqrt(initialPrice × 10^(dB−dA)) × 2^64).
ينشئ حسابي observation وtick_array_bitmap_extension.
يدفع رسوم إنشاء الـ pool المحددة في ammConfig.

فتح position ضمن نطاق مختار

المصدر: src/clmm/createPosition.ts

import { PoolUtils, TickUtil } from "@raydium-io/raydium-sdk-v2";

const POOL_ID = "<POOL_ID>";   // base58 string
// note: CLMM's getPoolInfoFromRpc returns `rpcPoolInfo`, not `rpcData` (CPMM's does)
const { poolInfo, poolKeys, rpcPoolInfo } = await raydium.clmm.getPoolInfoFromRpc(POOL_ID);

// Choose a price range. Here: ±10% of current.
const currentPrice = new Decimal(poolInfo.price);
const lowerPrice   = currentPrice.mul(0.9);
const upperPrice   = currentPrice.mul(1.1);

// Snap to valid ticks for this pool's tick_spacing.
// The class is TickUtil (singular), and it takes decimals + tickSpacing, not poolInfo.
const { tick: tickLower } = TickUtil.getPriceAndTick({
  price: lowerPrice,
  mintADecimals: poolInfo.mintA.decimals,
  mintBDecimals: poolInfo.mintB.decimals,
  zeroForOne: true,
  tickSpacing: poolInfo.config.tickSpacing,
});
const { tick: tickUpper } = TickUtil.getPriceAndTick({
  price: upperPrice,
  mintADecimals: poolInfo.mintA.decimals,
  mintBDecimals: poolInfo.mintB.decimals,
  zeroForOne: true,
  tickSpacing: poolInfo.config.tickSpacing,
});

// How much of each token to deposit.
const inputAmount = new BN(10_000_000);  // 0.01 SOL

// getLiquidityAmountOutFromAmountIn is async — await it.
const res = await PoolUtils.getLiquidityAmountOutFromAmountIn({
  poolInfo,
  slippage: 0.01,
  inputA: true,
  tickUpper,
  tickLower,
  amount: inputAmount,
  add: true,
  amountHasFee: true,
  epochInfo: await raydium.fetchEpochInfo(),
});

const { execute } = await raydium.clmm.openPositionFromBase({
  poolInfo,
  poolKeys,
  tickUpper,
  tickLower,
  base: "MintA",
  ownerInfo: { useSOLBalance: true },
  baseAmount: inputAmount,
  otherAmountMax: res.amountSlippageB.amount,
  txVersion: TxVersion.V0,
});

const { txId } = await execute({ sendAndConfirm: true });
console.log("Position opened, tx:", txId);

يحسب الـ SDK الـ tick arrays التي يمسّها النطاق ويمررها كحسابات. ولا حاجة إلى إرفاق أي تعليمة تهيئة، إذ لا توجد تعليمة init-tick-array؛ فـ OpenPosition* يخصّص الـ tick array المفقودة بنفسه على حساب الدافع.

زيادة السيولة في position موجود

المصدر: src/clmm/increaseLiquidity.ts

const positionNftMint = new PublicKey("<POSITION_NFT_MINT>");

// There is no getPositionInfo — enumerate the wallet's positions and pick one.
const allPositions = await raydium.clmm.getOwnerPositionInfo({
  programId: poolInfo.programId,
});
const positionAccount = allPositions.find((p) => p.nftMint.equals(positionNftMint));
if (!positionAccount) throw new Error("position not found for this wallet");

const { execute } = await raydium.clmm.increasePositionFromBase({
  poolInfo,
  ownerPosition: positionAccount,
  ownerInfo: { useSOLBalance: true },   // required
  base: "MintA",
  baseAmount: new BN(5_000_000),
  otherAmountMax: new BN(1_000_000_000),
  txVersion: TxVersion.V0,              // no poolKeys member on this call
});

await execute({ sendAndConfirm: true });

تقليل السيولة (وجمع الرسوم في الوقت نفسه)

المصدر: src/clmm/decreaseLiquidity.ts وsrc/clmm/closePosition.ts

const { execute } = await raydium.clmm.decreaseLiquidity({
  poolInfo,
  poolKeys,
  ownerPosition: positionAccount,
  ownerInfo: {                       // required; closePosition lives in here
    useSOLBalance: true,
    closePosition: false,
  },
  liquidity: positionAccount.liquidity.divn(2),   // halve
  amountMinA: new BN(0),
  amountMinB: new BN(0),
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });

لجمع الرسوم والمكافآت فقط، استدعِ decreaseLiquidity بقيمة liquidity = new BN(0). أثر هذه التعليمة هو تسوية token_fees_owed_{0,1} وreward_amount_owed ونقلها إلى الخارج، وهذه هي الطريقة الوحيدة لجمع أيٍّ منهما. ولإغلاق الـ position نهائيًا بعد تصفير السيولة والرسوم، مرّر ownerInfo: { closePosition: true } في الاستدعاء الأخير لـ decreaseLiquidity. عندها يُلحق الـ SDK تعليمة ClosePosition ويحرق الـ NFT.

مراكز المُصدِر المقيَّد تتطلب بانيَ إغلاق متوافقًا. لهذه المراكز حساب رمز NFT مجمّد. يجب أن تُلحق ClosePosition معرّفَ الـ pool الخاص بالمركز كأول حساب متبقٍّ، حتى يتمكن CLMM من فكّ تجميد الحساب قبل حرقه. لا يتضمن فرع الكود المصدري للبرنامج أي تغيير في الـ SDK. تأكد من أن إصدار الـ SDK لديك يدعم مسار الإغلاق للحسابات المجمّدة صراحةً قبل تفعيل إنشاء مراكز المُصدِر المقيَّد.

بالنسبة إلى عميل Anchor مباشر، أبقِ الحسابات المعلنة دون تغيير، وأضف الـ pool في النهاية:

// CLMM program: see reference/program-addresses; source ecb1577;
// Solana mainnet-beta; last verified 2026-08-13.
await program.methods
  .closePosition()
  .accounts({
    nftOwner,
    positionNftMint,
    positionNftAccount,
    personalPosition,
    systemProgram: SystemProgram.programId,
    tokenProgram: positionNftTokenProgram,
  })
  .remainingAccounts([
    { pubkey: poolId, isWritable: false, isSigner: false },
  ])
  .rpc();

يمكنك تمرير poolId في كل عملية إغلاق. لا يقرؤه CLMM إلا عندما يكون positionNftAccount مجمّدًا، ما يُبقي مسار عميل واحد متوافقًا مع المراكز القديمة والجديدة.

جمع المكافأة (المكافآت)

المصدر: src/clmm/harvestAllRewards.ts

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

const { execute } = await raydium.clmm.harvestAllRewards({
  ownerInfo: { useSOLBalance: true },
  allPoolInfo: { [poolInfo.id]: poolInfo },
  allPositions: { [poolInfo.id]: [positionAccount] },
  programId: CLMM_PROGRAM_ID,
  txVersion: TxVersion.V0,
});

// harvestAllRewards is a MULTI-transaction builder: `sequentially` is required
// and the result is `txIds`, not `txId`.
const { txIds } = await execute({ sequentially: true });

يمرّ harvestAllRewards على كل position في كل pool تُمرَّر إليه، ويجمّع استدعاءات DecreaseLiquidity ذات السيولة الصفرية التي تسوّي الرسوم والمكافآت (إضافةً إلى أي UpdateRewardInfos)، ثم يوزّعها على عدة معاملات عند الحاجة.

المبادلة (Swap)

المصدر: src/clmm/swap.ts يعكس هذا المثال الملف src/clmm/swap.ts، إذ يحاكي العملية باستخدام swapInternal بدلًا من PoolUtils.computeAmountOutFormat.

import {
  swapInternal,
  getPdaExBitmapAccount,
  TickArrayBitmapExtensionLayout,
  CLMM_PROGRAM_ID,
} from "@raydium-io/raydium-sdk-v2";

const amountIn   = new BN(10_000_000);
const zeroForOne = true;             // swap A (SOL) → B (USDC)

const poolIdPub = new PublicKey(poolInfo.id);
const { rpcData, tickArrays, configInfo } =
  await raydium.clmm.getSwapPoolInfo(poolInfo.id, zeroForOne);

const exBitmap = getPdaExBitmapAccount(CLMM_PROGRAM_ID, poolIdPub).publicKey;
const exBitmapInfo = await raydium.connection.getAccountInfo(exBitmap);

const simulation = swapInternal({
  programId: CLMM_PROGRAM_ID,
  poolId: poolIdPub,
  poolInfo: rpcData,
  tickArrays,
  configInfo,
  tickarrayBitmapExtension: TickArrayBitmapExtensionLayout.decode(exBitmapInfo!.data),
  amountSpecified: amountIn,
  sqrtPriceLimitX64: new BN(0),
  zeroForOne,
  isBaseInput: true,               // false for exact-output
  blockTimestamp: Math.floor(Date.now() / 1000),
  includeExtraTickArrays: true,
});

const { execute } = await raydium.clmm.swap({
  poolInfo,
  poolKeys,
  inputMint: poolInfo.mintA.address,
  amountIn,
  amountOutMin: simulation.amountCalculated,
  observationId: rpcData.observationId,
  ownerInfo: { useSOLBalance: true },   // required
  remainingAccounts: simulation.accounts,
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });

تُجري المحاكاة مسار عبور خريطة الـ tick خارج السلسلة (off-chain) باستخدام المنطق نفسه الموجود في البرنامج على السلسلة، وتُعيد الكمية الناتجة (amountCalculated) إضافةً إلى قائمة الحسابات الدقيقة التي ستلمسها عملية المبادلة (accounts). مرِّر دائمًا remainingAccounts التي تُعيدها المحاكاة: إذا كانت الحسابات أقل من المطلوب فستفشل المبادلة في منتصف المسار مع NotEnoughTickArrayAccount، أما الحسابات الزائدة أو القديمة فتستهلك وحدات الحوسبة دون فائدة.

ما زال PoolUtils.computeAmountOutFormat موجودًا، لكنه يتطلب ComputeClmmPoolInfo (وهو computePoolInfo القادم من getPoolInfoFromRpc، وليس كائن pool من الـ API)، إضافةً إلى معاملين إلزاميين آخرين هما tickarrayBitmapExtension وblockTimestamp. كما أنه لا توجد طريقة raydium.clmm.fetchTickArrays، فـ fetchTickArrays دالة مستقلة، والمساعدات على مستوى الوحدة هي PoolUtils.fetchMultiplePoolTickArrays والـ tickData / tickArrays التي يُعيدها getPoolInfoFromRpc.

إنشاء مجمّع CLMM قابل للتخصيص

createCustomizablePool هي نقطة الدخول التي تتيح تفعيل الرسوم الديناميكية ورسوم الجانب الواحد عند إنشاء المجمّع. تأخذ الشكل نفسه الذي تأخذه createPool، مع إضافتين:

import { CLMM_PROGRAM_ID, CollectFeeOn } from "@raydium-io/raydium-sdk-v2";

const dynamicFeeConfigs = await raydium.api.getClmmDynamicConfigs();    // GET /main/clmm-dynamic-config
const dynamicFeeConfig  = dynamicFeeConfigs.find((c) => c.index === 0); // pick a calibration tier

const { execute, extInfo } = await raydium.clmm.createCustomizablePool({
  programId: CLMM_PROGRAM_ID,
  mint1:     mintA,
  mint2:     mintB,
  ammConfig,
  initialPrice,
  // The two additions:
  collectFeeOn:      CollectFeeOn.TokenOnlyB,   // FromInput | TokenOnlyA | TokenOnlyB
  dynamicFeeConfig:  new PublicKey(dynamicFeeConfig!.id),
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });
console.log("Customizable pool:", extInfo.address.id);   // base58 string

لا توجد معلمة enableDynamicFee ولا dynamicFeeConfigId، ولا startTime. تفعيل الرسوم الديناميكية يتم بتمرير dynamicFeeConfig — إذا حذفته ستحصل على مجمّع برسوم ثابتة دون أي خطأ. كما تجدر الإشارة إلى أن أعضاء التعداد (enum) في الـ SDK هي TokenOnlyA / TokenOnlyB، بينما يكتبها تعداد Rust على السلسلة Token0Only / Token1Only؛ والقيم العددية متطابقة (FromInput = 0).

تبقى createPool تعمل للمسار ذي الرسوم الافتراضية دون رسوم ديناميكية. استخدم createCustomizablePool متى احتجت أيًّا من الخيارين. راجع products/clmm/instructions للاطلاع على قائمة الحسابات على السلسلة.

أوامر الحدّ (Limit orders)

أمر الحدّ يحجز مدخلات المستخدم عند tick واحد، ويُنفَّذ وفق مبدأ FIFO عندما تعبر عملية مبادلة ذلك الـ tick. تُرسَل المخرجات إلى ATA المالك عند التسوية، ولا يلزم أن يكون المالك متصلًا كي يُنفَّذ أمره.

فتح أمر حدّ

لا يوجد حساب إعدادات لأوامر الحدّ لكل مجمّع، ولا دالة getClmmLimitOrderConfigs() — الأوامر مُفهرسة حسب الـ tick.

import {
  getOrderTick,
  getPdaExBitmapAccount,
  CLMM_PROGRAM_ID,
} from "@raydium-io/raydium-sdk-v2";

const { poolInfo, rpcData } = await raydium.clmm.getSimplePoolInfo(POOL_ID);

// Limit price MUST be quantized to tick_spacing — getOrderTick does that.
const targetPrice = new Decimal(180);                              // sell SOL at 180 USDC
const orderData = getOrderTick({
  baseIn: true,                                                    // selling mintA
  mintADecimal: poolInfo.mintA.decimals,
  mintBDecimal: poolInfo.mintB.decimals,
  tickSpacing: poolInfo.config.tickSpacing,
  price: targetPrice,
});

// A sell order must sit above the current tick; a buy order below it.
if (orderData.tick < rpcData.tickCurrent) throw new Error("sell price must be > current price");

const { execute, extInfo } = await raydium.clmm.openLimitOrder({
  poolInfo,
  baseIn: true,
  orderTick: orderData.tick,
  amount: new BN(50_000_000),                // 0.05 SOL
  tickArrayBitmap: getPdaExBitmapAccount(
    CLMM_PROGRAM_ID,
    new PublicKey(poolInfo.id),
  ).publicKey,
  // noneIndex: 0,                           // optional, defaults to 0
  txVersion: TxVersion.V0,
});

const { txId } = await execute({ sendAndConfirm: true });
console.log("Limit order opened:", extInfo.limitOrder.toBase58(), "tx:", txId);

يشتق SDK الـ PDA الخاص بـ LimitOrderState من (owner, nonce PDA, order nonce)، ويرفع LimitOrderNonce الخاص بكل محفظة، ويُدرج الأمر في طابور FIFO عند ذلك الـ tick.

زيادة / تقليل أمر مفتوح

const limitOrder = new PublicKey("<LIMIT_ORDER_PDA>");

await raydium.clmm.increaseLimitOrder({
  poolInfo,
  limitOrder,
  amount: new BN(20_000_000),
  txVersion: TxVersion.V0,
}).then((b) => b.execute({ sendAndConfirm: true }));

await raydium.clmm.decreaseLimitOrder({
  poolInfo,
  limitOrder,
  amount: new BN(10_000_000),
  slippage: 100,                 // optional; DecreaseLimitOrder adds this over Increase
  txVersion: TxVersion.V0,
}).then((b) => b.execute({ sendAndConfirm: true }));

لا يمكن لـ decreaseLimitOrder أن يقتطع إلا من الجزء غير المنفَّذ من الأمر، أما الجزء المنفَّذ فيبقى مقفلًا حتى التسوية. وتفشل كلتا التعليمتين بالخطأ InvalidOrderPhase إذا كان الأمر منفَّذًا بالكامل.

تسوية أمر منفَّذ

// settleLimitOrder takes ONLY the order PDA — no poolInfo, no poolKeys.
await raydium.clmm.settleLimitOrder({
  limitOrder,
  txVersion: TxVersion.V0,
}).then((b) => b.execute({ sendAndConfirm: true }));

تقرأ settleLimitOrder القيمة unfilled_ratio_x64 الخاصة بالأمر مقارنةً بمتتبّع الطابور، وتحسب المخرجات المنفَّذة، ثم تحوّلها إلى ATA المالك. يستطيع المالك استدعاء هذه الدالة بنفسه، كما يستطيع limit_order_admin (وهو مشغّل تشغيلي خارج السلسلة) استدعاءها نيابةً عنه، وتبقى المخرجات من نصيب المالك في كل الأحوال. لإغلاق الأوامر المسوّاة بالكامل واسترداد الإيجار (rent)، استخدم closeLimitOrder (لأمر واحد) أو closeAllLimitOrder (دفعةً واحدة). ولتسوية عدد كبير من الأوامر دفعةً واحدة، تقوم settleAllLimitOrder بتجميع أكبر عدد ممكن من استدعاءات SettleLimitOrder في معاملة v0 واحدة.

عرض الأوامر المعلّقة لمحفظة (خارج السلسلة)

// API helper. See api-reference/temp-api-v1.
const active = await fetch(
  `https://temp-api-v1.raydium.io/limit-order/order/list?wallet=<your-wallet-pubkey>`,
).then((r) => r.json());

تُعيد نقطة الـ API الخاصة بالأوامر النشطة الأوامر غير المنفَّذة والمنفَّذة جزئيًا في حمولة واحدة (وتُميّز الحقول totalAmount وfilledAmount وpendingSettle بين المراحل). أما سجل الأوامر المغلقة فيُستخرج من /limit-order/history/order/list-by-user?wallet=… (لكل محفظة، مع ترقيم الصفحات عبر nextPageId)، وأما سجل الأحداث الكامل لأمر بعينه فيُستخرج من /limit-order/history/event/list-by-pda?pda=….

هيكل استدعاء CPI بلغة Rust

// Cargo.toml — `master` pins anchor-lang =1.0.2.
// anchor-lang  = "=1.0.2"   // must match what raydium-clmm pins
// anchor-spl   = "=1.0.2"
// raydium-clmm = { git = "https://github.com/raydium-io/raydium-clmm",
//                  branch = "master", features = ["cpi"] }
//
// Same Anchor line as the CPMM sample in products/cpmm/code-demos, so both
// CPI crates can be dependencies of one program.

use anchor_lang::prelude::*;
use raydium_clmm::cpi;
use raydium_clmm::program::RaydiumClmm;
use raydium_clmm::cpi::accounts::SwapSingleV2;   // `SwapV2` is the instruction name,
                                                 // `SwapSingleV2` is the accounts struct

#[derive(Accounts)]
pub struct ProxyClmmSwap<'info> {
    #[account(mut)]
    pub payer: Signer<'info>,
    /// CHECK:
    pub amm_config: UncheckedAccount<'info>,
    #[account(mut)]
    /// CHECK:
    pub pool_state: UncheckedAccount<'info>,
    #[account(mut)]
    /// CHECK:
    pub input_token_account: UncheckedAccount<'info>,
    #[account(mut)]
    /// CHECK:
    pub output_token_account: UncheckedAccount<'info>,
    #[account(mut)]
    /// CHECK:
    pub input_vault: UncheckedAccount<'info>,
    #[account(mut)]
    /// CHECK:
    pub output_vault: UncheckedAccount<'info>,
    #[account(mut)]
    /// CHECK:
    pub observation_state: UncheckedAccount<'info>,
    /// CHECK:
    pub token_program: UncheckedAccount<'info>,
    /// CHECK:
    pub token_program_2022: UncheckedAccount<'info>,
    /// CHECK:
    pub memo_program: UncheckedAccount<'info>,
    /// CHECK:
    pub input_vault_mint: UncheckedAccount<'info>,
    /// CHECK:
    pub output_vault_mint: UncheckedAccount<'info>,
    pub clmm_program: Program<'info, RaydiumClmm>,
    // `remaining_accounts` carries the tick_array and bitmap_extension accounts.
}

pub fn proxy_swap<'info>(
    ctx: Context<'info, ProxyClmmSwap<'info>>,
    amount: u64,
    other_amount_threshold: u64,
    sqrt_price_limit_x64: u128,
    is_base_input: bool,
) -> Result<()> {
    let cpi_accounts = SwapSingleV2 {
        payer:                 ctx.accounts.payer.to_account_info(),
        amm_config:            ctx.accounts.amm_config.to_account_info(),
        pool_state:            ctx.accounts.pool_state.to_account_info(),
        input_token_account:   ctx.accounts.input_token_account.to_account_info(),
        output_token_account:  ctx.accounts.output_token_account.to_account_info(),
        input_vault:           ctx.accounts.input_vault.to_account_info(),
        output_vault:          ctx.accounts.output_vault.to_account_info(),
        observation_state:     ctx.accounts.observation_state.to_account_info(),
        token_program:         ctx.accounts.token_program.to_account_info(),
        token_program_2022:    ctx.accounts.token_program_2022.to_account_info(),
        memo_program:          ctx.accounts.memo_program.to_account_info(),
        input_vault_mint:      ctx.accounts.input_vault_mint.to_account_info(),
        output_vault_mint:     ctx.accounts.output_vault_mint.to_account_info(),
    };
    // Anchor 1.0 takes the program's Pubkey here, not its AccountInfo. On the
    // 0.32 `master` branch this was `ctx.accounts.clmm_program.to_account_info()`.
    let cpi_ctx = CpiContext::new(*ctx.accounts.clmm_program.key, cpi_accounts)
        .with_remaining_accounts(ctx.remaining_accounts.to_vec());
    cpi::swap_v2(cpi_ctx, amount, other_amount_threshold, sqrt_price_limit_x64, is_base_input)
}

ترتيب الحسابات المتبقية لـ SwapV2:

[tick_array_bitmap_extension?, tick_array_0, tick_array_1, …]

إذا لم تحتج المبادلة إلى الامتداد (extension) أصلًا فاحذفه، وإلا فسيكون أول حساب متبقٍّ.

المزالق الشائعة

نقاط نهاية الـtick غير متوافقة مع الـspacing → TickAndSpacingNotMatch. استخدم دائمًا TickUtil.getPriceAndTick للتقريب (بصيغة المفرد TickUtil).
عدم كفاية مصفوفات الـtick المُمرَّرة في SwapV2 → NotEnoughTickArrayAccount. اجلب القائمة من swapInternal(...).accounts.
position بنطاق كامل دون امتداد الـbitmap → يجب أن يكون PDA الخاص بالامتداد قابلاً للكتابة، ويتولى الـSDK ذلك تلقائيًا.
الخلط بين sqrt_price_x64 وprice → الخطأ بعامل 2 هنا مؤلم بشكل خاص. عند الشك، دع الـSDK يحسب القيمة انطلاقًا من سعر مقروء للإنسان.
جمع المكافآت بإفراط → كل عملية جمع هي DecreaseLiquidity بسيولة صفرية وتكلّف معاملة واحدة. اجمعها دفعة واحدة عبر harvestAllRewards على عدة positions، وتذكّر أن execute الخاص بها يحتاج إلى { sequentially: true }.
إغلاق حسابات الـNFT يدويًا → ClosePosition يحرق الـNFT ويغلق الـATA الخاص به. كما يغلق mint الخاص بـNFT من نوع Token-2022، أما mint من نوع SPL Token الكلاسيكي فيبقى بعرض صفري لأن ذلك البرنامج لا يستطيع إغلاق الـmints. لا تغلق الحسابات المدعومة بشكل منفصل، وإلا فستفشل التعليمة وتتراجع.
فتح أمر حد عند tick غير متوافق مع الـspacing → TickAndSpacingNotMatch. قرِّب القيمة دائمًا عبر دالة المساعدة المصدَّرة getOrderTick.
استدعاء decreaseLimitOrder على أمر مُنفَّذ بالكامل → InvalidOrderPhase. استخدم settleLimitOrder ثم closeLimitOrder بدلًا من ذلك.
توقّع علامة enableDynamicFee → لا وجود لها. حذف dynamicFeeConfig ينشئ ببساطة pool برسوم ثابتة، بصمت ودون أي خطأ. إن أردت رسومًا ديناميكية، فمرِّر الـPublicKey الخاص بحساب الإعدادات، واختره من /main/clmm-dynamic-config.

إلى أين تذهب بعد ذلك

sdk-api/typescript-sdk — واجهة الـSDK الكاملة.
sdk-api/rest-api — نقاط نهاية عروض الأسعار وبيانات الـpool.
user-flows/create-clmm-pool — شرح بدون كود خطوة بخطوة.
integration-guides/aggregator — توجيه CLMM ضمن مسار التبادل.

المصادر:

Products

Algorithms

أمثلة أكواد CLMM

الإعداد

إنشاء CLMM pool

فتح position ضمن نطاق مختار

زيادة السيولة في position موجود

تقليل السيولة (وجمع الرسوم في الوقت نفسه)

جمع المكافأة (المكافآت)

المبادلة (Swap)

إنشاء مجمّع CLMM قابل للتخصيص

أوامر الحدّ (Limit orders)

فتح أمر حدّ

زيادة / تقليل أمر مفتوح

تسوية أمر منفَّذ

عرض الأوامر المعلّقة لمحفظة (خارج السلسلة)

هيكل استدعاء CPI بلغة Rust

المزالق الشائعة

إلى أين تذهب بعد ذلك

​الإعداد

​إنشاء CLMM pool

​فتح position ضمن نطاق مختار

​زيادة السيولة في position موجود

​تقليل السيولة (وجمع الرسوم في الوقت نفسه)

​جمع المكافأة (المكافآت)

​المبادلة (Swap)

​إنشاء مجمّع CLMM قابل للتخصيص

​أوامر الحدّ (Limit orders)

​فتح أمر حدّ

​زيادة / تقليل أمر مفتوح

​تسوية أمر منفَّذ

​عرض الأوامر المعلّقة لمحفظة (خارج السلسلة)

​هيكل استدعاء CPI بلغة Rust

​المزالق الشائعة

​إلى أين تذهب بعد ذلك

الإعداد

إنشاء CLMM pool

فتح position ضمن نطاق مختار

زيادة السيولة في position موجود

تقليل السيولة (وجمع الرسوم في الوقت نفسه)

جمع المكافأة (المكافآت)

المبادلة (Swap)

إنشاء مجمّع CLMM قابل للتخصيص

أوامر الحدّ (Limit orders)

فتح أمر حدّ

زيادة / تقليل أمر مفتوح

تسوية أمر منفَّذ

عرض الأوامر المعلّقة لمحفظة (خارج السلسلة)

هيكل استدعاء CPI بلغة Rust

المزالق الشائعة

إلى أين تذهب بعد ذلك