Rust CPI

هذه الصفحة مُترجَمة آليًا بواسطة الذكاء الاصطناعي. النسخة الإنجليزية هي المرجع المعتمد.عرض النسخة الإنجليزية →

CPI (“cross-program invocation” أو استدعاء البرنامج المتقاطع) هي الآلية التي يستدعي بها برنامج Solana واحد برنامجًا آخر. تشحن معظم برامج Raydium صناديق غلاف CPI مبنية على Anchor التي تجعل موقع الاستدعاء يبدو وكأنه استدعاء دالة مكتوبة، مع هياكل حسابات لها أسماء حقول تم التحقق منها وcpi::<ix>() مساعدات. تتناول هذه الصفحة النمط العام مرة واحدة، ثم الاختلافات لكل برنامج. للحصول على أمثلة TypeScript قابلة للتشغيل، انظر صفحة code-demos من فصل كل منتج.

أي نمط ينطبق على أي برنامج

البرنامج	مبني على Anchor	الصندوق	حيث
CPMM	نعم	`raydium-cp-swap` (مستودع عام؛ مسار Rust `use` هو `raydium_cp_swap`)	النمط العام، المثال المعمول به
CLMM	نعم	`raydium-clmm` (مستودع عام؛ مسار Rust `use` هو `raydium_clmm`)	تطبيق النمط: CLMM
LaunchLab	نعم	لا يوجد اسم صندوق مؤكد؛ مصدر البرنامج مغلق، لكن معرّف البيانات الوصفية الداخلي للـ IDL على السلسلة هو `raydium_launchpad`، اسم تقني وليس اسم المنتج (انظر التحذير في تطبيق النمط: LaunchLab)	تطبيق النمط: LaunchLab
Farm v6	غير مؤكد؛ لم يتم العثور على IDL عام أو مصدر (انظر التحذير في Farm v6)	غير متاح	Farm v6
AMM v4	لا، يسبق Anchor بدون صندوق CPI	لا يوجد	AMM v4

إذا كنت تدمج CPMM أو CLMM أو LaunchLab، اقرأ النمط العام أولاً، ثم انتقل إلى قسم برنامجك للحصول على قائمة الحسابات وأي اختلافات. Farm v6 و AMM v4 مختلفان بما يكفي لضمان قراءة أقسامهما بشكل مستقل.

تبعيات Cargo

# اختر صندوق CPI واحد فقط من صناديق Raydium لكل برنامج — انظر التحذير أدناه.
[dependencies]
anchor-lang     = "=1.0.2"   # =0.32.1 إذا كنت تستهدف raydium-clmm بدلاً من ذلك
anchor-spl      = "=1.0.2"   # =0.32.1 وبالمثل
raydium-cp-swap = { git = "https://github.com/raydium-io/raydium-cp-swap", branch = "master", features = ["cpi"] }
# raydium-clmm  = { git = "https://github.com/raydium-io/raydium-clmm",    branch = "master", features = ["cpi"] }
# LaunchLab: مصدر البرنامج غير متاح للعموم (انظر reference/program-addresses).
# لا توجد تبعية git للإشارة إليها. بدلاً من ذلك، أنشئ ربط CPI من IDL المنشور
# انظر "تطبيق النمط: LaunchLab" أدناه.
# AMM v4 ليس لديه صندوق CPI Anchor منشور؛ انظر قسمه الخاص.

يجب أن يطابق مفتاح التبعية اسم [package] في مستودع الهدف بالضبط، مع الواصلات. لا يعامل Cargo raydium_cp_swap كمكافئ لـ raydium-cp-swap عند حل تبعية git.

branch = "master" يتتبع أحدث مصدر منشور؛ ثبّت على rev = "<commit>" محدد إذا كنت بحاجة إلى بناء قابل للتكرار. يُنصح به بمجرد تجاوزك مرحلة النماذج الأولية، لأن تغيير تخطيط الحساب على master سيكسر بناءك بدون تحذير. علم cpi يجعل الصناديق تُترجم إلى سطح CPI فقط (هياكل الحسابات + المستدعيات) بدلاً من البرنامج الكامل، لذا يبقى ملفك الثنائي صغيراً. يجب أن يطابق anchor-lang / anchor-spl ما يثبّته الصندوق الهدف، واعتباراً من 2026-09 الصناديق العامة Raydium لا تتفق:

