Mejores Prácticas de Python para Solana

Reglas para servicios de Python de nivel de producción que se comunican con la RPC de Agave 4.1.1: matemáticas correctas, claves seguras, envíos resilientes y fallos observables.

Cómo Usar Esta Lista

• Aplícala a cada bot, backend y trabajo ETL antes de la habilitación en mainnet.
• Combínala con una revisión de código centrada en la firma, las tarifas y la lógica de reintentos.
• Revísala cuando cambien el proveedor de RPC, el IDL de Anchor o el comportamiento del mercado de tarifas.

A - Seguridad y Claves

• Nunca incluyas en el commit keypairs o claves de API. Usa variables de entorno, gestores de secretos o firmantes respaldados por HSM.
• Aísla las billeteras "hot" por estrategia con límites de gasto. Limita el radio de explosión en caso de error o fuga de claves.
• Ejecuta bots bajo cuentas de servicio dedicadas. No bajo portátiles de desarrolladores en producción.
• Valida las pubkeys antes de construir instrucciones. Pubkey.from_string detecta entradas mal formadas tempranamente.
• Redacta los secretos de los logs. Elimina el material de claves y las claves de API del proveedor de los rastros de error.

B - RPC y Datos

• Usa RPC privada con SLA para bots de mainnet. Los puntos finales públicos tienen límites de tasa y latencia.
• Establece explícitamente el commitment por llamada. confirmed para trading; finalized para contabilidad.
• Limita y retrocede en 429/5xx. El jitter evita las "manadas de truenos" entre réplicas.
• Evita getProgramAccounts sin filtrar. Usa filtros memcmp o un indexador.
• Caché de datos inmutables de cuentas. Los decimales de acuñación y los IDs de programa rara vez cambian.

C - Transacciones

• Simula antes de cada envío a mainnet. Lee los logs en caso de fallo; no reintentes ciegamente.
• Actualiza el blockhash en cada reintento. Los blockhashes expirados garantizan el fallo.
• Establece explícitamente el límite de unidades de cómputo y el precio. No confíes en los valores predeterminados durante la congestión.
• Usa lamports enteros de extremo a extremo. No uses flotantes en los cálculos de montos.
• Confirma las transacciones con tiempos de espera. Rastrea las firmas atascadas y alerta a los operadores.

D - AnchorPy e IDL

• Fija el JSON del IDL al hash del programa desplegado. Regenera en las actualizaciones de Anchor 0.32.1.
• Separa las configuraciones por clúster. Los IDs de programa de Devnet y Mainnet difieren.
• Usa AsyncClient en todo el código asyncio. No bloquees la RPC en los bucles de eventos.

E - Operaciones

• Logging estructurado con firma, slot y tarifa. Permite la correlación de incidentes.
• Exporta métricas: tasa de éxito de envíos, razones de fallo de simulación, latencia de RPC. Los dashboards son mejores que grep.
• Fija las versiones de las dependencias en requirements.txt o el lock de Poetry. Despliegues reproducibles.
• Ejecuta en modo "dry-run" en devnet o en una bifurcación de Surfpool 0.12.0 antes de mainnet. Valida las metadatos de cuenta de forma económica.

Preguntas Frecuentes

Relacionado

• Conceptos Básicos de Python para Solana - introducción a la sección
• Construcción de Transacciones en Python - patrones de tx
• Trading y Bots - arquitectura de automatización
• Mejores Prácticas de Tarifas de Prioridad - aterrizaje de tx

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