atagen

matrix-rust-sdk

public
Star0
Watch0
ssh://brewery@pls.lobotomise.me:33/atagen/matrix-rust-sdk.git

Blame: crates/matrix-sdk-qrcode/src/utils.rs

7ff8adafe9e4atagen2026-10-22 12:30 UTC1
// Copyright 2021 The Matrix.org Foundation C.I.C.
7ff8adafe9e4atagen2026-10-22 12:30 UTC2
//
7ff8adafe9e4atagen2026-10-22 12:30 UTC3
// Licensed under the Apache License, Version 2.0 (the "License");
7ff8adafe9e4atagen2026-10-22 12:30 UTC4
// you may not use this file except in compliance with the License.
7ff8adafe9e4atagen2026-10-22 12:30 UTC5
// You may obtain a copy of the License at
7ff8adafe9e4atagen2026-10-22 12:30 UTC6
//
7ff8adafe9e4atagen2026-10-22 12:30 UTC7
//     http://www.apache.org/licenses/LICENSE-2.0
7ff8adafe9e4atagen2026-10-22 12:30 UTC8
//
7ff8adafe9e4atagen2026-10-22 12:30 UTC9
// Unless required by applicable law or agreed to in writing, software
7ff8adafe9e4atagen2026-10-22 12:30 UTC10
// distributed under the License is distributed on an "AS IS" BASIS,
7ff8adafe9e4atagen2026-10-22 12:30 UTC11
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
7ff8adafe9e4atagen2026-10-22 12:30 UTC12
// See the License for the specific language governing permissions and
7ff8adafe9e4atagen2026-10-22 12:30 UTC13
// limitations under the License.
7ff8adafe9e4atagen2026-10-22 12:30 UTC14
7ff8adafe9e4atagen2026-10-22 12:30 UTC15
use qrcode::{EcLevel, QrCode, Version, bits::Bits};
7ff8adafe9e4atagen2026-10-22 12:30 UTC16
use ruma::serde::Base64;
7ff8adafe9e4atagen2026-10-22 12:30 UTC17
use vodozemac::Ed25519PublicKey;
7ff8adafe9e4atagen2026-10-22 12:30 UTC18
7ff8adafe9e4atagen2026-10-22 12:30 UTC19
use crate::error::EncodingError;
7ff8adafe9e4atagen2026-10-22 12:30 UTC20
7ff8adafe9e4atagen2026-10-22 12:30 UTC21
pub(crate) const HEADER: &[u8] = b"MATRIX";
7ff8adafe9e4atagen2026-10-22 12:30 UTC22
pub(crate) const VERSION: u8 = 0x2;
7ff8adafe9e4atagen2026-10-22 12:30 UTC23
pub(crate) const MAX_MODE: u8 = 0x2;
7ff8adafe9e4atagen2026-10-22 12:30 UTC24
pub(crate) const MIN_SECRET_LEN: usize = 8;
7ff8adafe9e4atagen2026-10-22 12:30 UTC25
7ff8adafe9e4atagen2026-10-22 12:30 UTC26
pub(crate) fn to_bytes(
7ff8adafe9e4atagen2026-10-22 12:30 UTC27
    mode: u8,
7ff8adafe9e4atagen2026-10-22 12:30 UTC28
    flow_id: &str,
7ff8adafe9e4atagen2026-10-22 12:30 UTC29
    first_key: Ed25519PublicKey,
7ff8adafe9e4atagen2026-10-22 12:30 UTC30
    second_key: Ed25519PublicKey,
7ff8adafe9e4atagen2026-10-22 12:30 UTC31
    shared_secret: &Base64,
7ff8adafe9e4atagen2026-10-22 12:30 UTC32
) -> Result<Vec<u8>, EncodingError> {
7ff8adafe9e4atagen2026-10-22 12:30 UTC33
    let flow_id_len: u16 = flow_id.len().try_into()?;
7ff8adafe9e4atagen2026-10-22 12:30 UTC34
    let flow_id_len = flow_id_len.to_be_bytes();
7ff8adafe9e4atagen2026-10-22 12:30 UTC35
7ff8adafe9e4atagen2026-10-22 12:30 UTC36
    let data = [
7ff8adafe9e4atagen2026-10-22 12:30 UTC37
        HEADER,
7ff8adafe9e4atagen2026-10-22 12:30 UTC38
        &[VERSION],
7ff8adafe9e4atagen2026-10-22 12:30 UTC39
        &[mode],
7ff8adafe9e4atagen2026-10-22 12:30 UTC40
        flow_id_len.as_ref(),
7ff8adafe9e4atagen2026-10-22 12:30 UTC41
        flow_id.as_bytes(),
7ff8adafe9e4atagen2026-10-22 12:30 UTC42
        first_key.as_bytes(),
7ff8adafe9e4atagen2026-10-22 12:30 UTC43
        second_key.as_bytes(),
7ff8adafe9e4atagen2026-10-22 12:30 UTC44
        shared_secret.as_bytes(),
7ff8adafe9e4atagen2026-10-22 12:30 UTC45
    ]
7ff8adafe9e4atagen2026-10-22 12:30 UTC46
    .concat();
7ff8adafe9e4atagen2026-10-22 12:30 UTC47
7ff8adafe9e4atagen2026-10-22 12:30 UTC48
    Ok(data)
7ff8adafe9e4atagen2026-10-22 12:30 UTC49
}
7ff8adafe9e4atagen2026-10-22 12:30 UTC50
7ff8adafe9e4atagen2026-10-22 12:30 UTC51
pub(crate) fn to_qr_code(
7ff8adafe9e4atagen2026-10-22 12:30 UTC52
    mode: u8,
7ff8adafe9e4atagen2026-10-22 12:30 UTC53
    flow_id: &str,
7ff8adafe9e4atagen2026-10-22 12:30 UTC54
    first_key: Ed25519PublicKey,
7ff8adafe9e4atagen2026-10-22 12:30 UTC55
    second_key: Ed25519PublicKey,
7ff8adafe9e4atagen2026-10-22 12:30 UTC56
    shared_secret: &Base64,
7ff8adafe9e4atagen2026-10-22 12:30 UTC57
) -> Result<QrCode, EncodingError> {
7ff8adafe9e4atagen2026-10-22 12:30 UTC58
    let data = to_bytes(mode, flow_id, first_key, second_key, shared_secret)?;
7ff8adafe9e4atagen2026-10-22 12:30 UTC59
7ff8adafe9e4atagen2026-10-22 12:30 UTC60
    // Mobile clients seem to have trouble decoding the QR code that gets
7ff8adafe9e4atagen2026-10-22 12:30 UTC61
    // generated by `QrCode::new()` it seems to add a couple of data segments
7ff8adafe9e4atagen2026-10-22 12:30 UTC62
    // with different data modes/types. The parsers seem to assume a single
7ff8adafe9e4atagen2026-10-22 12:30 UTC63
    // data type and since we start with an ASCII `MATRIX` header the rest of
7ff8adafe9e4atagen2026-10-22 12:30 UTC64
    // the data gets treated as a string as well.
7ff8adafe9e4atagen2026-10-22 12:30 UTC65
    //
7ff8adafe9e4atagen2026-10-22 12:30 UTC66
    // We make sure that there isn't an ECI bit set and we just push the bytes,
7ff8adafe9e4atagen2026-10-22 12:30 UTC67
    // this seems to help since the decoder doesn't assume an encoding and
7ff8adafe9e4atagen2026-10-22 12:30 UTC68
    // treats everything as raw bytes.
7ff8adafe9e4atagen2026-10-22 12:30 UTC69
    let mut bits = Bits::new(Version::Normal(7));
7ff8adafe9e4atagen2026-10-22 12:30 UTC70
    bits.push_byte_data(&data)?;
7ff8adafe9e4atagen2026-10-22 12:30 UTC71
    bits.push_terminator(EcLevel::L)?;
7ff8adafe9e4atagen2026-10-22 12:30 UTC72
7ff8adafe9e4atagen2026-10-22 12:30 UTC73
    Ok(QrCode::with_bits(bits, EcLevel::L)?)
7ff8adafe9e4atagen2026-10-22 12:30 UTC74
}