Skip to content

docs: record purpose, zkVM findings, and consensus-layer roadmap - #6

Merged
adust09 merged 2 commits into
mainfrom
docs/zkvm-roadmap-20260918-1751
Sep 18, 2026
Merged

adust09 merged 2 commits into
mainfrom
docs/zkvm-roadmap-20260918-1751

Conversation

@adust09

@adust09 adust09 commented Sep 18, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Adds docs/roadmap.md and links it from README and DESIGN.md. It records the discussion following #5:

  • why the consensus-layer state transition is being proved and why weigh_justification_and_finalization came first
  • where the routine sits in the block and epoch flow (with an ASCII diagram), and that it performs no cryptography
  • what the ZisK measurements established: weigh steps equal RV64 steps, one 2^22-row segment is 98% padding, so steps by symbol is the metric to track and per-process overheads are deployment costs
  • the PoC decisions: in-memory BeaconState model per the spec, stateless Merkle access deferred to Stateless block_roots access: pass only the two read roots with SSZ Merkle proofs #4, resident prover later, no GPU re-measurement for a byte-identical guest
  • the remaining consensus-layer work ordered by distance from the current tooling
  • the lean Ethereum setting (zkEVM-proved EL, XMSS aggregation in leanVM) and what remains for a consensus-layer zkVM there, plus recommended next steps

Also shortens README.md to a 30-line overview; the build, toolchain, test-coverage, and ZisK guest instructions move verbatim to docs/build.md, and docs/benchmarks.md now points there.

Documentation only; no code changes.

Capture the 2026-09-17/18 discussion: why the consensus-layer state
transition is being proved, where weigh sits in the block and epoch
flow, what the ZisK segment-padding result means for the metric to
track, the PoC decisions (in-memory state model, Merkle access deferred
to #4, resident prover later), the remaining consensus-layer work, and
what is left for a consensus-layer zkVM once the execution layer is
proved by a zkEVM and BLS is replaced by aggregated XMSS proofs.
@adust09
adust09 merged commit 0c67469 into main Sep 18, 2026
2 checks passed
@adust09
adust09 deleted the docs/zkvm-roadmap-20260918-1751 branch September 18, 2026 09:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant