HC-128 Cipher Generator¶
None, *, key=
Container for the HC-128 cipher-based pseudo-random number generator
Random seed initializing the pseudo-random number generator. Can be an integer in [0, 2**64), array of integers in [0, 2**64), a SeedSequence instance or
None(the default). If seed is
None, then data is read from
/dev/urandom(or the Windows analog) if available. If unavailable, a hash of the time and process ID is used.
Key for HC128. The key is a 256-bit integer that contains both the key (lower 128 bits) and initial values (upper 128-bits) for the HC-128 cipher. key and seed cannot both be used.
The seeding mode to use. “legacy” uses the legacy SplitMix64-based initialization. “sequence” uses a SeedSequence to transforms the seed into an initial state. None defaults to “sequence”.
Lock instance that is shared so that the same bit git generator can be used in multiple Generators without corrupting the state. Code that generates values from a bit generator should hold the bit generator’s lock.
The SeedSequence instance used to initialize the generator if mode is “sequence” or is seed is a SeedSequence. None if mode is “legacy”.
HC-128 was developer by Hongjun Wu and is an eSTREAM finalist (, ). It is a cryptographic quality random number generator that produces a keystream is suitable for encryption. The average cycle length is expected to be 2**(1024*32+10-1) = 2**32777.
HC128is the fastest software-only encryption-quality bit generator, and about 50% as fast as
AESCounterwhen used with AESNI.
HC128provides a capsule containing function pointers that produce doubles, and unsigned 32 and 64- bit integers. These are not directly consumable in Python and must be consumed by a
Generatoror similar object that supports low-level access.
ChaChafor related PRNGs that uses a block cipher rather than a stream cipher.
State and Seeding
HC128state vector consists of a 2 512-element arrays of 32-bit unsigned integers (p and q) and an integer in [0, 1024). In addition, the state contains a 16-element array that buffers values and a buffer index.
HC128is seeded using either a single 256-bit unsigned integer or a vector of 64-bit unsigned integers. In either case, the seed is used as an input for another simple random number generator, SplitMix64, and the output of this PRNG function is used as the initial state. Alternatively, the key can be set directly using a 256-bit integer.
HC128can be used in parallel applications by using distinct keys
>>> from numpy.random import Generator >>> from randomgen import HC128 >>> rg = [Generator(HC128(key=1234 + i)) for i in range(10)]
HC128makes a guarantee that a fixed seed will always produce the same random integer stream.
>>> from numpy.random import Generator >>> from randomgen import HC128 >>> rg = Generator(HC128(1234)) >>> rg.standard_normal() 0.123 # random
Seeding and State¶
Seed the generator
Get or set the PRNG state
Return randoms as generated by the underlying BitGenerator