mirror of
https://github.com/saymrwulf/swisspost-evoting-go-poc.git
synced 2026-11-21 10:13:13 +00:00
README: document both cockpit surfaces (browser + tmux)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
parent
b38b990bc4
commit
1ad12d6c33
1 changed files with 15 additions and 6 deletions
21
README.md
21
README.md
|
|
@ -68,8 +68,9 @@ make test # runs cargo test + go test ./...
|
||||||
./evote netdemo --voters 10 --options 3
|
./evote netdemo --voters 10 --options 3
|
||||||
./evote netdemo --voters 3 --options 2 --verbose # log every signed message
|
./evote netdemo --voters 3 --options 2 --verbose # log every signed message
|
||||||
|
|
||||||
# Watch the cryptography execute as live typeset math in the browser
|
# Watch the cryptography execute as live math — two surfaces, one event stream:
|
||||||
./evote cockpit --voters 3 --options 3 # open http://localhost:8090
|
./evote cockpit --voters 3 --options 3 # browser: typeset MathML at http://localhost:8090
|
||||||
|
./evote cockpit --tmux --voters 3 # terminal: one tmux pane per stakeholder
|
||||||
|
|
||||||
# Serve presentations on local network (for iPad viewing)
|
# Serve presentations on local network (for iPad viewing)
|
||||||
./evote serve --port 8080
|
./evote serve --port 8080
|
||||||
|
|
@ -81,10 +82,18 @@ make test # runs cargo test + go test ./...
|
||||||
The `cockpit` command is a teaching instrument: it runs the full multi-party
|
The `cockpit` command is a teaching instrument: it runs the full multi-party
|
||||||
ceremony and streams **every cryptographic operation** — sampling, ElGamal
|
ceremony and streams **every cryptographic operation** — sampling, ElGamal
|
||||||
encryption, Fiat-Shamir challenges, the Bayer-Groth shuffle, Ed25519 signatures,
|
encryption, Fiat-Shamir challenges, the Bayer-Groth shuffle, Ed25519 signatures,
|
||||||
X25519 key agreement — to a browser page that renders each as **typeset
|
X25519 key agreement — as **the mathematics that is executing, with the real
|
||||||
mathematics with the real runtime values**, the instant it executes. The math is
|
runtime values**, the instant it runs. One `pkg/trace` event stream feeds two
|
||||||
native MathML (no libraries, offline); a stakeholder sidebar highlights the acting
|
surfaces:
|
||||||
party and a phase timeline tracks setup→cards→voting→tally→verify.
|
|
||||||
|
- **Browser** (default): a self-contained page renders each operation as typeset
|
||||||
|
MathML (no libraries, offline). A stakeholder sidebar highlights the acting
|
||||||
|
party; a phase timeline tracks setup→cards→voting→tally→verify.
|
||||||
|
- **Terminal** (`--tmux`): one tmux pane per stakeholder, each rendering its
|
||||||
|
party's operations as colored ASCII/Unicode math — the "autonomous parties"
|
||||||
|
view.
|
||||||
|
|
||||||
|
`--delay` paces the events so a human can follow along.
|
||||||
|
|
||||||
The `demo` command runs the whole protocol in one process. `netdemo` runs the
|
The `demo` command runs the whole protocol in one process. `netdemo` runs the
|
||||||
**multi-party** architecture: every party is a separate endpoint holding only its
|
**multi-party** architecture: every party is a separate endpoint holding only its
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue