Skip to main content

qualia_core_db/crypto/network/
kdf.rs

1//! HKDF-SHA-384 and HMAC-SHA-384. Domain-separated; no secret XOR combiners.
2
3use hkdf::Hkdf;
4use hmac::{Hmac, KeyInit, Mac};
5use sha2::Sha384;
6use zeroize::Zeroize;
7
8use super::errors::CryptoError;
9
10type HmacSha384 = Hmac<Sha384>;
11
12/// HKDF-SHA384 extract+expand over `ikm`/`salt`/`info` into caller buffer.
13pub fn hkdf_sha384(
14    salt: Option<&[u8]>,
15    ikm: &[u8],
16    info: &[u8],
17    okm: &mut [u8],
18) -> Result<(), CryptoError> {
19    if okm.is_empty() {
20        return Err(CryptoError::Range);
21    }
22    let hk = Hkdf::<Sha384>::new(salt, ikm);
23    hk.expand(info, okm).map_err(|_| CryptoError::CryptoFailure)
24}
25
26/// HMAC-SHA384 of `data` under `key` into `out`.
27pub fn hmac_sha384(key: &[u8], data: &[u8], out: &mut [u8; 48]) -> Result<(), CryptoError> {
28    let mut mac = HmacSha384::new_from_slice(key).map_err(|_| CryptoError::CryptoFailure)?;
29    mac.update(data);
30    let result = mac.finalize().into_bytes();
31    out.copy_from_slice(&result);
32    Ok(())
33}
34
35/// Constant-time HMAC-SHA-384 verification. Mismatched tags are CryptoFailure.
36pub fn hmac_sha384_verify(key: &[u8], data: &[u8], expected: &[u8; 48]) -> Result<(), CryptoError> {
37    let mut mac = HmacSha384::new_from_slice(key).map_err(|_| CryptoError::CryptoFailure)?;
38    mac.update(data);
39    mac.verify_slice(expected)
40        .map_err(|_| CryptoError::CryptoFailure)
41}
42
43/// Combine ML-KEM and X25519 secrets: HKDF(IKM = kem || x25519). Never XOR.
44pub fn hybrid_shared_secret(
45    ml_kem_ss: &[u8; 32],
46    x25519_ss: &[u8; 32],
47    info: &[u8],
48    out: &mut [u8],
49) -> Result<(), CryptoError> {
50    let mut ikm = [0u8; 64];
51    ikm[..32].copy_from_slice(ml_kem_ss);
52    ikm[32..].copy_from_slice(x25519_ss);
53    let result = hkdf_sha384(Some(b"qpr-pq-1"), &ikm, info, out);
54    ikm.zeroize();
55    result
56}
57
58#[cfg(test)]
59mod tests {
60    use super::*;
61
62    #[test]
63    fn hybrid_combiner_is_not_xor() {
64        let kem = [1u8; 32];
65        let x = [1u8; 32];
66        let mut out = [0u8; 32];
67        hybrid_shared_secret(&kem, &x, b"test", &mut out).unwrap();
68        assert_ne!(out, [0u8; 32]);
69        assert_ne!(out, [1u8; 32]);
70    }
71
72    #[test]
73    fn hmac_verify_rejects_wrong_tag() {
74        let mut tag = [0u8; 48];
75        hmac_sha384(b"key", b"data", &mut tag).unwrap();
76        assert!(hmac_sha384_verify(b"key", b"data", &tag).is_ok());
77        tag[0] ^= 1;
78        assert!(hmac_sha384_verify(b"key", b"data", &tag).is_err());
79    }
80}