Skip to main content
The protocol demo is the primary end-to-end reference run for the live V4 deployment. It exercises every settlement path against the real devnet program and produces the benchmark artifacts that this documentation site publishes.

​
What it covers

The demo executes five scenarios in sequence:
  1. Latest-commitment settlement — one payer, one payee, one channel, settled with a single agon-cmt-v5 message.
  2. Commitment bundle settlement — one payee collecting multiple payers in a single transaction.
  3. Single-payer clearing round — one payer distributing to multiple payees in one cooperative round.
  4. Bilateral clearing round — two participants netting two channels.
  5. Largest executable multilateral round — the largest cooperative round that fits a v0 transaction with Address Lookup Tables.
Each scenario records participants, channels, underlying payment counts, explorer links, serialized transaction bytes, signed message bytes, and signature counts.

​
Run it

cd /home/heis/agon/agon-protocol
npm run demo:agon-protocol
npm run benchmarks:generate
  • The first command runs the live settlement scenarios against devnet.
  • The second turns the last-run manifest plus the deterministic sizing scripts into committed JSON snapshots under benchmarks/ and refreshes the generated pages in this docs site.
Re-running both commands republishes the Live devnet benchmarks and Synthetic capacity benchmarks pages from fresh evidence.

​
Why this matters

Keeping the demo and the docs in the same loop ensures every published number is tied to a reproducible on-chain run at a specific commit, not hand-maintained benchmark copy.

​
See also