Skip to content

Room Relay Sealed Delivery v1

Source schema: doc/schemas/room-relay-sealed-delivery.v1.schema.json

Ephemeral sender-authenticated encrypted Room carrier frame for a non-member federation relay. The explicit delivery/kind discriminator prevents ambiguity with member-visible deliveries. The relay can validate and order the bounded envelope but cannot read the content payload.

Governing Basis

Project Lineage

Fields

Field Required Shape Description
schema/v yes const: 1
delivery/kind yes const: sealed
crypto/profile yes const: sealed-sender-key-v1
room/id yes ref: room.v1.schema.json#/$defs/room_id
relay/epoch yes integer
relay/seq-no yes integer
membership/epoch yes integer
sender/subject yes ref: room.v1.schema.json#/$defs/subject
sender/seq-no yes integer
nonce yes string
ciphertext yes string
ciphertext/digest yes string
signer/ref yes string
signature yes object
accepted-at yes string
## Field Semantics

schema/v

  • Required: yes
  • Shape: const: 1

delivery/kind

  • Required: yes
  • Shape: const: sealed

crypto/profile

  • Required: yes
  • Shape: const: sealed-sender-key-v1

room/id

  • Required: yes
  • Shape: ref: room.v1.schema.json#/$defs/room_id

relay/epoch

  • Required: yes
  • Shape: integer

relay/seq-no

  • Required: yes
  • Shape: integer

membership/epoch

  • Required: yes
  • Shape: integer

sender/subject

  • Required: yes
  • Shape: ref: room.v1.schema.json#/$defs/subject

sender/seq-no

  • Required: yes
  • Shape: integer

nonce

  • Required: yes
  • Shape: string

ciphertext

  • Required: yes
  • Shape: string

ciphertext/digest

  • Required: yes
  • Shape: string

signer/ref

  • Required: yes
  • Shape: string

signature

  • Required: yes
  • Shape: object

accepted-at

  • Required: yes
  • Shape: string