mirror of https://github.com/logos-blockchain/lssa.git synced 2026-05-22 01:30:00 +00:00

History

Moudy b84a3e8b44 docs(cycle_bench): document Stats fields and use Display instead of ::format()

- Add /// doc comments on Stats {n, best_ms, mean_ms, stdev_ms}
  clarifying units, semantics, and Bessel's correction.
- Replace pub fn format(&self) -> String with impl fmt::Display for
  Stats, idiomatic and lets println! use {} directly.
- Update three call sites accordingly.

2026-05-18 16:37:11 +02:00

src

docs(cycle_bench): document Stats fields and use Display instead of ::format()

2026-05-18 16:37:11 +02:00

Cargo.toml

feat: add cycle_bench tool for executor, prove, PPE, and verify cycle measurements

2026-05-14 18:14:37 +02:00

README.md

Update README.md

2026-05-15 00:24:56 +02:00

README.md

cycle_bench

Per-program Risc0 cycle counts, prover wall time, PPE composition cost, and verifier wall time for the built-in LEZ programs. Feeds the fee model (G_executor, G_prove, G_verify, S_agg).

Run

# Executor cycles only (fast, ~seconds)
cargo run --release -p cycle_bench

# + real proving per program (slow, ~minutes)
cargo run --release -p cycle_bench --features prove -- --prove

# + PPE composition cases (very slow, ~hour)
cargo run --release -p cycle_bench --features ppe -- --prove --ppe

# + verifier microbench (G_verify): generates one PPE receipt, times verify x1000
cargo run --release -p cycle_bench --features ppe -- --verify --verify-iters 1000

RISC0_DEV_MODE=1 skips proving entirely and is only useful for the executor path. Combine flags freely; output is printed to stdout and written to target/cycle_bench.json for regression diffs.

What you'll see

Per-program executor cycles and segments, plus exec wall time as best / mean ± stdev (n=N).
With --prove: prover total cycles, paging cycles, segments, and wall time.
With --ppe: end-to-end execute_and_prove wall time and S_agg (the borsh-serialized InnerReceipt length) for one auth-transfer-in-PPE case and a chain-caller depth sweep.
With --verify: verify wall time best / mean ± stdev, plus proof_bytes and journal_bytes.