الصندوق	يثبّت `anchor-lang` / `anchor-spl`
`raydium-cp-swap`	`=1.0.2` (كان `0.32.1` قبل ترقية 2026-09-09)
`raydium-clmm`	`=0.32.1`

لا يمكنك الاعتماد على كلا الصندوقين من برنامج واحد الآن. كل منهما يثبّت Anchor بـ =، لذا سيضطر Cargo إلى ربط نسختين غير متوافقتين من سمات Anchor في ملف ثنائي واحد، والبناء يفشل. إذا كان برنامجك يستدعي CPI إلى كل من CPMM و CLMM، فيجب عليك إما تقسيمه إلى برنامجين، أو إسقاط صندوق CPI المكتوب لأحدهما وترميز تلك التعليمة يدويًا (النمط الموضح لـ AMM v4 يعمل مع أي برنامج). أعد التحقق من ملفي Cargo.toml قبل البدء — من المتوقع أن يتم حل هذا عندما ينتقل CLMM إلى Anchor 1.x.

غيّر Anchor 1.0 شيئين يلمسهما كل موقع استدعاء CPI. إذا كنت تنقل تكاملاً عاملاً من 0.3x:

CpiContext::new يأخذ Pubkey، وليس AccountInfo. CpiContext::new(ctx.accounts.cpmm_program.to_account_info(), accts) يصبح CpiContext::new(*ctx.accounts.cpmm_program.key, accts). نفس الشيء لـ new_with_signer. حقل الهيكل الآن program_id: Pubkey.
Context له عمر واحد، وليس أربعة. Context<'_, '_, 'info, 'info, MyProxySwap<'info>> يصبح Context<'info, MyProxySwap<'info>>.

على جانب العميل، anchor-client’s RequestBuilder::instructions() الآن يعيد Vec<Instruction> بدلاً من Result<Vec<Instruction>> (أسقط ?)، وCommitmentConfig انتقل خارج solana-sdk — خذه من anchor_client بدلاً من ذلك. spl-associated-token-account 8.0 أيضاً نقل مساعداته: get_associated_token_address الآن تحت ::address، ومعرّف البرنامج هو ::program::ID.

للحصول على أمثلة CPI عاملة تربط هياكل الحسابات من البداية إلى النهاية، انظر raydium-io/raydium-cpi-example (يغطي AMM v4 و CPMM و CLMM).

النمط العام لـ Anchor CPI

يمشي هذا القسم عبر CPMM من البداية إلى النهاية كمثال معمول به: هيكل Accounts، CpiContext، cpi::<ix>(). يتبع CLMM الشكل المتطابق، مع قائمة حسابات مختلفة ومتطلب remaining-accounts. يتبع LaunchLab نفس الميكانيكا لكن قائمة حساباته تحمل عدة حسابات بدون مكافئ CPMM/CLMM (global_config، platform_config، event_authority، program)، لذا تعامل معها كنفس النمط، وليس نفس الشكل. انظر قسم كل برنامج الخاص به بدلاً من افتراض أن قائمة الحسابات من هذا الشرح تنتقل مباشرة.

بناء قائمة الحسابات

كل CPI من Raydium يتطلب هيكل Accounts في البرنامج الاستدعاء. حقوله هي أي حسابات يحتاجها تعليمتك، مع محققات على مستوى الحقل؛ ترتيب إعلانهم لا يجب أن يطابق ترتيب حساب Raydium الخاص، لأن عميلك المُنشأ من IDL يعالجهم بالاسم، وليس بالموضع:

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
    #[account(mut)]
    pub pool_state: UncheckedAccount<'info>,

    /// CHECK: وبالمثل
    pub amm_config: UncheckedAccount<'info>,

    /// CHECK: وبالمثل
    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>,

    /// مكتوب كـ `Program<RaydiumCpSwap>` بدلاً من `UncheckedAccount`: هذا الحساب
    /// هو البرنامج الذي يتم استدعاؤه، وليس بيانات مملوكة لـ Raydium، لذا يتحقق غلاف Anchor `Program<T>`
    /// من عنوانه تلقائياً بدلاً من ترك هذا الفحص للمستدعى.
    pub cpmm_program: Program<'info, raydium_cp_swap::program::RaydiumCpSwap>,
    pub token_program: Program<'info, Token>,
    /// CHECK: ملاحظة PDA
    #[account(mut)]
    pub observation_state: UncheckedAccount<'info>,
}

