Skip to main content
This page is the fastest way to see the Agon protocol execute real settlements. It runs the committed devnet demo, which exercises every settlement path against the live V4 deployment and produces the benchmark artifacts used throughout these docs. If you want the integration-level walkthrough instead, go to Your first payment.
1

Clone the protocol repository

git clone https://github.com/Agonx402/agon-protocol.git
cd agon-protocol
npm install
2

Run the devnet demo

npm run demo:agon-protocol
This executes the committed end-to-end flow against the live devnet program:
  1. latest-commitment settlement
  2. bundle settlement
  3. single-payer cooperative clearing
  4. bilateral cooperative clearing
  5. the largest executable multilateral clearing round on devnet
The run writes a machine-readable manifest to config/agon-protocol-demo-last-run.json.
3

Generate benchmark artifacts (optional)

npm run benchmarks:generate
This combines the demo manifest with deterministic sizing scripts and refreshes the live and synthetic benchmark pages in this docs site.

​
Live devnet deployment

FieldValue
Program IDBa2puU8D2CLD1dYfRQ4YBXxirdyz3zVLLChvMf9AqJ1Y
Clusterdevnet
Message domainb2ba0d07c5a4fcd09b933f732c3f389d
Default settlement tokenaUSDC (token_id = 2, mint AMXvvKksfCprEKY9uxzNx9MKrDq9kwDWG6Fr9sXkEpAr)
The full reference is on the Deployment page.

​
Prerequisites

  • Node.js 18 or newer
  • Rust toolchain (only required if you want to rebuild the program)
  • Solana CLI
  • Anchor
If you only want to integrate against the live deployment, you do not need to rebuild the program. Build tools are only required when working inside the protocol repository itself.

​
Repository commands

From inside the protocol repo, these are the commands you will use most often: 
cargo fmt --check
cargo clippy --lib --features no-entrypoint -- -D warnings
anchor build
node ./node_modules/typescript/bin/tsc --noEmit
powershell -ExecutionPolicy Bypass -File scripts/test-local.ps1
The PowerShell script spins up a local validator, deploys the program, and runs the full Anchor test suite — useful on Windows + WSL developer machines.

​
Where to go next

Protocol overview

The on-chain objects, signed messages, and settlement paths in V4.

Your first payment

Build the smallest useful Agon integration end-to-end.

Run the devnet demo

More detail on the demo script and what it produces.

Live benchmarks

See the compression ratios and explorer links this demo generates.