CPMM kod örnekleri

Her CPMM işlemi için uçtan uca TypeScript örnekleri — havuz oluşturma, swap, likidite yatırma, çekme, ücret toplama — ve minimal Rust CPI iskeletini içerir.

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 TypeScript örnekleri @raydium-io/raydium-sdk-v2@0.2.64-alpha hedeflemektedir; son olarak 0.2.42-alpha (2026-04) sürümüne karşı çalıştırılmış ve çağrı imzaları 2026-09-09 tarihinde 0.2.64-alpha kaynağına karşı Solana mainnet-beta üzerinde yeniden kontrol edilmiştir. Rust CPI iskeleti raydium-cp-swap üzerinde master dalında, Anchor 1.0.2 hedeflemektedir. Program ID’leri reference/program-addresses içindeki sabitlerden alınmaktadır.

​

Ön koşullar

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

Bu sayfadaki her örnek raydium-sdk-V2-demo/src/cpmm içindeki bir dosyayı yansıtmaktadır; GitHub bağlantısı her bölümün yanında yer almaktadır. Başlatma, demo deposunun config.ts.template dosyasını takip etmektedir (kaynak):

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

Raydium örneği SDK’nın cephesidir — aşağıdaki her örnek bunu kullanmaktadır. Raydium.load asenkron olduğu için varsayılan olarak token listesini yüklemektedir; bu getirişi atlamak için disableLoadToken: true geçiniz. Kullanılabilirlik özelliği kontrolü, disableFeatureCheck: false geçmediğiniz sürece zaten atlanmaktadır. Ücret yapılandırmaları raydium.api.getCpmmConfigs() aracılığıyla ilk kullanımda tembel olarak getirilmektedir.

​

CPMM havuzu oluşturma

Kaynak: src/cpmm/createCpmmPool.ts

import { PublicKey } from "@solana/web3.js";
import BN from "bn.js";
import { CREATE_CPMM_POOL_PROGRAM, CREATE_CPMM_POOL_FEE_ACC }
  from "@raydium-io/raydium-sdk-v2";
// (Tüm havuz PDA'larını bir kerede almanız gerekiyorsa, dışa aktarılan yardımcı
//  `getCreatePoolKeys` olur. `getCpmmPdas` yoktur.)

const mintA = new PublicKey("So11111111111111111111111111111111111111112"); // wSOL
const mintB = new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"); // USDC

// 1. Bir ücret yapılandırması seçiniz. index=0, %0.25 katmanıdır.
const feeConfigs = await raydium.api.getCpmmConfigs();
const feeConfig  = feeConfigs.find((c) => c.index === 0)!;

// 2. SDK'nın Token-2022 uzantılarını işleyebilmesi için mint meta verilerini çekiniz.
const mintAInfo = await raydium.token.getTokenInfo(mintA);
const mintBInfo = await raydium.token.getTokenInfo(mintB);

// 3. İşlemi oluşturunuz.
const { execute, extInfo } = await raydium.cpmm.createPool({
  programId:       CREATE_CPMM_POOL_PROGRAM,
  poolFeeAccount:  CREATE_CPMM_POOL_FEE_ACC,
  mintA:           mintAInfo,
  mintB:           mintBInfo,
  mintAAmount:     new BN(1_000_000_000),   // 1 SOL (9 ondalık basamak varsayılarak)
  mintBAmount:     new BN(   160_000_000),  // 160 USDC (160/SOL'da)
  startTime:       new BN(0),               // hemen aç
  feeConfig,
  associatedOnly:  false,
  ownerInfo:       { useSOLBalance: true },
  txVersion:       TxVersion.V0,
});

const { txId } = await execute({ sendAndConfirm: true });
console.log("Havuz oluşturuldu:", extInfo.address.poolId.toBase58());
console.log("İşlem:", txId);

SDK’nın sessizce hallettiği birkaç şey:

