AMM v4 程式碼示例

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

版本標記。 所有示例針對 @raydium-io/raydium-sdk-v2@0.2.64-alpha 在 Solana mainnet-beta 上執行，驗證時間 2026-09-09 — 下方每個建構者名稱、參數名稱和參數類型都已針對該版本的原始碼和 raydium-sdk-V2-demo/src/amm 進行驗證。程式 ID：675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8（見 reference/program-addresses）。最常見的兩個陷阱：computeAmountOut 的 slippage 是純數字（0.005 = 0.5%），不是 Percent；而 liquidity.swap 必須將 inputMint 作為 base58 字串。

本處未展示新池建立。 Raydium UI 不再提供 AMM v4 池建立 — 新交易對預設為 CPMM。AMM v4 程式本身仍接受鏈上 Initialize2；只是不再是推薦路徑。下方示例涵蓋每個整合者仍需的即時池操作：交換、存入、提取。

設定

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" });

按 ID 取得池

import { PublicKey } from "@solana/web3.js";

// `liquidity.getPoolInfoFromRpc` 將池 ID 作為 base58 **字串**，而非 PublicKey。
const poolId = "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2"; // SOL-USDC，見 reference/program-addresses

const data = await raydium.liquidity.getPoolInfoFromRpc({ poolId });
const { poolInfo, poolKeys, poolRpcData } = data;

console.log("交易對：", poolInfo.mintA.symbol, "/", poolInfo.mintB.symbol);
console.log("版本：", poolInfo.version);       // AMM v4 為 4
console.log("市場：", poolKeys.marketId);       // 已是 base58 字串

poolKeys 是指令建構者使用的結構。它按程式預期的順序攜帶每個 AMM v4 帳戶，加上當前程式按位置接受但不再讀取的舊版市場欄位。

交換（固定輸入）

import BN from "bn.js";

const amountIn = new BN(1_000_000);            // 1 USDC（6 位小數報價）
const inputMint = new PublicKey(poolInfo.mintB.address);  // USDC
const slippage  = 0.005;

const computed = raydium.liquidity.computeAmountOut({
  poolInfo,
  amountIn,
  mintIn: inputMint,
  mintOut: new PublicKey(poolInfo.mintA.address),
  slippage,
});

const { execute } = await raydium.liquidity.swap({
  poolInfo,
  poolKeys,
  amountIn,
  amountOut: computed.minAmountOut,
  fixedSide: "in",
  inputMint: poolInfo.mintB.address,   // base58 **字串**，且為必需
  txVersion: TxVersion.V0,
});

const { txId } = await execute({ sendAndConfirm: true });
console.log("交換交易：", txId);

SDK 透過 V2 進入點路由 AMM v4 交換，這些進入點不攜帶 OpenBook 帳戶。（在 2026-07 升級後，市場帳戶即使在舊版 v1 路徑上也不再被驗證。）

交換（固定輸出）

const amountOut = new BN(1_000_000_000);       // 1 SOL（9 位小數基礎）
const slippage  = 0.005;

const computed = raydium.liquidity.computeAmountIn({
  poolInfo,
  amountOut,
  mintOut: new PublicKey(poolInfo.mintA.address),
  mintIn: new PublicKey(poolInfo.mintB.address),
  slippage,
});

const { execute } = await raydium.liquidity.swap({
  poolInfo,
  poolKeys,
  amountIn: computed.maxAmountIn,
  amountOut,
  fixedSide: "out",
  inputMint: poolInfo.mintB.address,   // base58 字串，不是 PublicKey
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });

新增流動性

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

const amountARaw = new BN(100_000_000);        // 0.1 SOL，以基礎單位表示

// computePairAmount 接受 UI 小數字串（或 Decimal）和 Percent —
// 不是 BN 也不是數字 — 且為同步。
const { anotherAmount, maxAnotherAmount, minAnotherAmount } =
  raydium.liquidity.computePairAmount({
    poolInfo,
    amount: "0.1",
    baseIn: true,
    slippage: new Percent(1, 100),
  });

