房间版本 3

该房间版本在 版本 2 的基础上，改进了事件格式。

客户端注意事项

此房间版本更改了发送给客户端的事件 ID 格式。客户端应注意，这些事件 ID 可能包含斜杠和其他潜在有问题的字符。客户端应将事件 ID 视为不透明标识符，不应尝试对其进行解析或转换（这一点与其他房间版本相同）。

客户端应预期事件 ID 的格式将由 $randomstring:example.org 变为类似 $acR1l0raoZnm60CBwAVgqbZqoO/mYU81xysh1u7XcJk（注意没有域名，且可能出现斜杠等特殊字符）。

虽然在本房间版本中未作更改，但实现本地化脱敏算法的客户端应参阅下文 脱敏 部分获取完整说明。

服务器实现组件

房间版本 3 除采用此处描述的事件格式外，也遵循了 房间版本 2 的其余行为规范。

处理脱敏

[New in this version] 在房间版本1和2中，清除操作（redactions）明确属于授权规则第11条。自房间版本3起，这些条件不再适用，如本版本的授权规则所示。

尽管清除操作始终被事件的授权规则接受，但只有在清除事件和被清除的事件都已被接收并且能够被验证后，才能将其发送给客户端。如果这两个事件都有效并已被服务器看到，那么在满足以下任一条件时，服务器会应用清除操作：

1. 清除事件的 sender 的权限等级大于或等于清除权限等级（redact level）。
2. 清除事件的 sender 的域名与原事件的 sender 的域名一致。

如果服务器将应用清除操作，则该清除事件也会被发送给客户端。否则，服务器只会等待有效的配对事件到来，届时可以重新检查上述条件。

事件 ID

[New in this version] 事件 ID 是该事件的引用哈希，采用无填充 Base64 编码，并以 $ 前缀。采用此方式生成的事件 ID 形如 $CD66HAED5npg6074c6pDtLKalHjVfYb2q4Q3LZgrW6o。

事件格式

当事件通过联邦协议传递时，将不再包含 event_id 字段。接收服务器应自行计算相应的事件 ID。

此外，auth_events 和 prev_events 字段的格式也被更改：不再是 (event_id, hash) 对的列表，而是直接为事件 ID 的普通列表。

事件格式的这些更改意味着服务器必须识别所收到事件所在房间的版本，以便能正确解析和处理事件。通过对服务器-服务器 API 的调整（例如在 GET /_matrix/federation/v1/make_join/{roomId}/{userId} 响应中包含 room_version 字段），此要求得以实现。

v3 房间内事件的完整结构如下所示。

{
  "auth_events": [
    "$base64encodedeventid",
    "$adifferenteventid"
  ],
  "content": {
    "key": "value"
  },
  "depth": 12,
  "hashes": {
    "sha256": "thishashcoversallfieldsincasethisisredacted"
  },
  "origin_server_ts": 1404838188000,
  "prev_events": [
    "$base64encodedeventid",
    "$adifferenteventid"
  ],
  "redacts": "$some/old+event",
  "room_id": "!UcYsUzyxTGDxLBEvLy:example.org",
  "sender": "@alice:example.com",
  "signatures": {
    "example.com": {
      "ed25519:key_version": "these86bytesofbase64signaturecoveressentialfieldsincludinghashessocancheckredactedpdus"
    }
  },
  "type": "m.room.message",
  "unsigned": {
    "age": 4612
  }
}

已弃用的事件内容模式

发送到此版本房间中的事件，其格式可能与其常规模式不同。此类情况将在此处进行说明。

m.room.power_levels 事件支持以字符串形式传递数值

为了与早期实现保持向后兼容， m.room.power_levels 事件中的每个整数值属性 都可以被编码为字符串而非整数。这包括 events、notifications 和 users 属性中的嵌套值。例如，以下是在此房间版本中有效的 m.room.power_levels 事件：

{
  "content": {
    "ban": "50",
    "events": {
      "m.room.power_levels": "100"
    },
    "events_default": "0",
    "state_default": "50",
    "users": {
      "@example:localhost": "100"
    },
    "users_default": "0"
  },
  "origin_server_ts": 1432735824653,
  "room_id": "!jEsUZKDJdhlrceRyVU:example.org",
  "sender": "@example:example.org",
  "state_key": "",
  "type": "m.room.power_levels"
}

当该值表示整数时，必须符合以下格式：