معظم حسابات جانب Raydium هي UncheckedAccount لأن المستدعى (Raydium) يمتلك التحقق. برنامجك الاستدعاء يتحقق فقط بصرامة من الحسابات التي تمتلكها، مثل ATAs للمستخدم و PDAs الخاصة بك. تعليق /// CHECK: يقمع تحذير Anchor حول الفحوصات المفقودة. الاستثناء الوحيد من جانب Raydium هو cpmm_program نفسه: إنه البرنامج الذي يتم استدعاؤه بدلاً من حساب بيانات يتحقق منه Raydium داخلياً، لذا يُكتب Program<T> ويحصل على فحص عنوان Anchor التلقائي بدلاً من /// CHECK: يدوي. هذا الشكل الذي يحتوي على UncheckedAccount في الغالب، حيث يتحقق Raydium من حساباته الخاصة، هو نفسه لـ CLMM و LaunchLab. يفترض هذا المثال أن كلا الـ mints كلاسيكي SPL Token؛ إذا كان أي جانب يمكن أن يكون mint Token-2022، أضف حقل token_program_2022: Program<'info, anchor_spl::token_2022::Token2022> وأمرره كـ input_token_program/output_token_program لذلك الجانب في استدعاء CPI أدناه بدلاً من token_program.

بناء استدعاء CPI

ينشئ Anchor مساعداً واحداً لكل تعليمة، جنباً إلى جنب مع هيكل حسابات CPI (cpi::accounts::Swap، مستعار CpmmSwap أدناه). بخلاف هيكل MyProxySwap الخاص بك أعلاه، أسماء الحقول والترتيب في هذا الهيكل ثابتة بواسطة IDL الخاص بـ raydium-cp-swap ويجب أن تطابق بالضبط:

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(),
    };
    // Anchor 1.0: الحجة الأولى هي Pubkey للبرنامج، وليس AccountInfo.
    let cpi_ctx = CpiContext::new(
        *ctx.accounts.cpmm_program.key,
        cpi_accounts,
    );

    cpi::swap_base_input(cpi_ctx, amount_in, minimum_amount_out)?;
    Ok(())
}

cpi::swap_base_input يُنشأ من IDL؛ قائمة حجته تعكس قائمة حجة تعليمة Anchor. كل برنامج Raydium مبني على Anchor مؤكد (CPMM و CLMM و LaunchLab) ينشئ مساعدات cpi::<ix>() بنفس الطريقة، مع اسم الدالة يطابق اسم التعليمة في snake_case. ما إذا كان هذا يمتد إلى Farm v6 غير مؤكد؛ انظر قسمه.

بذور الموقّع (CPI موقّع بـ PDA)

عندما يوقّع برنامجك على CPI نيابة عن PDA (شائع للأقبية والضمانات، إلخ)، استخدم CpiContext::new_with_signer:

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.key,
    cpi_accounts,
    signer_seeds,
);

cpi::swap_base_input(cpi_ctx, amount_in, minimum_amount_out)?;

يجب أن تطابق بذور الموقّع اشتقاق PDA. لأي حساب يُمرر كـ authority (أو دور موقّع مشابه)، يتحقق وقت تشغيل Solana من أن PDA يوقّع عبر هذه البذور.

الحسابات المتبقية

بعض تعليمات Raydium تأخذ حسابات متبقية، قائمة بطول متغير مُلحقة بعد الحسابات الثابتة. مساعدات CPI الخاصة بـ Anchor لا تتحقق من نوع الحسابات المتبقية؛ مررها عبر .with_remaining_accounts(...):

let cpi_ctx = CpiContext::new(program_id, accounts)
    .with_remaining_accounts(ctx.remaining_accounts.to_vec());

الترتيب مهم دائماً، لأن برنامج المستقبل يكرر الحسابات المتبقية بالترتيب الذي تمررها. ترتيبان مؤكدان:

CLMM SwapV2: مصفوفات التجزئة، مرتبة اتجاهياً.
Farm v6: أزواج (reward_vault, user_reward_ata)، لكن فقط من تدفق المكافأة الثاني فما بعده؛ انظر Farm v6 لما يظهره فك تشفير معاملة حقيقية.

