docs: write witness retrieval concept page#9
Merged
Conversation
Explains what an execution witness is, why Zesu needs one instead of holding full chain state, the difference between a witness and a proof, and how Zesu currently retrieves witnesses via the debug_executionWitness RPC endpoint. Includes a caution admonition noting the witness spec and retrieval mechanism are under active development, and a note linking to the execution-apis proposals for the longer-term Engine API delivery path. Co-authored-by: Cursor <cursoragent@cursor.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Writes the Witness retrieval concept page (
docs/concepts/witness-retrieval.mdx), covering:debug_executionWitnessRPC endpoint provided by thebesu-zkevm-plugin.Review notes
:::cautionadmonition at the top of the page notes the witness specification and retrieval method are under active development.:::notein the retrieval section links to execution-apis #741 and #773 for the longer-term Engine API delivery proposals.Test plan
npm run buildsucceeds.Made with Cursor
Note
Low Risk
Documentation-only update introducing new conceptual content; no runtime or security-sensitive code paths are affected.
Overview
Adds a substantially expanded
Witness retrievalconcept page explaining what an execution witness is, why Zesu needs it for stateless re-execution, and how it differs from a proof (including a comparison table).Documents Zesu’s current witness-fetching approach via Besu’s
debug_executionWitnessRPC (viabesu-zkevm-plugin) and adds frontmatter metadata (description,keywords) plus a top-level caution noting the spec/retrieval method are still in flux.Reviewed by Cursor Bugbot for commit d33a8c9. Bugbot is set up for automated code reviews on this repo. Configure here.