Skip to main content

qualia_core_db/crypto/network/
kem.rs

1//! ML-KEM-768 adapter. Named ML-KEM on the wire, not historical Kyber.
2
3use fips203::ml_kem_768;
4use fips203::traits::{Decaps, Encaps, KeyGen, SerDes};
5use zeroize::{Zeroize, ZeroizeOnDrop};
6
7use super::errors::CryptoError;
8use super::types::{ML_KEM_768_CT_LEN, ML_KEM_768_PK_LEN, ML_KEM_768_SK_LEN, ML_KEM_SS_LEN};
9
10#[derive(Zeroize, ZeroizeOnDrop)]
11pub struct MlKem768Secret {
12    bytes: [u8; ML_KEM_768_SK_LEN],
13}
14
15impl MlKem768Secret {
16    /// Generates an ML-KEM-768 keypair; returns `(secret, public)`.
17    pub fn generate() -> Result<(Self, [u8; ML_KEM_768_PK_LEN]), CryptoError> {
18        let (ek, dk) = ml_kem_768::KG::try_keygen().map_err(|_| CryptoError::CryptoFailure)?;
19        Ok((
20            Self {
21                bytes: dk.into_bytes(),
22            },
23            ek.into_bytes(),
24        ))
25    }
26
27    /// Wraps a raw secret key.
28    pub fn from_bytes(bytes: [u8; ML_KEM_768_SK_LEN]) -> Self {
29        Self { bytes }
30    }
31
32    /// Decapsulates a ciphertext into a shared secret.
33    pub fn decapsulate(
34        &self,
35        ciphertext: &[u8; ML_KEM_768_CT_LEN],
36    ) -> Result<[u8; ML_KEM_SS_LEN], CryptoError> {
37        let dk = ml_kem_768::DecapsKey::try_from_bytes(self.bytes)
38            .map_err(|_| CryptoError::CryptoFailure)?;
39        let ct = ml_kem_768::CipherText::try_from_bytes(*ciphertext)
40            .map_err(|_| CryptoError::CryptoFailure)?;
41        let ss = dk.try_decaps(&ct).map_err(|_| CryptoError::CryptoFailure)?;
42        Ok(ss.into_bytes())
43    }
44}
45
46/// Encapsulates against a public key, returning `(ct, ss)`.
47pub fn encapsulate(
48    public: &[u8; ML_KEM_768_PK_LEN],
49) -> Result<([u8; ML_KEM_SS_LEN], [u8; ML_KEM_768_CT_LEN]), CryptoError> {
50    let ek =
51        ml_kem_768::EncapsKey::try_from_bytes(*public).map_err(|_| CryptoError::CryptoFailure)?;
52    let (ss, ct) = ek.try_encaps().map_err(|_| CryptoError::CryptoFailure)?;
53    Ok((ss.into_bytes(), ct.into_bytes()))
54}
55
56#[cfg(test)]
57mod tests {
58    use super::*;
59
60    #[test]
61    fn encapsulate_decapsulate() {
62        let (sk, pk) = MlKem768Secret::generate().unwrap();
63        let (ss1, ct) = encapsulate(&pk).unwrap();
64        let ss2 = sk.decapsulate(&ct).unwrap();
65        assert_eq!(ss1, ss2);
66    }
67}