[][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.

References


  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]

Formats the value using the given formatter. Read more

impl Clone for Hc128Rng
[src]

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

impl CryptoRng for Hc128Rng
[src]

impl RngCore for Hc128Rng
[src]

Return the next random u32. Read more

Return the next random u64. Read more

Fill dest with random data. Read more

Fill dest entirely with random data. Read more

impl SeedableRng for Hc128Rng
[src]

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

Create a new PRNG using the given seed. Read more

Create a new PRNG seeded from another Rng. Read more

Create a new PRNG using a u64 seed. Read more

Auto Trait Implementations

impl Send for Hc128Rng

impl Sync for Hc128Rng

Blanket Implementations

impl<T> From for T
[src]

Performs the conversion.

impl<T, U> TryFrom for T where
    T: From<U>, 
[src]

🔬 This is a nightly-only experimental API. (try_from)

The type returned in the event of a conversion error.

🔬 This is a nightly-only experimental API. (try_from)

Performs the conversion.

impl<T, U> TryInto for T where
    U: TryFrom<T>, 
[src]

🔬 This is a nightly-only experimental API. (try_from)

The type returned in the event of a conversion error.

🔬 This is a nightly-only experimental API. (try_from)

Performs the conversion.

impl<T, U> Into for T where
    U: From<T>, 
[src]

Performs the conversion.

impl<T> Borrow for T where
    T: ?Sized
[src]

Immutably borrows from an owned value. Read more

impl<T> BorrowMut for T where
    T: ?Sized
[src]

Mutably borrows from an owned value. Read more

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

🔬 This is a nightly-only experimental API. (get_type_id)

this method will likely be replaced by an associated static

Gets the TypeId of self. Read more