Struct SelfVerificationNoMasterKey

pub struct SelfVerificationNoMasterKey { /* private fields */ }

The non-encoded data for the third mode of QR code verification.

This mode is used for verification between two devices of the same user where this device, that is creating this QR code, is not trusting the cross signing master key.

Implementations

impl SelfVerificationNoMasterKey

pub fn new( transaction_id: String, device_key: Ed25519PublicKey, master_key: Ed25519PublicKey, shared_secret: Base64, ) -> Self

Create a new SelfVerificationData struct that can be encoded as a QR code.

Arguments

• transaction_id - The transaction id of this verification flow, the transaction id was sent by the m.key.verification.request event that initiated the verification flow this QR code should be part of.

• device_key - The ed25519 key of our own device.

• master_key - Our own cross signing master key.

• shared_secret - A random bytestring encoded as unpadded base64, needs to be at least 8 bytes long.

pub fn to_bytes(&self) -> Result<Vec<u8>, EncodingError>

Encode the SelfVerificationNoMasterKey into a vector of bytes that can be encoded as a QR code.

The encoding can fail if the keys that should be encoded are not valid base64.

Examples

let data = b"MATRIX\
             \x02\x02\x00\x06\
             FLOWID\
             kS /\x92i\x1e6\xcd'g\xf9#\x11\xd8\x8a\xa2\xf61\x05\x1b6\xef\xfc\xa4%\x80\x1a\x0c\xd2\xe8\x04\
             \xbdR|\xf8n\x07\xa4\x1f\xb4\xcc3\x0eBT\xe7[~\xfd\x87\xd06B\xdfoVv%\x9b\x86\xae\xbcM\
             SHARED_SECRET";

let result = QrVerificationData::from_bytes(data)?;
if let QrVerificationData::SelfVerificationNoMasterKey(decoded) = result {
    let encoded = decoded.to_bytes().unwrap();
    assert_eq!(data.as_ref(), encoded.as_slice());
} else {
    panic!("Data was encoded as an incorrect mode");
}

pub fn to_qr_code(&self) -> Result<QrCode, EncodingError>

Encode the SelfVerificationNoMasterKey into a QrCode.

This method turns the SelfVerificationNoMasterKey into a QR code that can be rendered and presented to be scanned.

The encoding can fail if the data doesn’t fit into a QR code or if the keys that should be encoded into the QR code are not valid base64.

Trait Implementations

impl Clone for SelfVerificationNoMasterKey

fn clone(&self) -> SelfVerificationNoMasterKey

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SelfVerificationNoMasterKey

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

Formats the value using the given formatter.

impl From<SelfVerificationNoMasterKey> for QrVerificationData

fn from(data: SelfVerificationNoMasterKey) -> Self

Converts to this type from the input type.

impl PartialEq for SelfVerificationNoMasterKey

fn eq(&self, other: &SelfVerificationNoMasterKey) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for SelfVerificationNoMasterKey

impl StructuralPartialEq for SelfVerificationNoMasterKey