CPIs de Token SPL

anchor-spl expõe funções CPI tipadas para o SPL Token: transfer, mint_to, burn, approve, e mais. Elas encapsulam metadados de conta e dados de instrução para o programa de token.

Receita

use anchor_spl::token::{self, MintTo, Transfer};
 
token::mint_to(cpi_ctx, amount)?;
token::transfer(cpi_ctx, amount)?;
token::burn(cpi_ctx, amount)?;

Quando usar isso: Seu programa move tokens SPL sem reimplementar layouts de instrução de token.

Exemplo de Trabalho

#[derive(Accounts)]
pub struct Deposit<'info> {
    #[account(mut)]
    pub user: Signer<'info>,
    #[account(mut)]
    pub user_ata: Account<'info, TokenAccount>,
    #[account(mut)]
    pub vault_ata: Account<'info, TokenAccount>,
    pub token_program: Program<'info, Token>,
}
 
pub fn deposit(ctx: Context<Deposit>, amount: u64) -> Result<()> {
    token::transfer(
        CpiContext::new(
            ctx.accounts.token_program.to_account_info(),
            Transfer {
                from: ctx.accounts.user_ata.to_account_info(),
                to: ctx.accounts.vault_ata.to_account_info(),
                authority: ctx.accounts.user.to_account_info(),
            },
        ),
        amount,
    )?;
    Ok(())
}

O que isso demonstra:

• MintTo requer um signatário da autoridade de cunhagem ou PDA.
• Transfer precisa de ATAs de origem e destino mutáveis.
• Burn reduz o suprimento da conta de queima.
• Token-2022 usa o módulo token_interface.

Mergulho Profundo

Interface de Token (2022)

use anchor_spl::token_interface::{self, Mint, TokenAccount, TokenInterface};
 
pub token_program: Interface<'info, TokenInterface>,

Use ao suportar os programas clássicos Token e Token-2022.

Armadilhas

• Autoridade não signatária para transferência de usuário - CPI falha. Correção: Use Signer ou with_signer para PDA.
• Discrepância de cunhagem/decimais - Valor com magnitude errada. Correção: Valide a cunhagem em ambos os ATAs.
• Esqueceu mut nos ATAs - O programa de token rejeita. Correção: Marque as contas de token como mut.
• Usando o programa Token para cunhagem Token-2022 - Discrepância de proprietário. Correção: Mude para tipos Interface.
• Aprovação sem revogação - Risco de permissão pendente. Correção: Revogue ou use o padrão exact-delegate.

Alternativas

FAQs

Relacionados

• Noções Básicas de CPI no Anchor - CpiContext
• Restrições de Token e Token Associado - validação
• Noções Básicas de SPL Token - modelo de token

Versões da Stack: 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.