Struct AesCtrKeyGenerator 

pub struct AesCtrKeyGenerator { /* private fields */ }

Hardware-only AES-256-CTR fast random generator.

The state contains a 128-bit counter, AES-256 encryption round keys, and a small buffered-output block. It does not contain a software AES fallback or a runtime enum that can hold one.

Implementations

impl AesCtrKeyGenerator

pub fn hardware_available() -> bool

Returns whether this process currently exposes the required AES hardware functionality for the AES-CTR backend.

pub const fn state_layout() -> StateLayout

Returns the state layout for this owned generator type.

pub fn from_os_entropy() -> Result<Self, Error>

Seeds a new AES-CTR generator from OS entropy.

Errors

Returns Error::UnsupportedCpu if the required AES hardware support is unavailable. Returns Error::OsEntropy if the platform entropy source cannot provide a seed.

pub fn from_seed(seed: &mut [u8; 48]) -> Result<Self, Error>

Seeds a new AES-CTR generator from explicit seed material and zeroizes the provided seed before returning.

seed[..32] is the AES-256 key and seed[32..] is the initial 128-bit little-endian counter. This constructor exists for deterministic tests and benchmarks; production callers should use Self::from_os_entropy.

Errors

Returns Error::UnsupportedCpu if the required AES hardware support is unavailable.

pub fn key_32(&mut self) -> Result<[u8; 32], Error>

Generates a 32-byte AES-256 key.

Errors

Returns entropy, hardware, or fork-detection failures.

pub fn nonce_12(&mut self) -> Result<[u8; 12], Error>

Generates a 12-byte AES-GCM nonce.

Errors

Returns entropy, hardware, or fork-detection failures.

Trait Implementations

impl Debug for AesCtrKeyGenerator

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for AesCtrKeyGenerator

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

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

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl KeyGenerator for AesCtrKeyGenerator

fn fill_bytes(&mut self, out: &mut [u8]) -> Result<(), Error>

Fills out with AES-CTR CSPRNG output.

fn key_32(&mut self) -> Result<[u8; 32], Error>

Generates a 32-byte AES-256 key.

fn nonce_12(&mut self) -> Result<[u8; 12], Error>

Generates a 12-byte AES-GCM nonce.