Struct arx_kw::g::G

pub struct G;

The ARX-8-2-4-G variant. Has a key length of 32 bytes and a maximum input length of 64 bytes. See the ArxKW trait for usage.

Implementations

impl G

#[must_use]pub const fn key_length() -> usize

The length of the secret key used by this variant of ARX-KW, in bytes

#[must_use]pub const fn max_input_length() -> usize

Returns the maximum length in bytes for the input to G::encrypt and G::decrypt

---

This is the same for the plaintext input when encrypting and ciphertext input when decrypting, but is not the same for all variants of ARX-KW. Specifically, the E and G variants are defined only for plaintext/ciphertext inputs of no more than 512 bits, the length of a ChaCha Block, whereas EX and GX do not have this limitation.

Trait Implementations

impl ArxKW for G

type Key = [u8; 32]

The type of data which is used as a key for the type that impls this trait. Note that this is not the same for all variants of ARX-KW. all of the currently-defined variants use the same-sized keys

pub fn encrypt(
    key: &Self::Key,
    plaintext: &[u8]
) -> Result<(Vec<u8>, AuthTag), ArxKwError>

Encrypts the plaintext using ARX-KW and returns the encrypted ciphertext and an AuthTag

pub fn decrypt(
    key: &Self::Key,
    ciphertext: &[u8],
    authentication_tag: &AuthTag
) -> Result<Vec<u8>, ArxKwError>

Attempts to decrypt the ciphertext using ARX-KW and returns the decrypted plaintext if successful. As ARX-KW is a form of authenticated encryption, the authenticity of the decrypted text is verified if the function returns an Ok value. which can be stored/transported alongside it.

pub fn encrypt_blob(
    key: &Self::Key,
    plaintext: &[u8]
) -> Result<Vec<u8>, ArxKwError>

Encrypts the plaintext and returns a Vec<u8> containing both the authentication tag and the ciphertext.

pub fn decrypt_blob(key: &Self::Key, blob: &[u8]) -> Result<Vec<u8>, ArxKwError>

Decrypts a blob containing an authentication tag followed by the corresponding ciphertext