Struct abcrypt::Decryptor

pub struct Decryptor<'c> { /* private fields */ }

Decryptor for the abcrypt encrypted data format.

Implementations

impl<'c> Decryptor<'c>

pub fn new( ciphertext: &'c impl AsRef<[u8]>, passphrase: impl AsRef<[u8]> ) -> Result<Self>

Creates a new Decryptor.

Errors

Returns Err if any of the following are true:

• ciphertext is shorter than 156 bytes.
• The magic number is invalid.
• The version number is the unrecognized abcrypt version number.
• The Argon2 parameters are invalid.
• The Argon2 context is invalid.
• The MAC (authentication tag) of the header is invalid.

Examples

let ciphertext = include_bytes!("../tests/data/data.txt.abcrypt");
let passphrase = "passphrase";

let cipher = Decryptor::new(&ciphertext, passphrase).unwrap();

pub fn decrypt(&self, buf: impl AsMut<[u8]>) -> Result<()>

Decrypts the ciphertext into buf.

Errors

Returns Err if the MAC (authentication tag) of the ciphertext is invalid.

Panics

Panics if buf and the decrypted data have different lengths.

Examples

let data = b"Hello, world!\n";
let ciphertext = include_bytes!("../tests/data/data.txt.abcrypt");
let passphrase = "passphrase";

let cipher = Decryptor::new(&ciphertext, passphrase).unwrap();
let mut buf = [u8::default(); 14];
cipher.decrypt(&mut buf).unwrap();

pub fn decrypt_to_vec(&self) -> Result<Vec<u8>>

Available on crate feature alloc only.

Decrypts the ciphertext and into a newly allocated Vec.

Errors

Returns Err if the MAC (authentication tag) of the ciphertext is invalid.

Examples

let data = b"Hello, world!\n";
let ciphertext = include_bytes!("../tests/data/data.txt.abcrypt");
let passphrase = "passphrase";

let cipher = Decryptor::new(&ciphertext, passphrase).unwrap();
let plaintext = cipher.decrypt_to_vec().unwrap();

pub const fn out_len(&self) -> usize

Returns the number of output bytes of the decrypted data.

Examples

let ciphertext = include_bytes!("../tests/data/data.txt.abcrypt");
let passphrase = "passphrase";

let cipher = Decryptor::new(&ciphertext, passphrase).unwrap();
assert_eq!(cipher.out_len(), 14);

Trait Implementations

impl<'c> Clone for Decryptor<'c>

fn clone(&self) -> Decryptor<'c>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'c> Debug for Decryptor<'c>

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

Formats the value using the given formatter.