Skip to main content

Full Network Sandbox (e2e_full)

cmd/e2e_full is the canonical end-to-end test for Genesis X-1. It simulates a complete 5-party agricultural supply-chain trade on the live production API — from actor registration through to cross-party Ed25519 verification.

Run it to validate that the network is working correctly, or as a live demonstration of the full protocol.

What It Does​

A single run executes a complete trade lifecycle:

FarmFresh Ltd (Supplier)  ─── ships wheat ───►  RetailCo Ltd (Buyer)
                                │
          ┌─────────────────────┼─────────────────────┐
          │                     │                     │
  SwiftLogistics          TrustAudit Inc         NationalBank
  (Transport)             (Auditor)              (Bank / Financier)

~30 actors are registered across 5 organizations. Every actor enrolls an Ed25519 key at registration. Every business event is signed. The final phase independently verifies every signature — without trusting the server.

Quick Start​

# Against production API (default)
go run ./cmd/e2e_full

# Against local server
go run ./cmd/e2e_full -base-url http://localhost:8080 -region in

No environment variables required. The run ID is auto-generated (timestamp-based). Every actor registered uses a unique run ID suffix to avoid collisions across concurrent runs.

Phases​

PhaseWhat happens
1 — Register5 orgs + ~25 staff registered; Ed25519 keys enrolled at registration
2 — OnboardEach org onboards via POST /onboarding/organization → gets FRL ledger
3 — DelegateEach org grants staff delegation via POST /delegation/organization (signed)
4 — FRL MastersEach org creates a TraceLedger master on their FRL (signed)
5 — Master AccessEach org grants staff write on their FRL master (signed)
6 — Sup EventsFarmFresh records: PRODUCTION_STARTED → TEMPERATURE_LOG ×3 → QC_INSPECTION_PASSED → SHIPMENT_READY
7 — ORDER LedgerFarmFresh creates ORDER ledger with RetailCo via POST /ledgers
8 — ORDER MasterFarmFresh creates ORDER master; grants write to 13 cross-party delegates (signed)
9 — Order Events5 parties append 15 signed events: pickup, transit, IoT logs, delivery, audit, loan, disbursement
10 — Buy EventsRetailCo records: GOODS_ACCEPTED → DOCK_SCAN → BUYER_QC_PASSED → WAREHOUSE_RECEIVED
11 — CloseFarmFresh closes ORDER master + ORDER ledger (both actor-signed)
12 — Verify (10A)SigLog self-verify: re-verify every sig locally using stored public keys (zero server trust)
13 — Verify (10B)Cross-party: each party fetches ledger via own API key + independently verifies Ed25519

Expected Output (summary)​

PHASE 10A: SIGLOG SELF-VERIFICATION (client-side Ed25519 — zero server trust)
────────────────────────────────────────────────────────────────────────
#    event_type                           actor          result
────────────────────────────────────────────────────────────────────────
1    SUPPLIER_DELEGATION_GRANTED          FarmFresh Ltd  ✓ PASS
2    SUPPLIER_DELEGATION_GRANTED          FarmFresh Ltd  ✓ PASS
...
SigLog: 74 PASS  0 FAIL  74 total

VERIFIER: NationalBank (bnk_loan)
LEDGER:   ORDER ledger  id=8eecc02d-...
────────────────────────────────────────────────────────────────────────
...
integrity:✓  Ed25519-pass:33  fail:0  total:33

CROSS-PARTY VERIFICATION SUMMARY
────────────────────────────────────────────────────────────────────────
  Ed25519 verified : 116
  Failed           : 0
  Proof model: client-side Ed25519 — no server trust required

Network Topology Exercised​

Ledger / Scope          Party Access
─────────────────────────────────────────────────────────────────
Supplier FRL            FarmFresh org + 6 staff (direct)
                        Verified in 10B by sup_mgr API key

Buyer FRL               RetailCo org + 6 staff (direct)
                        Verified in 10B by buy_proc API key

ORDER Ledger            FarmFresh + RetailCo (direct parties)
                        SwiftLogistics — delegated via master access
                        TrustAudit Inc — delegated via master access
                        NationalBank   — delegated via master access
                        Verified in 10B by bnk_loan + trn_pickup API keys

Signing Coverage​

Every actor-signed event uses the Layer A protocol:

msg    = eventType + "\x00" + ledgerID + "\x00" + canonicalJSON(sigPayload)
digest = SHA-256(msg)
sig    = Ed25519.Sign(actorPrivKey, digest)

The SigLog in NetworkState accumulates every SigRecord during the flow. Phase 10A replays all of them locally. Phase 10B fetches from the server and re-verifies.

Causal links are sealed cryptographically:

  • QC_INSPECTION_PASSED.caused_by_hash → PRODUCTION_STARTED hash
  • DELIVERED.caused_by_hash → GOODS_PICKED_UP hash
  • LOAN_DISBURSED.caused_by_hash → DELIVERED hash

File Structure​

cmd/e2e_full/
├── main.go          — phase orchestration (phases 1–13)
├── state.go         — NetworkState, ActorState, SigRecord, MasterState
├── client.go        — HTTP helpers, signing helpers, canonicalJSON
├── sup_phases.go    — FarmFresh registration, onboard, delegate, FRL events
├── buy_phases.go    — RetailCo registration, onboard, delegate, FRL events
├── trade_phases.go  — all 5-party roles: Auditor, Transport, Bank, ORDER ledger/events, close
└── verify.go        — Phase 10A (SigLog) + Phase 10B (cross-party) verification

Flags​

FlagDefaultDescription
-base-urlhttps://api.iaexnetwork.comAPI base URL
-regioninRegion for actor registration (in or eu)

Using as Integration Test​

The program exits with a non-zero status on any failure (HTTP error, sig mismatch, missing field). Run in CI to validate the live API:

go run ./cmd/e2e_full 2>&1 | tee e2e_$(date +%Y%m%d_%H%M%S).log
echo "Exit: $?"

Zero exit = all phases passed including cross-party Ed25519 verification.