تطبيق النمط: CLMM

يتبع SwapV2 النمط العام أعلاه مع قائمة حسابات مختلفة ومتطلب remaining-accounts لمصفوفات التجزئة. وحدة #[program] الخاصة بالصندوق تُسمى raydium_clmm، وهي أيضاً مسار Rust use الخاص بها.

هيكل حسابات CPI يُسمى SwapSingleV2، وليس SwapV2. SwapV2 هو اسم التعليمة على السلسلة الفعلي.

use raydium_clmm::cpi::{self, accounts::SwapSingleV2 as ClmmSwap};

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

    /// CHECK: تم التحقق من قبل CLMM
    pub amm_config: UncheckedAccount<'info>,
    /// CHECK: وبالمثل
    #[account(mut)]
    pub pool_state: UncheckedAccount<'info>,

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

    /// CHECK: ملاحظة PDA
    #[account(mut)]
    pub observation_state: UncheckedAccount<'info>,

    pub token_program: Program<'info, Token>,
    pub token_program_2022: Program<'info, anchor_spl::token_2022::Token2022>,
    /// CHECK: برنامج SPL memo، مطلوب لبعض مسارات Token-2022
    pub memo_program: UncheckedAccount<'info>,

    pub input_vault_mint: Account<'info, Mint>,
    pub output_vault_mint: Account<'info, Mint>,

    /// مكتوب كـ `Program<T>` بدلاً من `UncheckedAccount`، نفس السبب كـ CPMM's
    /// `cpmm_program` في النمط العام أعلاه: إنه البرنامج المستدعى، و
    /// `Program<T>` يتحقق من عنوانه تلقائياً.
    pub clmm_program: Program<'info, raydium_clmm::program::RaydiumClmm>,
    // remaining_accounts: tick_array_bitmap_extension (إذا احتاج المسار إليها)، ثم
    // عدد كبير من حسابات tick_array حسب نطاق السعر المتوقع للمبادلة.
}

احسب قائمة مصفوفة التجزئة بنفس الطريقة التي يفعلها SDK، عبر اقتباس ضد حالة المجموعة الحالية، بدلاً من تخمين عدد ثابت؛ مبادلة تتجاوز المصفوفات التي مررتها تعود مع TickArrayNotFound (انظر products/clmm/instructions للجدول الكامل للحسابات وقائمة الأخطاء). مررها في اتجاه مسار السعر: أول مصفوفة في اتجاه المبادلة أولاً.

تطبيق النمط: LaunchLab

LaunchLab مبني على Anchor و IDL منشور: raydium_launchpad/raydium_launchpad.json في مستودع raydium-idl العام. معرّف البيانات الوصفية الداخلي لـ IDL هذا هو raydium_launchpad، اسم تقني للبرنامج الأساسي، وليس اسماً بديلاً للمنتج. بخلاف CPMM و CLMM، مع ذلك، مصدر البرنامج نفسه غير متاح للعموم (انظر reference/program-addresses). لا توجد تبعية git = "..." للإشارة إلى Cargo، ولا مصدر للتأكد من ما ستكون عليه مسار Rust use الفعلي للصندوق. أنشئ ربط من IDL المنشور باستخدام ماكرو Anchor declare_program!. احفظ JSON الـ IDL كـ idls/raydium_launchpad.json في صندوقك (Cargo يبحث عن مجلد idls/ نسبة إلى CARGO_MANIFEST_DIR)، ثم declare_program!(raydium_launchpad); ينشئ هياكل raydium_launchpad::cpi::accounts::<Ix> ودوال cpi::<ix>() مباشرة من IDL، بدون مصدر برنامج مطلوب. اسم هيكل الحسابات المُنشأ هو دائماً اسم التعليمة في PascalCase (buy_exact_in → BuyExactIn)، وأسماء الحقول تطابق أسماء الحسابات في IDL بالضبط، نفس قائمة الحسابات المستخدمة بالفعل في MyProxyBuy أدناه. يتبع شكل CPI النمط العام. قائمة الحسابات والحجج أدناه تأتي من تعليمة buy_exact_in الخاصة بـ IDL على السلسلة، وليس من products/launchlab/instructions.mdx:

use anchor_lang::prelude::*;
use anchor_spl::token::{Token, TokenAccount, Mint};
use raydium_launchpad::cpi::{self, accounts::BuyExactIn};

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

    /// CHECK: PDA، seeds = [b"vault_auth_seed"]، تم التحقق من قبل البرنامج
    pub authority: UncheckedAccount<'info>,

    /// CHECK: تم التحقق من قبل البرنامج
    pub global_config: UncheckedAccount<'info>,
    /// CHECK: تم التحقق من قبل البرنامج
    pub platform_config: UncheckedAccount<'info>,

    /// CHECK: تم التحقق من قبل البرنامج
    #[account(mut)]
    pub pool_state: UncheckedAccount<'info>,

    #[account(mut)]
    pub user_base_token: Account<'info, TokenAccount>,
    #[account(mut)]
    pub user_quote_token: Account<'info, TokenAccount>,
    #[account(mut)]
    pub base_vault: Account<'info, TokenAccount>,
    #[account(mut)]
    pub quote_vault: Account<'info, TokenAccount>,

    pub base_token_mint: Account<'info, Mint>,
    pub quote_token_mint: Account<'info, Mint>,

    /// CHECK: برنامج الرمز الأساسي (SPL Token أو Token-2022، حسب الرمز)
    pub base_token_program: UncheckedAccount<'info>,
    /// مكتوب كـ `Program<Token>` بدلاً من `UncheckedAccount`: يثبّت IDL هذا على
    /// SPL Token الكلاسيكي بالتحديد (بخلاف base_token_program أعلاه)، لذا فحص Anchor المدمج
    /// على `Program<Token>` كافٍ بمفرده.
    pub quote_token_program: Program<'info, Token>,

    /// CHECK: PDA، seeds = [b"__event_authority"]، مطلوب من قبل نمط emit_cpi! الخاص بالبرنامج
    pub event_authority: UncheckedAccount<'info>,
    /// CHECK: حساب البرنامج نفسه، مطلوب جنباً إلى جنب مع event_authority
    pub program: UncheckedAccount<'info>,
}

pub fn my_proxy_buy(
    ctx: Context<MyProxyBuy>,
    amount_in: u64,
    minimum_amount_out: u64,
    share_fee_rate: u64,
) -> Result<()> {
    let cpi_accounts = BuyExactIn {
        payer:               ctx.accounts.payer.to_account_info(),
        authority:           ctx.accounts.authority.to_account_info(),
        global_config:       ctx.accounts.global_config.to_account_info(),
        platform_config:     ctx.accounts.platform_config.to_account_info(),
        pool_state:          ctx.accounts.pool_state.to_account_info(),
        user_base_token:     ctx.accounts.user_base_token.to_account_info(),
        user_quote_token:    ctx.accounts.user_quote_token.to_account_info(),
        base_vault:          ctx.accounts.base_vault.to_account_info(),
        quote_vault:         ctx.accounts.quote_vault.to_account_info(),
        base_token_mint:     ctx.accounts.base_token_mint.to_account_info(),
        quote_token_mint:    ctx.accounts.quote_token_mint.to_account_info(),
        base_token_program:  ctx.accounts.base_token_program.to_account_info(),
        quote_token_program: ctx.accounts.quote_token_program.to_account_info(),
        event_authority:     ctx.accounts.event_authority.to_account_info(),
        program:             ctx.accounts.program.to_account_info(),
    };
    // `program` يعمل بمثابة هدف CPI هنا: حساب LaunchLab الخاص به هو كل من أحد
    // حسابات التعليمة المطلوبة (لنمط emit_cpi! الخاص به) والبرنامج
    // الذي يستدعيه CpiContext::new.
    let cpi_ctx = CpiContext::new(
        *ctx.accounts.program.key,
        cpi_accounts,
    );

    cpi::buy_exact_in(cpi_ctx, amount_in, minimum_amount_out, share_fee_rate)?;
    Ok(())
}

بعد التخرج، البرنامج الهدف هو CPMM أو AMM v4 حسب pool_state.migrate_type، الذي تقول products/launchlab/accounts.mdx أنه يُعيّن في وقت Initialize. قائمة حسابات CPI الخاصة بك يجب أن تكون مُحضّرة لأي منهما، أو تحتاج إلى قراءة migrate_type من PoolState أولاً والتفرع.