• Mint’leri PDA’yı türetmeden önce token0/token1 sırasına göre sıralamak.
• Tek seferlik create_pool_fee ödemesini poolFeeAccount’a yapmak.
• Çağıranın ilişkili token hesaplarını eksikse oluşturmak.
• Her bir taraf için doğru token programını (SPL Token vs Token-2022) seçmek.

Onaydan sonra canlı havuz durumunu şu şekilde getirebilirsiniz:

// getPoolInfoFromRpc, PublicKey değil, nesne değil, konumsal base58 dizesi alır.
const { poolKeys, poolInfo, rpcData } = await raydium.cpmm.getPoolInfoFromRpc(
  extInfo.address.poolId.toBase58(),
);

​

Swap (temel giriş)

Kaynak: src/cpmm/swap.ts

import { CurveCalculator, FeeOn } from "@raydium-io/raydium-sdk-v2";

const POOL_ID = "<POOL_ID>";   // base58 dizesi

// 1. Canlı havuz durumunu doğrudan RPC'den yükleyiniz (API'den değil).
const { poolInfo, poolKeys, rpcData } = await raydium.cpmm.getPoolInfoFromRpc(POOL_ID);

const inputMint  = poolInfo.mintA.address;                // A → B swap
const amountIn   = new BN(100_000_000);                   // 0.1 SOL
const slippage   = 0.005;                                 // %0.5

// 2. Yerel olarak fiyat belirleyiniz. CurveCalculator, zincir üstü matematiği yansıtır,
//    her iki tarafta Token-2022 transfer ücretleri dahil. Tüm sekiz bağımsız değişken gereklidir.
const baseIn = inputMint === poolInfo.mintA.address;
const swapResult = CurveCalculator.swapBaseInput(
  amountIn,
  baseIn ? rpcData.baseReserve : rpcData.quoteReserve,
  baseIn ? rpcData.quoteReserve : rpcData.baseReserve,
  rpcData.configInfo!.tradeFeeRate,
  rpcData.configInfo!.creatorFeeRate,
  rpcData.configInfo!.protocolFeeRate,
  rpcData.configInfo!.fundFeeRate,
  rpcData.feeOn === FeeOn.BothToken || rpcData.feeOn === FeeOn.OnlyTokenB,
);
// swapResult alanları inputAmount / outputAmount / tradeFee / protocolFee /
// fundFee / creatorFee / newInputVaultAmount / newOutputVaultAmount'tır.
// destinationAmountSwapped veya sourceAmountSwapped yoktur.

// 3. Oluşturunuz ve gönderi. `slippage` geçmek burada sınırı uygulayan şeydir —
//    manuel minimum-out aritmetiğine gerek yoktur.
const { execute } = await raydium.cpmm.swap({
  poolInfo,
  poolKeys,
  inputAmount: amountIn,
  swapResult,
  slippage,
  baseIn,
  txVersion: TxVersion.V0,
});

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

Not: SDK her zaman getPoolInfoFromRpc içinde havuz durumunu RPC’den yeniden getirir. İmzalamak üzere olduğunuz bir işlem için api-v3.raydium.io üzerinden fiyat belirlemeyin — bir blok eski olan bir fiyat, iniş zamanında ExceededSlippage içine kayabilir.

​

Swap (temel çıkış)

Kaynak: src/cpmm/swapBaseOut.ts

const amountOutWanted = new BN(15_000_000);        // 15 USDC
const slippage        = 0.005;

const baseIn = false; // false → mintB giriş tarafıdır
const swapResult = CurveCalculator.swapBaseOutput(
  amountOutWanted,
  baseIn ? rpcData.baseReserve : rpcData.quoteReserve,
  baseIn ? rpcData.quoteReserve : rpcData.baseReserve,
  rpcData.configInfo!.tradeFeeRate,
  rpcData.configInfo!.creatorFeeRate,
  rpcData.configInfo!.protocolFeeRate,
  rpcData.configInfo!.fundFeeRate,
  rpcData.feeOn === FeeOn.BothToken || rpcData.feeOn === FeeOn.OnlyTokenB,
);
// swapResult.inputAmount gerekli giriştir; sourceAmountSwapped yoktur.

