AMM v4 kod örnekleri

Bu sayfa yapay zekâ tarafından otomatik olarak çevrilmiştir. İngilizce sürüm esas alınır.İngilizce sürümü görüntüle →

Sürüm notu. Tüm örnekler @raydium-io/raydium-sdk-v2@0.2.64-alpha sürümünü Solana mainnet-beta’ya karşı hedefler, 2026-09-09 tarihinde doğrulanmıştır — aşağıdaki her builder adı, parametre adı ve parametre türü o sürümün kaynak koduna ve raydium-sdk-V2-demo/src/amm adresine karşı kontrol edilmiştir. Program ID: 675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8 (bkz. reference/program-addresses).Çoğu ilk entegrasyonu tuzağa düşüren iki sorun: computeAmountOut’un slippage parametresi düz bir sayıdır (0.005 = %0.5), Percent değildir; ve liquidity.swap gerekli olarak inputMint’i base58 dizesi olarak alır.

Yeni havuz oluşturma burada gösterilmemektedir. Raydium UI artık AMM v4 havuz oluşturmayı sunmamaktadır — yeni çiftler CPMM varsayılanına ayarlanır. AMM v4 programı kendisi hâlâ zincir üzerinde Initialize2’yi kabul eder; sadece önerilen yol değildir. Aşağıdaki örnekler her entegratörün hâlâ ihtiyaç duyduğu canlı havuz işlemlerini kapsar: swap, deposit, withdraw.

Kurulum

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

Havuzu ID’ye göre getir

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

// `liquidity.getPoolInfoFromRpc` havuz ID'sini base58 DİZESİ olarak alır, PublicKey değil.
const poolId = "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2"; // SOL-USDC, bkz. reference/program-addresses

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

console.log("Çift:", poolInfo.mintA.symbol, "/", poolInfo.mintB.symbol);
console.log("Sürüm:", poolInfo.version);       // AMM v4 için 4
console.log("Market:", poolKeys.marketId);       // zaten base58 dizesi

poolKeys, instruction builder’ların tükettiği yapıdır. Programın beklediği sırada her AMM v4 hesabını, artı mevcut programın konumsal olarak kabul ettiği ancak artık okumadığı eski market alanlarını içerir.

Swap (base-in)

import BN from "bn.js";

const amountIn = new BN(1_000_000);            // 1 USDC (6-ondalak quote)
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 DİZESİ, ve gereklidir
  txVersion: TxVersion.V0,
});

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

SDK, AMM v4 swap’larını V2 giriş noktaları aracılığıyla yönlendirir; bunlar OpenBook hesaplarını taşımaz. (2026-07 yükseltmesinden sonra, market hesapları eski v1 yolunda bile artık doğrulanmaz.)

Swap (base-out)

const amountOut = new BN(1_000_000_000);       // 1 SOL (9-ondalak base)
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 dizesi, PublicKey değil
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });

Likidite ekle

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

const amountARaw = new BN(100_000_000);        // 0.1 SOL, temel birimde

// computePairAmount bir UI-ondalak dizesi (veya Decimal) ve bir Percent alır —
// BN değil ve sayı değil — ve senkrondur.
const { anotherAmount, maxAnotherAmount, minAnotherAmount } =
  raydium.liquidity.computePairAmount({
    poolInfo,
    amount: "0.1",
    baseIn: true,
    slippage: new Percent(1, 100),
  });

// addLiquidity ÜÇ TokenAmount alır; otherAmountMin gereklidir.
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’ya tam amountInA’yı sağladığınızı ve amountInB’nin en fazla maxAnotherAmount olması gerektiğini söyler. Pro-rata matematik kasa bakiyeleri eksi tahakkuk eden PnL’den çalışır — artık önce kapatılacak herhangi bir on-book bileşeni yoktur.

Likiditeyi kaldır

const lpAmount = new BN(50_000);               // Yakılacak 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 });

Slippage minimumları, havuzun durumunun ön-quote’unuz ile iniş zamanı arasında değişmesine karşı koruma sağlar.

Compute-unit / priority fee ayarlaması

