Busque em todas as páginas da documentação
A inicialização é o momento de maior risco: ataques de reinit, substituição de conta e omissão de discriminador comprometem permanentemente a custódia. Separe criar de init, escreva discriminadores uma vez e rejeite contas já inicializadas.
if account.lamports() > 0 && is_initialized(&account)? { return Err(...); }Quando usar isso:
init e init_if_needed no Anchor.pub fn initialize(state: &AccountInfo, payer: &AccountInfo, system: &AccountInfo, program_id: &Pubkey, bump: u8) -> ProgramResult {
if state.lamports() > 0 {
let data = state.try_borrow_data()?;
if data.len() >= 8 && data[..8] == STATE_DISC { return Err(ProgramError::AccountAlreadyInitialized); }
}
// create_account CPI if empty, then write disc + State::default()
Ok(())
}O que isso demonstra:
| Padrão | Risco |
|---|---|
| init | Baixo se disc verificado |
| init_if_needed | Reinit se guarda fraca |
| create pelo cliente + init pelo programa | Confiança dividida |
Constraints init, init_if_needed, realloc.
// Always set discriminator before accepting deposits.| Alternativa | Use Quando | Não Use Quando |
|---|---|---|
| Txs create/init em duas etapas | Custo de UX mais seguro | Conveniência em um passo |
| Create apenas pelo cliente | Programa mais simples | Fluxos PDA mais difíceis |
| Macro init do Anchor | Mais rápido | Deve entender a expansão |
Custom ou InvalidAccountData.
Constraint de signatário.
invoke_signed create.
Antes de fundos aceitos.
Se tamanho desconhecido antecipadamente - raro.
Permitido se totalmente zerado.
Fluxo SPL separado.
Tente double init no LiteSVM.
Use create idempotente ou pagador assinado apenas pelo usuário.
Lógica de init congelada - teste pesadamente.
Simule create+init.
Classe de reinicialização.
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.
Revisado por Chris St. John·Última atualização: 16 de jul. de 2026