svmscope 0.6.0

Transaction autopsy for Solana — decode any mainnet transaction, replay it locally in an embedded SVM, and mutate state to see what happens.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

//! Hermetic CI: freeze a real transaction's world once, then regression-test
//! it forever — offline, deterministic, no RPC key in CI.
//!
//! ```sh
//! cargo run --example fixture_ci -- <signature> [rpc_url]
//! ```

use svmscope::{Check, Replay, Scenario, Scope};

fn main() -> svmscope::Result<()> {
    let mut args = std::env::args().skip(1);
    let sig = args
        .next()
        .expect("usage: fixture_ci <signature> [rpc_url]");
    let rpc = args
        .next()
        .unwrap_or_else(|| "https://api.mainnet-beta.solana.com".into());

    // Capture once (live). The fixture carries the accounts, the program ELFs,
    // the IDLs, and the recorded on-chain outcome.
    let fixture = Scope::new(rpc).capture(&sig)?;
    let json = fixture.to_json()?;
    println!("captured: v{} — {}", fixture.version, fixture.summary());
    // In real use: fs::write("fixtures/my_tx.json", &json)? and commit it.

    // From here on: NO network. This is what runs in CI.
    let frozen = svmscope::Fixture::from_json(&json)?;
    let replay = Replay::from_fixture(&frozen)?;
    let outcomes = replay.run_suite(&[
        Scenario::new("replays exactly like mainnet").check(Check::matches_onchain()),
        Scenario::new("still succeeds").check(Check::success()),
    ])?;

    for o in &outcomes {
        println!("{} {}", if o.pass { "PASS" } else { "FAIL" }, o.name);
    }
    assert!(outcomes.iter().all(|o| o.pass), "regression!");
    Ok(())
}