Files
aevolution/schemas/network/handoff-ticket-v1.md
T
dingoandClaude Opus 5.5 0ce51077b1
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 1m55s
Foundation / checks (client) (push) Successful in 12m40s
Foundation / checks (postgres) (push) Canceled after 4s
Foundation / checks (network) (push) Successful in 12m53s
Foundation / checks (tsan) (push) Successful in 7m55s
Foundation / checks (checks) (push) Successful in 31m47s
Foundation / postgres-tools (push) Skipped
Foundation / server-image (push) Skipped
Foundation / image (push) Skipped
Add M10.8b signed handoff tickets and ticket admission
ADR-0096. A source region's handoff key signs a 160-byte ticket for one probe
transfer, account and destination; it rides the Hello grant slot and is
verified against neighbour keys bound to their regions. SessionControl
admits a ticket once per region, superseding like a grant, with the session
ending at the client's original grant expiry. RegionSessions makes the
destination's durable step first: PostgresHandoffLedger stages and commits
the transfer and moves the account's control, idempotently.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 18:32:14 -04:00

1.9 KiB

Handoff ticket, version 1

ADR-0096 (M10.8b). A region signs a ticket for one probe transfer with its handoff key; the destination region admits the account's client with it instead of a grant. It travels in the 160-byte grant slot of Hello (session protocol v3); its marker routes it to ticket verification. Implemented by HandoffSigningKey and HandoffVerifier (include/evo/network/handoff_ticket.hpp). Integers little-endian.

Offset Size Field Rule
0 16 marker EVO-HANDOFF followed by five zero bytes
16 2 version 1
18 1 environment 1 dev, 2 stage, 3 world0; must equal the verifier's
19 1 reserved 0
20 4 key id Selects the source region's key (bound to that region)
24 16 transfer id Nonzero; the probe transfer (schema v12)
40 16 account Valid account id
56 8 world Nonzero, equal to the destination's
64 8 frame Nonzero, equal to the destination's
72 8 source region Nonzero; equal to the region the key is registered for
80 8 destination region Nonzero, not the source; equal to the verifying region
88 4 expires_at Seconds (server clock); accepted while now < expires_at <= now + 120
92 4 session_expires_at Seconds; the opened session ends then (capped at now + the maximum grant lifetime)
96 64 signature ECDSA P-256 / SHA-256 over bytes [0, 96), raw r and s

Rules:

  • The signature is verified first; no other byte is trusted before it.
  • Within a region a ticket is single-use: its transfer id is remembered until the ticket expires.
  • The destination's durable side stages and commits the transfer, then moves the account's control. It refuses a transfer that is unknown, aborted, for another account, from another source or for another region.
  • Grants and tickets never verify as each other (different markers and keys).