osrandom 0.1.1

An interface to the OS' secure random number generator
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
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

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

use std::{
    ffi::CStr,
    io::{self, ErrorKind::Other},
    os::raw::c_char,
};

/// Returns the name of the underlying provider
pub fn provider() -> &'static str {
    // The API of the bridge library
    extern "C" {
        // const char* osrandom_provider();
        fn osrandom_provider() -> *const c_char;
    }

    // Get the provider
    let ptr = unsafe { osrandom_provider() };
    let cstr = unsafe { CStr::from_ptr(ptr) };
    match cstr.to_str() {
        Ok(provider) => provider,
        Err(e) => unreachable!("Invalid provider: {e}"),
    }
}

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

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

/// Creates a `LEN`-sized array filled with crpytographically secure random bytes
pub fn to_array<const LEN: usize>() -> io::Result<[u8; LEN]> {
    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) -> io::Result<Vec<u8>> {
    let mut vec = vec![0; len];
    crate::to_slice(&mut vec)?;
    Ok(vec)
}