• 仅包含一个十进制整数，不允许浮点数或小数点，可以带任意数量的前导零（如 "100"、"000100"）；
• 可选地在整数前面加一个 - 或 + 字符（如 "+100"、"-100"）；
• 可选地在前后添加任意数量的空白字符（如 " 100 "、" 00100 "、" +100 "、" -100 "）。

授权规则

[New in this version] 在房间版本1和2中，事件需要来自 event_id 域的签名才能被视为有效。此房间版本在联邦过程中并未以相同方式包含 event_id，因此不需要该服务器的签名。不过，事件仍然必须由 sender 属性标识的服务器签名。

影响授权的状态事件类型有：

• m.room.create
• m.room.member
• m.room.join_rules
• m.room.power_levels
• m.room.third_party_invite

截至房间版本3，完整的规则列表如下：

1. 如果类型为 m.room.create：
   1. 如果有任何 prev_events，则拒绝。
   2. 如果 room_id 的域与 sender 的域不匹配，则拒绝。
   3. 如果存在 content.room_version 但不是被识别的版本，则拒绝。
   4. 如果 content 中缺少 creator 属性，则拒绝。
   5. 否则，允许。
2. 考虑事件的 auth_events：
   1. 如果某一对相同 type 和 state_key 的条目重复，则拒绝。
   2. 如果存在 type 和 state_key 不符合授权事件选择算法（见服务器规范）要求的条目，则拒绝。
   3. 如果存在在PDU接收时执行的检查中被拒绝的条目，则拒绝。
   4. 如果没有 m.room.create 事件，则拒绝。
3. 如果房间状态中的 m.room.create 事件的 content 属性 m.federate 设置为 false，且当前事件 sender 的域与创建事件的 sender 域不匹配，则拒绝。
4. 如果类型为 m.room.aliases：
   1. 如果没有 state_key，则拒绝。
   2. 如果发送者域与 state_key 不同，则拒绝。
   3. 否则，允许。
5. 如果类型为 m.room.member：
   1. 如果没有 state_key 属性，或 content 中没有 membership 属性，则拒绝。
   2. 如果 membership 是 join：
      1. 如果唯一的前置事件是 m.room.create 并且 state_key 是创建者，则允许。
      2. 如果 sender 不等于 state_key，则拒绝。
      3. 如果 sender 被封禁，则拒绝。
      4. 如果 join_rule 为 invite，则当成员状态为 invite 或 join 时允许。
      5. 如果 join_rule 为 public，则允许。
      6. 否则，拒绝。
   3. 如果 membership 是 invite：
      1. 如果 content 包含 third_party_invite 属性：
         1. 如果目标用户被封禁，则拒绝。
         2. 如果 content.third_party_invite 没有 signed 属性，则拒绝。
         3. 如果 signed 没有 mxid 和 token 属性，则拒绝。
         4. 如果 mxid 与 state_key 不一致，则拒绝。
         5. 如果当前房间状态下没有 state_key 与 token 匹配的 m.room.third_party_invite 事件，则拒绝。
         6. 如果 sender 不等于该 m.room.third_party_invite 的 sender，则拒绝。
         7. 如果 signed 中任一签名与 m.room.third_party_invite 事件中的任意公钥匹配，则允许。公钥可在 m.room.third_party_invite 的 content 中如下出现：
            1. public_key 属性中的单个公钥。
            2. public_keys 属性中的公钥列表。
         8. 否则，拒绝。
      2. 如果 sender 当前的成员状态不是 join，则拒绝。
      3. 如果目标用户当前成员状态为 join 或 ban，则拒绝。
      4. 如果 sender 的权限等级大于或等于邀请等级，则允许。
      5. 否则，拒绝。
   4. 如果 membership 是 leave：
      1. 如果 sender 等于 state_key，且该用户当前成员状态为 invite 或 join，则允许，否则拒绝。
      2. 如果 sender 当前成员状态不是 join，则拒绝。
      3. 如果目标用户当前成员状态为 ban，且 sender 权限等级小于封禁等级，则拒绝。
      4. 如果 sender 权限等级大于或等于踢出等级，且目标用户的权限等级小于 sender，则允许。
      5. 否则，拒绝。
   5. 如果 membership 是 ban：
      1. 如果 sender 当前的成员状态不是 join，则拒绝。
      2. 如果 sender 权限等级大于或等于封禁等级，且目标用户的权限等级小于 sender，则允许。
      3. 否则，拒绝。
   6. 其他情况下，成员状态未知，拒绝。
6. 如果 sender 当前成员状态不是 join，则拒绝。
7. 如果类型为 m.room.third_party_invite：
   1. 仅当 sender 当前权限等级大于或等于邀请等级时允许。
