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 --versionmostra 1.91.1. - Adicione targets wasm/sbf via ferramentas de plataforma Agave.
cargo build-sbf --versionsucede. - Instale componentes rustfmt e clippy.
cargo fmt --versionfunciona. - 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 --versioncorresponde. - Instale
agave-installe verifique.agave-install --versiondisponível. - Defina cluster padrão para devnet no onboarding.
solana config getmostra URL devnet. - Crie keypair padrão ou use caminho de política do time.
solana-keygen pubkeyimprime endereço. - Solicite airdrop devnet (2 SOL).
solana balance> 0 em devnet. - Confirme CLI
spl-tokenpresente.spl-token --versionroda.
Anchor
- Instale
avm(Anchor Version Manager).avm --versionfunciona. - Instale e use Anchor CLI 0.32.1.
anchor --version-> 0.32.1. - Verifique
anchor-lang0.32.1 noCargo.tomltemplate. Corresponde à CLI. - Execute smoke test
anchor initem dir temp.anchor buildsucede.
Node / TypeScript (para clients)
- Instale Node LTS (20+).
node --versionregistrado no.nvmrcdo time. - Instale
@solana/kit@7.0.0no app template.npm ls @solana/kitmostra 7.0.0. - Opcional: instale
gillpara bootstrap de app. Corresponde major do kit.
Validator Local e Testes
- Execute
solana-test-validatoruma vez. RPC emhttp://127.0.0.1:8899responde. - Implante programa sample no validator local.
solana program deploysucede. - Instale dev-dep LiteSVM 0.6.x no crate do programa.
cargo testroda caso LiteSVM. - Opcional: instale Surfpool 0.12.0.
surfpool --versionpara sims fork.
Python (trilha backend opcional)
- Venv Python 3.11+ criado.
python --versiondocumentado. -
pip install solders solana anchorpy. Smoke test de import passa.
Script de Verificação
- Execute script
doctordo 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
Notas Apple Silicon?
Use binários Agave aarch64; algumas imagens Docker precisam platform: linux/amd64 para paridade CI.
WSL no Windows?
Suportado com toolchain Linux; ledger USB pode precisar setup extra.
Múltiplas versões Anchor?
avm use 0.32.1 por repo; não confie em default global.
Problemas de PATH?
Garanta ~/.local/share/solana/install/active_release/bin precede caminhos antigos Solana 1.x.
Proxy corporativo?
Configure proxies cargo e npm antes de instalações.
Dev apenas Docker?
Aceitável se pins de versão dentro da imagem correspondem ao output do checklist.
Disco insuficiente?
Ledger Agave + target/ precisam vários GB - prune artefatos antigos semanalmente.
Paridade CI?
Espelhe estas versões na matrix GitHub Actions.
Hardware wallet?
Opcional para onboarding; devnet usa keypairs de arquivo primeiro.
Quando instalar Jito CLI?
Apenas para papéis relacionados a MEV - não obrigatório para completar checklist.
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.