CLMM 程式碼示例

本頁內容由 AI 自動翻譯，所有內容以英文版本為準。查看英文版 →

設定

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 流動性池

來源：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

const ammConfigs = await raydium.api.getClmmConfigs();
const ammConfig  = ammConfigs.find((c) => c.index === 1)!;        // 0.05% tier

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,
  startTime: new BN(0),
  txVersion: TxVersion.V0,
});

const { txId } = await execute({ sendAndConfirm: true });
console.log("Pool:", extInfo.address.id.toBase58(), "tx:", txId);

SDK 會：

在推導前按位元組順序排序 mint1/mint2。
計算 sqrt_price_x64 = floor(sqrt(initialPrice × 10^(dB−dA)) × 2^64)。
建立 observation 和 tick_array_bitmap_extension 帳戶。
支付由 ammConfig 定義的流動性池建立費用。

在選定範圍內開設部位

來源：src/clmm/createPosition.ts

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

const poolId = new PublicKey("<POOL_ID>");
const { poolInfo, poolKeys, rpcData } = await raydium.clmm.getPoolInfoFromRpc(poolId);

// 選擇價格範圍。這裡：當前價格的 ±10%。
const currentPrice = new Decimal(poolInfo.price);
const lowerPrice   = currentPrice.mul(0.9);
const upperPrice   = currentPrice.mul(1.1);

// 對齊到此流動性池 tick_spacing 的有效 tick。
const { tick: tickLower } = TickUtils.getPriceAndTick({
  poolInfo, price: lowerPrice, baseIn: true,
});
const { tick: tickUpper } = TickUtils.getPriceAndTick({
  poolInfo, price: upperPrice, baseIn: true,
});

// 每種代幣的存入金額。
const inputAmount = new BN(10_000_000);  // 0.01 SOL
const inputMint   = poolInfo.mintA.address;

const res = 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 陣列，並在任何未初始化時捆綁 InitTickArray 指令。

增加現有部位的流動性

來源：src/clmm/increaseLiquidity.ts

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

const positionAccount = await raydium.clmm.getPositionInfo({
  nftMint: positionNftMint,
});

const { execute } = await raydium.clmm.increasePositionFromBase({
  poolInfo,
  poolKeys,
  ownerPosition: positionAccount,
  base: "MintA",
  baseAmount: new BN(5_000_000),
  otherAmountMax: new BN(1_000_000_000),
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });

減少流動性（同時收取費用）

來源：src/clmm/decreaseLiquidity.ts 和 src/clmm/closePosition.ts

const { execute } = await raydium.clmm.decreaseLiquidity({
  poolInfo,
  poolKeys,
  ownerPosition: positionAccount,
  liquidity: positionAccount.liquidity.divn(2),   // 減半
  amountMinA: new BN(0),
  amountMinB: new BN(0),
  closePosition: false,
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });

若要僅收取費用，呼叫 decreaseLiquidity 並設定 liquidity = new BN(0)。該指令的副作用是結算 tokens_fees_owed_{0,1} 並轉出它們。若要在流動性和費用歸零後完全關閉部位，在最後的 decreaseLiquidity 呼叫中傳遞 closePosition: true。SDK 會附加 ClosePosition 並銷毀 NFT。

受限發行人部位需要相容的關閉建構器。 這些部位有凍結的 NFT 代幣帳戶。ClosePosition 必須將部位的流動性池 ID 附加為第一個剩餘帳戶，以便 CLMM 在銷毀前解凍帳戶。程式來源分支不包含 SDK 變更。在啟用受限發行人部位建立前，請確認你的 SDK 版本明確支援凍結關閉路徑。

對於直接 Anchor 用戶端，保持宣告的帳戶不變並附加流動性池：

// CLMM 程式：見 reference/program-addresses；來源 ecb1577；
// Solana mainnet-beta；最後驗證於 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

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

await execute({ sendAndConfirm: true });

harvestAllRewards 遍歷傳入的每個流動性池上的每個部位，批次處理 CollectReward（和任何 UpdateRewardInfos）指令，並在需要時將它們分割到多個交易中。

交換

來源：src/clmm/swap.ts

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

const amountIn = new BN(10_000_000);
const baseIn   = true;               // 交換 A (SOL) → B (USDC)
const slippage = 0.005;

const { minAmountOut, remainingAccounts, priceImpact } =
  PoolUtils.computeAmountOutFormat({
    poolInfo,
    tickArrayCache: await raydium.clmm.fetchTickArrays({ poolInfo }),
    amountIn,
    tokenOut: poolInfo.mintB,
    slippage,
    epochInfo: await raydium.fetchEpochInfo(),
  });