// addLiquidity 接受**三個** TokenAmount；otherAmountMin 為必需。
const { execute } = await raydium.liquidity.addLiquidity({
  poolInfo,
  poolKeys,
  amountInA: new TokenAmount(toToken(poolInfo.mintA), amountARaw),
  amountInB: maxAnotherAmount,
  otherAmountMin: minAnotherAmount,
  fixedSide: "a",
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });

fixedSide: "a" 告訴 SDK 你提供了確切的 amountInA，而 amountInB 應最多為 maxAnotherAmount。按比例數學基於金庫餘額減去累積 PnL 執行 — 不再有任何帳面上的組成部分需要先結算。

移除流動性

const lpAmount = new BN(50_000);               // 要銷毀的 LP

const { execute } = await raydium.liquidity.removeLiquidity({
  poolInfo,
  poolKeys,
  lpAmount,
  baseAmountMin: new BN(0),
  quoteAmountMin: new BN(0),
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });

滑點最小值保護池狀態在你的預報價和著陸時間之間發生變化。

計算單位 / 優先費用調整

自 OpenBook 移除後，AMM v4 交換不再驗證任何市場狀態，因此 V1 SwapBaseIn 比以前便宜得多 — 而 SwapBaseInV2（8 個帳戶，無市場佔位符）更便宜。根據你自己的路徑進行測量，而不是根據歷史數據進行預算，並始終傳遞明確的計算單位限制：

const { execute, transaction } = await raydium.liquidity.swap({
  /* ...params... */
  computeBudgetConfig: {
    units: 400_000,
    microLamports: 50_000,       // 每 CU 的優先費用
  },
});

如果你省略 computeBudgetConfig，SDK 仍可能使用自己的預設值；檢查返回的 transaction 以確認。見 integration-guides/priority-fee-tuning。

直接 Rust CPI

如果你必須從自己的 Anchor 程式 CPI 進入 AMM v4，你需要逐字模型化 SwapBaseIn 的帳戶列表。最小草圖：

use anchor_lang::prelude::*;
use anchor_lang::solana_program::program::invoke_signed;
use anchor_lang::solana_program::instruction::Instruction;

const AMM_V4_PROGRAM_ID: Pubkey = pubkey!("675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8");

#[derive(Accounts)]
pub struct ProxyAmmV4Swap<'info> {
    /// CHECK:
    pub token_program: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub amm:          UncheckedAccount<'info>,
    /// CHECK:
    pub amm_authority: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub amm_open_orders: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub amm_target_orders: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub pool_coin_token_account: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub pool_pc_token_account: UncheckedAccount<'info>,
    /// CHECK:
    pub market_program: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub market: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub market_bids: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub market_asks: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub market_event_queue: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub market_coin_vault: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub market_pc_vault: UncheckedAccount<'info>,
    /// CHECK:
    pub market_vault_signer: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub user_source: UncheckedAccount<'info>,
    #[account(mut)] /// CHECK:
    pub user_dest: UncheckedAccount<'info>,
    pub user_owner: Signer<'info>,
}

