ruma_events/key/verification/
key.rs

1//! Types for the [`m.key.verification.key`] event.
2//!
3//! [`m.key.verification.key`]: https://spec.matrix.org/latest/client-server-api/#mkeyverificationkey
4
5use ruma_common::{serde::Base64, OwnedTransactionId};
6use ruma_macros::EventContent;
7use serde::{Deserialize, Serialize};
8
9use crate::relation::Reference;
10
11/// The content of a to-device `m.key.verification.key` event.
12///
13/// Sends the ephemeral public key for a device to the partner device.
14#[derive(Clone, Debug, Deserialize, Serialize, EventContent)]
15#[cfg_attr(not(ruma_unstable_exhaustive_types), non_exhaustive)]
16#[ruma_event(type = "m.key.verification.key", kind = ToDevice)]
17pub struct ToDeviceKeyVerificationKeyEventContent {
18    /// An opaque identifier for the verification process.
19    ///
20    /// Must be the same as the one used for the `m.key.verification.start` message.
21    pub transaction_id: OwnedTransactionId,
22
23    /// The device's ephemeral public key, encoded as unpadded base64.
24    pub key: Base64,
25}
26
27impl ToDeviceKeyVerificationKeyEventContent {
28    /// Creates a new `ToDeviceKeyVerificationKeyEventContent` with the given transaction ID and
29    /// key.
30    pub fn new(transaction_id: OwnedTransactionId, key: Base64) -> Self {
31        Self { transaction_id, key }
32    }
33}
34
35/// The content of an in-room `m.key.verification.key` event.
36///
37/// Sends the ephemeral public key for a device to the partner device.
38#[derive(Clone, Debug, Deserialize, Serialize, EventContent)]
39#[cfg_attr(not(ruma_unstable_exhaustive_types), non_exhaustive)]
40#[ruma_event(type = "m.key.verification.key", kind = MessageLike)]
41pub struct KeyVerificationKeyEventContent {
42    /// The device's ephemeral public key, encoded as unpadded base64.
43    pub key: Base64,
44
45    /// Information about the related event.
46    #[serde(rename = "m.relates_to")]
47    pub relates_to: Reference,
48}
49
50impl KeyVerificationKeyEventContent {
51    /// Creates a new `KeyVerificationKeyEventContent` with the given key and reference.
52    pub fn new(key: Base64, relates_to: Reference) -> Self {
53        Self { key, relates_to }
54    }
55}
ruma_events/key/verification/key.rs

ruma_events/key/verification/
key.rs
