Struct enocoro128v2::Enocoro128

pub struct Enocoro128 { /* fields omitted */ }

Composition of reference implementation's context, state, and buffer structures. Implements en/decryption and random (i.e. keystream getter) functions.

Methods

impl Enocoro128

pub fn new(key: &[u8; 16], iv: &[u8; 8]) -> Enocoro128

Constructor, note key and IV length are compile-time enforced.

pub fn init_keystream(&mut self)

Keystream initialization.

pub fn apply_keystream(&mut self, data: &mut [u8])

Stateful, in-place en/decryption (current keystream XORed with data). Can be called repeatedly to continue applying keystream to data chunks of varying sizes. For usecases where the entirety of the plaintext or ciphertext is never in memory at once (e.g. data received/transmitted in chunks, potentially of varying sizes).

pub fn apply_keystream_static(key: &[u8; 16], iv: &[u8; 8], data: &mut [u8])

Stateless, in-place en/decryption (keystream XORed with data). Uses an ephemeral instance of the cipher, zeroed on function return. For usecases where the entirety of the plaintext or ciphertext is in-memory at once.

pub fn rand_buf(&mut self, r: &mut [u8])

Fill arbitrary length buffer from keystream.

pub fn rand_u8(&mut self) -> u8

Get u8 from keystream.

pub fn rand_u16(&mut self) -> u16

Get u16 from keystream.

pub fn rand_u32(&mut self) -> u32

Get u32 from keystream.

pub fn rand_u64(&mut self) -> u64

Get u64 from keystream.

pub fn rand_u128(&mut self) -> u128

Get u128 from keystream.

Trait Implementations

impl Debug for Enocoro128

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

Formats the value using the given formatter.

impl Drop for Enocoro128

fn drop(&mut self)

Executes the destructor for this type.

impl Zeroize for Enocoro128

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not "optimized away" by the compiler.