Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

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 →

​
Cargo bağımlılıkları

[dependencies]
anchor-lang            = "0.29"
anchor-spl             = "0.29"
raydium_cp_swap        = { git = "https://github.com/raydium-io/raydium-cp-swap", features = ["cpi"] }
raydium_amm_v3         = { git = "https://github.com/raydium-io/raydium-clmm",    features = ["cpi"] }
# AMM v4 ve farm v6: yayınlanmış Anchor CPI crate'i yok. "AMM v4 / farm v6" bölümüne bakın.
cpi özellik bayrağı, crate’lerin tam program yerine sadece CPI yüzeyine (hesap struct’ları + invoker’lar) derlemesini sağlar, böylece ikili dosyanızın boyutu küçük kalır. Hesap struct’larını baştan sona bağlayan çalışan CPI örnekleri için, bkz. raydium-io/raydium-cpi-example (AMM v4, CPMM ve CLMM’yi kapsar).

​
Hesap listesi oluşturma

Her Raydium CPI, çağıran programda bir Accounts struct’ı gerektirir. Alanlar, programın instruction hesap sırasına 1’e 1 eşlenir, alan düzeyinde doğrulayıcılarla: 
use anchor_lang::prelude::*;
use anchor_spl::token::{Token, TokenAccount, Mint};

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

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

    /// CHECK: aynı şekilde
    pub amm_config: UncheckedAccount<'info>,

    /// CHECK: aynı şekilde
    pub pool_authority: UncheckedAccount<'info>,

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

    pub input_mint: Account<'info, Mint>,
    pub output_mint: Account<'info, Mint>,

    #[account(mut)]
    pub user_input_ata:  Account<'info, TokenAccount>,
    #[account(mut)]
    pub user_output_ata: Account<'info, TokenAccount>,

    pub cpmm_program: Program<'info, raydium_cp_swap::program::RaydiumCpSwap>,
    pub token_program: Program<'info, Token>,
    pub token_program_2022: Program<'info, anchor_spl::token_2022::Token2022>,
    /// CHECK: observation PDA
    #[account(mut)]
    pub observation_state: UncheckedAccount<'info>,
}
Raydium tarafındaki hesapların çoğu UncheckedAccount’dir çünkü çağrılan program (Raydium) doğrulamaya sahiptir. Çağıran programınız sadece sizin sahip olduğunuz hesapları titizlikle doğrular — kullanıcı ATA’ları, kendi PDA’larınız. /// CHECK: yorum satırı Anchor’ın eksik kontroller hakkındaki uyarısını bastırır.

​
CPI çağrısı oluşturma

Anchor, her instruction için bir helper üretir: 
use raydium_cp_swap::cpi::{self, accounts::Swap as CpmmSwap};

pub fn my_proxy_swap(
    ctx: Context<MyProxySwap>,
    amount_in: u64,
    minimum_amount_out: u64,
) -> Result<()> {
    let cpi_accounts = CpmmSwap {
        payer:                ctx.accounts.user.to_account_info(),
        authority:            ctx.accounts.user.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.user_input_ata.to_account_info(),
        output_token_account: ctx.accounts.user_output_ata.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.token_program.to_account_info(),
        output_token_program: ctx.accounts.token_program.to_account_info(),
        input_token_mint:     ctx.accounts.input_mint.to_account_info(),
        output_token_mint:    ctx.accounts.output_mint.to_account_info(),
        observation_state:    ctx.accounts.observation_state.to_account_info(),
    };
    let cpi_ctx = CpiContext::new(
        ctx.accounts.cpmm_program.to_account_info(),
        cpi_accounts,
    );

    cpi::swap_base_input(cpi_ctx, amount_in, minimum_amount_out)?;
    Ok(())
}
cpi::swap_base_input IDL’den üretilir; argüman listesi Anchor instruction’ının argüman listesini yansıtır.

​
İmzalayan seed’leri (PDA-imzalı CPI)

Programınız bir PDA adına CPI’ı imzaladığında (vault’lar, escrow’lar vb. için yaygın), CpiContext::new_with_signer kullanın: 
let bump         = ctx.accounts.my_authority_bump;
let signer_seeds: &[&[&[u8]]] = &[&[b"my_authority", &[bump]]];

let cpi_ctx = CpiContext::new_with_signer(
    ctx.accounts.cpmm_program.to_account_info(),
    cpi_accounts,
    signer_seeds,
);

cpi::swap_base_input(cpi_ctx, amount_in, minimum_amount_out)?;
İmzalayan seed’leri PDA’nın türetilmesiyle eşleşmelidir. authority (veya benzer imzalayan rol) olarak iletilen herhangi bir hesap için Solana çalışma zamanı, PDA’nın bu seed’ler aracılığıyla imzaladığını kontrol eder.

​
Kalan hesaplar

