Struct Cipher

pub struct Cipher { /* private fields */ }

The Cipher struct provides a common interface for cryptographic operations, specifically focusing on encryption and decryption.

Implementations

impl Cipher

pub fn new(mode: CipherMode) -> Self

Constructs a new Cipher instance using the specified cipher mode.

Arguments

• mode - The mode of cipher (ChaCha20 or Custom) to use.

Returns

A new instance of Cipher.

pub fn init(&mut self, key: &[u8], iv: &[u8]) -> &mut Self

Initializes the cipher with a key and IV (initialization vector). Sets up the cipher’s internal state for encryption or decryption.

Arguments

• key - A byte slice representing the key.
• iv - A byte slice representing the initialization vector.

Returns

A mutable reference to the cipher instance.

pub fn encrypt(&mut self, data: &[u8]) -> Vec<u8>

Encrypts the provided data.

Arguments

• data - A slice of data to be encrypted.

Returns

Encrypted data as a vector of bytes (Bytes).

pub fn sign(&mut self, header: &[u8], data: &[u8]) -> SignedEnvelope

Signs the provided data.

Arguments

• header - A slice of unencrypted data to be signed.
• data - A slice of data to be signed.

Returns

A signed envelope containing the data and its MAC (message authentication code).

pub fn decrypt(&mut self, data: &[u8]) -> Vec<u8>

Decrypts the provided data. Note that this method does not provide any integrity checks. Most of the use cases should be covered by decrypt_and_verify() instead.

Arguments

• data - A slice of data to be decrypted.

Returns

Decrypted data as a vector of bytes (Bytes).

pub fn decrypt_and_verify( &mut self, envelope: &SignedEnvelope, ) -> Result<Vec<u8>, CipherError>

Decrypts the provided data and verifies the MAC.

Arguments

• envelope - A signed envelope containing encrypted data to be decrypted.

Returns

Decrypted data as a vector of bytes (Bytes), or an error in case of decryption failure.

Trait Implementations

impl Default for Cipher

fn default() -> Self

Provides a default instance of Cipher using the XChaCha20 mode.

Returns

A new instance of Cipher with XChaCha20 mode.