Skip to content

ADR 0003: Separate versioned control and IQ WebSockets

  • Status: accepted
  • Date: 2026-08-24

Decision

Use one JSON control WebSocket and one binary IQ WebSocket per session. The control plane is low-rate, inspectable, acknowledged, and schema-versioned. IQ frames use a fixed 80-byte network-byte-order header followed by sample bytes.

Separate channels prevent high-volume IQ backpressure from delaying stop, lease, error, and status messages. Sequence and sample counters make loss and retune discontinuities explicit. Full details are normative in docs/protocol/V1.md.

Evolution

Breaking wire changes increment the major version. Receivers reject unknown major versions; additive flags or JSON fields use minor versions. Reserved fields must be transmitted as zero and ignored on receipt.