Boas Práticas de Fundamentos de Solana

Os fundamentos para internalizar antes de escrever programas, clientes ou infraestrutura no Agave 4.1.1.

Como Usar Esta Lista

• Percorra A até C antes do seu primeiro deploy de programa
• Revise D ao integrar novos membros da equipe vindos de backgrounds EVM
• Trate E como um gate pré-mainnet - cada item deve passar

A - Modelo Mental

• O estado vive em contas, não em programas. Programas são executáveis sem estado que leem/escrevem contas passadas a eles.
• Toda entidade é uma conta. Carteiras, programas, mints de token e structs de dados são todas contas com lamports, owner e campos de data.
• Transações declaram todas as contas antecipadamente. O Sealevel usa essa lista para agendamento paralelo e enforcement de locks.
• Apenas o programa proprietário escreve dados da conta. Segurança segue regras de ownership, não de endereços ocultos.

B - Moeda e Precisão

• Armazene e transmita lamports como inteiros. Use bigint em TypeScript; evite casts f64 em programas Rust.
• Converta SOL para lamports na borda da UI. Faça parse de strings decimais com matemática inteira, não ponto flutuante.
• Leia decimals SPL separadamente de SOL. Valores de token usam decimals específicos do mint, não 1e9.
• Financie novas contas até o mínimo isento de rent. Consulte getMinimumBalanceForRentExemption antes de init.

C - Clusters e Ambiente

• Use devnet como padrão para desenvolvimento de aplicativos. Use validador local (Surfpool 0.12.0 ou solana-test-validator) para CI.
• Fixe URL de RPC, config da CLI e rede da carteira no mesmo cluster. Incompatibilidades geram erros "account not found".
• Nunca faça airdrop ou teste com keypairs de mainnet. Use arquivos de keypair separados por ambiente.
• Verifique o genesis hash ao depurar problemas de cluster. solana genesis-hash confirma que você está na rede pretendida.

D - Chaves e Assinatura

• Nunca faça commit de JSON de keypair no controle de versão. Adicione arquivos *.json de chave ao .gitignore; use gerenciadores de secrets em produção.
• Marque toda conta signatária com isSigner: true. Flags de signatário ausentes causam rejeição em runtime.
• Use PDAs para endereços controlados pelo programa. Usuários assinam; programas assinam por PDAs via seeds.
• Mantenha o fee payer financiado, mas não superfinanciado. Carteiras de serviço guardam SOL mínimo apenas para taxas.

E - Transações e Confirmação

• Use commitment confirmed para a maioria das ações de dapp. Reserve finalized para liquidações de alto valor.
• Atualize o blockhash em cada retry. Blockhashes expirados causam descartes silenciosos.
• Simule antes de enviar durante o desenvolvimento. Decodifique erros de programa a partir dos logs de simulação.
• Assine notificações de signature em vez de polling. WebSockets reduzem carga de RPC e latência.
• Leia logs do explorer para transações com falha. Erros on-chain estão nos logs do programa, não só nos códigos de erro de RPC.

FAQs

solana config set --url devnet && solana airdrop 2

Relacionado

• Noções Básicas de Solana - exemplos práticos de orientação
• O Modelo Mental da Solana vs. EVM - a mudança de modelo mais profunda
• Como uma Transação Flui - boas práticas de confirmação em contexto

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.