Struct crypto_api_chachapoly::XChaCha20

pub struct XChaCha20;

An implementation of XChaCha20

Implementations

impl XChaCha20

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

Creates a Cipher instance with XChaCha20 as underlying cipher

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

XORs the bytes in data with the XChaCha20 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 24 bytes/192 bits
• n exceeds 2^64 - 1 (which means that data must be smaller than (2^64 - n) * 64)

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

Trait Implementations

impl Cipher for XChaCha20

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 XChaCha20

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