8. 如果事件类型的所需权限等级大于 sender 的权限等级，则拒绝。
9. 如果事件有以 @ 开头且与 sender 不一致的 state_key，则拒绝。
10. 如果类型为 m.room.power_levels：
    1. 如果 content 中的 users 属性不是一个以有效用户ID为键、值为整数（或整数字符串）的对象，则拒绝。
    2. 如果房间中没有先前的 m.room.power_levels 事件，则允许。
    3. 检查 users_default、events_default、state_default、ban、redact、kick、invite 属性是否被新增、变更或移除。对于每一个变动：
       1. 如果当前值大于 sender 当前权限等级，则拒绝。
       2. 如果新值大于 sender 当前权限等级，则拒绝。
    4. 针对 events 属性中被更改或移除的每一项：
       1. 如果当前值大于 sender 当前权限等级，则拒绝。
    5. 针对 events 属性中被新增或变更的每一项：
       1. 如果新值大于 sender 当前权限等级，则拒绝。
    6. 针对 users 属性中被更改或移除的每一项（除了 sender 自己的项）：
       1. 如果当前值大于等于 sender 当前权限等级，则拒绝。
    7. 针对 users 属性中被新增或变更的每一项：
       1. 如果新值大于 sender 当前权限等级，则拒绝。
    8. 否则，允许。
11. 其他情况下，允许。

与 v2 保持一致的部分

以下部分自 v2 起未做修改，现为保证完整性仍予以保留。

脱敏

在接收到删除事件后，服务器必须移除除以下列表外的所有键：

• event_id
• type
• room_id
• sender
• state_key
• content
• hashes
• signatures
• depth
• prev_events
• prev_state
• auth_events
• origin
• origin_server_ts
• membership

对于 content 对象，也必须移除除下列类型允许外的所有键：

• m.room.member 允许键 membership。
• m.room.create 允许键 creator。
• m.room.join_rules 允许键 join_rule。
• m.room.power_levels 允许的键有 ban、events、events_default、kick、redact、state_default、users、 users_default。
• m.room.aliases 允许键 aliases。
• m.room.history_visibility 允许 键 history_visibility。

状态解析

事件 E 之后的房间状态 S′(E) 由事件 E 之前的房间状态 S(E) 定义，并且依赖于 E 是状态事件还是消息事件：

• 如果 E 是一条消息事件，则 S′(E) = S(E)。
• 如果 E 是一条状态事件，则 S′(E) 与 S(E) 相同，除了其与 E 的 event_type 和 state_key 对应的项被 E 的 event_id 替换。

事件 E 之前的房间状态 S(E) 是 prev_event 集合 {E₁, E₂, …} 之后的状态集合 {S′(E₁), S′(E₂), …} 的 合并与决议结果。如何对一组状态进行合并与决议，见下述算法。

定义

版本 2 房间的状态合并算法使用如下定义，并以房间状态集 {S₁, S₂, …} 为输入：

权限事件（Power events）。
权限事件 指具有类型 m.room.power_levels 或 m.room.join_rules 的状态事件，或者类型为 m.room.member 且 membership 字段为 leave 或 ban，且 sender 与 state_key 不一致的状态事件。其核心思想为：权限事件是那些可能移除某人在房间内某项操作权限的事件。

无冲突状态映射与冲突状态集。
状态映射 S_i 的 key 为形如 (event_type, state_key) 的字符串二元组 K，对应的 value V 为一个状态事件。所有 S_i 的 (K, V) 键值对可划分为两个集合：如果给定 key K 在所有 S_i 出现，且值 V 在每个状态映射都一致，则此 (K, V) 属于 无冲突状态映射；否则，V 属于 冲突状态集。

注意，无冲突状态映射每个 key K 只会有一个事件，而冲突状态集可能因同 key 包含多个事件。

鉴权链（Auth chain）。
事件 E 的 鉴权链，是包含 E 的所有鉴权事件（auth events）、所有这些事件的鉴权事件，递归回溯直到房间创建为止的集合。换句话说，就是通过事件的 auth_events 链接遍历可达的所有事件。

鉴权差集（Auth difference）。
鉴权差集 的计算方式如下：首先对每个状态 S_i，计算其完全鉴权链，即该状态中每个事件的鉴权链的并集。然后找出那些未在所有鉴权链中都出现的事件。若 C_i 表示 S_i 的完全鉴权链，则鉴权差集为 ∪ C_i − ∩ C_i。

