LiteSVM

LiteSVM 0.6.x executa uma VM Solana in-process para testes de programa em sub-segundo sem solana-test-validator. Use para testes unitários, casos negativos de segurança e loops de feedback Rust apertados.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

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"));

Quando usar:

• Testar handlers de instrução em #[test] Rust puro.
• Fuzzing adversarial de account meta rapidamente.
• Camada de teste unitário CI antes de anchor test mais lento.
• Depurar erros de programa sem ruído RPC.

Exemplo prático

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), // missing signer
        ],
        data: vec![1, 0, 0, 0], // withdraw discriminator stub
    };
 
    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());
}

O que isso demonstra:

• Carregue .so compilado diretamente no LiteSVM.
• Construa transações com account metas explícitos para casos de ataque.
• Asserte falha sem iniciar validador ou harness TypeScript.

Mergulho profundo

Como funciona

• LiteSVM embute execução SVM no processo de teste.
• Sysvars, rent e comportamento do BPF loader aproximam semântica Agave 4.1.1.
• Blockhash e clock podem ser avançados manualmente para testes dependentes de tempo.
• Sem RPC - testes rodam inteiramente em memória.

LiteSVM vs outros harnesses

Notas Rust

// Avance clock para testes de obsolescência
svm.set_sysvar(&solana_sdk::clock::Clock {
    unix_timestamp: 1_700_000_000,
    ..Default::default()
});

Erros comuns

• Artefato .so obsoleto - Teste executa binário antigo após mudança de código. Correção: anchor build no CI antes de cargo test.
• Programas ausentes no svm - CPI para SPL Token falha sem carregar token program. Correção: svm.add_program para dependências.
• Setup de dados de conta - Contas não inicializadas precisam packing manual de dados. Correção: Helper para escrever layouts Borsh/Anchor em contas svm.
• Blockhash expirado - Sequências longas precisam svm.expire_blockhash() ou refresh. Correção: Busque latest_blockhash() por tx.
• Mismatch de features - Features de build diferem do deploy. Correção: Mesmas features Cargo.toml que build de release.
• Não é RPC completo - Quirks específicos de RPC precisam testes de validador. Correção: Camada E2E separada.

Alternativas

FAQs

Relacionados

• Noções básicas de testes - contexto da pirâmide
• Mollusk - harness Rust alternativo
• Testando CPIs e PDAs - padrões de teste CPI
• Melhores práticas de segurança - testes negativos

Versões da stack: Esta página foi 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 e LiteSVM 0.6.x.