Restrições de Token e Token Associado

anchor-spl fornece helpers de restrição para contas SPL Token e Token Associado, reduzindo verificações manuais de mint/autoridade.

Receita

init_if_needed (usado por ambos os exemplos de ATA abaixo) é controlado por um recurso do cargo. Sem ele, nenhum dos trechos compila:

[dependencies]
anchor-lang = { version = "0.32.1", features = ["init-if-needed"] }

use anchor_spl::associated_token::AssociatedToken;
use anchor_spl::token::{Mint, Token, TokenAccount};
 
#[account(
    init_if_needed,
    payer = payer,
    associated_token::mint = mint,
    associated_token::authority = owner,
)]
pub ata: Account<'info, TokenAccount>,

Quando usar isso: Instruções movem tokens ou criam ATAs.

Exemplo de Trabalho

#[derive(Accounts)]
pub struct TransferTokens<'info> {
    #[account(mut)]
    pub payer: Signer<'info>,
    #[account(mut)]
    pub from: Account<'info, TokenAccount>,
    #[account(
        init_if_needed,
        payer = payer,
        associated_token::mint = mint,
        associated_token::authority = recipient,
    )]
    pub to: Account<'info, TokenAccount>,
    pub mint: Account<'info, Mint>,
    pub recipient: SystemAccount<'info>,
    pub token_program: Program<'info, Token>,
    pub associated_token_program: Program<'info, AssociatedToken>,
    pub system_program: Program<'info, System>,
}

O que isso demonstra:

• associated_token::mint vincula a ATA ao mint
• associated_token::authority define o proprietário
• O programa de token deve estar na lista de contas
• Use token_interface para Token-2022

Mergulho Profundo

Token-2022 / Interface

Para Token-2022, use InterfaceAccount e TokenInterface. Esses tipos vêm de anchor_spl::token_interface, não de anchor_spl::token — anchor_spl::token::Mint é o tipo legado apenas para Token e sua verificação de proprietário rejeita mints Token-2022:

use anchor_spl::token_interface::{Mint, TokenAccount, TokenInterface};
 
pub token_program: Interface<'info, TokenInterface>,
pub mint: InterfaceAccount<'info, Mint>,
#[account(mut)]
pub token_account: InterfaceAccount<'info, TokenAccount>,

anchor_spl::token_interface espelha anchor_spl::token com tipos cientes de interface; escolha um módulo por programa e não misture os dois tipos Mint.

Armadilhas

• ID do programa de token incorreto - A restrição falha para Token-2022. Correção: Use Interface ao suportar ambos.
• Inicialização de ATA sem programa de sistema - CPI de criação incompleta. Correção: Inclua os programas de sistema e de token associado.
• Discrepância de mint na transferência - O programa de token rejeita. Correção: Adicione constraint = from.mint == mint.key().
• ATA de destinatário não verificada - Fundos enviados para ATA errada. Correção: Use restrições de token associado.
• mut ausente em contas de token - A transferência falha. Correção: Marque a origem e o destino como mut.

Alternativas

FAQs

Relacionados

• CPIs SPL Token - helpers de transferência
• Contas de Token Associadas - modelo ATA
• anchor-lang & anchor-spl - visão geral dos crates

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.

3730363230327c3934336f6967637c6f692e73656469756765646f63