Struct crypto_wasi::Decipheriv

pub struct Decipheriv { /* private fields */ }

Equivalent to crypto.Decipheriv

Example:

let mut d = Decipheriv::create(alg, key, iv)?;
d.set_aad(aad)?; // optional
d.set_auth_tag(auth_tag)?;
let src = d.decrypt(msg)?;

Implementations

impl Decipheriv

pub fn create( alg: &str, key: impl AsRef<[u8]>, iv: impl AsRef<[u8]> ) -> Result<Self, CryptoErrno>

Equivalent to createDecipheriv

For AES-128-GCM key should be 16 bytes and iv should be 12 bytes. For AES-256-GCM key should be 32 bytes and iv should be 12 bytes. For CHACHA20-POLY1305 key should be 32 bytes and iv should be 12 bytes.

pub fn set_aad(&mut self, data: impl AsRef<[u8]>) -> Result<(), CryptoErrno>

Sets the value used for the additional authenticated data (AAD) input parameter. The set_add method must be called before update.

pub fn update(&mut self, data: impl AsRef<[u8]>) -> Result<(), CryptoErrno>

In WasmEdge implementation of wasi-crypto, decrypt can’t be called multiple times, multiple call decrypt is also not equivalent to multiple call update. so we store all message and concat it, then decrypt one-time on final

pub fn fin(&mut self) -> Result<Vec<u8>, CryptoErrno>

final is reserved keyword, fin looks better than r#final

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

Equivalent to update(data) then fin, but no need to restore data in struct internal.

pub fn set_auth_tag( &mut self, data: impl AsRef<[u8]> ) -> Result<(), CryptoErrno>

When using an authenticated encryption mode (GCM are currently supported), the set_auth_tag method is used to pass in the received authentication tag. The set_auth_tag method must be called before fin for GCM modes.

Trait Implementations

impl Drop for Decipheriv

fn drop(&mut self)

Executes the destructor for this type.