OpenBook kaldırılmasından bu yana, bir AMM v4 swap artık herhangi bir market durumunu doğrulamaz, bu nedenle bir V1 SwapBaseIn eskisinden belirgin şekilde daha ucuzdur — ve SwapBaseInV2 (8 hesap, market yer tutucu yok) daha da ucuzdur. Tarihsel rakamlardan bütçe ayırmak yerine kendi yolunuzu ölçün ve her zaman açık bir compute-unit limiti geçin:

const { execute, transaction } = await raydium.liquidity.swap({
  /* ...params... */
  computeBudgetConfig: {
    units: 400_000,
    microLamports: 50_000,       // CU başına priority fee
  },
});

computeBudgetConfig’i atlarsanız, SDK yine de kendi varsayılanını kullanabilir; döndürülen transaction’ı kontrol edin. Bkz. integration-guides/priority-fee-tuning.

Doğrudan Rust CPI

Kendi Anchor programınızdan AMM v4’e CPI yapmanız gerekiyorsa, SwapBaseIn’in hesap listesini tam olarak modellemeniz gerekecektir. Minimal bir taslak:

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 için instruction discriminator AMM v4'te 9'dur.
    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 için bir Anchor crate’i göndermiyor. Yukarıdaki taslak manuel olarak oluşturulmuş bir Instruction kullanır.

Yukarıdaki CPI taslağı eski v1 SwapBaseIn düzeni (tag 9, 17 hesap) kullanır mevcut işlemleri okumak/yeniden üretmek için. 2026-07 yükseltmesinden bu yana market hesapları kabul edilir ancak yoksayılır. Yeni kod için SwapBaseInV2 / SwapBaseOutV2’yi tercih edin (tag 16 / 17), bunlar market hesaplarını (ve amm_open_orders’ı) tamamen bırakır — sadece 8 hesap geçin: token_program, amm, amm_authority, iki havuz kasası, iki kullanıcı token hesabı ve user_owner.

Tuzaklar

v1 swap’larında yanlış hesap sayısı. Eski SwapBaseIn / SwapBaseOut hâlâ tam 17-hesap (veya 18-hesap) listesini gerektirir — uyumsuz bir sayı WrongAccountsNumber ile geri döner. Market hesaplarının içeriği artık doğrulanmaz, ancak yine de onların slotlarını doldurmanız gerekir. Bu sorunu önlemek için V2 giriş noktalarını tercih edin.
Ham kasa bakiyelerini okumak. Rezervler artık sadece kasa; tahakkuk eden PnL’yi çıkarın (need_take_pnl_*). SDK quote’u veya api-v3.raydium.io/pools/info/ids bunu sizin için işler.
Kaldırılan instruction’ları çağırmak. MonitorStep, MigrateToOpenBook, WithdrawSrm, SimulateInfo, AdminCancelOrders ve eski Initialize / PreInitialize artık geri döner. Havuz oluşturma için Initialize2’yi kullanın; çağrılacak crank yoktur.
Token-2022 mint’leri. Desteklenmez. Bir AMM v4 havuzu Token-2022 mint’ine karşı oluşturulamaz; herhangi bir Token-2022 çifti CPMM veya CLMM’de olmalıdır.

Sonraki adımlar

products/amm-v4/instructions — bu örneklerin arkasındaki instruction seviyesi yüzey.
user-flows/migrate-amm-v4-to-cpmm — göç düşünen bir LP iseniz.
integration-guides/priority-fee-tuning — ağır AMM v4 swap’ları için priority-fee boyutlandırması.

Kaynaklar:

Products

Algorithms

Kurulum

Havuzu ID’ye göre getir

Swap (base-in)

Swap (base-out)

Likidite ekle

Likiditeyi kaldır

Compute-unit / priority fee ayarlaması

Doğrudan Rust CPI

Tuzaklar

Sonraki adımlar

​Kurulum

​Havuzu ID’ye göre getir

​Swap (base-in)

​Swap (base-out)

​Likidite ekle

​Likiditeyi kaldır

​Compute-unit / priority fee ayarlaması

​Doğrudan Rust CPI

​Tuzaklar

​Sonraki adımlar

Kurulum

Havuzu ID’ye göre getir

Swap (base-in)

Swap (base-out)

Likidite ekle

Likiditeyi kaldır

Compute-unit / priority fee ayarlaması

Doğrudan Rust CPI

Tuzaklar

Sonraki adımlar