Struct crypto_api_chachapoly::ChaCha20Ietf

pub struct ChaCha20Ietf;

An implementation of ChaCha20 (IETF-version)

Implementations

impl ChaCha20Ietf

pub fn cipher() -> Box<dyn Cipher>

Creates a Cipher instance with ChaCha20Ietf as underlying cipher

pub fn xor(key: &[u8], nonce: &[u8], n: u32, data: &mut [u8])

XORs the bytes in data with the ChaCha20 keystream for key and nonce starting at the nth block

Warning:

This function panics if

• key is smaller or larger than 32 bytes/256 bits
• nonce is smaller or larger than 12 bytes/96 bits
• n exceeds 2^32 - 1 (which means that data must be smaller than (2^32 - n) * 64)

Consider using the crypto_api-interface instead of calling this function directly

Trait Implementations

impl Cipher for ChaCha20Ietf

fn info(&self) -> CipherInfo

Returns information about the cipher

fn encrypted_len_max(&self, plaintext_len: usize) -> usize

Predicts the maximum encrypted length for plaintext_len bytes

fn encrypt(
    &self,
    buf: &mut [u8],
    plaintext_len: usize,
    key: &[u8],
    nonce: &[u8]
) -> Result<usize, Box<dyn Error + 'static>>

Encrypts plaintext_len bytes in-place in buf using key and nonce and returns the ciphertext length

fn encrypt_to(
    &self,
    buf: &mut [u8],
    plaintext: &[u8],
    key: &[u8],
    nonce: &[u8]
) -> Result<usize, Box<dyn Error + 'static>>

Encrypts plaintext into buf using key and nonce and returns the ciphertext length

fn decrypt(
    &self,
    buf: &mut [u8],
    ciphertext_len: usize,
    key: &[u8],
    nonce: &[u8]
) -> Result<usize, Box<dyn Error + 'static>>

Decrypts ciphertext_len bytes in-place in buf using key and nonce and returns the plaintext length

fn decrypt_to(
    &self,
    buf: &mut [u8],
    ciphertext: &[u8],
    key: &[u8],
    nonce: &[u8]
) -> Result<usize, Box<dyn Error + 'static>>

Decrypts ciphertext into buf using key and nonce and returns the plaintext length

impl SecKeyGen for ChaCha20Ietf

fn new_sec_key(
    &self,
    buf: &mut [u8],
    rng: &mut dyn SecureRng
) -> Result<usize, Box<dyn Error + 'static>>

Generates a new key into buf using rng and returns the length of the secret key