Files
aevolution/schemas/network/session-v10-cellular-mutation-action.md
T
dingo 9da2bd37dd
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 1m52s
Foundation / checks (checks) (push) Failing after 4m1s
Foundation / checks (tsan) (push) Canceled after 0s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (client) (push) Canceled after 11m9s
Foundation / checks (network) (push) Canceled after 9m18s
Foundation / checks (postgres) (push) Canceled after 7m18s
Add cellular mutation action protocol v10
2026-10-11 06:57:22 -04:00

1.6 KiB
Raw Blame History

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.