نشر الأخطاء

كل برنامج Raydium مبني على Anchor يعيد enum أخطاء خاص به؛ Anchor يلفه، لذا يرى برنامجك الاستدعاء Err(ProgramError::Custom(code)). للتعامل مع أخطاء محددة:

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: {:?}", e);
        // أعد الرفع، أو حوّل إلى نوع خطأ خاص بك.
        Err(e)
    }
}

استبدل نوع الخطأ ذا الصلة للبرنامج الذي تستدعيه (raydium_clmm::error::ErrorCode لـ CLMM، وهكذا). أرقام رموز الخطأ مستقرة وفقاً لسياسة IDL (sdk-api/anchor-idl)، لذا يمكنك الاختبار مقابل رموز محددة بالمقارنة مع القيمة الرقمية. جداول الأخطاء الكاملة: CPMM، CLMM، AMM v4 و Farm v6 و LaunchLab.

ميزانية الحساب في CPIs المركبة

لكل إطار CPI نفقات عامة، واستهلاك CU الخاص بالمستدعى يتراكم فوق ملكك، لذا معاملة تستدعي Raydium من داخل برنامجك تحتاج إلى ميزانية حساب صريحة بدلاً من الاعتماد على الحد الافتراضي 200k CU.

نقطة بيانات واحدة مقاسة، وليست معيار. تقدير قاعدة الإبهام الشائع لـ CPMM swap CPI (تقريباً 1,500 CU CPI overhead + 150,000 CU للمبادلة نفسها + 10,000 CU لتحديث الملاحظة، ~161,500 CU إجمالي) يبالغ في الاستخدام الفعلي بهامش كبير. مبادلة CPI حقيقية (my_proxy_swap تستدعي swap_base_input، mints SPL-token، مجموعة ثنائية الرمز تم إنشاؤها للتو) استهلكت ~47,700 CU إجمالي، مقروءة من connection.getTransaction(...).meta.computeUnitsConsumed، تقريباً ثلث هذا التقدير. تعامل مع هذا كنقطة بيانات واحدة من شكل مجموعة واحد وتكوين mint واحد، وليس مواصفة. قس معاملتك الخاصة بدلاً من وضع ميزانية من أي رقم.

CPIs الخاصة بـ CLMM و LaunchLab تكلف أكثر (CLMM بالتحديد تمشي مصفوفات تجزئة إضافية عبر remaining_accounts، مضيفة CU لكل مصفوفة)، لكن فقط رقم CPMM أعلاه هو قيمة مقاسة. اضبط دائماً حد ComputeBudgetProgram::set_compute_unit_limit(...) صريح بحجم من قياسك الخاص، وليس رقماً منسوخاً من التوثيق، لأن حد 200k CU الافتراضي سيستنزف بصمت وتكاليف كل تعليمة تتحول مع ترقية البرامج.

AMM v4: بناء التعليمة اليدوي

AMM v4 يسبق Anchor وليس لديه صندوق CPI، مما يجعله البرنامج الوحيد في هذا المستند الذي لا يتبع النمط العام أعلاه. بناء Instruction يدويًا:

use anchor_lang::prelude::*;
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 هو 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(token_program_id, false),
        AccountMeta::new(amm_id, false),
        AccountMeta::new_readonly(amm_authority, false),
        // ... الحسابات المتبقية حسب products/amm-v4/instructions ...
    ],
    data,
};
invoke_signed(&ix, &account_infos, signer_seeds)?;

انظر products/amm-v4/code-demos لقائمة الحسابات الكاملة.

Farm v6

استخدم TS SDK إذا كان هذا خياراً لتكاملك. raydium.farm.deposit(...) (انظر products/farm-staking/code-demos) يتم ممارسته من قبل عروض توضيحية حقيقية ولا يعتمد على ما إذا كان صندوق Rust Anchor موجوداً لهذا البرنامج.

حالة Anchor CPI الخاصة بـ Farm v6 غير مؤكدة، والأدلة المتاحة تناقضها. لا يوجد IDL عام أو مصدر لـ Farm v6، مما يناقض ادعاء products/farm-staking/code-demos.mdx بوجود صندوق CPI Anchor (raydium_farm_v6) مع هيكل حسابات Deposit.