const { execute } = await raydium.cpmm.swap({
  poolInfo,
  poolKeys,
  inputAmount: new BN(0),   // fixedOut olduğunda kullanılmaz — tutar swapResult'tan gelir
  fixedOut:    true,
  swapResult,               // gerekli ve hedef çıkış tutarını taşır
  baseIn,
  slippage,
  txVersion:   TxVersion.V0,
});

await execute({ sendAndConfirm: true });

​

Likidite yatırma

Kaynak: src/cpmm/deposit.ts

import { Percent } from "@raydium-io/raydium-sdk-v2";
import Decimal from "decimal.js";

// addLiquidity, LP tutarı değil, GİRİŞ tutarı tarafından yönlendirilir.
const uiInputAmount = "0.0001";
const inputAmount = new BN(
  new Decimal(uiInputAmount).mul(10 ** poolInfo.mintA.decimals).toFixed(0),
);
const slippage = new Percent(1, 100);   // sayı değil, Percent

const { execute } = await raydium.cpmm.addLiquidity({
  poolInfo,
  poolKeys,
  inputAmount,
  baseIn: true,           // inputAmount mintA cinsinden ifade edilir
  slippage,
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });

SDK, eşleştirilmiş tutarı havuzun canlı rezervlerinden türetir, talimatın maximum_* bağımsız değişkenleri için her iki tarafı slippage tarafından şişirir ve gerekirse ATA oluşturmalarını oluşturur. raydium.cpmm.computePairAmount({ ... }) bir UI önizlemesi için istiyorsanız aynı sayıları döndürür.

​

Likidite çekme

Kaynak: src/cpmm/withdraw.ts

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

const lpAmount = new BN(100_000);           // Yakılacak LP
const slippage = new Percent(1, 100);       // sayı değil, Percent

const { execute } = await raydium.cpmm.withdrawLiquidity({
  poolInfo,
  poolKeys,
  lpAmount,
  slippage,
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });

​

Protokol/fon/yaratıcı ücretlerini tahsil etme

Kaynak: src/cpmm/collectCreatorFee.ts, src/cpmm/collectAllCreatorFee.ts

Protokol ve fon tahsili yetki ile sınırlıdır. Yaratıcı ücretlerinin iki yolu vardır: yaratıcı tarafından imzalanan CollectCreatorFee ve herhangi bir ödeyicinin çağırabileceği ancak yalnızca yaratıcının kanonik ATA’larına transfer yapabilen CollectCreatorFeePermissionless. 0.2.64-alpha her iki yaratıcı yolu için modül düzeyinde oluşturucular içerir:

// creator-signed
const { execute } = await raydium.cpmm.collectCreatorFees({
  poolInfo,
  poolKeys,
  txVersion: TxVersion.V0,
});

// permissionless — herhangi bir ödeyici; gelirler yaratıcının kanonik ATA'larına gider
const { execute } = await raydium.cpmm.collectCreatorFeesPermissionless({
  poolInfo,
  poolKeys,
  txVersion: TxVersion.V0,
});

// birden fazla havuz aynı anda, yaratıcı tarafından imzalanan
await raydium.cpmm.collectMultiCreatorFees({ poolInfoList, txVersion: TxVersion.V0 });

Her iki yaratıcı talimatı da 2026-09-19 program yükseltmesinde hesap listelerini değiştirdi. Her biri artık ["creator_fee_share", creator, ammConfig] konumunda bir creator_fee_share PDA’sı alır ve izinsiz olanı amm_config’i de alır — her ikisi de system_program’dan sonra eklenir yerine eklenirse, zaten orada olan hesaplar konumlarını korur. Yükseltmeden önceki bir SDK sürümüne sabitlenmiş bir oluşturucu daha kısa listeyi yayar ve işlem eksik hesaplar için reddedilir. Bu yardımcıları yükseltilmiş programa karşı kullanmadan önce yüklediğiniz sürümün yeni hesapları içerdiğini kontrol edin ve ondan istemciler oluşturursanız IDL’yi yenileyin.

