Commit b1c9b9c
docs, tests, benchmarks: improve trustworthiness and usability (#44)
* docs, tests, benchmarks: improve trustworthiness and usability
Soundness & documentation:
- Add protocol documentation to prover and verifier modules
- Add full soundness argument to verifier with notation, per-component
bounds (FRI, constraint folding, OOD, lookup, Fiat-Shamir), and overall
soundness error formula
- Annotate each verification step with inline soundness comments
- Add security parameter docs to FriParameters
- Document unused InvalidClaim variant
Testing:
- Replace ignored 2^20-row benchmark test with fast 2^4-row test
including serialization round-trip
- Add adversarial verifier tests: wrong claim, tampered stage-1 values,
tampered accumulator, truncated proof, serialization round-trip
- Trim blake3 test_all_claims from 9 redundant runs to 6 minimal ones
- CI: run tests with --features parallel, add --all-features to clippy
Benchmarks & examples:
- Add Criterion benchmarks (prove/verify)
- Add examples: simple_proof (no lookups), preprocessed_proof (preprocessed
trace with lookups), and lookup_proof (multi-circuit)
Repo cleanup:
- Rename chips/ to test_circuits/, move Blake3 helpers into blake3.rs
- Drop the "chip" terminology elsewhere
- Gate test_circuits module with #[cfg(test)]
- Add .cargo/config.toml with target-cpu=native
- Rewrite README with crypto setup, quick start, and soundness reference
* fixed table alignment on README.md
---------
Co-authored-by: Gabriel Barreto <gabriel.aquino.barreto@gmail.com>1 parent 9d6eb13 commit b1c9b9c
18 files changed
Lines changed: 2022 additions & 664 deletions
File tree
- .cargo
- .github/workflows
- benches
- examples
- src
- chips
- test_circuits
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
25 | 25 | | |
26 | 26 | | |
27 | 27 | | |
28 | | - | |
| 28 | + | |
29 | 29 | | |
30 | 30 | | |
31 | 31 | | |
| |||
42 | 42 | | |
43 | 43 | | |
44 | 44 | | |
45 | | - | |
| 45 | + | |
46 | 46 | | |
47 | 47 | | |
48 | 48 | | |
| |||
0 commit comments