Boas Práticas de PDA

Erros de PDA viram falhas totais de custódia. Aplique esta lista ao projetar seeds, armazenar bumps e assinar CPIs.

Como Usar Esta Lista

• Publique a gramática de seeds no SEEDS.md do repositório.
• Adicione testes em que seeds erradas falham na verificação.
• Revise toda chamada invoke_signed em PRs.

A - Derivação

• Use prefixo ASCII único por tipo de conta. Previne colisões semânticas.
• Inclua todos os pubkeys de domínio necessários para isolamento. Evita erros de vault global.
• Codifique inteiros como arrays little-endian fixos. Determinístico entre clientes.
• Derive on-chain antes de confiar; nunca confie só no endereço do cliente. Invariante central de segurança.
• Armazene bump canônico na inicialização. Economiza CU e fecha bump hunting.

B - Assinatura

• Mantenha invoke_signed dentro de handlers de instrução validados. Sem endpoints públicos de assinatura.
• Corresponda a ordem das seeds exatamente entre derivar e assinar. Previne falhas intermitentes de CPI.
• Anexe bump como segmento de seed de um byte. Formato exigido pelo runtime.
• Defina bit de signatário em account metas de PDA no CPI quando necessário. Enforcement do runtime.
• Libere borrows de data antes de assinar CPI. Evita erros de borrow no runtime.

C - Operações

• Documente endereços PDA no IDL ou schema Codama. Correção de clientes.
• Teste ciclo create-init-close no Surfpool. Captura bugs de reinit.
• Revogue autoridades de mint de token quando o supply estiver fixo. Integridade de supply.
• Versione o esquema de seeds para mudanças breaking. Clareza de caminho de migração.
• Audite upgrade authority separadamente da lógica de PDA. Risco de governança.

FAQs

Relacionado

• Noções Básicas de PDA - Introdução
• Assinando com PDAs - assinatura em CPI
• Boas Práticas de CPI - regras de CPI

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.