matrix-spec/content/rooms/v10.md

title	type	weight
Room Version 10	docs	100

This room version builds on version 9 to enforce that power level values be integers, and to introduce a new knock_restricted join rule, allowing prospective members to more easily join such a room.

Client considerations

This room version adds a new knock_restricted join rule to allow prospective members of a room join either through knocking (introduced in room version 7) or through "join restrictions" (introduced in room version 8 and refined in room version 9).

Clients should render the new join rule accordingly for such rooms.

Clients which implement the redaction algorithm locally should refer to the redactions section below for a full overview.

Server implementation components

{{% boxes/warning %}} The information contained in this section is strictly for server implementors. Applications which use the Client-Server API are generally unaffected by the intricacies contained here. The section above regarding client considerations is the resource that Client-Server API use cases should reference. {{% /boxes/warning %}}

Room version 7 added "knocking" and room version 8 added "join restrictions" (refined by room version 9) - both allow prospective members an avenue to join, however both could not be used at the same time due to how the join rules work. This room version adds a new knock_restricted join rule as a mix of the two behaviours (first match wins).

This room version additionally requires that values in the power levels event be integers and not string representations, unlike other room versions.

Room version 10 is based upon room version 9 with the following considerations.

TODO

• Auth rules
• Stringy power levels

Unchanged from v9

The following sections have not been modified since v9, but are included for completeness.

Redactions

{{% rver-fragment name="v9-redactions" %}}

Handling redactions

{{% rver-fragment name="v3-handling-redactions" %}}

Event IDs

{{% rver-fragment name="v4-event-ids" %}}

Event format

{{% rver-fragment name="v4-event-format" %}}

Deprecated formatting

{{% rver-fragment name="v1-deprecated-formatting-off-spec" %}}

{{% rver-fragment name="v1-stringy-power-levels" %}}

Authorization rules

{{% rver-fragment name="v8-auth-rules" %}}

State resolution

{{% rver-fragment name="v2-state-res" %}}

Canonical JSON

{{% rver-fragment name="v6-canonical-json" %}}

Signing key validity period

{{% rver-fragment name="v5-signing-requirements" %}}