إذا كنت بحاجة إلى Rust CPI بغض النظر، على سبيل المثال التركيب من برنامج آخر على السلسلة، بناء Instruction يدويًا، بنفس الطريقة كـ AMM v4: اشتق قائمة الحسابات الحقيقية ومميزات التعليمات بشكل مستقل، على سبيل المثال بفك تشفير تخطيطات TypeScript الخاصة بـ SDK (raydium-sdk-V2’s farm module)، فك تشفير معاملات حقيقية مباشرة (انظر أدناه)، أو تفريغ وفك تجميع البرنامج المنشور. لشكل التعليمة بدون حجة المتسق مع استدعاء حصاد أو مطالبة، ترتيب الحساب الحقيقي هو بادئة ثابتة (token_program، حساب حالة المزرعة، PDA سلطة الخزينة، أول خزينة مكافأة لـ PDA، PDA ثانية، المتصل، و ATA المتصل لأول رمز مكافأة)، متبوعة بأزواج (reward_vault_i, user_reward_ata_i) في remaining_accounts لكل تدفق مكافأة بعد الأول. اتفاقية الاقتران حقيقية، لكنها تبدأ فقط في تدفق المكافأة الثاني: خزينة وـ ATA تدفق المكافأة الأول ثابتة، وليست مجاورة لبعضها البعض، وليست جزءاً من remaining_accounts على الإطلاق.

اختبار تدفق CPI

يتطلب dev المحلي توفر برامج Raydium في مدقق الاختبار المحلي. ثلاثة خيارات:

