A Estrutura de Contas

Toda instrução declara uma estrutura de contas com #[derive(Accounts)]. O Anchor executa as restrições antes que seu manipulador seja executado, aplicando propriedade, mutabilidade e relacionamentos de forma falha e fechada.

Receita

#[derive(Accounts)]
pub struct Transfer<'info> {
    #[account(mut)]
    pub from: Signer<'info>,
    #[account(mut, constraint = to.owner == from.key())]
    pub to: Account<'info, TokenAccount>,
    pub token_program: Program<'info, Token>,
}

Quando usar isso: Você projeta qualquer instrução que toque em contas on-chain.

Exemplo de Trabalho

#[derive(Accounts)]
pub struct UpdateMetadata<'info> {
    #[account(
        mut,
        seeds = [b"meta", authority.key().as_ref()],
        bump = metadata.bump,
        has_one = authority,
    )]
    pub metadata: Account<'info, Metadata>,
    pub authority: Signer<'info>,
}
 
#[account]
pub struct Metadata {
    pub authority: Pubkey,
    pub bump: u8,
    pub uri: String,
}

O que isso demonstra:

• Tipos de campo (Signer, Account<T>, Program<T>) implicam verificações básicas
• Restrições de atributo adicionam seeds, init, has_one e expressões personalizadas
• O mapa bumps está disponível nos manipuladores para bumps canônicos armazenados
• A ordem de validação é importante para segurança de init e CPI

Mergulho Profundo

Tipos Comuns de Conta

Categorias de Restrição

• Mutabilidade - mut para contas graváveis.
• Propriedade - owner, has_one, restrições de token.
• Endereço - address = expr, seeds/bump para PDAs.
• Ciclo de Vida - init, init_if_needed, close.

Armadilhas

• UncheckedAccount sem restrições - Qualquer conta passa na validação. Correção: Adicione address, owner ou constraint.
• Falta de mut em conta gravável - Falha em tempo de execução na escrita. Correção: Marque toda conta escrita como mut.
• has_one no campo errado - Relacionamento não imposto. Correção: Corresponda o nome do campo ao campo da estrutura nos dados da conta.
• init sem pagador - Criação da conta falha. Correção: Defina payer = signer e inclua o programa do sistema.
• Confiar em PDAs fornecidos pelo cliente - Seeds incorretas drenam fundos. Correção: Sempre use restrições seeds + bump.

Alternativas

FAQs

Relacionado

• Tipos de Conta - referência de tipo
• As Restrições #[account] - catálogo de restrições
• Ordem de Validação de Conta - sequência de verificação

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.