#random #esdm

rand-esdm

provides interface to ESDM RNG server

14 releases

Uses new Rust 2024

new 0.2.2 Apr 11, 2025
0.1.5 Jul 23, 2024
0.1.1 Mar 22, 2024
0.0.2 Aug 10, 2023

#915 in Cryptography

Download history 2/week @ 2024-12-28 26/week @ 2025-01-04 76/week @ 2025-01-11 85/week @ 2025-01-18 59/week @ 2025-01-25 38/week @ 2025-02-01 64/week @ 2025-02-08 37/week @ 2025-02-15 70/week @ 2025-02-22 41/week @ 2025-03-01 80/week @ 2025-03-08 37/week @ 2025-03-15 56/week @ 2025-03-22 49/week @ 2025-03-29 263/week @ 2025-04-05

445 downloads per month
Used in esdm-tool

MIT license

22KB
434 lines

rand-esdm

crates.io

About

A small library for interfacing Rust with the ESDM user-space random server.

It currently provides the minimal amount of bindings necessary to use ESDM together with the rand crate.

Usage Example

Add rand-esdm to your Cargo.toml

rand-esdm = "0.2.1"

Generate Random Numbers with rand crate

Choose type of rng:

  • Only usable when fully seeded: let mut rng = EsdmRng::new(EsdmRngType::FullySeeded);
  • Only usable with fresh entropy: let mut rng = EsdmRng::new(EsdmRngType::PredictionResistant);

Include Rng utility trait from rand:

use rand::Rng;

Draw random numbers as needed, e.g.:

let rnd: u64 = rng.random();

Complete toy example can be found in examples/readme.rs:

use rand::{Rng, TryRngCore};
use rand_esdm::{EsdmRng, EsdmRngType};

fn main() {
    let mut rng = EsdmRng::new(EsdmRngType::FullySeeded).unwrap_err();
    let rnd: u32 = rng.random();
    println!("{rnd:X}");
}

Dependencies

~2.3–5MB
~95K SLoC