sim-cli 0.3.0

CLI tool for running and comparing Solana simulator backtests
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
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129

use std::sync::Arc;

use dashmap::DashMap;
use simulator_client::AccountDiffNotification;
use solana_client::{
    nonblocking::rpc_client::RpcClient,
    rpc_response::{Response, RpcLogsResponse},
};

use crate::{
    fetch::fetch_transaction,
    output::{AccountDiff, AccountDiffRow, Transaction},
};

/// Handle a single log notification from the subscription manager.
pub(crate) async fn on_log_notification(
    rpc: Arc<RpcClient>,
    records: Arc<DashMap<String, Transaction>>,
    notification: Response<RpcLogsResponse>,
) {
    let slot = notification.context.slot;
    let signature = notification.value.signature.clone();
    let logs = notification.value.logs.clone();

    let mut tx = match fetch_transaction(&rpc, &signature, slot).await {
        Some(t) => t,
        None => {
            let err_str = notification.value.err.as_ref().map(|e| e.to_string());
            Transaction {
                slot,
                timestamp: None,
                signature: signature.clone(),
                success: err_str.is_none(),
                error: err_str,
                logs: Vec::new(),
                sol_changes: Vec::new(),
                token_changes: Vec::new(),
                account_diffs: Vec::new(),
            }
        }
    };
    tx.logs = logs;
    records.insert(signature, tx);
}

/// Handle a single account-diff notification from the subscription manager.
pub(crate) async fn on_account_diff_notification(
    rpc: Arc<RpcClient>,
    records: Arc<DashMap<String, Transaction>>,
    stream_tx: Option<tokio::sync::mpsc::UnboundedSender<AccountDiffRow>>,
    notification: AccountDiffNotification,
) {
    let Some(sig) = notification.signature else {
        return;
    };
    let Some(account) = notification.account else {
        return;
    };
    let slot = notification.context.slot;
    let diff = AccountDiff {
        account,
        pre_state: notification.pre,
        post_state: notification.post,
    };

    // Fast path: transaction already in map (another diff for the same sig arrived first).
    if let Some(mut entry) = records.get_mut(&sig) {
        if let Some(ref tx) = stream_tx {
            let row = AccountDiffRow::from_diff(
                entry.slot,
                &sig,
                &diff,
                &entry.sol_changes,
                &entry.token_changes,
            );
            let _ = tx.send(row);
        } else {
            entry.account_diffs.push(diff);
        }
        return;
    }

    // Slow path: fetch from RPC, then insert. If the fetch fails we still insert
    // the diff — we just won't have sol/token metadata.
    let fetched = fetch_transaction(&rpc, &sig, slot).await;
    if fetched.is_none() {
        tracing::warn!(sig, slot, "failed to fetch transaction metadata");
    }

    let streaming = if let Some(ref tx) = stream_tx {
        let (sol, tok) = match &fetched {
            Some(f) => (f.sol_changes.as_slice(), f.token_changes.as_slice()),
            None => (&[][..], &[][..]),
        };
        let _ = tx.send(AccountDiffRow::from_diff(slot, &sig, &diff, sol, tok));
        true
    } else {
        false
    };

    let sig_fallback = sig.clone();
    let mut entry = records.entry(sig).or_insert_with(|| match fetched {
        Some(tx) => Transaction {
            slot: tx.slot,
            timestamp: tx.timestamp,
            signature: tx.signature,
            success: tx.success,
            error: tx.error,
            logs: Vec::new(),
            sol_changes: tx.sol_changes,
            token_changes: tx.token_changes,
            account_diffs: Vec::new(),
        },
        None => Transaction {
            slot,
            timestamp: None,
            signature: sig_fallback,
            success: false,
            error: None,
            logs: Vec::new(),
            sol_changes: Vec::new(),
            token_changes: Vec::new(),
            account_diffs: Vec::new(),
        },
    });
    if !streaming {
        entry.account_diffs.push(diff);
    }
}