[][src]Struct rand_hc::Hc128Rng

pub struct Hc128Rng(_);

A cryptographically secure random number generator that uses the HC-128 algorithm.

HC-128 is a stream cipher designed by Hongjun Wu1, that we use as an RNG. It is selected as one of the "stream ciphers suitable for widespread adoption" by eSTREAM2.

HC-128 is an array based RNG. In this it is similar to RC-4 and ISAAC before it, but those have never been proven cryptographically secure (or have even been significantly compromised, as in the case of RC-43).

Because HC-128 works with simple indexing into a large array and with a few operations that parallelize well, it has very good performance. The size of the array it needs, 4kb, can however be a disadvantage.

This implementation is not based on the version of HC-128 submitted to the eSTREAM contest, but on a later version by the author with a few small improvements from December 15, 20094.

HC-128 has no known weaknesses that are easier to exploit than doing a brute-force search of 2128. A very comprehensive analysis of the current state of known attacks / weaknesses of HC-128 is given in Some Results On Analysis And Implementation Of HC-128 Stream Cipher5.

The average cycle length is expected to be 21024*32+10-1 = 232777. We support seeding with a 256-bit array, which matches the 128-bit key concatenated with a 128-bit IV from the stream cipher.

This implementation uses an output buffer of sixteen u32 words, and uses BlockRng to implement the RngCore methods.


  1. Hongjun Wu (2008). "The Stream Cipher HC-128". The eSTREAM Finalists, LNCS 4986, pp. 39–47, Springer-Verlag. 

  2. eSTREAM: the ECRYPT Stream Cipher Project 

  3. Internet Engineering Task Force (February 2015), "Prohibiting RC4 Cipher Suites"

  4. Hongjun Wu, Stream Ciphers HC-128 and HC-256 

  5. Shashwat Raizada (January 2015),"Some Results On Analysis And Implementation Of HC-128 Stream Cipher"

Trait Implementations

impl Debug for Hc128Rng[src]

impl Clone for Hc128Rng[src]

fn clone_from(&mut self, source: &Self)1.0.0[src]

Performs copy-assignment from source. Read more

impl CryptoRng for Hc128Rng[src]

impl RngCore for Hc128Rng[src]

impl SeedableRng for Hc128Rng[src]

type Seed = <Hc128Core as SeedableRng>::Seed

Seed type, which is restricted to types mutably-dereferencable as u8 arrays (we recommend [u8; N] for some N). Read more

fn seed_from_u64(state: u64) -> Self[src]

Create a new PRNG using a u64 seed. Read more

fn from_entropy() -> Self[src]

Creates a new instance of the RNG seeded via [getrandom]. Read more

Auto Trait Implementations

impl Send for Hc128Rng

impl Sync for Hc128Rng

impl Unpin for Hc128Rng

impl UnwindSafe for Hc128Rng

impl RefUnwindSafe for Hc128Rng

Blanket Implementations

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> Into<U> for T where
    U: From<T>, 

impl<T> From<T> for T[src]

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<T> Borrow<T> for T where
    T: ?Sized

impl<T> BorrowMut<T> for T where
    T: ?Sized

impl<T> Any for T where
    T: 'static + ?Sized

impl<T> ToOwned for T where
    T: Clone

type Owned = T

The resulting type after obtaining ownership.