THEPROTOCOL

ADMIRALTY

#21 of 21Tier II · full anatomy6/6 primitives live in production
Maritime and Port Operations

Port calls that settle from escrow on signed events, and demurrage decided on an attested clock instead of competing spreadsheets.

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

A single port call scatters money across agency fees, pilotage, towage and dues, settled by invoice weeks later; and when the ship overstays her laytime, the demurrage claim is two spreadsheets disagreeing about when the clock started, argued by email for a year. The industry that standardised the container never standardised the handshake.

The system

ADMIRALTY gives the vessel an identity and the port call an escrow. Before MV Kestrel arrives, her operator funds the call: agency, pilotage, towage, dues, one escrowed disbursement account the port agent can see but not raid. The call then settles itself off signed events, because the events are attestations, not emails: notice of readiness signed by the master’s agent, berthing signed by the port, completion signed by both. Each service releases its slice at its trigger, and the agent who used to finance the ship’s costs and chase reimbursement for a quarter is simply paid at completion.

The same attested timeline is what kills the demurrage fight. Laytime runs from the signed NOR to the signed completion; the clock is not a claim either side makes but a record both already signed at the time. When there is still a genuine dispute, the weather clause, the excepted period, it goes through a dispute with the timeline as shared evidence and the disputed amount held until ruling. Ports run sovereign registries under their own law with their jurisdiction profiles declared, the fleet federates across them, and a voyage across four jurisdictions settles in each one without anyone wiring money on faith.

The cast and their ceilings

AgentRoleCeiling
vessel-kestrelThe ship’s transacting identityFunds its own calls; spend policy per voyage.
port-agent-piraeusCoordinates the call, signs eventsAttests and claims its own service. Cannot touch other slices.
port-authoritySigns berthing, levies duesIts own attestations and its own tariff.
charter-deskRuns laytime and demurrageReads the timeline; disputes with evidence.

The flow, step by step

  1. The disbursement account escrows before arrival. Visible, not raidable.
  2. Notice of readiness is a signed attestation. The clock starts on record.
  3. The port signs berthing under its own sovereign registry.
  4. Each service releases its slice at its trigger.
  5. The voyage ledger holds the timeline both sides signed at the time.

Each need, mapped to a live primitive

The needThe protocol primitiveStatus
A vessel is an identity, not an email threadDIDs with mTLS certificates per vessel and agentLIVE
Port-call money set aside before arrivalEscrowed disbursement accounts with staged releaseLIVE
Laytime is a clock both sides readSigned port attestations: NOR, berthing, completionLIVE
Demurrage disputes with evidenceFour-phase dispute over the attested timelineLIVE
Each port under its own lawSovereign registries, jurisdiction profiles declaredLIVE
Cross-border settlementCross-registry transfer, exactly-once, fees explicitLIVE

The attack this chamber refuses: The retroactive clock

The attack. Facing a six-figure demurrage claim, a party submits a corrected timeline moving the notice of readiness eleven hours later.

Why it fails. The NOR is an attestation signed by identified parties at the time, on an append-only ledger; there is no rail that rewrites a signed event, only one that adds a later, visibly later, statement. A demurrage case argues the clauses, not the clock.

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

What actually happens. The original timestamp stands, the correction attempt is itself on the record, and the dispute proceeds over the signed timeline with the disputed amount held until ruling.

Deep architecture

ADMIRALTY deployed: the port authority runs its sovereign frame under its own law; MV Kestrel and the charter desk act from the operator’s side; the harbour systems feed the agent who signs what happened, when it happened. The disbursement account is one escrow the agent can see but not raid, and the laytime clock is a record both parties signed at the time. The trace replays one call at Piraeus, funding to demurrage that never becomes a fight.

The deployment, traced

  1. Before MV Kestrel arrives, her operator funds the call: agency, pilotage, towage, dues.
  2. One escrowed disbursement account. The port agent can see it and cannot raid it.
  3. AIS and the terminal systems feed the agent who will sign what happened.
  4. Notice of readiness, signed by the master’s agent. An attestation, not an email.
  5. Berthing, signed by the port. Completion will be signed by both.
  6. Laytime runs from signed NOR to signed completion. The clock is not a claim either side makes; both already signed it at the time.
  7. Each service releases its slice at its trigger.
  8. Pilotage and towage are paid as their events land.
  9. The agent who used to finance the ship’s costs and chase reimbursement for a quarter is simply paid at completion.
  10. A genuine dispute, the weather clause, goes to ruling with the timeline as shared evidence, and the disputed amount holds until then.
  11. Signed commands courier through the fabric; the relaying peer is never the principal.
  12. The operator’s ledger holds the same call. The next port, in the next jurisdiction, settles the same way, and nobody wires money on faith.

Adoption, phase by phase

Discover: One call, re-told as events.

Pilot: One berth, shadow disbursement.

Production: The port settles itself, under its law.

Federation: A voyage across four jurisdictions.

Sizing

LevelWhatContainers
L1Agencies and charterers join with accounts and agents0 of theirs
L2An operator runs vessel identities against a hosted seatagents only
L3A sovereign frame per port authority, profile declared~9 per port

One port call, funding to completion

sequenceDiagram
  participant Ves as MV Kestrel (operator frame)
  participant XT as cross-registry pay
  participant Call as the port call (port frame)
  participant Agt as port-agent
  participant Port as port-authority
  participant TEG as disbursement escrow
  participant ES as attested timeline
  Ves->>XT: funds the call ahead
  XT->>TEG: one DA, escrowed, visible
  Agt->>Call: NOR signed
  Port->>Call: berthing signed
  Call-->>ES: the clock, signed by both at the time
  Call->>TEG: each service releases its slice
  TEG->>Agt: agent paid at completion
  Note over ES: demurrage argues over a record, not against one
  Note over Call: the disputed slice holds until the ruling; the rest settles

Topology, as declared

flowchart LR
  OP["ship operator"] -->|"fund the call pre-arrival"| TEG["call escrow<br/>agency + dues + towage"]
  PA["port agent"] -->|"NOR, completion signed"| G{"event gate"}
  AUTH["port authority<br/>sovereign registry"] -->|"berthing signed"| G
  G -->|"staged release per service"| TEG
  CH["charter desk"] -.->|"demurrage dispute<br/>over attested timeline"| DS["dispute, amount held"]
  TEG --> ES[("voyage ledger<br/>the clock both sides signed")]

Standing it up

What this does not claim