Bazı Raydium instruction’ları kalan hesapları alır — sabit hesaplardan sonra eklenen değişken uzunlukta bir liste. Kanonik örnekler:
  • CLMM SwapV2: swap’ın geçebileceği tick dizilerine karşılık gelen 1–8 TickArrayState hesabı ekler.
  • Farm v6 Deposit: her canlı reward akışı için (reward_vault, user_reward_ata) çiftlerini ekler.
Anchor’ın CPI helper’ları kalan hesapları tür-kontrol etmez. .with_remaining_accounts(...) aracılığıyla iletiniz: 
let cpi_ctx = CpiContext::new(program, accounts)
    .with_remaining_accounts(ctx.remaining_accounts.to_vec());
Sıra önemlidir: alıcı program kalan hesapları ilettiğiniz sıraya göre yineler. CLMM için tick dizileri yönsel olarak sıralanmalı (swap yönündeki ilk dizi önce). Farm v6 için reward slot’ları slot indeks sırasına göre gider.

​
Hata yayılımı

Raydium’un programları kendi hata enum’larını döndürür. Anchor onları sarar; çağıran programınız onları Err(ProgramError::Custom(code)) olarak görür. Belirli hataları işlemek için: 
use raydium_cp_swap::error::ErrorCode as CpmmErr;

match cpi::swap_base_input(cpi_ctx, amount_in, minimum_amount_out) {
    Ok(_) => Ok(()),
    Err(e) => {
        msg!("CPMM swap başarısız: {:?}", e);
        // Yeniden oluştur veya kendi hata türüne dönüştür.
        Err(e)
    }
}
Hata kodu numarası IDL politikasına göre sabittir (sdk-api/anchor-idl). Sayısal değere karşı karşılaştırarak belirli kodlara karşı test edebilirsiniz.

​
Bileşik CPI’larda işlem bütçesi

Her CPI frame’inin ek yükü vardır (~çağrı kendisi için 1.500 CU) ve çağrılanın kendi CU tüketimi bunun üzerine yığılır. Programınızın içinden CPMM swap çağıran bir işlem şunları harcar: 
your_program_cu
+ ~1_500       (CPI ek yükü)
+ ~150_000     (CPMM swap, SPL-token varyantı)
+ ~200_000     (Token-2022 aktarım ücreti ile)
+ ~10_000      (observation güncellemesi)
Yığılı yönlendirme için (programınız → aggregator → CPMM + CLMM + farm harvest), bütçe ≥500k CU. İşlemde her zaman açık bir ComputeBudgetProgram::set_compute_unit_limit(...) instruction’ı ayarlayın — varsayılan 200k CU limiti sessizce tükenecektir.

​
AMM v4 — manuel Instruction oluşturma

AMM v4’ün Anchor crate’i yoktur. Instruction’ı elle oluşturun: 
use anchor_lang::solana_program::program::invoke_signed;
use anchor_lang::solana_program::instruction::{Instruction, AccountMeta};

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

// SwapBaseIn ayırt edicisi 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(token_program_id, false),
        AccountMeta::new(amm_id, false),
        AccountMeta::new_readonly(amm_authority, false),
        // ... products/amm-v4/instructions başına kalan hesaplar ...
    ],
    data,
};
invoke_signed(&ix, &account_infos, signer_seeds)?;
Tam hesap listesi için bkz. products/amm-v4/code-demos.

​
Farm v6 — reward-çift kalan hesaplar

Farm v6’nın Deposit / Withdraw / Harvest’i kalan hesaplarda (reward_vault_i, user_reward_ata_i) çift deseni kullanır. Tam sıra: 
remaining_accounts = [
    reward_vault_0, user_reward_ata_0,
    reward_vault_1, user_reward_ata_1,
    ...
]
Canlı (çalışan veya talep edilmemiş sonu biten) reward slot’ı başına bir çift. Kullanılmayan slot’ları atlayın; program farm_state.reward_infos[i].reward_state dışında gönderir.

​
CPI akışını test etme

Yerel geliştirme, Raydium programlarının test validator’ünüzde mevcut olmasını gerektirir. Seçenekler:
  1. Program klonla anchor test — Anchor.toml içinde: 
    [test.validator]
clone = [
  { address = "CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK" },  # CPMM
  { address = "CLMM...program-id..." },                          # CLMM
  { address = "farm-v6-program-id..." },                         # farm v6
]
    Bu, dağıtılan bytecode’unu mainnet’ten yerel validator’ünüze çeker.
  2. Devnet — Raydium tüm programları devnet’e mainnet ile aynı program ID’leri ile dağıtır. Canlı koda vurmak için anchor test --provider.cluster devnet çalıştırın.
  3. Yerel dağıtım — Raydium repo’larını klonlayın ve yerel validator’e anchor deploy yapın. Test döngüsü ek yükü ekler ancak hata ayıklama için çağrılanı değiştirmenize izin verir.

​
İşaretçiler

Kaynaklar: