Trait aead::stream::StreamPrimitive

pub trait StreamPrimitive<A> where
    A: AeadInPlace,
    A::NonceSize: Sub<Self::NonceOverhead>,
    NonceSize<A, Self>: ArrayLength<u8>, {
    type NonceOverhead: ArrayLength<u8>;
    type Counter: AddAssign + Copy + Default + Eq;

    const COUNTER_INCR: Self::Counter;
    const COUNTER_MAX: Self::Counter;

    fn encrypt_in_place(
        &self,
        position: Self::Counter,
        last_block: bool,
        associated_data: &[u8],
        buffer: &mut dyn Buffer
    ) -> Result<()>;
    fn decrypt_in_place(
        &self,
        position: Self::Counter,
        last_block: bool,
        associated_data: &[u8],
        buffer: &mut dyn Buffer
    ) -> Result<()>;

    fn encrypt<'msg, 'aad>(
        &self,
        position: Self::Counter,
        last_block: bool,
        plaintext: impl Into<Payload<'msg, 'aad>>
    ) -> Result<Vec<u8>> { ... }
    fn decrypt<'msg, 'aad>(
        &self,
        position: Self::Counter,
        last_block: bool,
        ciphertext: impl Into<Payload<'msg, 'aad>>
    ) -> Result<Vec<u8>> { ... }
    fn encryptor(self) -> Encryptor<A, Self>
    where
        Self: Sized,
    { ... }
    fn decryptor(self) -> Decryptor<A, Self>
    where
        Self: Sized,
    { ... }
}

Available on crate feature stream only.

Low-level STREAM implementation.

This trait provides a particular “flavor” of STREAM, as there are different ways the specifics of the construction can be implemented.

Deliberately immutable and stateless to permit parallel operation.

Required Associated Types

type NonceOverhead: ArrayLength<u8>

Number of bytes this STREAM primitive requires from the nonce.

type Counter: AddAssign + Copy + Default + Eq

Type used as the STREAM counter.

Required Associated Constants

const COUNTER_INCR: Self::Counter

Value to use when incrementing the STREAM counter (i.e. one)

const COUNTER_MAX: Self::Counter

Maximum value of the STREAM counter.

Required Methods

fn encrypt_in_place(
    &self,
    position: Self::Counter,
    last_block: bool,
    associated_data: &[u8],
    buffer: &mut dyn Buffer
) -> Result<()>

Encrypt an AEAD message in-place at the given position in the STREAM.

fn decrypt_in_place(
    &self,
    position: Self::Counter,
    last_block: bool,
    associated_data: &[u8],
    buffer: &mut dyn Buffer
) -> Result<()>

Decrypt an AEAD message in-place at the given position in the STREAM.

Provided Methods

fn encrypt<'msg, 'aad>(
    &self,
    position: Self::Counter,
    last_block: bool,
    plaintext: impl Into<Payload<'msg, 'aad>>
) -> Result<Vec<u8>>

Available on crate feature alloc only.

Encrypt the given plaintext payload, and return the resulting ciphertext as a vector of bytes.

fn decrypt<'msg, 'aad>(
    &self,
    position: Self::Counter,
    last_block: bool,
    ciphertext: impl Into<Payload<'msg, 'aad>>
) -> Result<Vec<u8>>

Available on crate feature alloc only.

Decrypt the given ciphertext slice, and return the resulting plaintext as a vector of bytes.

fn encryptor(self) -> Encryptor<A, Self> where
    Self: Sized, 

Obtain Encryptor for this StreamPrimitive.

fn decryptor(self) -> Decryptor<A, Self> where
    Self: Sized, 

Obtain Decryptor for this StreamPrimitive.

Implementors

impl<A> StreamPrimitive<A> for StreamBE32<A> where
    A: AeadInPlace,
    A::NonceSize: Sub<U5>,
    <<A as AeadCore>::NonceSize as Sub<U5>>::Output: ArrayLength<u8>, 

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

type Counter = u32

const COUNTER_INCR: u32 = 1u32

const COUNTER_MAX: u32 = 4_294_967_295u32

impl<A> StreamPrimitive<A> for StreamLE31<A> where
    A: AeadInPlace,
    A::NonceSize: Sub<U4>,
    <<A as AeadCore>::NonceSize as Sub<U4>>::Output: ArrayLength<u8>, 

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

type Counter = u32

const COUNTER_INCR: u32 = 1u32

const COUNTER_MAX: u32 = 268_435_455u32