Noções Básicas de CPI em Anchor
8 exemplos para você começar com CPIs em Anchor - 5 básicos e 3 intermediários.
Busque em todas as páginas da documentação
8 exemplos para você começar com CPIs em Anchor - 5 básicos e 3 intermediários.
Cargo.toml do programaO programa System CPI move lamports entre contas.
use anchor_lang::system_program::{self, Transfer};
system_program::transfer(
CpiContext::new(
ctx.accounts.system_program.to_account_info(),
Transfer {
from: ctx.accounts.payer.to_account_info(),
to: ctx.accounts.recipient.to_account_info(),
},
),
lamports,
)?;? para propagar ProgramErroranchor-spl envolve a invocação do programa de token. Use transfer_checked - token::transfer / Transfer estão obsoletos porque não carregam mint ou decimais.
use anchor_spl::token_interface::{self, TransferChecked};
token_interface::transfer_checked(
CpiContext::new(
ctx.accounts.token_program.to_account_info(),
TransferChecked {
from: ctx.accounts.from_ata.to_account_info(),
mint: ctx.accounts.mint.to_account_info(),
to: ctx.accounts.to_ata.to_account_info(),
authority: ctx.accounts.authority.to_account_info(),
},
),
amount,
ctx.accounts.mint.decimals,
)?;PDAs assinam CPIs através de fatias de sementes.
use anchor_spl::token_interface::{self, TransferChecked};
let seeds: &[&[u8]] = &[b"vault", &[ctx.bumps.vault]];
let signer: &[&[&[u8]]] = &[seeds];
token_interface::transfer_checked(
CpiContext::new_with_signer(
ctx.accounts.token_program.to_account_info(),
TransferChecked {
from: ctx.accounts.vault_ata.to_account_info(),
mint: ctx.accounts.mint.to_account_info(),
to: ctx.accounts.user_ata.to_account_info(),
authority: ctx.accounts.vault.to_account_info(),
},
signer,
),
amount,
ctx.accounts.mint.decimals,
)?;signer_seeds é &[&[&[u8]]] - uma fatia interna por PDA assinante.key() a um let antes de .as_ref() em um array de sementes, ou o temporário será descartado cedo demais (E0716)Adicione sementes a um contexto existente com .with_signer.
let cpi_ctx = CpiContext::new(
ctx.accounts.token_program.to_account_info(),
transfer_accounts, // uma struct TransferChecked construída anteriormente
);
token_interface::transfer_checked(
cpi_ctx.with_signer(signer),
amount,
ctx.accounts.mint.decimals,
)?;Fixe os IDs de programa CPI na struct de contas.
pub token_program: Program<'info, Token>,
pub system_program: Program<'info, System>,Anchor 0.32 gera clientes CPI a partir de IDL externa.
// lib.rs
declare_program!(other_program);
pub fn call_other(ctx: Context<CallOther>) -> Result<()> {
other_program::cpi::do_something(
CpiContext::new(
ctx.accounts.other_program.to_account_info(),
other_program::cpi::accounts::DoSomething { /* ... */ },
),
)?;
Ok(())
}Relacionado: CPI para Programas Personalizados
Encaminha contas extras para o alvo da CPI.
let mut cpi_ctx = CpiContext::new(program, accounts);
cpi_ctx = cpi_ctx.with_remaining_accounts(ctx.remaining_accounts.to_vec());
other_program::cpi::advanced(cpi_ctx)?;Relacionado: Passando Contas Restantes
Falhas de CPI retornam como ProgramError no chamador.
token_interface::transfer_checked(cpi_ctx, amount, decimals)
.map_err(|_| MyError::TransferFailed)?;Versões da Pilha: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0, e LiteSVM 0.6.x.
Revisado por Chris St. John·Última atualização: 16 de jul. de 2026