Struct ChaChaPoly1305 

pub struct ChaChaPoly1305<C, N: ArraySize = U12> {
    pub(crate) key: Key,
    pub(crate) stream_cipher: PhantomData<C>,
    pub(crate) nonce_size: PhantomData<N>,
}

Generic ChaCha+Poly1305 Authenticated Encryption with Additional Data (AEAD) construction.

See the toplevel documentation for a usage example.

Fields

key: Key

Secret key.

stream_cipher: PhantomData<C>

ChaCha stream cipher.

nonce_size: PhantomData<N>

Nonce size.

Trait Implementations

impl<C, N> AeadCore for ChaChaPoly1305<C, N>

where N: ArraySize,

const TAG_POSITION: TagPosition = TagPosition::Postfix

The AEAD tag position.

type NonceSize = N

The length of a nonce.

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

The maximum length of the tag.

impl<C, N> AeadInOut for ChaChaPoly1305<C, N>

where C: KeyIvInit<KeySize = U32, IvSize = N> + StreamCipher + StreamCipherSeek, N: ArraySize,

fn encrypt_inout_detached( &self, nonce: &Nonce<Self>, associated_data: &[u8], buffer: InOutBuf<'_, '_, u8>, ) -> Result<Tag, Error>

Encrypt the data in the provided InOutBuf, returning the authentication tag.

fn decrypt_inout_detached( &self, nonce: &Nonce<Self>, associated_data: &[u8], buffer: InOutBuf<'_, '_, u8>, tag: &Tag, ) -> Result<(), Error>

Decrypt the data in the provided InOutBuf, returning an error in the event the provided authentication tag is invalid for the given ciphertext (i.e. ciphertext is modified/unauthentic).

fn encrypt_in_place( &self, nonce: &Array<u8, Self::NonceSize>, associated_data: &[u8], buffer: &mut dyn Buffer, ) -> Result<(), Error>

Encrypt the given buffer containing a plaintext message in-place.

fn decrypt_in_place( &self, nonce: &Array<u8, Self::NonceSize>, associated_data: &[u8], buffer: &mut dyn Buffer, ) -> Result<(), Error>

Decrypt the message in-place, returning an error in the event the provided authentication tag does not match the given ciphertext.

impl<C, N> Clone for ChaChaPoly1305<C, N>

where N: ArraySize,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<C, N> Debug for ChaChaPoly1305<C, N>

where N: ArraySize,

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

Formats the value using the given formatter.

impl<C, N> Drop for ChaChaPoly1305<C, N>

where N: ArraySize,

fn drop(&mut self)

Executes the destructor for this type.

impl<C, N> KeyInit for ChaChaPoly1305<C, N>

where N: ArraySize,

fn new(key: &Key) -> Self

Create new value from fixed size key.

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

Create new value from variable size key.

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.

impl<C, N> KeySizeUser for ChaChaPoly1305<C, N>

where N: ArraySize,

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<C, N: ArraySize> ZeroizeOnDrop for ChaChaPoly1305<C, N>

Available on crate feature zeroize only.