Contas do Sistema vs. Contas de Programa

Contas possuídas pelo sistema são simples detentoras de lamports. Contas possuídas por programa têm dados estruturados interpretados por seu proprietário. Contas de Programa (executáveis) contêm bytecode BPF. Cada tipo tem regras de mutação diferentes.

Receita

Exemplo de Trabalho

use anchor_lang::prelude::*;
 
declare_id!("Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS");
 
#[derive(Accounts)]
pub struct TransferSol<'info> {
    #[account(mut)]
    pub from: SystemAccount<'info>,
    #[account(mut)]
    pub to: SystemAccount<'info>,
    pub system_program: Program<'info, System>,
}
 
#[derive(Accounts)]
pub struct MutateState<'info> {
    #[account(mut, owner = crate::ID)]
    pub state: Account<'info, GameState>,
}

O que isso demonstra:

• SystemAccount envolve contas que detêm lamports simples
• Estado personalizado requer owner = seu_id_de_programa
• O Programa do Sistema lida com transferências de SOL; seu programa lida com suas próprias contas de dados

Análise Profunda

Regras de Mutação

• Programa do Sistema pode criar contas, atribuir proprietários, transferir lamports
• Programa proprietário pode escrever data e debitar lamports (dentro das regras)
• Programas não proprietários só podem ler a menos que o proprietário delegue via CPI
• Contas executáveis não podem ser escritas como dados durante invocações normais

Programas Nativos

Armadilhas

• Passar carteira como Account<T> - a desserialização falha em dados vazios. Correção: use SystemAccount ou Signer.
• Escrever diretamente em contas de token SPL - apenas o Programa de Token pode. Correção: CPI para instruções do Programa de Token SPL.
• Tratar a conta de ID do programa como estado - a conta do programa é executável, não seu PDA. Correção: armazene o estado em PDAs pertencentes ao seu programa.
• Restrição de proprietário incorreta - vulnerabilidade de segurança. Correção: sempre defina owner = program_id ou use a verificação automática Account<T> do Anchor.
• Invocar contas executáveis como dados - erro de tempo de execução. Correção: passe contas de programa apenas como Program<'info, T> ou AccountInfo para CPI.

Alternativas

FAQs

Relacionado

• Anatomia da Conta - campos de proprietário e executável
• Estado Possuído por Programa - padrão de conta de estado
• Propriedade e Permissões de Conta - regras de escrita

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.