From c9d2423c3846755ac5a575d23a589ce25b8b60ca Mon Sep 17 00:00:00 2001
From: Jannis Braun <151788261+TheZwiss@users.noreply.github.com>
Date: Thu, 2 Apr 2026 11:38:25 +0200
Subject: [PATCH] docs: add federation filtering note to ready payload spec

---
 docs/systems/websocket.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/systems/websocket.md b/docs/systems/websocket.md
index a440cf3d..943dd5ff 100644
--- a/docs/systems/websocket.md
+++ b/docs/systems/websocket.md
@@ -213,3 +213,5 @@ reason: `'displaced'` (new tab) | `'session_closed'`
   userActivities?: Record<userId, Activity[]>
 }
 ```
+
+**Federation filtering:** When the connecting user is federated (`homeInstance` is set), the server omits all DM-related data from the ready payload. `dmChannels` and `activeCalls` are sent as empty arrays, and `readStates` is filtered to only include space channel entries. Federated users receive their DM data from their home instance's ready payload instead.