#solana #programs #vm #testing #simulator

litesvm

A fast and lightweight Solana VM simulator for testing solana programs

4 releases (2 breaking)

0.3.0 Oct 12, 2024
0.2.1 Sep 27, 2024
0.2.0 Sep 11, 2024
0.1.0 Apr 2, 2024
0.0.1 Feb 8, 2024

#99 in #simulator

Download history 296/week @ 2024-08-07 275/week @ 2024-08-14 176/week @ 2024-08-21 278/week @ 2024-08-28 240/week @ 2024-09-04 488/week @ 2024-09-11 345/week @ 2024-09-18 404/week @ 2024-09-25 113/week @ 2024-10-02 199/week @ 2024-10-09 70/week @ 2024-10-16 39/week @ 2024-10-23 79/week @ 2024-10-30 78/week @ 2024-11-06 39/week @ 2024-11-13 62/week @ 2024-11-20

267 downloads per month
Used in 2 crates

Apache-2.0

1MB
2K SLoC

Contains (ELF lib, 535KB) src/spl/programs/spl_token_2022-1.0.0.so, (ELF lib, 135KB) src/spl/programs/spl_token-3.5.0.so, (ELF lib, 105KB) spl_associated_token_account-1.1.1.so, (ELF lib, 75KB) src/spl/programs/spl_memo-3.0.0.so, (ELF lib, 18KB) src/spl/programs/spl_memo-1.0.0.so


LiteSVM

github crates.io docs.rs build status

📍 Overview

litesvm is a fast and lightweight library for testing Solana programs. It works by creating an in-process Solana VM optimized for program developers. This makes it much faster to run and compile than alternatives like solana-program-test and solana-test-validator. In a further break from tradition, it has an ergonomic API with sane defaults and extensive configurability for those who want it.

🚀 Getting Started

🔧 Installation

cargo add --dev litesvm

🤖 Minimal Example

use litesvm::LiteSVM;
use solana_program::{message::Message, pubkey::Pubkey, system_instruction::transfer};
use solana_sdk::{signature::Keypair, signer::Signer, transaction::Transaction};

#[test]
fn system_transfer() {
    let from_keypair = Keypair::new();
    let from = from_keypair.pubkey();
    let to = Pubkey::new_unique();

    let mut svm = LiteSVM::new();
    svm.airdrop(&from, 10_000).unwrap();

    let instruction = transfer(&from, &to, 64);
    let tx = Transaction::new(
        &[&from_keypair],
        Message::new(&[instruction], Some(&from)),
        svm.latest_blockhash(),
    );
    let tx_res = svm.send_transaction(tx).unwrap();

    let from_account = svm.get_account(&from);
    let to_account = svm.get_account(&to);
    assert_eq!(from_account.unwrap().lamports, 4936);
    assert_eq!(to_account.unwrap().lamports, 64);
}

Development

Run the tests

The tests use some test programs you need to build first (Solana CLI >= 1.18.8 required):

cd test_programs && cargo build-sbf

Then just run cargo test.

Dependencies

~23–39MB
~686K SLoC