Lista de verificación de configuración del entorno

Instala y verifica la cadena de herramientas de desarrollo de Solana en macOS o Linux: Rust 1.91.1, Agave 4.1.1 / Solana CLI 3.0.10, Anchor 0.32.1 y una ruta de validador local funcional.

Cómo usar esta lista de verificación

• Complétala en una sola sesión (30-60 minutos en una red rápida).
• Copia/pega los comandos en un registro de terminal para que tu compañero los revise si te quedas atascado.
• Vuelve a ejecutar las verificaciones de versión después de las actualizaciones del sistema operativo o los cambios en el perfil de la shell.

Cadena de herramientas Rust

• Instala rustup y la versión estable 1.91.1. rustc --version muestra 1.91.1.
• Agrega destinos wasm/sbf a través de las herramientas de la plataforma Agave. cargo build-sbf --version se completa correctamente.
• Instala los componentes rustfmt y clippy. cargo fmt --version funciona.
• Opcional: rust-analyzer en el editor. Abre el crate del programa y ve los tipos.

Agave / Solana CLI

• Instala Solana CLI 3.0.10 (canal Agave 4.1.1). solana --version coincide.
• Instala agave-install y verifica. agave-install --version está disponible.
• Configura el clúster predeterminado en devnet para la incorporación. solana config get muestra la URL de devnet.
• Crea un par de claves predeterminado o usa la ruta de la política del equipo. solana-keygen pubkey imprime la dirección.
• Solicita un airdrop de devnet (2 SOL). solana balance > 0 en devnet.
• Confirma la presencia de la CLI spl-token. spl-token --version se ejecuta.

Anchor

• Instala avm (Anchor Version Manager). avm --version funciona.
• Instala y usa Anchor CLI 0.32.1. anchor --version -> 0.32.1.
• Verifica anchor-lang 0.32.1 en el Cargo.toml de la plantilla. Coincide con la CLI.
• Ejecuta una prueba de humo anchor init en un directorio temporal. anchor build se completa correctamente.

Node / TypeScript (para clientes)

• Instala Node LTS (20+). node --version registrado en el .nvmrc del equipo.
• Instala @solana/kit@7.0.0 en la aplicación de plantilla. npm ls @solana/kit muestra 7.0.0.
• Opcional: instala gill para el arranque de la aplicación. Coincide con la versión principal de kit.

Validador local y pruebas

• Ejecuta solana-test-validator una vez. RPC en http://127.0.0.1:8899 responde.
• Implementa un programa de ejemplo en el validador local. solana program deploy se completa correctamente.
• Instala LiteSVM 0.6.x como dependencia de desarrollo en el crate del programa. cargo test ejecuta el caso LiteSVM.
• Opcional: instala Surfpool 0.12.0. surfpool --version para simulaciones de bifurcación.

Python (pista de backend opcional)

• Se creó un entorno virtual de Python 3.11+. python --version documentado.
• pip install solders solana anchorpy. La prueba de humo de importación se completa correctamente.

Script de verificación

• Ejecuta el script doctor del equipo o el bloque de versiones manual:

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

• Pega la salida en el ticket de incorporación. El compañero confirma las versiones fijadas.

Preguntas frecuentes

Relacionado

• Lista de verificación de incorporación de desarrolladores - incorporación completa
• Descripción general de la cadena de herramientas - qué hace cada herramienta
• Gestión de versiones - cambio de versiones
• Conceptos básicos de desarrollo local - flujos de trabajo del validador

Versiones de la pila: Esta página se escribió 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 y LiteSVM 0.6.x.