Struct ChaChaCore 

pub struct ChaChaCore<R: Rounds, V: Variant> {
    pub(crate) state: [u32; 16],
    pub(crate) tokens: (InitToken, InitToken),
    pub(crate) _pd: PhantomData<(R, V)>,
}

The ChaCha core function.

Fields

state: [u32; 16]

Internal state of the core function

tokens: (InitToken, InitToken)

CPU target feature tokens

_pd: PhantomData<(R, V)>

Number of rounds to perform and the cipher variant

Implementations

impl<R: Rounds, V: Variant> ChaChaCore<R, V>

pub(crate) fn new_internal(key: &[u8; 32], iv: &[u8]) -> Self

Constructs a ChaChaCore with the specified key and iv.

You must ensure that the iv is of the correct size when using this method directly.

Panics

If iv.len() is not equal to 4, 8, or 12.

pub fn get_block_pos(&self) -> V::Counter

Get the current block position.

pub fn set_block_pos(&mut self, pos: V::Counter)

Set the block position.

Trait Implementations

impl<R: Rounds, V: Variant> BlockSizeUser for ChaChaCore<R, V>

Available on crate feature cipher only.

type BlockSize = UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>

Size of the block in bytes.

fn block_size() -> usize

Return block size in bytes.

impl<R: Rounds, V: Variant> Debug for ChaChaCore<R, V>

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

Formats the value using the given formatter.

impl<R: Rounds, V: Variant> Drop for ChaChaCore<R, V>

Available on crate feature zeroize only.

fn drop(&mut self)

Executes the destructor for this type.

impl<R: Rounds, V: Variant> Generator for ChaChaCore<R, V>

fn generate(&mut self, buffer: &mut [u32; 64])

Generates 4 blocks in parallel with avx2 & neon, but merely fills 4 blocks with sse2 & soft

type Output = [u32; 64]

The output type.

fn drop(&mut self, output: &mut Self::Output)

Destruct the output buffer

impl<R: Rounds> IvSizeUser for ChaChaCore<R, Ietf>

type IvSize = UInt<UInt<UInt<UInt<UTerm, B1>, B1>, B0>, B0>

Initialization vector size in bytes.

fn iv_size() -> usize

Return IV size in bytes.

impl<R: Rounds> KeyIvInit for ChaChaCore<R, Ietf>

fn new(key: &Key, iv: &Nonce) -> Self

Create new value from fixed length key and nonce.

fn new_from_slices(key: &[u8], iv: &[u8]) -> Result<Self, InvalidLength>

Create new value from variable length key and nonce.

fn generate_key<R>(rng: &mut R) -> Array<u8, Self::KeySize>

where R: CryptoRng,

👎Deprecated since 0.2.0: use the Generate trait impl on Key instead

DEPRECATED: generate random key using the provided CryptoRng.

fn generate_iv<R>(rng: &mut R) -> Array<u8, Self::IvSize>

where R: CryptoRng,

👎Deprecated since 0.2.0: use the Generate trait impl on Iv instead

DEPRECATED: generate random IV using the provided CryptoRng.

fn generate_key_iv<R>( rng: &mut R, ) -> (Array<u8, Self::KeySize>, Array<u8, Self::IvSize>)

where R: CryptoRng,

👎Deprecated since 0.2.0: use the Generate trait impls on Key and Iv instead

DEPRECATED: generate random key and IV using the provided CryptoRng.

impl<R: Rounds> KeySizeUser for ChaChaCore<R, Ietf>

type KeySize = UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>

Key size in bytes.

fn key_size() -> usize

Return key size in bytes.

impl<R: Rounds, V: Variant> SeedableRng for ChaChaCore<R, V>

type Seed = [u8; 32]

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

fn from_seed(seed: Self::Seed) -> Self

Create a new PRNG using the given seed.

fn seed_from_u64(state: u64) -> Self

Create a new PRNG using a u64 seed.

fn from_rng<R>(rng: &mut R) -> Self

where R: Rng + ?Sized,

Create a new PRNG seeded from an infallible Rng.

fn try_from_rng<R>(rng: &mut R) -> Result<Self, <R as TryRng>::Error>

where R: TryRng + ?Sized,

Create a new PRNG seeded from a potentially fallible Rng.

impl<R: Rounds, V: Variant> StreamCipherCore for ChaChaCore<R, V>

Available on crate feature cipher only.

fn remaining_blocks(&self) -> Option<usize>

Return number of remaining blocks before the cipher wraps around.

fn process_with_backend( &mut self, f: impl StreamCipherClosure<BlockSize = Self::BlockSize>, )

Process data using backend provided to the rank-2 closure.

fn write_keystream_block(&mut self, block: &mut Array<u8, Self::BlockSize>)

Write keystream block.

fn write_keystream_blocks(&mut self, blocks: &mut [Array<u8, Self::BlockSize>])

Write keystream blocks.

fn apply_keystream_block_inout( &mut self, block: InOut<'_, '_, Array<u8, Self::BlockSize>>, )

Apply keystream block.

fn apply_keystream_blocks(&mut self, blocks: &mut [Array<u8, Self::BlockSize>])

Apply keystream blocks.

fn apply_keystream_blocks_inout( &mut self, blocks: InOutBuf<'_, '_, Array<u8, Self::BlockSize>>, )

Apply keystream blocks.

fn try_apply_keystream_partial( self, buf: InOutBuf<'_, '_, u8>, ) -> Result<(), StreamCipherError>

Try to apply keystream to data not divided into blocks.

fn apply_keystream_partial(self, buf: InOutBuf<'_, '_, u8>)

Try to apply keystream to data not divided into blocks.

impl<R: Rounds, V: Variant> StreamCipherSeekCore for ChaChaCore<R, V>

Available on crate feature cipher only.

type Counter = <V as Variant>::Counter

Counter type used inside stream cipher.

fn get_block_pos(&self) -> Self::Counter

Get current block position.

fn set_block_pos(&mut self, pos: Self::Counter)

Set block position.

impl<R: Rounds, V: Variant> ZeroizeOnDrop for ChaChaCore<R, V>

Available on crate feature zeroize only.