litesvm, mollusk y solana-bankrun

Los entornos de prueba rápidos de Solana evitan los ciclos completos de solana-test-validator. LiteSVM 0.6.x ejecuta una SVM en proceso para pruebas de Rust. Mollusk ejecuta instrucciones individuales contra un ELF de programa con fixtures. solana-bankrun (Bankrun) incrusta un entorno similar a un validador para pruebas de integración de TypeScript. Elige según el lenguaje y las necesidades de fidelidad en la semántica de Agave 4.1.1.

Receta

Tarjeta de receta de referencia rápida, lista para copiar y pegar.

[dev-dependencies]
litesvm = "0.6"
mollusk-svm = "0.1"

npm install -D solana-bankrun @solana/kit@7.0.0

use litesvm::LiteSVM;
 
let mut svm = LiteSVM::new();
// svm.add_program(...) y enviar txs en pruebas

Cuándo recurrir a esto:

• Pruebas unitarias para programas Anchor/nativos en CI sin validadores Docker.
• Benchmarking del uso de CU en variantes de instrucciones.
• Pruebas de integración de TS que cargan tu .so y verifican deltas de cuentas.
• Bucles rápidos de rojo/verde durante correcciones de seguridad.

Ejemplo de Trabajo

use litesvm::LiteSVM;
use solana_sdk::{
    instruction::{AccountMeta, Instruction},
    pubkey::Pubkey,
    signature::{Keypair, Signer},
    system_program,
    transaction::Transaction,
};
 
#[test]
fn transfer_in_litesvm() {
    let mut svm = LiteSVM::new();
    let payer = Keypair::new();
    let recipient = Keypair::new();
 
    svm.airdrop(&payer.pubkey(), 1_000_000_000).unwrap();
 
    let ix = Instruction {
        program_id: system_program::ID,
        accounts: vec![
            AccountMeta::new(payer.pubkey(), true),
            AccountMeta::new(recipient.pubkey(), false),
        ],
        data: solana_sdk::system_instruction::transfer(&payer.pubkey(), &recipient.pubkey(), 10_000).data,
    };
 
    let bh = svm.latest_blockhash();
    let tx = Transaction::new_signed_with_payer(&[ix], Some(&payer.pubkey()), &[&payer], bh);
    svm.send_transaction(tx).unwrap();
 
    let bal = svm.get_balance(&recipient.pubkey()).unwrap();
    assert_eq!(bal, 10_000);
}

Lo que esto demuestra:

• LiteSVM otorga lamports sin necesidad de un faucet CLI.
• La instrucción real del programa del sistema se ejecuta en proceso.
• El blockhash proviene del estado de svm, no de un RPC externo.
• Las aserciones leen los saldos directamente de svm.

Análisis Profundo

Cómo Funciona

• LiteSVM incrusta la ejecución compatible con Agave para binarios de programas cargados.
• Mollusk se centra en un entorno de instrucción única con una lista de cuentas simuladas.
• Bankrun inicia el estado del banco para pruebas de TS con hooks de despliegue de programas.
• Ninguno reemplaza completamente las pruebas del validador para casos de borde de RPC/red.

Tabla de Crates de Rust

Tabla de TypeScript / NPM

Notas de Rust

// Carga tu programa .so en pruebas de LiteSVM
// svm.add_program(program_id, "target/deploy/my_program.so");
 
// Compara los logs de CU con `mollusk` para la optimización de instrucciones clave

Trampas

• Pruebas sin artefacto BPF desplegado - fallos de ID de programa vacío. Solución: anchor build antes de las pruebas; enlaza la ruta en CI.
• Desviación de características de mainnet - la disponibilidad de syscall difiere según la versión. Solución: fija LiteSVM 0.6.x con la cadena de herramientas Agave 4.1.1.
• Ruta de programa de Bankrun incorrecta en monorepos - .so obsoleto. Solución: copia el artefacto en el script de configuración de pruebas.
• Simulación excesiva de cuentas en Mollusk - pasa las pruebas, falla en mainnet. Solución: añade casos de integración de LiteSVM.
• Omitir completamente las pruebas del validador - se pierden errores de serialización de RPC. Solución: mantén un conjunto delgado de solana-test-validator.

Alternativas

Preguntas Frecuentes

Relacionado

• LiteSVM - guía detallada
• Mollusk - entorno de instrucción
• Bankrun (TS) - pruebas de TS
• Conceptos básicos de pruebas - pirámide

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.