Melhores Práticas de Contas e Restrições

Estruturas de conta com falha fechada e confiança mínima para programas Anchor de produção.

Como Usar Esta Lista

• Revise cada novo #[derive(Accounts)] contra esta lista.
• Trate UncheckedAccount como uma exceção de segurança que requer um comentário.
• Reexecute a revisão ao adicionar init_if_needed ou CPIs de token.

A - Higiene de Tipos

• Use Signer para autoridades, não UncheckedAccount com is_signer manual.
• Prefira Account<T> em vez de UncheckedAccount para estado de propriedade do programa.
• Inclua Program<Token/System> explicitamente para cada destino de CPI.
• Use tipos de Interface para Token-2022 ao suportar extensões.

B - Restrições

• Valide PDAs com seeds + bump armazenado em cada instrução.
• Adicione has_one para relacionamentos de autoridade em vez de verificações apenas no manipulador.
• Mapeie falhas de restrição para #[error_code] com a sintaxe @.
• Evite init_if_needed sem verificações de autoridade em contas existentes.

C - Dimensionamento e Ciclo de Vida

• Use InitSpace + max_len para campos de comprimento variável.
• Feche contas para um destinatário definido para recuperar o aluguel.
• Documente migrações quando o espaço crescer com realloc ou novas contas.
• Nunca confie na ordem de conta fornecida pelo cliente sem restrições de tipo.

FAQs

Relacionados

• Tipos de Conta - wrappers
• Restrições Personalizadas - invariantes
• Melhores Práticas Básicas do Anchor - hábitos de workspace

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.