hpsvm 0.1.19

A fast and lightweight Solana VM simulator for testing solana programs
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
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

use solana_address::{Address, address};
use solana_sdk_ids::{
    address_lookup_table, bpf_loader, bpf_loader_deprecated, bpf_loader_upgradeable, config, stake,
};

use crate::{FeatureGate, Svm, SvmTypesHost, TxFeatureFlags};

pub(crate) const DEFAULT_PROGRAM_IDS: [Address; 8] = [
    address!("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"),
    address!("TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"),
    address!("Memo1UhkJRfHyvLMcVucJwxXeuD728EqVDDwQDxFMNo"),
    address!("MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr"),
    address!("ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"),
    config::ID,
    address_lookup_table::ID,
    stake::ID,
];

pub(crate) const SPL_PROGRAM_IDS: [Address; 3] = [
    address!("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"),
    address!("TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"),
    address!("ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"),
];

pub(crate) fn load_default_programs<T: SvmTypesHost>(svm: &mut Svm<'_, T>) {
    load_spl_programs(svm);
    load_non_spl_default_programs(svm);
}

pub(crate) fn load_spl_programs<T: SvmTypesHost>(svm: &mut Svm<'_, T>) {
    // One flag load per program-load pass; loading runs at setup or feature
    // reconfiguration time, never per transaction.
    let flags = TxFeatureFlags::load(&svm.version.feature_set);
    // if replace spl-token with p-token feature is enabled, the SPL token contract is loaded from
    // a different .so
    if flags.is_enabled(FeatureGate::ReplaceSplTokenWithPToken) {
        svm.add_program_preverified(
            address!("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"),
            include_bytes!("../../elf/pinocchio_token_program.so"),
            &bpf_loader_upgradeable::id(),
        )
        .expect("failed to load pinocchio token program (p-token feature active)");
    } else {
        svm.add_program_preverified(
            address!("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"),
            include_bytes!("../../elf/spl_token-3.5.0.so"),
            &bpf_loader::id(),
        )
        .expect("failed to load spl-token 3.5.0");
    }

    svm.add_program_preverified(
        address!("TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"),
        include_bytes!("../../elf/spl_token_2022-10.0.0.so"),
        &bpf_loader_upgradeable::id(),
    )
    .expect("failed to load spl-token-2022 10.0.0");
    svm.add_program_preverified(
        address!("ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"),
        include_bytes!("../../elf/spl_associated_token_account-1.1.1.so"),
        &bpf_loader::id(),
    )
    .expect("failed to load spl-associated-token-account 1.1.1");
}

fn load_non_spl_default_programs<T: SvmTypesHost>(svm: &mut Svm<'_, T>) {
    svm.add_program_preverified(
        address!("Memo1UhkJRfHyvLMcVucJwxXeuD728EqVDDwQDxFMNo"),
        include_bytes!("../../elf/spl_memo-1.0.0.so"),
        &bpf_loader_deprecated::id(),
    )
    .expect("failed to load spl-memo 1.0.0");
    svm.add_program_preverified(
        address!("MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr"),
        include_bytes!("../../elf/spl_memo-3.0.0.so"),
        &bpf_loader::id(),
    )
    .expect("failed to load spl-memo 3.0.0");
    // The ELFs in `crates/hpsvm/elf` are vendored prebuilt binaries, not built
    // from the workspace. They track a Solana release rather than the crate
    // versions in `Cargo.toml`, so bumping the dependencies does not refresh
    // them and they can drift out of step with the programs loaded here.
    //
    // `core_bpf_stake-1.0.1.so` is known to be affected: its `DelegateStake`
    // handler cannot decode a vote account written by the current
    // `solana-vote-interface`, so `DelegateStake` and `DeactivateDelinquent`
    // fail with `InvalidAccountData` while the rest of the stake program works.
    // `crates/hpsvm/tests/stake_program.rs` pins that behaviour in
    // `delegate_is_blocked_by_the_stale_vendored_stake_elf` so the drift is
    // visible and fails loudly once the binary is rebuilt.
    //
    // To refresh, rebuild each program from its upstream source and commit the
    // result; nothing in this workspace can regenerate them.
    svm.add_program_preverified(
        config::ID,
        include_bytes!("../../elf/config.so"),
        &bpf_loader_upgradeable::id(),
    )
    .expect("failed to load config program");
    svm.add_program_preverified(
        address_lookup_table::ID,
        include_bytes!("../../elf/address_lookup_table.so"),
        &bpf_loader_upgradeable::id(),
    )
    .expect("failed to load address-lookup-table program");
    svm.add_program_preverified(
        stake::ID,
        include_bytes!("../../elf/core_bpf_stake-1.0.1.so"),
        &bpf_loader_upgradeable::id(),
    )
    .expect("failed to load core-bpf-stake 1.0.1");
}