Struct ServerSigningKeys

#[non_exhaustive]
pub struct ServerSigningKeys {
    pub server_name: OwnedServerName,
    pub verify_keys: BTreeMap<OwnedKeyId<SigningKeyAlgorithm, ServerSigningKeyVersion>, VerifyKey>,
    pub old_verify_keys: BTreeMap<OwnedKeyId<SigningKeyAlgorithm, ServerSigningKeyVersion>, OldVerifyKey>,
    pub signatures: Signatures<OwnedServerName, ServerSigningKeyVersion>,
    pub valid_until_ts: MilliSecondsSinceUnixEpoch,
}

Available on crate feature api and (crate features federation-api-c or federation-api-s) only.

Queried server key, signed by the notary server.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

server_name: OwnedServerName

DNS name of the homeserver.

verify_keys: BTreeMap<OwnedKeyId<SigningKeyAlgorithm, ServerSigningKeyVersion>, VerifyKey>

Public keys of the homeserver for verifying digital signatures.

old_verify_keys: BTreeMap<OwnedKeyId<SigningKeyAlgorithm, ServerSigningKeyVersion>, OldVerifyKey>

Public keys that the homeserver used to use and when it stopped using them.

signatures: Signatures<OwnedServerName, ServerSigningKeyVersion>

Digital signatures of this object signed using the verify_keys.

Map of server name to keys by key ID.

valid_until_ts: MilliSecondsSinceUnixEpoch

Timestamp when the keys should be refreshed.

This field MUST be ignored in room versions 1, 2, 3, and 4.

Implementations

impl ServerSigningKeys

pub fn new( server_name: OwnedServerName, valid_until_ts: MilliSecondsSinceUnixEpoch, ) -> ServerSigningKeys

Creates a new ServerSigningKeys with the given server name and validity timestamp.

All other fields will be empty.

Trait Implementations

impl Clone for ServerSigningKeys

fn clone(&self) -> ServerSigningKeys

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ServerSigningKeys

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ServerSigningKeys

fn deserialize<__D>( __deserializer: __D, ) -> Result<ServerSigningKeys, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ServerSigningKeys

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.