Melhores práticas de token SPL

Regras para manuseio correto e seguro do token SPL no Agave 4.1.1 - desde o lançamento do mint até CPIs do programa e leituras do cliente.

Como usar esta lista

• Aplique A antes de criar qualquer mainnet mint
• Revise B antes de enviar o cofre na rede ou o código de pagamento
• Use C ao criar carteiras, painéis e indexadores

A - Lançamento do Mint

• Escolha os decimais uma vez no início da casa. Imutável para sempre - indústria de correspondência (6 para stablecoins, 9 para SOL-like).
• Revogar a autoridade da casa da moeda após a distribuição. O fornecimento fixo é o sinal de confiança padrão, a menos que a inflação seja documentada.
• Revogar a autoridade de congelamento para tokens da comunidade. A menos que a conformidade exija o congelamento, os titulares não devem enfrentar o congelamento de contas.
• Documente transações de autoridade publicamente. Indexadores e exploradores devem corresponder aos seus anúncios.
• Verifique o mint pubkey on-chain antes do marketing. Erros de digitação em URLs causam perda irreversível do usuário.

B - Programas On-Chain

• Use transfer_checked com decimais perfeitos. Evita confusão entre decimais cruzados em programas de vários ativos.
• Restringir token::mint em cada TokenAccount. Interrompe depósitos de ativos errados em cofres.
• Validar endereços ATA por meio de derivação. Não confie cegamente nas chaves públicas da conta de token fornecidas pelo usuário.
• Assine CPIs do vault do PDA com new_with_signer. Sementes faltantes são a falha na transferência do vault superior.
• Use token_interface ao aceitar o Token-2022. A restrição clássica do programa Token rejeita extensões de hortelã.
• Rejeitar transferências/mints de valor zero. Desperdiça CU e confunde análises.

C - Clientes e Operações

• Converta valores de UI com BigInt/string math. Nunca float * 1e6 para valores de pagamento de produção.
• Leia decimais do RPC mint, não constantes. Aplicativos com vários tokens precisam de decimais por mint.
• ATAs do destinatário do fundo (--fund-recipient ou criação idempotente). As transferências falham sem a conta de token de destino.
• Reutilize o WSOL ATA para traders ativos. Evite repetidas rotações de aluguel.
• Mostrar valores brutos e de UI nas ferramentas administrativas. Suporte para depuração de incidentes decimais.
• Revogar aprovações de delegados obsoletos após trocas DeFi. Reduz o risco de esgotamento da carteira.

Perguntas frequentes