zexc 1.2.1

zex native lossless compressor — CLI zexc, library zexc, files *.zex
Documentation
//! Key derivation for ZEX AEAD.

use crate::{Error, Result};

/// ChaCha20-Poly1305 key length.
pub const KEY_LEN: usize = 32;

/// 32-byte symmetric key.
pub type Key = [u8; KEY_LEN];

/// Domain separation for BLAKE3 derive_key.
const KDF_CONTEXT: &str = "ZEX frame AEAD key v1";

/// Derive a 32-byte key from password + salt (16+ bytes recommended).
pub fn derive_key_from_password(password: &str, salt: &[u8]) -> Result<Key> {
    if password.is_empty() {
        return Err(Error::InvalidParameter("empty password".into()));
    }
    if salt.len() < 8 {
        return Err(Error::InvalidParameter("salt too short".into()));
    }
    // BLAKE3 keyed derive: hash(password || salt) under domain context.
    let mut hasher = blake3::Hasher::new_derive_key(KDF_CONTEXT);
    hasher.update(password.as_bytes());
    hasher.update(salt);
    let hash = hasher.finalize();
    let mut key = [0u8; KEY_LEN];
    key.copy_from_slice(hash.as_bytes());
    Ok(key)
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn kdf_deterministic() {
        let a = derive_key_from_password("secret", b"0123456789abcdef").unwrap();
        let b = derive_key_from_password("secret", b"0123456789abcdef").unwrap();
        assert_eq!(a, b);
        let c = derive_key_from_password("other", b"0123456789abcdef").unwrap();
        assert_ne!(a, c);
    }
}