Add protocol v1: versioned, bounded frames (Hello, Welcome, Intent, IntentResult, environment/organism views, Close) carrying session, epoch and commit watermark, with an explicit little-endian canonical codec, a header-first FrameReader, seeded mutation tests and a libFuzzer target. SessionAdmission enforces world/region scope, grant lifetime and skew, single-use grants, one session per subject, epoch, replay, tick window and per-session rate. Dev identity is a 108-byte HMAC-SHA256 grant (PSA) that cannot be created or verified outside the dev environment. Transport security is TLS 1.3 only via pinned Mbed TLS 4.1.1 LTS with TLS 1.2, DTLS, tickets and PSK compiled out, AEAD suites, ECDHE groups and a pinned dev CA. Opt-in EVO_BUILD_NETWORK, new network CI suite. Sockets and region integration follow in M9.7. ADR-0082 records the decision. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1.4 KiB
ADR-0017: Network transport and security
Status
Transport proposed; server authority/no custom cryptography locked. ADR-0082 applies this to the M9 dev session only (TLS 1.3 over a stream with Mbed TLS 4.1.1); the M10 transport remains open.
Context
Superseding state and durable decisions need distinct delivery and trust contracts.
Decision
Keep application semantics transport-neutral; compare QUIC streams+DATAGRAM with DTLS-protected UDP plus mature reliability. Own replication/perception/application logic; use maintained crypto implementations.
Alternatives Considered
TCP/TLS all traffic is simple but head-of-line behavior needs measurement; early Steam-specific coupling limits portability; homemade encrypted transport rejected.
Benefits
Established security with perception-aware replication and independent identity provider.
Costs
Reconnect/channel/window/rate/epoch tests and dependency review.
Risks
Replay/parser abuse, hidden-information leakage, obsolete crypto and compromised workers.
Consequences
Measure loss/latency/MTU/NAT/platforms/binary size/license/maintenance, then pin. Fuzz and adversarial tests gate multiplayer. Worker compromise requires scoped durable constraints/audit, not only client authority. QUIC, DATAGRAM, DTLS1.3.