litesvm, mollusk & solana-bankrun

Testes rápidos de programas Solana evitam viagens de ida e volta completas do solana-test-validator. LiteSVM 0.6.x executa um SVM in-process para testes Rust. Mollusk executa instruções únicas contra o ELF do programa com fixtures. solana-bankrun (Bankrun) incorpora um ambiente semelhante a um validador para testes de integração TypeScript. Escolha com base na linguagem e nas necessidades de fidelidade da semântica do Agave 4.1.1.

Receita

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

[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(...) e envia txs em testes

Quando usar isso:

• Testes unitários para programas Anchor/nativos em CI sem validadores Docker.
• Benchmarking de uso de CU em variantes de instrução.
• Testes de integração TS que carregam seu .so e verificam deltas de conta.
• Loops rápidos de vermelho/verde durante correções de segurança.

Exemplo de Trabalho

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

O que isso demonstra:

• LiteSVM airdrops lamports sem faucet CLI.
• Instrução real do programa do sistema executa in-process.
• Blockhash vem do estado svm, não de RPC externo.
• Asserções leem saldos diretamente do svm.

Mergulho Profundo

Como Funciona

• LiteSVM incorpora execução compatível com Agave para binários de programa carregados.
• Mollusk foca em um harness de instrução única com lista de contas simuladas.
• Bankrun inicia o estado do banco para testes TS com hooks de implantação de programa.
• Nenhum substitui completamente os testes de validador para casos de borda de RPC/rede.

Tabela de Crates Rust

Tabela TypeScript / NPM

Notas Rust

// Carrega seu programa .so em testes LiteSVM
// svm.add_program(program_id, "target/deploy/my_program.so");
 
// Compara logs de CU com `mollusk` para ajuste de instrução quente

Armadilhas

• Testar sem artefato BPF implantado - falhas de ID de programa vazio. Correção: anchor build antes dos testes; conecte o caminho em CI.
• Deriva de recursos da mainnet - a disponibilidade de syscall difere por versão. Correção: fixe LiteSVM 0.6.x com a toolchain Agave 4.1.1.
• Caminho do programa Bankrun incorreto em monorepos - .so obsoleto. Correção: copie o artefato no script de configuração de teste.
• Simular contas em excesso no Mollusk - passa nos testes, falha na mainnet. Correção: adicione casos de integração LiteSVM.
• Pular completamente os testes do validador - perca bugs de serialização RPC. Correção: mantenha uma suíte solana-test-validator fina.

Alternativas

FAQs

Relacionado

• LiteSVM - guia detalhado
• Mollusk - harness de instrução
• Bankrun (TS) - testes TS
• Noções Básicas de Teste - pirâmide

Versões da Pilha: 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.