Checklist de Setup de Ambiente

Instale e verifique a toolchain de desenvolvimento Solana em macOS ou Linux: Rust 1.91.1, Agave 4.1.1 / Solana CLI 3.0.10, Anchor 0.32.1 e caminho de validator local funcional.

Como Usar Este Checklist

• Complete em uma sessão (30-60 minutos em rede rápida).
• Copie/cole comandos em log de terminal para revisão do buddy se travar.
• Reexecute checks de versão após updates de OS ou mudanças de shell profile.

Toolchain Rust

• Instale rustup e stable 1.91.1. rustc --version mostra 1.91.1.
• Adicione targets wasm/sbf via ferramentas de plataforma Agave. cargo build-sbf --version sucede.
• Instale componentes rustfmt e clippy. cargo fmt --version funciona.
• Opcional: rust-analyzer no editor. Abra crate de programa e veja tipos.

Agave / Solana CLI

• Instale Solana CLI 3.0.10 (canal Agave 4.1.1). solana --version corresponde.
• Instale agave-install e verifique. agave-install --version disponível.
• Defina cluster padrão para devnet no onboarding. solana config get mostra URL devnet.
• Crie keypair padrão ou use caminho de política do time. solana-keygen pubkey imprime endereço.
• Solicite airdrop devnet (2 SOL). solana balance > 0 em devnet.
• Confirme CLI spl-token presente. spl-token --version roda.

Anchor

• Instale avm (Anchor Version Manager). avm --version funciona.
• Instale e use Anchor CLI 0.32.1. anchor --version -> 0.32.1.
• Verifique anchor-lang 0.32.1 no Cargo.toml template. Corresponde à CLI.
• Execute smoke test anchor init em dir temp. anchor build sucede.

Node / TypeScript (para clients)

• Instale Node LTS (20+). node --version registrado no .nvmrc do time.
• Instale @solana/kit@7.0.0 no app template. npm ls @solana/kit mostra 7.0.0.
• Opcional: instale gill para bootstrap de app. Corresponde major do kit.

Validator Local e Testes

• Execute solana-test-validator uma vez. RPC em http://127.0.0.1:8899 responde.
• Implante programa sample no validator local. solana program deploy sucede.
• Instale dev-dep LiteSVM 0.6.x no crate do programa. cargo test roda caso LiteSVM.
• Opcional: instale Surfpool 0.12.0. surfpool --version para sims fork.

Python (trilha backend opcional)

• Venv Python 3.11+ criado. python --version documentado.
• pip install solders solana anchorpy. Smoke test de import passa.

Script de Verificação

• Execute script doctor do time ou bloco manual de versão:

rustc --version          # 1.91.1
solana --version         # 3.0.10
anchor --version         # 0.32.1
cargo build-sbf --version
node --version

• Cole output no ticket de onboarding. Buddy confirma pins.

FAQs

Relacionado

• Checklist de Onboarding de Devs - ramp completo
• Visão Geral da Toolchain - o que cada ferramenta faz
• Gerenciamento de Versão - trocar versões
• Noções Básicas de Dev Local - workflows validator

Versões do 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.