const { execute } = await raydium.clmm.swap({
  poolInfo,
  poolKeys,
  inputMint: new PublicKey(poolInfo.mintA.address),
  amountIn,
  amountOutMin: minAmountOut.amount,
  observationId: poolKeys.observationId,
  remainingAccounts,
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });

computeAmountOutFormat 使用與鏈上程式相同的邏輯離線遍歷 tick 地圖，並返回：

預期輸出金額，
滑點後的最小輸出金額，
實際交換將涉及的 tick 陣列帳戶列表（remainingAccounts）。

始終傳遞模擬返回的 remainingAccounts：如果傳遞太少，交換會在遍歷中途以 TickArrayNotFound 回復；如果傳遞過時的，會浪費計算。

建立可自訂的 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); // 選擇一個校準層級

const { execute, extInfo } = await raydium.clmm.createCustomizablePool({
  programId: CLMM_PROGRAM_ID,
  mint1:     mintA,
  mint2:     mintB,
  ammConfig,
  initialPrice,
  startTime: new BN(0),
  // 新欄位：
  collectFeeOn:        CollectFeeOn.Token1Only,   // 0 = FromInput, 1 = Token0Only, 2 = Token1Only
  enableDynamicFee:    true,
  dynamicFeeConfigId:  dynamicFeeConfig?.id,      // 當 enableDynamicFee 為 false 時省略
  txVersion: TxVersion.V0,
});

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

createPool 繼續用於預設費用、無限價訂單、無動態費用的路徑。當你需要三個新開關中的任何一個時，使用 createCustomizablePool。詳見 products/clmm/instructions 的鏈上帳戶列表。

限價訂單

限價訂單在單個 tick 處停泊使用者輸入，當交換穿過該 tick 時按 FIFO 方式成交。輸出在結算時推送到所有者的 ATA；所有者無需在線即可成交。

開設限價訂單

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

const limitConfigs = await raydium.api.getClmmLimitOrderConfigs(); // GET /main/clmm-limit-order-config
const limitConfig  = limitConfigs.find((c) => c.poolId === poolInfo.id);

// 限價必須量化到 tick_spacing。
const targetPrice = new Decimal(180);                              // 以 180 USDC 賣出 SOL
const { tick: limitTick } = TickUtils.getPriceAndTick({
  poolInfo, price: targetPrice, baseIn: true,
});

const { execute } = await raydium.clmm.openLimitOrder({
  poolInfo,
  poolKeys,
  limitOrderConfig: limitConfig,
  inputMint: poolInfo.mintA.address,         // 賣出 SOL
  inputAmount: new BN(50_000_000),           // 0.05 SOL
  tick: limitTick,
  txVersion: TxVersion.V0,
});

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

SDK 從 (pool, owner, tick, nonce) 推導 LimitOrderState PDA，遞增每個 (pool, owner) 的 LimitOrderNonce，並將訂單插入該 tick 的 FIFO 隊列。

增加/減少開放訂單

await raydium.clmm.increaseLimitOrder({
  poolInfo,
  poolKeys,
  limitOrderId: <LIMIT_ORDER_PUBKEY>,
  addAmount: new BN(20_000_000),
  txVersion: TxVersion.V0,
}).then((b) => b.execute({ sendAndConfirm: true }));

await raydium.clmm.decreaseLimitOrder({
  poolInfo,
  poolKeys,
  limitOrderId: <LIMIT_ORDER_PUBKEY>,
  removeAmount: new BN(10_000_000),
  txVersion: TxVersion.V0,
}).then((b) => b.execute({ sendAndConfirm: true }));

decreaseLimitOrder 只能從訂單的未成交部分移除；成交部分被鎖定直到結算。如果訂單已完全成交，兩個指令都會以 InvalidOrderPhase 回復。

結算已成交訂單

await raydium.clmm.settleLimitOrder({
  poolInfo,
  poolKeys,
  limitOrderId: <LIMIT_ORDER_PUBKEY>,
  txVersion: TxVersion.V0,
}).then((b) => b.execute({ sendAndConfirm: true }));

settleLimitOrder 根據隊列追蹤器讀取訂單的 unfilled_ratio_x64，計算成交輸出，並將其轉移到所有者的 ATA。所有者可以自己呼叫此方法；limit_order_admin（離線操作管理員）也可以代表所有者呼叫它 — 輸出仍然進入所有者。若要關閉完全結算的訂單以恢復租金，使用 closeLimitOrder（單個）或 closeAllLimitOrder（批次）。若要同時結算許多訂單，settleAllLimitOrder 將盡可能多的 SettleLimitOrder 呼叫打包到 v0 交易中。

