Simulación de Transacciones
Simulación pre-vuelo y decodificación de errores. Esta guía está dirigida a validadores Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1 y clientes @solana/kit 7.0.0.
Receta
Tarjeta de receta de referencia rápida.
solana config set --url devnet
solana balanceimport { createSolanaRpc } from "@solana/kit";
const rpc = createSolanaRpc("https://api.devnet.solana.com");Cuándo usar esto:
- Implementar o depurar la simulación de transacciones en rutas de producción
- Enseñar el concepto a ingenieros nuevos en Solana
- Auditar si tu stack coincide con el comportamiento de la era Agave 4.1
Ejemplo de Trabajo
import { createSolanaRpc, address } from "@solana/kit";
const rpc = createSolanaRpc("https://api.devnet.solana.com");
const slot = await rpc.getSlot().send();
const sig = "PEGA_LA_FIRMA_DESPUÉS_DE_TU_TX";
const tx = await rpc
.getTransaction(sig, { encoding: "json", maxSupportedTransactionVersion: 0 })
.send();
console.log({ slot, err: tx?.meta?.err, cu: tx?.meta?.computeUnitsConsumed });use anchor_lang::prelude::*;
#[program]
pub mod demo {
use super::*;
pub fn log_slot(_ctx: Context<LogSlot>) -> Result<()> {
let clock = Clock::get()?;
msg!("slot: {}", clock.slot);
Ok(())
}
}
#[derive(Accounts)]
pub struct LogSlot {}Lo que esto demuestra:
- Patrones de acceso RPC con @solana/kit 7.0.0
- Lectura de metadatos de ejecución (errores, CU) de transacciones confirmadas
- Acceso a sysvars en cadena en programas Anchor 0.32.1
Análisis Profundo
Cómo Funciona
- Simulación pre-vuelo y decodificación de errores.
- El modelo de cuentas de Solana requiere listas explícitas de cuentas por instrucción.
- Sealevel ejecuta transacciones no conflictivas en paralelo.
Notas de Agave 4.1.1
- Las semánticas de confirmación siguen la votación TowerBFT con ordenamiento PoH.
- Alpenglow (Votor + Rotor) se está implementando para una finalidad más rápida; consulta la sección de Consenso.
- Desarrollo local: Surfpool 0.12.0 y LiteSVM 0.6.x.
Notas de Rust
// Usa matemáticas verificadas y restricciones explícitas en los programas
require!(amount > 0, MyError::InvalidAmount);Trampas Comunes
- Snippets heredados de web3.js v1 - La API difiere de Kit. Solución: usa @solana/kit 7.0.0.
- Cluster incorrecto - Desajuste entre devnet y mainnet. Solución: alinea CLI, RPC, wallet y explorador.
- Montos de SOL en punto flotante - Pérdida de precisión. Solución: usa lamports bigint de extremo a extremo.
- Blockhash expirado - Transacciones descartadas. Solución: vuelve a obtener el blockhash y firma de nuevo.
- CU insuficiente - OOM o presupuesto excedido. Solución: optimiza el programa + establece el Presupuesto de Cómputo.
- Faltan comprobaciones de propietario - Exploits de cuentas escribibles. Solución: restricciones de Anchor en cada cuenta
mut.
Alternativas
| Alternativa | Usar Cuando | No Usar Cuando |
|---|---|---|
| @solana/kit 7.0.0 | Nuevos clientes TypeScript | Mantenimiento de código heredado temporalmente |
| Solana CLI 3.0.10 | Operaciones y sondeos rápidos | Firma de transacciones en producción a escala |
| Surfpool 0.12.0 | Pruebas de integración de Anchor | Despliegue en producción |
| LiteSVM 0.6.x | Pruebas unitarias rápidas | Validación del comportamiento completo de la red |
Preguntas Frecuentes
¿Cómo se aplica esto en Agave 4.1.1?
El RPC simulateTransaction de Agave 4.1.1 ejecuta la misma ruta de Sealevel que la ejecución real, menos la persistencia y las tarifas.
¿Qué versión de Solana CLI debo usar?
Usa Solana CLI 3.0.10, que se empareja con Agave 4.1.1. Instala con agave-install init 4.1.1 (o el archivo de pines de tu equipo), luego verifica con solana --version y agave-install --version.
¿Debo usar @solana/kit o web3.js?
Usa @solana/kit 7.0.0 para nuevos métodos RPC tipados en TypeScript, una superficie de API más pequeña y los ejemplos de esta página ya usan Kit. Conserva web3.js solo para bases de código heredadas; migra las llamadas RPC y la construcción de transacciones incrementalmente.
¿Qué nivel de compromiso se recomienda?
Simula en confirmed, luego consulta getSignatureStatuses en confirmed para mayor velocidad. Usa finalized antes de tratar los movimientos de tokens como asentados.
¿Cómo depuro fallos relacionados?
Siempre lee err, logs y unitsConsumed. Coincide exactamente con la lista de cuentas y los firmantes; la simulación tiene éxito pero el envío falla cuando el blockhash o las tarifas difieren.
¿Funciona esto en devnet?
Sí, apunta la CLI y el RPC a https://api.devnet.solana.com. El comportamiento coincide con mainnet; solo los datos de la cuenta y la economía difieren.
¿Cómo afectan las unidades de cómputo a esto?
La simulación devuelve el uso de CU; úsalo para establecer SetComputeUnitLimit con aproximadamente un 10% de margen.
¿Cuál es el patrón de Anchor 0.32.1?
Anchor 0.32.1 usa #[program], Context<T> y #[derive(Accounts)] con restricciones explícitas de mut/signer; ejecuta anchor build y anchor test en 0.32.1 a través de avm use 0.32.1.
¿Cómo pruebo con Surfpool 0.12.0?
Ejecuta anchor test con Surfpool 0.12.0 para simular transacciones completas contra una bifurcación de mainnet, especialmente las rutas de priority-fee y v0/ALT.
¿Puede LiteSVM 0.6.x cubrir esto?
LiteSVM es un simulador local; usa el RPC simulateTransaction cuando necesites el estado exacto de las cuentas del cluster.
¿Qué cambió en la era Agave?
El cliente validador cambió de nombre a Agave (4.1.1), CLI 3.0.10 se alinea con él y el trabajo de Alpenglow está cambiando la finalidad; fija las versiones y lee las notas de la versión en cada actualización.
¿Dónde encuentro métodos RPC relacionados?
simulateTransaction con sigVerify: true para paridad de producción; getAccountInfo para sembrar cuentas faltantes.
Relacionado
- Explora otras páginas de la sección
transactions-instructions-feespara temas complementarios. - Fundamentos de Solana - Orientación sobre cuentas y transacciones.
Versiones del Stack: 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.