LiteSVM

LiteSVM 0.6.x ejecuta una VM de Solana en proceso para pruebas de programas en menos de un segundo sin solana-test-validator. Úsalo para pruebas unitarias, casos negativos de seguridad y bucles de retroalimentación de Rust rápidos.

Receta

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

use litesvm::LiteSVM;
use solana_sdk::{
    instruction::{AccountMeta, Instruction},
    pubkey::Pubkey,
    signature::Keypair,
    signer::Signer,
    transaction::Transaction,
};
 
let mut svm = LiteSVM::new();
let payer = Keypair::new();
svm.airdrop(&payer.pubkey(), 10_000_000_000).unwrap();
svm.add_program(program_id, include_bytes!("../target/deploy/my_program.so"));

Cuándo usar esto:

• Pruebas de manejadores de instrucciones en Rust puro #[test].
• Fuzzing rápido de metadatos de cuentas adversarias.
• Capa de pruebas unitarias de CI antes de un anchor test más lento.
• Depuración de errores de programas sin el ruido de RPC.

Ejemplo de trabajo

use litesvm::LiteSVM;
use solana_sdk::{
    instruction::{AccountMeta, Instruction},
    pubkey::Pubkey,
    signature::Keypair,
    signer::Signer,
    system_program,
    transaction::Transaction,
};
 
#[test]
fn withdraw_requires_signer() {
    let program_id = Pubkey::new_unique();
    let mut svm = LiteSVM::new();
    svm.add_program(program_id, include_bytes!("../target/deploy/my_program.so"));
 
    let payer = Keypair::new();
    svm.airdrop(&payer.pubkey(), 2_000_000_000).unwrap();
 
    let vault = Pubkey::new_unique();
    let ix = Instruction {
        program_id,
        accounts: vec![
            AccountMeta::new(vault, false),
            AccountMeta::new_readonly(payer.pubkey(), false), // falta firmante
        ],
        data: vec![1, 0, 0, 0], // marcador de posición del discriminador de retiro
    };
 
    let tx = Transaction::new_signed_with_payer(
        &[ix],
        Some(&payer.pubkey()),
        &[&payer],
        svm.latest_blockhash(),
    );
 
    let result = svm.send_transaction(tx);
    assert!(result.is_err());
}

Lo que esto demuestra:

• Carga de .so compilado directamente en LiteSVM.
• Construcción de transacciones con metadatos de cuenta explícitos para casos de ataque.
• Afirmación de fallo sin iniciar un validador o un framework de TypeScript.

Inmersión Profunda

Cómo funciona

• LiteSVM integra la ejecución de SVM en tu proceso de prueba.
• Sysvars, rent y el comportamiento del cargador BPF aproximan la semántica de Agave 4.1.1.
• Blockhash y clock se pueden avanzar manualmente para pruebas dependientes del tiempo.
• Sin RPC: las pruebas se ejecutan completamente en memoria.

LiteSVM vs. Otros Frameworks

Notas de Rust

// Avanzar el reloj para pruebas de obsolescencia
svm.set_sysvar(&solana_sdk::clock::Clock {
    unix_timestamp: 1_700_000_000,
    ..Default::default()
});

Trampas

• Artefacto .so obsoleto - La prueba ejecuta una binario antigua después de un cambio de código. Solución: anchor build en CI antes de cargo test.
• Programas faltantes en svm - CPI a SPL Token falla sin cargar el programa de token. Solución: svm.add_program para dependencias.
• Configuración de datos de cuenta - Las cuentas no inicializadas requieren empaquetado de datos manual. Solución: Ayudante para escribir diseños Borsh/Anchor en cuentas svm.
• Blockhash expirado - Las secuencias de prueba largas requieren svm.expire_blockhash() o actualización. Solución: Obtener latest_blockhash() por tx.
• Conflicto de características - Las características de compilación difieren de las de implementación. Solución: Mismas características de Cargo.toml que la compilación de lanzamiento.
• No es RPC completo - Las peculiaridades específicas de RPC requieren pruebas de validador. Solución: Capa de pruebas E2E por separado.

Alternativas

Preguntas frecuentes

Relacionado

• Conceptos básicos de pruebas - contexto de la pirámide
• Mollusk - framework alternativo de Rust
• Pruebas de CPI y PDA - patrones de prueba de CPI
• Mejores prácticas de seguridad - pruebas negativas

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.