Struct pwbox::pure::PureCrypto

pub struct PureCrypto(_);

This is supported on crate feature pure only.

Suite for password-based encryption provided by pure-Rust crypto primitives.

Ciphers

• chacha20-poly1305: ChaCha20 stream cipher with Poly1305 MAC

KDFs

• scrypt: scrypt KDF with the original paper parametrization.

Examples

This suite can be used in constrained environments, e.g., WASM.

use rand::thread_rng;
use pwbox::{Eraser, ErasedPwBox, Suite, pure::PureCrypto};

// Create a new box.
let pwbox = PureCrypto::build_box(&mut thread_rng())
    .seal(b"correct horse", b"battery staple")
    .unwrap();

// Read from existing box.
let mut eraser = Eraser::new();
eraser.add_suite::<PureCrypto>();
let erased: ErasedPwBox = // deserialized from some format
let plaintext = eraser.restore(&erased)?.open(b"correct horse")?;

Trait Implementations

impl Debug for PureCrypto

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

Formats the value using the given formatter.

impl Suite for PureCrypto

type Cipher = ChaCha20Poly1305

Recommended cipher for this suite.

type DeriveKey = Scrypt

Recommended KDF for this suite.

fn add_ciphers_and_kdfs(eraser: &mut Eraser)

Adds ciphers and KDFs from this suite into the specified Eraser.

fn build_box<R: RngCore + CryptoRng>(
    rng: &mut R
) -> PwBoxBuilder<'_, Self::DeriveKey, Self::Cipher>

Initializes a PwBoxBuilder with the recommended cipher and KDF.