First of all, all PDU definitions were based on the v1 PDU definition with a few fields overwritten to change the format with needed. While that works when rendering the spec, this is semantically incorrect because it means that the objects must match both schemas, which is impossible. So now we make a base with only the common fields, and we add the others as needed by the room version. Note that there is no more "unsigned PDU" definition since it is not used directly, and hashes and signatures are the same across all versions. Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
53 lines
1.8 KiB
YAML
53 lines
1.8 KiB
YAML
# Copyright 2019 New Vector Ltd
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
type: object
|
|
title: Persistent Data Unit
|
|
description: A persistent data unit (event) for room version 3.
|
|
example:
|
|
$ref: "../examples/pdu_v3.json"
|
|
allOf:
|
|
- $ref: "components/pdu_base.yaml"
|
|
- type: object
|
|
properties:
|
|
redacts:
|
|
type: string
|
|
description: For redaction events, the ID of the event being redacted.
|
|
example: "$def/456+oldevent"
|
|
auth_events:
|
|
type: array
|
|
items:
|
|
type: string
|
|
description: Event ID.
|
|
description: |-
|
|
Event IDs for the authorization events that would
|
|
allow this event to be in the room.
|
|
|
|
Must contain less than or equal to 10 events. Note that if the relevant
|
|
auth event selection rules are used, this restriction should never be
|
|
encountered.
|
|
example: ["$base64EncodedHash", "$AnotherEvent"]
|
|
prev_events:
|
|
type: array
|
|
items:
|
|
type: string
|
|
description: Event ID.
|
|
description: |-
|
|
Event IDs for the most recent events in the room
|
|
that the homeserver was aware of when it made this event.
|
|
|
|
Must contain less than or equal to 20 events.
|
|
example: ["$base64EncodedHash", "$AnotherEvent"]
|
|
required:
|
|
- auth_events
|
|
- prev_events
|