libpep 0.12.0

Library for polymorphic encryption and pseudonymization
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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

//! Polymorphic encryption and decryption helper functions for client operations.

use crate::data::traits::{Encryptable, Encrypted};
use rand_core::{CryptoRng, Rng};

/// Polymorphic encrypt function that works for any encryptable type.
///
/// # Examples
/// ```rust,ignore
/// let encrypted_pseudonym = encrypt(&pseudonym, &pseudonym_key, &mut rng);
/// let encrypted_attribute = encrypt(&attribute, &attribute_key, &mut rng);
/// let encrypted_long = encrypt(&long_pseudonym, &pseudonym_key, &mut rng);
/// ```
pub fn encrypt<M, R>(message: &M, public_key: &M::PublicKeyType, rng: &mut R) -> M::EncryptedType
where
    M: Encryptable,
    R: Rng + CryptoRng,
{
    message.encrypt(public_key, rng)
}

/// Polymorphic decrypt function that works for any encrypted type.
/// With the `elgamal3` feature, returns `None` if the secret key doesn't match.
///
/// # Examples
/// ```rust,ignore
/// let pseudonym = decrypt(&encrypted_pseudonym, &pseudonym_key);
/// let attribute = decrypt(&encrypted_attribute, &attribute_key);
/// ```
#[cfg(feature = "elgamal3")]
pub fn decrypt<E>(encrypted: &E, secret_key: &E::SecretKeyType) -> Option<E::UnencryptedType>
where
    E: Encrypted,
{
    encrypted.decrypt(secret_key)
}

/// Polymorphic decrypt function that works for any encrypted type.
///
/// # Examples
/// ```rust,ignore
/// let pseudonym = decrypt(&encrypted_pseudonym, &pseudonym_key);
/// let attribute = decrypt(&encrypted_attribute,
/// &attribute_key);
/// ```
#[cfg(not(feature = "elgamal3"))]
pub fn decrypt<E>(encrypted: &E, secret_key: &E::SecretKeyType) -> E::UnencryptedType
where
    E: Encrypted,
{
    encrypted.decrypt(secret_key)
}

/// Polymorphic encrypt_global function for offline encryption.
///
/// # Examples
/// ```rust,ignore
/// let encrypted = encrypt_global(&pseudonym, &global_key, &mut rng);
/// ```
#[cfg(feature = "offline")]
pub fn encrypt_global<M, R>(
    message: &M,
    public_key: &M::GlobalPublicKeyType,
    rng: &mut R,
) -> M::EncryptedType
where
    M: Encryptable,
    R: Rng + CryptoRng,
{
    message.encrypt_global(public_key, rng)
}

/// Polymorphic decrypt_global function for offline decryption.
/// With the `elgamal3` feature, returns `None` if the secret key doesn't match.
#[cfg(all(feature = "offline", feature = "insecure", feature = "elgamal3"))]
pub fn decrypt_global<E>(
    encrypted: &E,
    secret_key: &E::GlobalSecretKeyType,
) -> Option<E::UnencryptedType>
where
    E: Encrypted,
{
    encrypted.decrypt_global(secret_key)
}

/// Polymorphic decrypt_global function for offline decryption.
#[cfg(all(feature = "offline", feature = "insecure", not(feature = "elgamal3")))]
pub fn decrypt_global<E>(encrypted: &E, secret_key: &E::GlobalSecretKeyType) -> E::UnencryptedType
where
    E: Encrypted,
{
    encrypted.decrypt_global(secret_key)
}