PDA’yı hiç oluşturulmamış olsa bile geçmek zorunludur — türetin ve geçin; program hesap boş olduğunda AmmConfig.creator_fee_share_rate’e geri döner.

İki yaratıcı talimatının farklı ayırıcıları ve hesap düzenleri vardır — izinsiz olanı yaratıcı imzalayanı ayrı bir payer ve imzalamayan bir creator ile değiştirir. Diğerinin hesaplarını el ile değiştirmek yerine eşleşen oluşturucuyu kullanın.

SDK’da protokol veya fon ücreti oluşturucusu yoktur (makeCollectProtocolFeeInstruction ve makeCollectFundFeeInstruction hiçbir ad altında mevcut değildir) — bunlar yönetici yollarıdır ve CreateCreatorFeeShare / CloseCreatorFeeShare de öyledir, bunların da oluşturucusu yoktur. Mevcut olan düşük düzey talimat oluşturucuları collectCpFeeInstruction, makeCollectCreatorFeeInstruction ve collectCreatorFeePermissionlessInInstruction’dır.

Zincir dışında, tahakkuk eden ücretleri doğrudan PoolState’den okuyabilirsiniz:

const pool = await raydium.cpmm.getRpcPoolInfo(POOL_ID);   // base58 string
console.log("Tahakkuk eden protokol ücreti mintA:", pool.protocolFeesMintA.toString());
console.log("Tahakkuk eden protokol ücreti mintB:", pool.protocolFeesMintB.toString());
// CpmmPoolInfoLayout alanları protocolFeesMintA/B, fundFeesMintA/B ve
// creatorFeesMintA/B'dir — ...Token0/...Token1 alanları yoktur.
//
// creatorFeesMintA/B *brüt* tahakkuktur. Yaratıcı bunu tahsil sırasında çözülen
// protokol payı eksi alır; protocolFeesMintA/B bu payı alır, bu nedenle
// yalnızca swaplarda değil, yaratıcı ücreti tahsillerinde de büyür.
// Bkz. products/cpmm/fees#protocol-share-of-the-creator-fee.

​

Rust CPI iskeletı

CPMM’yi kendi Anchor programınızdan çağırmak istiyorsanız — örneğin, mevduat sahipleri adına swap yapan bir kasa — CPI bağlamı şöyle görünür. Hesap sırası products/cpmm/instructions’ı izler.

// Cargo.toml — `master` anchor-lang =1.0.2'yi sabitleri.
// raydium-cp-swap = { git = "https://github.com/raydium-io/raydium-cp-swap",
//                     branch = "master", features = ["cpi"] }
// anchor-lang      = "=1.0.2"   // raydium-cp-swap'ın sabitlediği ile eşleşmeli
// anchor-spl       = "=1.0.2"
//
// `cpi` özelliği gereklidir — `raydium_cp_swap::cpi` modülü yalnızca
// onun altında mevcuttur. products/clmm/code-demos'daki CLMM örneği
// kendi `master`'ında aynı =1.0.2'yi sabitleri, bu nedenle ikisi bir
// programı paylaşabilir.

use anchor_lang::prelude::*;
use anchor_spl::token_interface::{TokenAccount, TokenInterface, Mint};
use raydium_cp_swap::cpi::accounts::Swap;
use raydium_cp_swap::cpi;
use raydium_cp_swap::program::RaydiumCpSwap;

