https://github.com/tf-encrypted/aes-prng
Rust pseudo-random number generator based on AES
https://github.com/tf-encrypted/aes-prng
aes cryptography prng rust
Last synced: 3 months ago
JSON representation
Rust pseudo-random number generator based on AES
- Host: GitHub
- URL: https://github.com/tf-encrypted/aes-prng
- Owner: tf-encrypted
- License: apache-2.0
- Created: 2022-05-25T09:41:02.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-02-15T08:39:43.000Z (over 1 year ago)
- Last Synced: 2024-03-15T11:49:18.067Z (over 1 year ago)
- Topics: aes, cryptography, prng, rust
- Language: Rust
- Homepage:
- Size: 36.1 KB
- Stars: 6
- Watchers: 13
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AES-PRNG
[![crate][crate-image]][crate-link]
[![Docs][docs-image]][docs-link]
[![Build Status][build-image]][build-link]
[![Apache2 License 2.0][license-image]][license-link]
[![Minimum rustc version][rustc-image]][rustc-link]
[![Downloads][downloads-image]][crate-link]
A Rust library for random number generation using AES as the underlying block-cipher.
## Usage
Add this to your `Cargo.toml`:
```toml
[dependencies]
aes-prng = "0.2.2"
```
## Example
```rust
use rand::{RngCore, SeedableRng};
use aes_prng::AesRng;
let mut rng = AesRng::from_random_seed();
// sample random bytes
let mut bytes = [0; 1024];
rng.fill_bytes(&mut bytes);
// sample random u32
let r_u32 = rng.next_u32();
// sample random u64
let r_u64 = rng.next_u64();
```
`AesRng` can also be created from an existing seed:
```rust
let seed = AesRng::generate_random_seed();
let mut rng = AesRng::from_seed(seed);
```
### Rust version requirements
AES-PRNG requires **Rustc version 1.56 or greater** due to the [RustCrypto](
https://github.com/RustCrypto/block-ciphers/tree/master/aes) dependency.
## Crate Features
AES-PRNG is built with the `-Ctarget-feature=+aes` feature enabled by default
to get the benefit of AES-NI instructions for speeding up the PRNG calls.
## Benchmarks
### AMD Ryzen 9 3900X
```
$ cargo bench -- rng_fill
rng_fill/chacha8/100 time: [18.266 us 18.269 us 18.271 us]
rng_fill/chacha12/100 time: [24.603 us 24.607 us 24.610 us]
rng_fill/chacha20/100 time: [38.965 us 38.970 us 38.974 us]
rng_fill/aes/100 time: [24.080 us 24.113 us 24.144 us]
rng_fill/chacha8/1000 time: [176.70 us 176.71 us 176.73 us]
rng_fill/chacha12/1000 time: [248.39 us 248.41 us 248.44 us]
rng_fill/chacha20/1000 time: [391.49 us 391.68 us 391.90 us]
rng_fill/aes/1000 time: [225.52 us 225.53 us 225.54 us]
```
### Apple M1 Max
```
$ cargo bench -- rng_fill
rng_fill/chacha8/100 time: [82.938 us 83.033 us 83.144 us]
rng_fill/chacha12/100 time: [120.63 us 120.84 us 121.05 us]
rng_fill/chacha20/100 time: [195.85 us 196.17 us 196.51 us]
rng_fill/aes/100 time: [414.90 us 415.26 us 415.71 us]
rng_fill/chacha8/1000 time: [833.53 us 834.31 us 835.25 us]
rng_fill/chacha12/1000 time: [1.2083 ms 1.2093 ms 1.2106 ms]
rng_fill/chacha20/1000 time: [1.9600 ms 1.9638 ms 1.9685 ms]
rng_fill/aes/1000 time: [4.1675 ms 4.1731 ms 4.1792 ms]
```
```
$ RUSTUP_TOOLCHAIN=nightly \
RUSTFLAGS="--cfg aes_armv8" \
cargo bench -- rng_fill
rng_fill/chacha8/100 time: [74.994 us 75.104 us 75.223 us]
rng_fill/chacha12/100 time: [109.58 us 109.75 us 109.95 us]
rng_fill/chacha20/100 time: [179.29 us 179.52 us 179.79 us]
rng_fill/aes/100 time: [11.019 us 11.064 us 11.113 us]
rng_fill/chacha8/1000 time: [751.56 us 752.02 us 752.55 us]
rng_fill/chacha12/1000 time: [1.1022 ms 1.1036 ms 1.1054 ms]
rng_fill/chacha20/1000 time: [1.8051 ms 1.8100 ms 1.8157 ms]
rng_fill/aes/1000 time: [112.58 us 113.03 us 113.49 us]
```
## Releasing
We release manually using [`carge-release`](https://github.com/crate-ci/cargo-release):
```
$ cargo release minor
```
## License
AES-PRNG is distributed under the terms of Apache License (Version 2.0). Copyright as specified in [NOTICE](./NOTICE).
[//]: # (badges)
[crate-image]: https://img.shields.io/crates/v/aes-prng.svg
[crate-link]: https://crates.io/crates/aes-prng
[docs-image]: https://docs.rs/aes-prng/badge.svg
[docs-link]: https://docs.rs/aes-prng
[build-image]: https://github.com/tf-encrypted/aes-prng/workflows/CI/badge.svg
[build-link]: https://github.com/tf-encrypted/aes-prng/actions
[license-image]: https://img.shields.io/badge/license-Apache%20License%202.0-blue.svg?style=flat
[license-link]: https://www.apache.org/licenses/LICENSE-2.0
[rustc-image]: https://img.shields.io/badge/rustc-1.56+-blue.svg
[rustc-link]: https://github.com/tf-encrypted/aes-prng#rust-version-requirements
[downloads-image]: https://img.shields.io/crates/d/aes-prng.svg