Por que LiteSVM

Visão Geral

Pense no LiteSVM como uma VM Solana rodando dentro da sua função de teste. Não como um processo separado, não como um serviço de rede - é apenas uma chamada de biblioteca no seu código.

Testes Tradicionais

// Traditional approach - slow and complex
let validator = TestValidator::new().await; // Starts separate process
let client = RpcClient::new(validator.url()); // Network connection

// Every operation is async and goes over network
let balance = client.get_balance(&pubkey).await?;
tokio::time::sleep(Duration::from_secs(1)).await; // Wait for confirmation

Testes com LiteSVM

// LiteSVM - fast and simple
let mut svm = LiteSVM::new(); // Just a struct in memory

// Everything is synchronous and immediate
let balance = svm.get_balance(&pubkey).unwrap_or(0);

Princípios Fundamentais

1. Tudo é Síncrono

Sem async, sem await, sem atrasos:

// Send transaction and check result immediately
svm.send_transaction(tx).unwrap();
let balance = svm.get_balance(&account).unwrap(); // Already updated!

2. Manipulação Direta de Estado

// Create any account with any data
svm.set_account(pubkey, Account {
    lamports: 1_000_000_000,
    data: vec![1, 2, 3, 4],
    owner: program_id,
    executable: false,
    rent_epoch: 0,
}).unwrap();

3. O Tempo Está Sob Seu Controle

// Jump to any slot instantly
svm.warp_to_slot(1000);

// Expire blockhashes on demand
svm.expire_blockhash();

// Set any sysvar
let mut clock = svm.get_sysvar::<Clock>();
clock.unix_timestamp = 1735689600; // Jan 1, 2025
svm.set_sysvar(&clock);

4. Os Erros São Imediatos e Claros

match svm.send_transaction(tx) {
    Ok(meta) => {
        // Transaction succeeded
        println!("Compute units: {}", meta.compute_units_consumed);
    }
    Err(e) => {
        // Error with full details
        println!("Error: {:?}", e.err);
        println!("Logs: {:?}", e.meta.logs);
    }
}

Testando Seu Programa → Aprenda como testar seu próprio programa Solana
Exemplos → Veja soluções prontas para usar em cenários comuns e exemplos completos do repositório
Referência da API → Conheça recursos avançados e configurações personalizadas