As Restrições #[account]

Atributos de campo em membros de structs de contas compõem regras de validação. Anchor as avalia em uma ordem definida antes que seu manipulador de instruções seja executado.

Receita

#[account(
    mut,
    has_one = authority,
    constraint = vault.amount > 0 @ MyError::InvalidAmount,
)]
pub vault: Account<'info, Vault>,

Expressões de restrição podem referenciar apenas campos de conta irmãos e argumentos de instrução declarados com #[instruction(...)]. Um amount simples aqui não compilaria; se for realmente um argumento de instrução, adicione #[instruction(amount: u64)] à struct.

Quando usar isso: Você expressa propriedade, relacionamentos ou invariantes personalizados declarativamente.

Exemplo de Trabalho

#[derive(Accounts)]
#[instruction(new_fee_bps: u16)]
pub struct SetFee<'info> {
    #[account(
        mut,
        seeds = [b"config"],
        bump = config.bump,
        has_one = admin,
        constraint = new_fee_bps <= 10_000 @ ConfigError::FeeTooHigh,
    )]
    pub config: Account<'info, Config>,
    pub admin: Signer<'info>,
}

O que isso demonstra:

• #[instruction(...)] traz os argumentos do manipulador para o escopo da restrição; ele deve listá-los em ordem, começando pelo primeiro
• mut marca contas graváveis
• has_one verifica a igualdade da chave pública com o campo aninhado
• constraint executa expressões booleanas arbitrárias
• O erro após @ mapeia para uma variante de enum de erro personalizada

Análise Detalhada

Atributos Comuns

Combine atributos; todos devem passar.

Armadilhas

• constraint sem @ erro - Mensagem genérica de violação de restrição. Correção: Adicione @ MyError::Variant para clareza.
• erro de digitação em has_one - Falha silenciosa na compilação ou campo incorreto. Correção: O nome do campo deve existir na struct da conta.
• address = chave incorreta - Quebra a mainnet se uma chave de teste for codificada. Correção: Use constantes pubkey! por sinalizadores de recursos do cluster.
• mut ausente no destino de has_one - Somente leitura quando você precisa escrever. Correção: Adicione mut nas contas que você persiste.
• Restrição e verificação do manipulador sobrepostas - Lógica duplicada se desvia. Correção: Escolha declarativa ou manipulador, não ambos para a mesma regra.

Alternativas

FAQs

Relacionados

• Restrições Personalizadas - expressões avançadas
• Ordem de Validação de Conta - ordem de avaliação
• init & init_if_needed - restrições de ciclo de vida

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.