obcrypt 1.0.0

Bytes-in/bytes-out cryptographic core of the oboron protocol (authenticated core schemes, no encoding).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

//! `mock1` — identity scheme. **Testing only — no encryption.**
//!
//! Returns plaintext unchanged. Behind the `mock` feature flag,
//! disabled by default. Exists to:
//!
//! - Provide a no-crypto round-trip baseline for unit tests.
//! - Isolate cross-crate / dispatch overhead from AEAD cost in
//!   benchmarks (any timing diff between `mock1` and a real scheme is
//!   pure layering overhead).
//! - Serve as the simplest possible valid scheme for testing the
//!   scheme dispatch logic.
//!
//! **Never enable `mock` in a production build.** Ciphertext == plaintext.

use crate::{Error, Key};

/// Return `plaintext` unchanged in a fresh `Vec<u8>`.
///
/// # Errors
///
/// [`Error::EmptyPlaintext`] if `plaintext` is empty.
#[inline]
pub fn encrypt(plaintext: &[u8], _key: &Key) -> Result<Vec<u8>, Error> {
    if plaintext.is_empty() {
        return Err(Error::EmptyPlaintext);
    }
    Ok(plaintext.to_vec())
}

/// Append `plaintext` unchanged to `out`. `out` is appended to, not cleared.
///
/// # Errors
///
/// Same as [`encrypt`].
#[inline]
pub fn encrypt_into(plaintext: &[u8], _key: &Key, out: &mut Vec<u8>) -> Result<(), Error> {
    if plaintext.is_empty() {
        return Err(Error::EmptyPlaintext);
    }
    out.extend_from_slice(plaintext);
    Ok(())
}

/// Return `ciphertext` unchanged in a fresh `Vec<u8>`.
///
/// # Errors
///
/// [`Error::EmptyPayload`] if `ciphertext` is empty.
#[inline]
pub fn decrypt(ciphertext: &[u8], _key: &Key) -> Result<Vec<u8>, Error> {
    if ciphertext.is_empty() {
        return Err(Error::EmptyPayload);
    }
    Ok(ciphertext.to_vec())
}

/// Append `ciphertext` unchanged to `out`. `out` is appended to, not cleared.
///
/// # Errors
///
/// Same as [`decrypt`].
#[inline]
pub fn decrypt_into(ciphertext: &[u8], _key: &Key, out: &mut Vec<u8>) -> Result<(), Error> {
    if ciphertext.is_empty() {
        return Err(Error::EmptyPayload);
    }
    out.extend_from_slice(ciphertext);
    Ok(())
}