Skip to main content

qualia_core_db/crypto/network/
transcript.rs

1//! Length-delimited transcript construction (cryptographic profile ยง5).
2//!
3//! Each item: u16be(label_len) || label || u32be(value_len) || value
4//! Digest: SHA-384("QPR-TRANSCRIPT-PQ-1" || ordered_items) for qpr-pq-1.
5
6use sha2::{Digest, Sha384};
7
8use super::errors::CryptoError;
9use crate::net::qdnf::types::StrongDigest;
10
11pub const MAX_TRANSCRIPT: usize = 4096;
12const DOMAIN: &[u8] = b"QPR-TRANSCRIPT-PQ-1";
13
14#[derive(Clone)]
15pub struct Transcript {
16    buf: [u8; MAX_TRANSCRIPT],
17    len: usize,
18}
19
20impl Transcript {
21    /// Creates a default `Transcript`.
22    pub const fn new() -> Self {
23        Self {
24            buf: [0u8; MAX_TRANSCRIPT],
25            len: 0,
26        }
27    }
28
29    /// Appends `label`+`value` into the transcript hash.
30    pub fn append(&mut self, label: &[u8], value: &[u8]) -> Result<(), CryptoError> {
31        let need = 2usize
32            .checked_add(label.len())
33            .and_then(|n| n.checked_add(4))
34            .and_then(|n| n.checked_add(value.len()))
35            .ok_or(CryptoError::Range)?;
36        if self.len.checked_add(need).ok_or(CryptoError::Range)? > MAX_TRANSCRIPT {
37            return Err(CryptoError::Capacity);
38        }
39        let label_len: u16 = label.len().try_into().map_err(|_| CryptoError::Range)?;
40        let value_len: u32 = value.len().try_into().map_err(|_| CryptoError::Range)?;
41        let mut i = self.len;
42        self.buf[i..i + 2].copy_from_slice(&label_len.to_be_bytes());
43        i += 2;
44        self.buf[i..i + label.len()].copy_from_slice(label);
45        i += label.len();
46        self.buf[i..i + 4].copy_from_slice(&value_len.to_be_bytes());
47        i += 4;
48        self.buf[i..i + value.len()].copy_from_slice(value);
49        i += value.len();
50        self.len = i;
51        Ok(())
52    }
53
54    /// Current transcript digest.
55    pub fn digest(&self) -> StrongDigest {
56        let mut hasher = Sha384::new();
57        hasher.update(DOMAIN);
58        hasher.update(&self.buf[..self.len]);
59        let out = hasher.finalize();
60        let mut d = StrongDigest::ZERO;
61        d.0.copy_from_slice(&out);
62        d
63    }
64
65    /// Raw transcript bytes.
66    pub fn as_bytes(&self) -> &[u8] {
67        &self.buf[..self.len]
68    }
69}
70
71impl Default for Transcript {
72    fn default() -> Self {
73        Self::new()
74    }
75}
76
77#[cfg(test)]
78mod tests {
79    use super::*;
80
81    #[test]
82    fn length_delimited_prevents_ambiguity() {
83        let mut a = Transcript::new();
84        a.append(b"ab", b"cd").unwrap();
85        let mut b = Transcript::new();
86        b.append(b"a", b"bcd").unwrap();
87        assert_ne!(a.digest(), b.digest());
88    }
89}