1.6 KiB
Session protocol v10 cellular mutation choice
ADR-0121 adds v10 as an additive extension. Versions 1–9 retain their exact wire layouts and behavior. V10 retains the v9 owner diagnostics and adds a reliable-stream mutation-choice action as message type 25. This message selects an operator from an already earned offer; it supplies no genome, successor identity, price, or biological state.
Type 25
The standard 8-byte EVSN header uses version 10, type 25 and flags 0. The
payload is exactly 64 bytes, little-endian:
| Payload offset | Size | Field |
|---|---|---|
| 0 | 8 | authenticated session id, nonzero |
| 8 | 8 | control epoch, nonzero |
| 16 | 8 | stable per-account action id, nonzero |
| 24 | 8 | intended simulation tick, nonzero |
| 32 | 8 | stable life identity, nonzero |
| 40 | 8 | earned offer event index, nonzero |
| 48 | 8 | exact offer tick, nonzero and before the intended tick |
| 56 | 2 | offered operator id, nonzero |
| 58 | 6 | reserved, all zero |
The decoder rejects all zero identities, an offer tick at or after the target
tick, reserved bytes, wrong lengths, and use under versions 1–9. When server
admission is enabled, it must bind the action to the authenticated account,
verify the exact current offer and operator, reserve the successor identity
idempotently by (world, account, action_id), then schedule the choice for that
advancing tick. The reliable receipt means admission only; the final outcome is
tied to the committed tick and its recovered cellular checkpoint. This document
defines the wire codec only; runtime admission remains disabled until its
durable reservation and publication path is complete.