https://github.com/LiteSVM/litesvm
https://github.com/LiteSVM/litesvm
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/LiteSVM/litesvm
- Owner: LiteSVM
- License: apache-2.0
- Created: 2023-11-18T11:02:30.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-02-03T17:41:05.000Z (3 months ago)
- Last Synced: 2025-02-04T09:11:12.411Z (3 months ago)
- Language: Rust
- Size: 2.6 MB
- Stars: 166
- Watchers: 5
- Forks: 31
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- solana-awesome - Link - process Solana VM optimized for program developers | (Developer Resources / Testing Programs)
- awesome - LiteSVM/litesvm - (Rust)
README
---
# LiteSVM
[
](https://github.com/LiteSVM/litesvm)
[
](https://crates.io/crates/litesvm)
[
](https://docs.rs/litesvm/latest/litesvm/)
[
](https://github.com/LiteSVM/litesvm/actions?query=branch%3Amaster)
## 📍 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
```sh
cargo add --dev litesvm
```
### 🤖 Minimal Example
```rust
use litesvm::LiteSVM;
use solana_keypair::Keypair;
use solana_message::Message;
use solana_pubkey::Pubkey;
use solana_signer::Signer;
use solana_system_interface::instruction::transfer;
use solana_transaction::Transaction;
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);
```
### 🛠️ Developing litesvm
#### Run the tests
The tests in this repo use some test programs you need to build first (Solana CLI >= 1.18.8 required):
```cd crates/litesvm/test_programs && cargo build-sbf```
Then just run `cargo test`.