Struct ChaChaStream 

pub struct ChaChaStream<const ROUNDS: u32> { /* private fields */ }

The Osom imlementation of ChaCha algorithm, as defined in RFC 8439.

ChaChaStream is cryptographically secure block stream.

Note that the recommended ROUNDS value is 20.

Implementations

impl<const ROUNDS: u32> ChaChaStream<ROUNDS>

pub fn from_seed(seed: u128) -> Self

Creates a new ChaChaStream from a given seed. This method puts the seed into the key, and passes 0 as the nonce.

For better control use Self::from_arrays or Self::from_slices.

pub fn from_arrays(key: [u8; 32], nonce: [u8; 12]) -> Self

Creates a new ChaChaStream from a given key and nonce.

pub fn from_slices(key: &[u8], nonce: &[u8]) -> Self

Creates a new ChaChaStream from a given key and nonce slices.

pub fn from_slices_and_counter(key: &[u8], nonce: &[u8], counter: u32) -> Self

Creates a new ChaChaStream from a given key, nonce slices and internal counter.

Panics

Panics if the key or nonce is not of size 32 or 8 respectively. Also when counter is u32::MAX.

pub fn next_u32_block(&mut self) -> [u32; 16]

Generates the next chacha block.

Panics

When the internal counter overflows, i.e. when this function is called more than u32::MAX times.

pub fn serialize_block(block: &[u32; 16]) -> [u8; 64]

Serializes the given chacha block, by applying little endian encoding to each element.

Trait Implementations

impl<const ROUNDS: u32> BlockStream for ChaChaStream<ROUNDS>

const BLOCK_SIZE: u32 = 64u32

The size of the block in bytes.

type BlockType = [u8; 64]

The actual type of the block.

fn next_block(&mut self) -> Self::BlockType

Generates the next block.

impl<const ROUNDS: u32> Clone for ChaChaStream<ROUNDS>

fn clone(&self) -> ChaChaStream<ROUNDS>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<const ROUNDS: u32> Debug for ChaChaStream<ROUNDS>

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

Formats the value using the given formatter.

impl<const ROUNDS: u32> PartialEq for ChaChaStream<ROUNDS>

fn eq(&self, other: &ChaChaStream<ROUNDS>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<const ROUNDS: u32> ReprC for ChaChaStream<ROUNDS>

const CHECK: ()

This field is used for const checks only.

impl<const ROUNDS: u32> Seedable<u128> for ChaChaStream<ROUNDS>

fn with_seed(seed: u128) -> Self

Creates a new instance from a given seed.

impl<const ROUNDS: u32> Seedable<u64> for ChaChaStream<ROUNDS>

fn with_seed(seed: u64) -> Self

Creates a new instance from a given seed.

impl<const ROUNDS: u32> Copy for ChaChaStream<ROUNDS>

impl<const ROUNDS: u32> Eq for ChaChaStream<ROUNDS>

impl<const ROUNDS: u32> StructuralPartialEq for ChaChaStream<ROUNDS>