pub fn proxy_swap(
    ctx: Context<ProxyAmmV4Swap>,
    amount_in: u64,
    minimum_amount_out: u64,
) -> Result<()> {
    // SwapBaseIn 在 AMM v4 上的指令判別器為 9。
    let mut data = vec![9u8];
    data.extend_from_slice(&amount_in.to_le_bytes());
    data.extend_from_slice(&minimum_amount_out.to_le_bytes());

    let ix = Instruction {
        program_id: AMM_V4_PROGRAM_ID,
        accounts: vec![
            AccountMeta::new_readonly(ctx.accounts.token_program.key(), false),
            AccountMeta::new(ctx.accounts.amm.key(), false),
            AccountMeta::new_readonly(ctx.accounts.amm_authority.key(), false),
            AccountMeta::new(ctx.accounts.amm_open_orders.key(), false),
            AccountMeta::new(ctx.accounts.amm_target_orders.key(), false),
            AccountMeta::new(ctx.accounts.pool_coin_token_account.key(), false),
            AccountMeta::new(ctx.accounts.pool_pc_token_account.key(), false),
            AccountMeta::new_readonly(ctx.accounts.market_program.key(), false),
            AccountMeta::new(ctx.accounts.market.key(), false),
            AccountMeta::new(ctx.accounts.market_bids.key(), false),
            AccountMeta::new(ctx.accounts.market_asks.key(), false),
            AccountMeta::new(ctx.accounts.market_event_queue.key(), false),
            AccountMeta::new(ctx.accounts.market_coin_vault.key(), false),
            AccountMeta::new(ctx.accounts.market_pc_vault.key(), false),
            AccountMeta::new_readonly(ctx.accounts.market_vault_signer.key(), false),
            AccountMeta::new(ctx.accounts.user_source.key(), false),
            AccountMeta::new(ctx.accounts.user_dest.key(), false),
            AccountMeta::new_readonly(ctx.accounts.user_owner.key(), true),
        ],
        data,
    };
    invoke_signed(&ix, &ctx.accounts.to_account_infos(), &[])?;
    Ok(())
}

AMM v4 不提供用於 CPI 的 Anchor crate。上方草圖使用手動構造的 Instruction。

上方 CPI 草圖使用舊版 v1 SwapBaseIn 佈局（標籤 9，17 個帳戶）用於讀取/重現現有交易。自 2026-07 升級後，市場帳戶被接受但被忽略。對於新程式碼，優先使用 SwapBaseInV2 / SwapBaseOutV2（標籤 16 / 17），它們完全移除市場帳戶（和 amm_open_orders）— 僅傳遞 8 個帳戶：token_program、amm、amm_authority、兩個池金庫、兩個使用者代幣帳戶和 user_owner。

陷阱

v1 交換上的帳戶計數錯誤。 舊版 SwapBaseIn / SwapBaseOut 仍需要完整的 17 帳戶（或 18 帳戶）列表 — 不匹配的計數會以 WrongAccountsNumber 回復。市場帳戶的內容不再被驗證，但你仍必須佔據它們的位置。優先使用 V2 進入點以避免此問題。
讀取原始金庫餘額。 準備金現在僅限金庫；減去累積 PnL（need_take_pnl_*）。SDK 報價或 api-v3.raydium.io/pools/info/ids 為你處理此問題。
呼叫已移除的指令。 MonitorStep、MigrateToOpenBook、WithdrawSrm、SimulateInfo、AdminCancelOrders 和舊版 Initialize / PreInitialize 現在會回復。使用 Initialize2 進行池建立；沒有要呼叫的 crank。
Token-2022 mint。 不支援。無法針對 Token-2022 mint 建立 AMM v4 池；任何 Token-2022 交易對應在 CPMM 或 CLMM 上。

後續步驟

products/amm-v4/instructions — 這些示例背後的指令級介面。
user-flows/migrate-amm-v4-to-cpmm — 如果你是考慮遷移的 LP。
integration-guides/priority-fee-tuning — 大量 AMM v4 交換的優先費用調整。

來源：

產品

演算法

設定

按 ID 取得池

交換（固定輸入）

交換（固定輸出）

新增流動性

移除流動性

計算單位 / 優先費用調整

直接 Rust CPI

陷阱

後續步驟

​設定

​按 ID 取得池

​交換（固定輸入）

​交換（固定輸出）

​新增流動性

​移除流動性

​計算單位 / 優先費用調整

​直接 Rust CPI

​陷阱

​後續步驟

設定

按 ID 取得池

交換（固定輸入）

交換（固定輸出）

新增流動性

移除流動性

計算單位 / 優先費用調整

直接 Rust CPI

陷阱

後續步驟