完整冲突集（Full conflicted set）。
完整冲突集 是冲突状态集与鉴权差集的并集。

逆拓扑权限排序（Reverse topological power ordering）。
一组事件的 逆拓扑权限排序，是按鉴权事件形成的有向无环图（DAG）进行拓扑排序，得到字典序最小的排序，并从最早事件到最晚事件排列。比较两个拓扑排序确定哪一个字典序更小时，事件的比较关系如下：对事件 x 和 y，若

1. x 的发送者的权限级别 高于 y 的发送者（以各自的 auth_event 查得）；或
2. 发送者权限级别相同，但 x 的 origin_server_ts 小于 y；或
3. 权限级别与 origin_server_ts 都相同，但 x 的 event_id 小于 y 的 event_id，

则 x < y。

逆拓扑权限排序可用 Kahn 算法进行拓扑排序，每步从候选顶点中按上述比较关系选择最小顶点。

主链排序（Mainline ordering）。
令 P = P₀ 为某个 m.room.power_levels 事件。从 i = 0 开始，反复获取 P_i+1，即 P_i 的 auth_events 中类型为 m.room.power_levels 的事件。每次自增 i，直到 P_i 的 auth_events 中没有 m.room.power_levels 事件为止。P₀ 的 主链 为 [P₀ , P₁, … , P_n]。

若另有事件 e = e₀（可以是另一个 m.room.power_levels 事件），可以构造类似事件链 [e₁, …, e_m]，其中 e_j+1 为 e_j 的 auth_events 中的 m.room.power_levels 事件，e_m 没有再指向任何 m.room.power_levels 事件。（注意 e₀ 本身不包含在该列表中，也有可能该列表为空，因为 e 可能没有引用过 m.room.power_levels 事件。）

对这两条列表进行如下比较：

• 查找最小的 j ≥ 1，使得 e_j 属于 P 的主链；
• 若存在这样的 j，则 e_j = P_i，且 i 唯一、i ≥ 0；否则令 i = ∞，其中 ∞ 为一个大于任何整数的特殊标记值；
• 无论哪种情况，e 的 主链位置 就是 i。

以 P 计算得主链位置后，基于 P 的主链排序，就是将一组事件按以下比较关系（从小到大）排序：对事件 x 和 y，若

1. x 的主链位置 大于 y（即 x 的鉴权链基于主链上的较早事件）；或
2. 主链位置相同，但 x 的 origin_server_ts 小于 y；或
3. 主链位置、origin_server_ts 都相同，但 x 的 event_id 小于 y，

则 x < y。

迭代鉴权检查（Iterative auth checks）。
迭代鉴权检查算法 的输入是初始房间状态和已排序的状态事件列表。它通过遍历事件列表，将符合授权规则的状态事件依次应用到房间状态上。若某状态事件未通过授权规则，则忽略该事件。如果验证授权规则时缺少某个必须的 (event_type, state_key) key，则用事件 auth_events 中相应的状态事件（若未被拒绝）替代。

算法

一组状态的 合并与决议 按如下步骤执行：

1. 选取出现在 完整冲突集 内的所有权限事件组成集合 X。对于每一个权限事件 P，将 P 的鉴权链中同时属于完整冲突集的事件也加入 X。对 X 按 逆拓扑权限排序 排序为列表。
2. 从 无冲突状态映射 作为起点，对上一步得到的事件列表应用迭代鉴权检查算法，得出部分已决议状态。
3. 将第 1 步未涉及的所有剩余事件按第 2 步已决议状态中的权限等级，用主链排序确定顺序。
4. 对上述部分已决议状态及新排序的事件列表，再次应用迭代鉴权检查算法。
5. 用无冲突状态映射中的相同 key 事件（若存在）替换当前结果中对应事件，得出最终合并决议状态。

被拒绝的事件

由于基于事件当前状态（而非鉴权链）验证授权而被拒绝的事件，除非另有特别说明，在算法中仍按常规方式处理。

注意，那些由于无法通过其鉴权链授权而被拒绝的事件不应出现在此流程中，因为他们不会出现在状态集合之内（本算法只使用状态集中的事件，或状态集中事件的鉴权链中的事件）。

被拒绝的鉴权事件（auth events）故意不参与迭代鉴权检查，因为检查过程中不会对鉴权事件重新授权（但非鉴权事件则会被检查）。

规范化 JSON

出于附录中所述的原因，服务器不得强制严格遵循所规定的 JSON 格式。