tfhe 1.6.1

TFHE-rs is a fully homomorphic encryption (FHE) library that implements Zama's variant of TFHE.
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

use super::{ClientKey, SecretEncryptionKeyView};
use crate::integer::backward_compatibility::client_key::CrtClientKeyVersions;
use crate::integer::CrtCiphertext;
use serde::{Deserialize, Serialize};
use tfhe_versionable::Versionize;

/// Client key "specialized" for CRT decomposition.
///
/// This key is a simple wrapper of the [ClientKey],
/// that only encrypt and decrypt in CRT decomposition.
///
/// # Example
///
/// ```rust
/// use tfhe::integer::CrtClientKey;
/// use tfhe::shortint::parameters::PARAM_MESSAGE_3_CARRY_3_KS_PBS_GAUSSIAN_2M128;
///
/// let basis = vec![2, 3, 5];
/// let cks = CrtClientKey::new(PARAM_MESSAGE_3_CARRY_3_KS_PBS_GAUSSIAN_2M128, basis);
///
/// let msg = 13_u64;
///
/// // Encryption:
/// let ct = cks.encrypt(msg);
///
/// // Decryption:
/// let dec = cks.decrypt(&ct);
/// assert_eq!(msg, dec);
/// ```
#[derive(Serialize, Deserialize, PartialEq, Debug, Clone, Versionize)]
#[versionize(CrtClientKeyVersions)]
pub struct CrtClientKey {
    key: ClientKey,
    moduli: Vec<u64>,
}

impl AsRef<ClientKey> for CrtClientKey {
    fn as_ref(&self) -> &ClientKey {
        &self.key
    }
}

impl<'key> From<&'key CrtClientKey> for SecretEncryptionKeyView<'key> {
    fn from(value: &'key CrtClientKey) -> Self {
        Self {
            key: (&value.key.key).into(),
        }
    }
}

impl CrtClientKey {
    pub fn new<P>(parameters: P, moduli: Vec<u64>) -> Self
    where
        P: Into<crate::shortint::PBSParameters>,
    {
        Self {
            key: ClientKey::new(parameters.into()),
            moduli,
        }
    }

    pub fn encrypt(&self, message: u64) -> CrtCiphertext {
        self.key.encrypt_crt(message, self.moduli.clone())
    }

    pub fn encrypt_native_crt(&self, message: u64) -> CrtCiphertext {
        self.key.encrypt_native_crt(message, self.moduli.clone())
    }

    pub fn decrypt(&self, ciphertext: &CrtCiphertext) -> u64 {
        self.key.decrypt_crt(ciphertext)
    }

    pub fn decrypt_native_crt(&self, ciphertext: &CrtCiphertext) -> u64 {
        self.key.decrypt_native_crt(ciphertext)
    }

    /// Returns the parameters used by the client key.
    pub fn parameters(&self) -> crate::shortint::AtomicPatternParameters {
        self.key.parameters()
    }

    pub fn moduli(&self) -> &[u64] {
        self.moduli.as_slice()
    }
}

impl From<(ClientKey, Vec<u64>)> for CrtClientKey {
    fn from((key, moduli): (ClientKey, Vec<u64>)) -> Self {
        Self { key, moduli }
    }
}