Trabalhando com Pubkeys e Contas

Pubkey identifica contas e programas. AccountInfo é o handle do runtime para lamports, dados, owner e flags de signer. Slicing e validação corretos previnem escalação de privilégio.

Receita

use solana_program::{account_info::AccountInfo, pubkey::Pubkey};
 
fn assert_signer(ai: &AccountInfo) -> ProgramResult {
    if !ai.is_signer { return Err(ProgramError::MissingRequiredSignature); }
    Ok(())
}

Quando usar:

• Validar listas de contas fornecidas pelo cliente em programas nativos.
• Comparar owners, PDAs e IDs de programa.
• Iterar contas com next_account_info.

Exemplo Funcional

use solana_program::{
    account_info::{next_account_info, AccountInfo},
    program_error::ProgramError,
    pubkey::Pubkey,
};
 
pub fn process_transfer(accounts: &[AccountInfo], expected_owner: &Pubkey) -> ProgramResult {
    let iter = &mut accounts.iter();
    let payer = next_account_info(iter)?;
    let vault = next_account_info(iter)?;
 
    if !payer.is_signer {
        return Err(ProgramError::MissingRequiredSignature);
    }
    if vault.owner != expected_owner {
        return Err(ProgramError::IncorrectProgramId);
    }
    if !vault.is_writable {
        return Err(ProgramError::InvalidAccountData);
    }
    Ok(())
}

O que isso demonstra:

• Flags signer e writable são aplicadas explicitamente.
• Checagem de owner vincula o vault ao seu programa.
• next_account_info avança o iterador de contas na ordem do cliente.

Aprofundamento

Campos de AccountInfo

Dicas de Pubkey

• Compare com == em referências.
• PDAs têm is_on_curve == false off-chain; on-chain trate como chaves normais.

Notas Rust

let (pda, bump) = Pubkey::find_program_address(&[b"vault", owner.as_ref()], program_id);

Armadilhas

• Deriva de ordem de contas - Reordenação do cliente passa conta errada na checagem. Correção: Documente ordem fixa; use constraints Anchor ou índices explícitos.
• PDA não verificado - Derive bump on-chain e compare ao bump canônico armazenado. Correção: Veja página Canonical Bumps.
• Contas duplicadas - Mesma chave passada duas vezes pode burlar checagens de débito/crédito. Correção: Rejeite chaves duplicadas em instruções sensíveis.
• Owner vs key - Checar key quando quis dizer owner permite impersonação. Correção: Nomeie variáveis claramente e faça lint em reviews.
• Lamports mut sem signer - Debitar SOL exige signer ou autoridade PDA. Correção: Valide signer antes de mudanças em **lamports.

Alternativas

FAQs

Relacionado

• Manual Account Validation - Checklist completo
• Deriving PDAs - Endereços PDA
• PDA Basics - Por que PDAs existem

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.