secrets 1.3.0

Protected-access memory for cryptographic secrets
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

#![allow(unsafe_code)]

use super::*;
use crate::ffi::sodium;

/// Types that can be safely initialized by setting their memory to a
/// random value.
///
/// The trait is marked unsafe in order to restrict implementors to
/// types that can safely have their underlying memory randomized.
///
/// # Safety
///
/// This trait allows for overwriting a type's memory with a
/// cryptographically random bit pattern. If it is not legal to
/// represent your type as any potential series of bits, then your type
/// may not implement this trait.
pub unsafe trait Randomizable: AsContiguousBytes {
    /// Randomizes the contents of `self`.
    fn randomize(&mut self) {
        sodium::memrandom(self.as_mut_bytes());
    }
}

unsafe impl<T: AsContiguousBytes + ?Sized> Randomizable for T {}