列出錢包的停泊訂單（離線）

// API 幫助程式。見 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());

活躍訂單端點在一個負載中返回未成交和部分成交的訂單（totalAmount / filledAmount / pendingSettle 區分各階段）。對於已關閉訂單歷史，使用 /limit-order/history/order/list-by-user?wallet=…（按錢包，按 nextPageId 分頁）；對於特定訂單的完整事件日誌，使用 /limit-order/history/event/list-by-pda?pda=…。

Rust CPI 骨架

use anchor_lang::prelude::*;
use raydium_amm_v3::cpi;
use raydium_amm_v3::program::AmmV3;
use raydium_amm_v3::cpi::accounts::SwapV2;

#[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, AmmV3>,
    // `remaining_accounts` 攜帶 tick_array 和 bitmap_extension 帳戶。
}

pub fn proxy_swap(
    ctx: Context<ProxyClmmSwap>,
    amount: u64,
    other_amount_threshold: u64,
    sqrt_price_limit_x64: u128,
    is_base_input: bool,
) -> Result<()> {
    let cpi_accounts = SwapV2 {
        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(),
    };
    let cpi_ctx = CpiContext::new(ctx.accounts.clmm_program.to_account_info(), 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, …]

如果交換永遠不需要擴展，省略它；否則它是第一個剩餘帳戶。

常見陷阱

非對齊 tick 端點 → InvalidTickIndex。始終透過 TickUtils.getPriceAndTick 對齊。
SwapV2 中提供的 tick 陣列不足 → TickArrayNotFound。使用 computeAmountOutFormat 取得完整列表。
沒有 bitmap 擴展的全範圍部位 → 擴展 PDA 必須可寫；SDK 會自動處理。
將 sqrt_price_x64 誤認為 price → 這裡的因子 2 混淆特別痛苦。有疑問時，讓 SDK 從人類可讀的價格計算。
過於急切地收取獎勵 → 每次收取需要一個交易。透過 harvestAllRewards 跨多個部位批次處理。
自己關閉 NFT 帳戶 → ClosePosition 銷毀 NFT 並關閉其 ATA。它也關閉 Token-2022 NFT 鑄幣；經典 SPL Token 鑄幣保持供應量為零，因為該程式無法關閉鑄幣。不要單獨關閉支援的帳戶，否則指令將回復。
在非對齊 tick 開設限價訂單 → InvalidTickIndex。始終透過 TickUtils.getPriceAndTick 量化。
在完全成交的訂單上呼叫 decreaseLimitOrder → InvalidOrderPhase。改用 settleLimitOrder 然後 closeLimitOrder。
在傳遞 enableDynamicFee: true 時忘記 dynamicFeeConfigId → CreateCustomizablePool 回復是 InvalidDynamicFeeConfigParams。要麼關閉動態費用，要麼從 /main/clmm-dynamic-config 選擇一個設定。

後續步驟

sdk-api/typescript-sdk — 完整 SDK 表面。
sdk-api/rest-api — 報價和流動性池元資料端點。
user-flows/create-clmm-pool — 非程式碼逐步說明。
integration-guides/aggregator — 將 CLMM 路由作為路徑的一部分。

來源：

產品

演算法

設定

建立 CLMM 流動性池

在選定範圍內開設部位

增加現有部位的流動性

減少流動性（同時收取費用）

收取獎勵

交換

建立可自訂的 CLMM 流動性池

限價訂單

開設限價訂單

增加/減少開放訂單

結算已成交訂單

列出錢包的停泊訂單（離線）

Rust CPI 骨架

常見陷阱

後續步驟

​設定

​建立 CLMM 流動性池

​在選定範圍內開設部位

​增加現有部位的流動性

​減少流動性（同時收取費用）

​收取獎勵

​交換

​建立可自訂的 CLMM 流動性池

​限價訂單

​開設限價訂單

​增加/減少開放訂單

​結算已成交訂單

​列出錢包的停泊訂單（離線）

​Rust CPI 骨架

​常見陷阱

​後續步驟

設定

建立 CLMM 流動性池

在選定範圍內開設部位

增加現有部位的流動性

減少流動性（同時收取費用）

收取獎勵

交換

建立可自訂的 CLMM 流動性池

限價訂單

開設限價訂單

增加/減少開放訂單

結算已成交訂單

列出錢包的停泊訂單（離線）

Rust CPI 骨架

常見陷阱

後續步驟