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
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>
1.9 KiB
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).