#[derive(Accounts)]
pub struct ProxySwap<'info> {
    #[account(mut)]
    pub payer: Signer<'info>,

    /// CHECK: CPMM programı tarafından doğrulanır
    pub authority:     UncheckedAccount<'info>,
    /// CHECK:
    pub amm_config:    UncheckedAccount<'info>,
    #[account(mut)]
    /// CHECK:
    pub pool_state:    UncheckedAccount<'info>,

    #[account(mut)]
    pub input_token_account:  InterfaceAccount<'info, TokenAccount>,
    #[account(mut)]
    pub output_token_account: InterfaceAccount<'info, TokenAccount>,

    #[account(mut)]
    pub input_vault:  InterfaceAccount<'info, TokenAccount>,
    #[account(mut)]
    pub output_vault: InterfaceAccount<'info, TokenAccount>,

    pub input_token_program:  Interface<'info, TokenInterface>,
    pub output_token_program: Interface<'info, TokenInterface>,

    pub input_token_mint:  InterfaceAccount<'info, Mint>,
    pub output_token_mint: InterfaceAccount<'info, Mint>,

    #[account(mut)]
    /// CHECK: halka arabellek
    pub observation_state: UncheckedAccount<'info>,

    pub cpmm_program: Program<'info, RaydiumCpSwap>,
}

pub fn proxy_swap_base_input(
    ctx: Context<ProxySwap>,
    amount_in: u64,
    minimum_amount_out: u64,
) -> Result<()> {
    let cpi_accounts = Swap {
        payer:                ctx.accounts.payer.to_account_info(),
        authority:            ctx.accounts.authority.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(),
        input_token_program:  ctx.accounts.input_token_program.to_account_info(),
        output_token_program: ctx.accounts.output_token_program.to_account_info(),
        input_token_mint:     ctx.accounts.input_token_mint.to_account_info(),
        output_token_mint:    ctx.accounts.output_token_mint.to_account_info(),
        observation_state:    ctx.accounts.observation_state.to_account_info(),
    };
    // Anchor 1.0 burada programın AccountInfo'sunu değil Pubkey'ini alır.
    let cpi_ctx = CpiContext::new(
        *ctx.accounts.cpmm_program.key,
        cpi_accounts,
    );
    cpi::swap_base_input(cpi_ctx, amount_in, minimum_amount_out)
}

CPI’niz bir PDA olarak imzalıyorsa (örneğin, mevduat sahipleri adına bir kasa yönetiyorsanız), CpiContext::new’i CpiContext::new_with_signer ile değiştirin ve tohumlarınızı geçin.

​

Yaygın tuzaklar

Bir destek talebini açmadan önce kısa bir kontrol listesi:

• Sıralanmış mintler. Türetilmiş poolState PDA’nız zincir üstü havuzla eşleşmiyorsa, muhtemelen mintleri sıralamayı unuttunuz.
• Eski API teklifi. Hiçbir zaman api-v3.raydium.io’dan bir rezerv değerini CurveCalculator.swap’a geçirmeyin. Bir RPC’den getirin.
• Yanlış token programı. Token-2022 mint’inin kasası SPL Token tarafından değil Token-2022 programı tarafından sahiplenilir. Her zaman havuzun token_0_program / token_1_program alanlarını kullanın.
• Transfer ücreti mintleri için yetersiz slippage. Havuzun her iki tarafı da Token-2022 transfer ücreti mint’i ise, minimum_amount_out’unuz kasanın gönderdiği şey değil, kullanıcının gerçekten aldığı şey cinsinden olmalıdır.
• Bir swap’ta NotApproved. PoolState.status’u kontrol edin — yönetici o havuzda swapleri duraklatmış olabilir. Durum bitmaski için products/cpmm/instructions’a bakın.

​

Sonraki adımlar

• sdk-api/typescript-sdk — tam SDK referansı.
• sdk-api/rest-api — teklif ve havuz meta verisi uç noktaları.
• user-flows/create-cpmm-pool — aynı akışın kod olmayan açıklaması.
• integration-guides/aggregator — çok atlamalı bir yolun parçası olarak CPMM’yi yönlendiriyorsanız.

Kaynaklar:

• Raydium SDK v2 — @raydium-io/raydium-sdk-v2
• Raydium SDK v2 demoları — raydium-sdk-v2-demo
• raydium-io/raydium-cp-swap