Mejores prácticas de desarrollo local

Un resumen condensado de las 25 prácticas más importantes de desarrollo local extraídas de todas las páginas de esta sección.

1. Por defecto usar localnet para CI: Ejecuta solana-test-validator --reset en pipelines; evita los límites de tasa de devnet (Conceptos básicos de desarrollo local).

2. Fijar RPC en Anchor.toml: La URL del proveedor debe coincidir con el clúster activo para evitar despliegues accidentales en devnet durante anchor test.

3. Siempre usar --reset en CI: La génesis determinista evita pruebas inestables debido al estado previo del ledger (solana-test-validator).

4. Iniciar logs antes de las transacciones: Ejecuta solana logs en una segunda terminal antes de enviar (Logs locales y depuración).

5. Confirmar archivos de fixture: Versiona los fixtures JSON con la ranura de origen documentada (Carga de programas y fixtures).

6. Minimizar conjuntos de clones: Clona solo las cuentas que tu instrucción toca; el tiempo de inicio escala linealmente (Clonación de cuentas de Mainnet).

7. Usar RPC del proveedor para clones: La obtención de mainnet durante la clonación necesita una --url fiable con clave API.

8. Coincidir los IDs de programa en todas partes: La clave pública de --bpf-program debe ser igual a declare_id! y a las constantes del cliente.

9. Usar LiteSVM para velocidad: Prueba las rutas críticas en LiteSVM 0.6.x; reserva el validador para integración.

10. Usar Surfpool para gráficos DeFi: Cuando los clones explotan, cambia a la simulación de la bifurcación de Surfpool 0.12.0 (Surfpool).

11. Documentar la elección del clúster por PR: Sigue el Flujo de trabajo de Localnet vs Devnet y registra la decisión.

12. Fondear generosamente las billeteras locales: Los airdrops locales son gratuitos; prueba diseños que consumen mucha renta de forma realista.

13. Medir CU localmente: Lee computeUnitsConsumed antes de establecer los presupuestos de cómputo de mainnet.

14. Reducir msg! en compilaciones de producción: El ruido de los logs trunca y desperdicia CU; usa feature gates para logs detallados.

15. Omitir local-validator intencionalmente: Al gestionar un validador de larga duración, pasa anchor test --skip-local-validator consistentemente.

16. Matar validadores huérfanos: Libera el puerto 8899 antes de que CI vuelva a ejecutarse; los procesos obsoletos causan "conexión rechazada".

17. Separar directorios de ledger para experimentos: Usa --ledger por rama de características al explorar el estado persistente.

18. Sincronizar pines de la toolchain: El validador local debe ejecutar Agave 4.1.1, coincidiendo con los artefactos de despliegue.

19. Probar transacciones v0 localmente: Incluye ALTs en las pruebas locales cuando mainnet use transacciones versionadas.

20. No depender de devnet para las puertas de CI: Trata devnet como una prueba de humo opcional, no como un bloqueador de fusión.

21. Refrescar clones obsoletos: Reinicia el validador cuando los cambios en el diseño de mainnet rompan las pruebas de CPI.

22. Exportar JSON de transacciones fallidas: Adjunta la salida de solana transaction a los problemas para reproducibilidad.

23. Demos de billetera en devnet: Apunta Phantom al RPC de devnet para demos a stakeholders; el localhost de localnet es frágil.

24. Sondear mainnet con polvo: Las comprobaciones finales de aterrizaje necesitan tarifas reales; no reemplazables solo por localnet.

25. Emparejar pruebas locales con clientes del kit: Apunta las pruebas de integración de @solana/kit 7.0.0 a la misma URL RPC que la CLI.

Preguntas frecuentes

Relacionado

• Conceptos básicos de desarrollo local - entrada de sección
• solana-test-validator - referencia del validador
• Mejores prácticas de pruebas de Solana - política de pruebas más amplia
• Mejores prácticas de Solana CLI - higiene de la CLI

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.