crypto_api_osrandom 0.2.0

An interface to the OS' secure random number generator for `crypto_api`
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
26
27
28
29
30
31
32
33
34
35
36
37
38
39

#![doc = include_str!("../README.md")]

#[macro_use]
pub mod error;
pub mod crypto_api;

#[cfg(feature = "crypto_api")]
pub use crate::crypto_api::OsRandom;
use crate::error::Error;

/// Fills the given slice with crpytographically secure random bytes
pub fn to_slice(slice: &mut [u8]) -> Result<(), Error> {
    // The API of the bridge library
    extern "C" {
        // uint8_t crypto_api_osrandom(uint8_t* buf, size_t len);
        fn crypto_api_osrandom_native(buf: *mut u8, len: usize) -> u8;
    }

    // Call the native implementation
    let result = unsafe { crypto_api_osrandom_native(slice.as_mut_ptr(), slice.len()) };
    match result {
        0 => Ok(()),
        _ => Err(Error),
    }
}

/// Creates a `LEN`-sized array filled with crpytographically secure random bytes
pub fn to_array<const LEN: usize>() -> Result<[u8; LEN], Error> {
    let mut array = [0; LEN];
    crate::to_slice(&mut array)?;
    Ok(array)
}

/// Creates a `len`-sized vec filled with crpytographically secure random bytes
pub fn to_vec(len: usize) -> Result<Vec<u8>, Error> {
    let mut vec = vec![0; len];
    crate::to_slice(&mut vec)?;
    Ok(vec)
}