Add cross references throughout the spec

This commit is contained in:
Travis Ralston 2026-03-17 13:51:51 -06:00
parent be12573a85
commit fc19945bdc

View file

@ -473,6 +473,9 @@ server must ensure that the event:
otherwise it is rejected. otherwise it is rejected.
6. Passes authorization rules based on the current state of the room, 6. Passes authorization rules based on the current state of the room,
otherwise it is "soft failed". otherwise it is "soft failed".
7. {{% added-in v="1.18" %}} Is [validated](#validating-policy-server-signatures)
by the Policy Server, if the room is [using a Policy Server](#determining-if-a-policy-server-is-enabled-in-a-room),
otherwise it is "soft failed".
Further details of these checks, and how to handle failures, are Further details of these checks, and how to handle failures, are
described below. described below.
@ -689,6 +692,11 @@ then any new event `D'` will not reference `C`:
| |
D' D'
{{% boxes/note %}}
{{% added-in v="1.18" %}}
Events can also be soft failed if they fail [Policy Server checks](#validating-policy-server-signatures).
{{% /boxes/note %}}
#### Retrieving event authorization information #### Retrieving event authorization information
The homeserver may be missing event authorization information, or wish The homeserver may be missing event authorization information, or wish
@ -1465,6 +1473,12 @@ The signature is then copied back to the original event object.
For an example of a signed event, see the [room version For an example of a signed event, see the [room version
specification](/rooms). specification](/rooms).
{{% boxes/note %}}
{{% added-in v="1.18" %}}
Events sent in rooms with [Policy Servers](#policy-servers) MUST [ask](#asking-for-a-policy-server-signature-on-an-event)
the Policy Server for a signature too.
{{% /boxes/note %}}
### Validating hashes and signatures on received events ### Validating hashes and signatures on received events
When a server receives an event over federation from another server, the When a server receives an event over federation from another server, the
@ -1499,6 +1513,12 @@ only been given a redacted version of the event. To enforce this, the
receiving server should use the redacted copy it calculated rather than receiving server should use the redacted copy it calculated rather than
the full copy it received. the full copy it received.
{{% boxes/note %}}
{{% added-in v="1.18" %}}
Events sent in rooms with [Policy Servers](#policy-servers) have [additional](#validating-policy-server-signatures)
signature validation requirements.
{{% /boxes/note %}}
### Calculating the reference hash for an event ### Calculating the reference hash for an event
The *reference hash* of an event covers the essential fields of an The *reference hash* of an event covers the essential fields of an