lez-fuzzing/fuzz/fuzz_targets/fuzz_state_transition.rs
2026-05-28 11:40:38 +08:00

88 lines
3.6 KiB
Rust

#![cfg_attr(feature = "fuzzer-libfuzzer", no_main)]
use arbitrary::{Arbitrary, Unstructured};
use fuzz_props::generators::{arb_fuzz_native_transfer, arbitrary_fuzz_state, arbitrary_transaction};
use fuzz_props::invariants::{BalanceSnapshot, NonceSnapshot, assert_tx_execution_invariants};
use nssa::V03State;
fuzz_props::fuzz_entry!(|data: &[u8]| {
let mut u = Unstructured::new(data);
// Generate a fuzz-driven initial state instead of always using the fixed
// testnet genesis. This exposes state-dependent bugs that only manifest
// with specific account shapes (e.g. zero balance, u128::MAX balance, or a
// nonce at the wrap-around boundary).
let fuzz_accs = match arbitrary_fuzz_state(&mut u) {
Ok(accs) => accs,
Err(_) => return,
};
let init_accs: Vec<(nssa::AccountId, u128)> = fuzz_accs
.iter()
.map(|a| (a.account_id, a.balance))
.collect();
// Construct the initial state
let mut state = V03State::new_with_genesis_accounts(&init_accs, vec![], 0);
// Generate up to 8 transactions and apply them
let n_txs: u8 = u8::arbitrary(&mut u).unwrap_or(0) % 8;
for i in 0..n_txs {
// Mix correlated transactions (referencing known fuzz accounts and
// correctly signed) with random ones. Correlated transactions give
// the fuzzer a direct path to successful state transitions; random ones
// exercise the rejection and isolation paths.
let tx_result = if bool::arbitrary(&mut u).unwrap_or(false) {
arb_fuzz_native_transfer(&mut u, &fuzz_accs)
} else {
arbitrary_transaction(&mut u)
};
let Ok(tx) = tx_result else {
break;
};
// Stateless gate: only attempt state transitions that pass stateless check
let Ok(tx) = tx.transaction_stateless_check() else {
continue;
};
// Build snapshots from the live state before this transaction so that the
// shared invariant framework can check isolation and conservation.
let balances_before = BalanceSnapshot(
init_accs
.iter()
.map(|&(id, _)| (id, state.get_account_by_id(id).balance))
.collect(),
);
let nonces_before = NonceSnapshot(
init_accs
.iter()
.map(|&(id, _)| (id, state.get_account_by_id(id).nonce))
.collect(),
);
// Advance block_id and timestamp each iteration so the state machine
// sees a realistic monotonically-increasing context. Using the same
// block_id=1 / timestamp=0 for every tx hides bugs that only manifest
// when the block context changes across a multi-transaction sequence.
let block_id: u64 = 1 + u64::from(i);
let timestamp: u64 = u64::from(i);
// Snapshot state before execution for isolation checks.
let state_snapshot = state.clone();
let result = tx.execute_check_on_state(&mut state, block_id, timestamp);
// ── All five protocol invariants ──────────────────────────────────────
// A single call enforces every invariant — no standalone helpers needed:
// On rejection: StateIsolationOnFailure + FailedTxNonceStability
// On success: BalanceConservation + NonceIncrementCorrectness + ReplayRejection
assert_tx_execution_invariants(
&state_snapshot,
&mut state,
balances_before,
nonces_before,
result,
(block_id + 1, timestamp + 1),
);
}
});