Summary
The native zesu binary is the practical reference for two debugging workflows:
- zkVM integrators validating their wiring by comparing their guest's 41-byte commitment to the native binary's commitment for the same input.
- Operators reproducing a failing block locally during incident response, without involving any zkVM.
The docs don't currently cover either workflow. This issue asks for a how-to that does.
Suggested scope
- How to obtain a block bundle to test against: capture one from an execution client, use one of the canonical fixtures, or generate one with the available tooling.
- Running the native
zesu binary against that input.
- Comparing the 41-byte commitment against an expected value, or against the commitment a zkVM integration produces for the same input.
- Interpreting a divergence — what it does and doesn't tell you about where the bug lives.
Out of scope
- How to capture witnesses from a specific execution client. Witness production is covered in
docs/concepts/witness-retrieval.mdx; this page should reference it rather than duplicate it.
- The full zkVM integration flow. That belongs in the integrator content elsewhere.
- Architecture of the native binary internals. Zesu is currently alpha and a fast-moving target — documentation should stay focused on user-facing usage rather than implementation details.
Notes
Summary
The native
zesubinary is the practical reference for two debugging workflows:The docs don't currently cover either workflow. This issue asks for a how-to that does.
Suggested scope
zesubinary against that input.Out of scope
docs/concepts/witness-retrieval.mdx; this page should reference it rather than duplicate it.Notes
how-to/debug-with-native-binary.mdxor similar. Writer should pick the page name that fits the docs IA.zesubinary #20) is merged so this page can link to install steps rather than restate them.docs/concepts/inputs-and-outputs.mdx: missing wire formats and design rationale #18 will give this page a canonical place to link for input-format details.