THEPROTOCOL

AEGIS

#5 of 28Tier II · full anatomy6 of 6 steps on built rails
Risk Analysis and Event Verification

A weather risk reading whose method froze at publication and whose every input carries a signature. It sells readings, never cover.

Open the live chamber in the app
The animated flow, the attack replays and the deep architecture run there; this page is the reference text.

Who this serves

The problem

Weather risk is argued after the fact because the method, the data and the fee live in three systems and nobody can replay how a number was made. Every party has an incentive to remember the method differently, and the method is a PDF.

The system

AEGIS is the risk desk of a growers’ cooperative with 2,400 greenhouse operators. It reads the weather service’s and the satellite operator’s signed readings and publishes a hail chance per district, per week, by method v4. The method is an instantiated template version: it froze when it was published, every reading the cooperative orders copies it, and neither side can rewrite how a number was made. The cooperative pays per reading through escrow on the ledger, released when the signed report arrives.

On the night of 14 June, hail crosses Emsland. The oracle agents sign what they saw; the event gate checks the readings against method v4 and issues 61 verified event reports before the growers wake up, one per affected district, each with its sources and their signatures. The 62nd district contests its report, so its fee does what contested money does here: it stops, holds in escrow through a four-phase dispute, and moves exactly once when the ruling lands. What a grower decides on a report stays the grower’s own business, outside the protocol.

The cast and their ceilings

AgentRoleCeiling
risk-deskPublishes method versions, issues readingsPublish and instantiate. Cannot touch the method of a delivered reading.
oracle-dwd, oracle-satSupply weather dataSigned attestations only. No release authority.
event-gateChecks readings against the frozen methodIssues a report per event. Cannot alter the method or the fees.
coop-watchReads the season for the cooperativeRead-only, all season.

The flow, step by step

  1. The method froze at publish. Each order copied it. The fee waits in escrow.
  2. 02:12. Hail crosses Emsland, and the oracles sign what they saw.
  3. Readings against the frozen method. The event is verified, and the report is issued.
  4. The escrow releases the fee for the delivered report.
  5. 61 verified reports before sunrise, each fee carved and logged by the same rail.

Each need, mapped to a live primitive

The needThe protocol primitiveStatus
The method, frozen at publicationContract templates: publish is an irreversible version freezeLIVE (gated)
Paid per reading, on deliveryEscrow funded at order, released on the signed reportLIVE
Weather data with identityOracle agents with SPIFFE identity, signed attestationsLIVE
Contested readingsFour-phase dispute: evidence, ruling, settlementLIVE
The analyst’s track recordEigenTrust reputation over settled outcomesLIVE
Downstream notificationWebhooks on contract and settlement eventsLIVE

The attack this chamber refuses: The after-the-fact rewrite

The attack. After the hail, the desk tries to soften step 9 of method v4, so that last week’s chance reads closer to what happened.

Why it fails. Publishing is an irreversible freeze and instantiation copies rather than references. Every delivered reading carries the method it was made with, and there is no reference for a rewrite to travel through.

Rail S14 · Immutable ledger. Append-only, replayable, forensically searchable. History cannot be edited.

What actually happens. The desk can publish version 5 for next season. Version 4, and every reading made with it, is beyond reach, and the desk’s track record is scored against what it actually said.

Deep architecture

AEGIS deployed: the analyst’s frame holds the frozen methods, the reading escrow and the event gate; the cooperative and its auditor read a signed replica on their own side; the weather arrives raw underneath and leaves the oracles as signed attestations. Nothing in this drawing is a report anyone files afterwards. The trace replays one season, publish to verified report to the three readers.

The deployment, traced

  1. The risk desk publishes method v4. Publishing is an irreversible freeze.
  2. The cooperative orders a season of readings: the order copies the frozen method, and the fee waits in escrow, on the ledger.
  3. The event gate holds the frozen method. Nobody argues about a PDF, because there is no PDF.
  4. All season, the weather arrives raw.
  5. The oracles sign what they saw. An attestation has an identity, not just a value.
  6. 02:12, 14 June. Hail crosses Emsland. The readings meet the method; the gate issues the report and the escrow releases its fee.
  7. 61 verified reports land before the growers wake up. The 62nd is contested, so its fee stops in escrow and waits for the four-phase ruling.
  8. The back office receives evidence, not spreadsheets to reconcile.
  9. The season mirrors out as signed events.
  10. The replica carries the same method, the same reports, the same refusals.
  11. The cooperative reads all season. Every number traces to a signed source.
  12. The auditor reads the same replica. One ledger, three readers, nothing to reconcile.

Adoption, phase by phase

Discover: Your method, re-read as a schema.

Pilot: One district, real readings, pocket fees.

Production: The method becomes a fact the cooperative watches.

Federation: The auditor reads the replica, not an export.

Sizing

LevelWhatContainers
L1Growers and planners join as accounts; readings land on their desks0 of theirs
L2The analyst runs oracles and gates against a hosted registry seatagents only
L3The analyst’s sovereign frame: escrow and season ledger under its law~9, one VM up

One event, weather to verified report

sequenceDiagram
  participant WX as weather feed
  participant Ora as oracle agents
  participant Gate as event gate
  participant TEG as reading escrow
  participant ES as event ledger
  participant Rep as signed replica
  WX->>Ora: raw readings, all season
  Ora->>Gate: signed attestations (SPIFFE identity)
  Gate->>Gate: readings vs frozen method (v4)
  Gate->>TEG: report issued, per district
  TEG-->>ES: fee released + logged, append-only
  ES-->>Rep: signed mirror update
  Rep-->>Rep: cooperative + auditor read, cannot write
  Note over TEG: a contested report's fee stops in escrow, four-phase dispute

Topology, as declared

flowchart LR
  T["method template<br/>publish = freeze"] -->|"instantiate copies"| R["reading order<br/>method v4"]
  R -->|"fee at order"| TEG["TEG escrow"]
  O["oracle agents<br/>SPIFFE identities"] -->|"signed attestations"| G{"event gate"}
  G -->|"report issued"| TEG
  TEG -->|"release on delivery"| ES[("event store")]
  DIS["dispute, 4 phases"] -->|"ruling drives split, once"| TEG

Standing it up

Runs beside what you already have

A full sovereign frame is nine containers and boots in about two minutes, on anything from a Raspberry Pi to a rack. That is cheap enough to run the whole system in parallel with the legacy stack: the old system keeps running, real work mirrors onto the rails, and you compare ledgers until the evidence settles the argument. Nothing is ripped out.

Planned: a public proxy library. Free, ready-made connectors for the systems above and whatever else a merge needs, so the bridge is an import, not an integration project.

What this does not claim