Struct FixedNoClone 

pub struct FixedNoClone<T>(/* private fields */);

Non-cloneable stack-allocated secret wrapper.

This is a zero-cost newtype over Fixed<T> that deliberately omits Clone and Copy. Use this when you want to enforce single-ownership and prevent accidental duplication of secrets.

Converts from Fixed<T> via .no_clone().

Examples

use secure_gate::{Fixed, FixedNoClone};
let secret = Fixed::new([1u8; 32]);
let no_clone: FixedNoClone<[u8; 32]> = secret.no_clone();
// no_clone cannot be cloned
assert_eq!(no_clone.expose_secret()[0], 1);

With zeroize:

use secure_gate::FixedNoClone;
let mut secret = FixedNoClone::new([1u8, 2, 3]);
drop(secret); // wiped on drop

Implementations

impl<T> FixedNoClone<T>

pub const fn new(value: T) -> Self

Wrap a value in a non-cloneable fixed secret.

Example

use secure_gate::FixedNoClone;
let secret = FixedNoClone::new(42u32);

pub const fn expose_secret(&self) -> &T

Expose the inner value for read-only access.

This is the only way to read the secret — loud and auditable.

Example

use secure_gate::FixedNoClone;
let secret = FixedNoClone::new([42u8; 32]);
assert_eq!(secret.expose_secret()[0], 42);

pub fn expose_secret_mut(&mut self) -> &mut T

Expose the inner value for mutable access.

This is the only way to mutate the secret — loud and auditable.

Example

use secure_gate::FixedNoClone;
let mut secret = FixedNoClone::new([1u8, 2, 3]);
secret.expose_secret_mut()[0] = 99;
assert_eq!(secret.expose_secret()[0], 99);

impl<T: Zeroize> FixedNoClone<T>

pub fn zeroize_now(&mut self)

Explicitly zeroize the secret immediately.

This is useful when you want to wipe memory before the value goes out of scope, or when you want to make the zeroization intent explicit in the code.

Example

use secure_gate::FixedNoClone;
let mut key = FixedNoClone::new([42u8; 32]);
// ... use key ...
key.zeroize_now();  // Explicit wipe - makes intent clear

Trait Implementations

impl<T> Debug for FixedNoClone<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Zeroize> Zeroize for FixedNoClone<T>

Available on crate feature zeroize only.

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.

impl<T: Zeroize> ZeroizeOnDrop for FixedNoClone<T>

Available on crate feature zeroize only.