use core::fmt;
use core::sync::atomic::{Ordering, compiler_fence};
use crate::{
HKDF_SHA384_PRK_LEN, ML_DSA_87_SECRET_KEY_LEN, ML_DSA_87_SEED_LEN,
ML_KEM_1024_DECAPSULATION_KEY_LEN, ML_KEM_1024_SEED_LEN, ML_KEM_1024_SHARED_SECRET_LEN,
};
pub(crate) fn wipe(buf: &mut [u8]) {
let ptr = buf.as_mut_ptr();
for i in 0..buf.len() {
unsafe { core::ptr::write_volatile(ptr.add(i), 0) };
}
compiler_fence(Ordering::SeqCst);
}
macro_rules! stack_secret {
($(#[$doc:meta])* $name:ident, $len:expr) => {
$(#[$doc])*
pub struct $name {
pub(crate) bytes: [u8; $len],
}
impl $name {
#[must_use]
pub fn from_bytes(bytes: &[u8; $len]) -> Self {
let mut out = Self::zeroed();
out.bytes.copy_from_slice(bytes);
out
}
#[must_use]
pub fn as_bytes(&self) -> &[u8; $len] {
&self.bytes
}
pub(crate) const fn zeroed() -> Self {
Self { bytes: [0; $len] }
}
}
impl Drop for $name {
fn drop(&mut self) {
wipe(&mut self.bytes);
}
}
impl fmt::Debug for $name {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
f.write_str(stringify!($name))
}
}
};
}
macro_rules! boxed_secret {
($(#[$doc:meta])* $name:ident, $len:expr) => {
$(#[$doc])*
pub struct $name {
pub(crate) bytes: Box<[u8; $len]>,
}
impl $name {
#[must_use]
pub fn from_bytes(bytes: &[u8; $len]) -> Self {
let mut out = Self::zeroed();
out.bytes.copy_from_slice(bytes);
out
}
#[must_use]
pub fn as_bytes(&self) -> &[u8; $len] {
&self.bytes
}
pub(crate) fn zeroed() -> Self {
Self { bytes: Box::new([0; $len]) }
}
}
impl Drop for $name {
fn drop(&mut self) {
wipe(&mut self.bytes[..]);
}
}
impl fmt::Debug for $name {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
f.write_str(stringify!($name))
}
}
};
}
stack_secret!(
HkdfPrk,
HKDF_SHA384_PRK_LEN
);
stack_secret!(
SharedSecret,
ML_KEM_1024_SHARED_SECRET_LEN
);
stack_secret!(
MlDsa87KeySeed,
ML_DSA_87_SEED_LEN
);
stack_secret!(
MlKem1024KeySeedD,
ML_KEM_1024_SEED_LEN
);
stack_secret!(
MlKem1024KeySeedZ,
ML_KEM_1024_SEED_LEN
);
stack_secret!(
MlKem1024EncapsSeed,
ML_KEM_1024_SEED_LEN
);
mod sealed {
pub trait Sealed {
fn zeroed_seed() -> Self;
fn seed_bytes_mut(&mut self) -> &mut [u8; 32];
}
}
pub trait DrbgSeed: sealed::Sealed {}
macro_rules! drbg_seed {
($($name:ident),*) => {$(
impl sealed::Sealed for $name {
fn zeroed_seed() -> Self {
Self::zeroed()
}
fn seed_bytes_mut(&mut self) -> &mut [u8; 32] {
&mut self.bytes
}
}
impl DrbgSeed for $name {}
)*};
}
drbg_seed!(
MlDsa87KeySeed,
MlKem1024KeySeedD,
MlKem1024KeySeedZ,
MlKem1024EncapsSeed
);
pub(crate) fn zeroed_seed<S: DrbgSeed>() -> S {
S::zeroed_seed()
}
pub(crate) fn seed_bytes_mut<S: DrbgSeed>(seed: &mut S) -> &mut [u8; 32] {
seed.seed_bytes_mut()
}
boxed_secret!(
MlDsa87SecretKey,
ML_DSA_87_SECRET_KEY_LEN
);
boxed_secret!(
MlKem1024DecapsulationKey,
ML_KEM_1024_DECAPSULATION_KEY_LEN
);
pub struct Okm {
pub(crate) bytes: Box<[u8]>,
}
impl Okm {
#[must_use]
pub fn as_bytes(&self) -> &[u8] {
&self.bytes
}
pub(crate) fn zeroed(len: usize) -> Self {
Self {
bytes: vec![0; len].into_boxed_slice(),
}
}
}
impl Drop for Okm {
fn drop(&mut self) {
wipe(&mut self.bytes);
}
}
impl fmt::Debug for Okm {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
f.write_str("Okm")
}
}