Skip to content

Add mermaid sequence diagram for testnet example #36

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
han0110 merged 1 commit into from
Feb 2, 2026
Merged

Add mermaid sequence diagram for testnet example #36

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions docker/example/testnet/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,24 @@

This example shows how to run a small local testnet with 3 normal nodes, and 3 optional-proofs nodes, with zkboost generating EL execution proofs, and EWS (Execution Witness Sentry) publish the proofs (configured to have 2 proof types `ethrex-zisk` and `reth-zisk`).

```mermaid
sequenceDiagram
participant CL as CL
participant EL as EL
participant CLOptionalProofs as CL <br> (optional-proofs)
participant EWS as EWS
participant zkboost as zkboost <br> server
participant ere as Ere <br> server(s)
CL->>EWS: New head <br> (SSE)
EL->>EWS: Fetch block + witness
EWS->>zkboost: Request proof
zkboost->>EWS: Response proof_gen_id
zkboost->>ere: Request proof
ere->>zkboost: Response proof
zkboost->>EWS: Send proof + proof_gen_id
EWS->>CLOptionalProofs: Submit proof
```

## Installation

1. Install [Docker](https://docs.docker.com/get-docker/). Verify that Docker has been successfully installed by running `sudo docker run hello-world`.
Expand Down