anchor test مع استنساخ البرنامج. يسحب bytecode mainnet المنشور إلى مدقق محلي؛ انظر استنساخ البرامج إلى مدقق محلي أدناه لتكوين Anchor.toml وشيئين يعثران على اختبارات إنشاء المجموعة بالتحديد.
Devnet. ينشر Raydium معظم البرامج إلى devnet، لكن في معرفات برامج مختلفة عن mainnet لكل برنامج (CPMM و CLMM و AMM v4 و Stable AMM و LaunchLab لكل منها عنوان devnet مميز؛ انظر جدول Devnet في reference/program-addresses). لا يتم نشر Farm v3/v5/v6 بشكل موثوق على devnet؛ API المباشر (https://api-v3-devnet.raydium.io/main/info) لديه الصورة الحالية. إذا استخدمت ثوابت DEVNET_PROGRAM_ID المجمعة في raydium_clmm (أو ما يعادلها للبرامج الأخرى)، لا تفترض أن معرّف mainnet يعمل أيضاً على devnet. شغّل anchor test --provider.cluster devnet للوصول إلى الكود المباشر بمجرد حصولك على العناوين الصحيحة.
نشر محلي. استنسخ مستودعات Raydium (CPMM و CLMM؛ مصدر LaunchLab غير متاح لهذا الخيار) و anchor deploy إلى مدقق محلي. يضيف نفقات عامة لدورة الاختبار لكن يسمح لك بتعديل المستدعى للتصحيح.

شغّل مع anchor test، أو anchor build أولاً و anchor test --skip-build بعد ذلك إذا كنت تكرر على ملف الاختبار بدون تغيير البرنامج.

استنساخ البرامج إلى مدقق محلي

[test]
# الافتراضي (5s) ليس كافياً بمجرد استنساخ عدة حسابات، لأن كل واحد
# هو جولة RPC mainnet متسلسلة أثناء بدء المدقق.
startup_wait = 60000

[test.validator]
url = "https://api.mainnet-beta.solana.com"

[[test.validator.clone]]
address = "CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK"  # CLMM

[[test.validator.clone]]
address = "CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C"  # CPMM

[[test.validator.clone]]
address = "LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj"   # LaunchLab

[[test.validator.clone]]
address = "FarmqiPv5eAj3j1GMdMCMUGXqPUvmquZtMy86QH6rzhG"  # Farm v6

يعمل هذا بمعرّف البرنامج بغض النظر عما إذا كان مصدر البرنامج عاماً، لذا يستنسخ LaunchLab بنفس الطريقة CPMM و CLMM حتى لو لم يكن مصدره متاحاً. reference/program-addresses هو مصدر الحقيقة لكل عنوان هنا.

استنساخ البرنامج ليس كافياً إذا كان اختبارك أيضاً ينشئ مجموعة (بدلاً من المبادلة مقابل واحدة موجودة بالفعل). تعليمة initialize الخاصة بـ CPMM تتحقق من حسابات amm_config و create_pool_fee مقابل بيانات حقيقية على السلسلة، لذا تحتاج إلى استنساخ تلك أيضاً، أو initialize يفشل تماماً. لـ CPMM بالتحديد: استنسخ AmmConfig لفئة الرسوم التي تريدها (احصل على عنوانها من GET https://api-v3.raydium.io/main/cpmm-config، الفهرس 0 هو فئة 0.25%) و حساب رمز مستقبل الرسوم، تم التحقق من قبل العنوان الدقيق، وليس تم إنشاؤه على الطاير، لذا يجب أن يكون موجوداً بالفعل.

مجموعة أنشأها اختبارك للتو ليست قابلة للمبادلة في نفس اللحظة. تعليمة initialize الخاصة بـ CPMM تتجاوز بصمت open_time مطلوب ليس بصرامة في المستقبل (if open_time <= block_timestamp { open_time = block_timestamp + 1 })، لذا حتى startTime: 0 (“افتح فوراً،” حسب SDK) يترك فجوة حقيقية ≥1 ثانية قبل أن تقبل المجموعة المبادلات. اختبار ينشئ مجموعة ويبادل ضدها بدون تأخير سيضرب NotApproved. await قصير (1–2s) بين إنشاء المجموعة والمبادلة الأولى كافٍ. هذا خاص بالاختبار؛ إنسان يشغّل أمرين منفصلين يدويين لن يلاحظ عادة، لأن الكتابة وبدء العملية تأكل بالفعل أكثر من ثانية.

مؤشرات

products/cpmm/code-demos، products/clmm/code-demos، products/amm-v4/code-demos، products/farm-staking/code-demos، products/launchlab/code-demos: أمثلة CPI و TypeScript خاصة بالمنتج.
sdk-api/anchor-idl: استرجاع IDL وإعادة توليد العميل، بما في ذلك مسار IDL-codegen لـ LaunchLab.
integration-guides/cpi-integration: أنماط تكامل أعلى مستوى مثل الضمانات والأقبية وتركيب المجمّع.

المصادر:

raydium-cp-swap
raydium-clmm
raydium-idl: LaunchLab IDL (مصدر البرنامج نفسه مغلق)
Anchor CPI docs

Solana fundamentals

Quick start

SDK & API

Integration guides

أي نمط ينطبق على أي برنامج

تبعيات Cargo

النمط العام لـ Anchor CPI

بناء قائمة الحسابات

بناء استدعاء CPI

بذور الموقّع (CPI موقّع بـ PDA)

الحسابات المتبقية

تطبيق النمط: CLMM

تطبيق النمط: LaunchLab

نشر الأخطاء

ميزانية الحساب في CPIs المركبة

AMM v4: بناء التعليمة اليدوي

Farm v6

اختبار تدفق CPI

استنساخ البرامج إلى مدقق محلي

مؤشرات

​أي نمط ينطبق على أي برنامج

​تبعيات Cargo

​النمط العام لـ Anchor CPI

​بناء قائمة الحسابات

​بناء استدعاء CPI

​بذور الموقّع (CPI موقّع بـ PDA)

​الحسابات المتبقية

​تطبيق النمط: CLMM

​تطبيق النمط: LaunchLab

​نشر الأخطاء

​ميزانية الحساب في CPIs المركبة

​AMM v4: بناء التعليمة اليدوي

​Farm v6

​اختبار تدفق CPI

​استنساخ البرامج إلى مدقق محلي

​مؤشرات

أي نمط ينطبق على أي برنامج

تبعيات Cargo

النمط العام لـ Anchor CPI

بناء قائمة الحسابات

بناء استدعاء CPI

بذور الموقّع (CPI موقّع بـ PDA)

الحسابات المتبقية

تطبيق النمط: CLMM

تطبيق النمط: LaunchLab

نشر الأخطاء

ميزانية الحساب في CPIs المركبة

AMM v4: بناء التعليمة اليدوي

Farm v6

اختبار تدفق CPI

استنساخ البرامج إلى مدقق محلي

مؤشرات