Struct threshold_crypto::SecretKey

pub struct SecretKey(_);

A secret key; wraps a single prime field element. The field element is heap allocated to avoid any stack copying that result when passing SecretKeys between stack frames.

Serde integration

SecretKey implements Deserialize but not Serialize to avoid accidental serialization in insecure contexts. To enable both use the ::serde_impl::SerdeSecret wrapper which implements both Deserialize and Serialize.

Methods

impl SecretKey

pub fn from_mut(fr: &mut Fr) -> Self

Creates a new SecretKey from a mutable reference to a field element. This constructor takes a reference to avoid any unnecessary stack copying/moving of secrets (i.e. the field element). The field element is copied bytewise onto the heap, the resulting Box is stored in the returned SecretKey.

WARNING this constructor will overwrite the referenced Fr element with zeros after it has been copied onto the heap.

pub fn random() -> Self

Creates a new random instance of SecretKey. If you want to use/define your own random number generator, you should use the constructor: SecretKey::sample(). If you do not need to specify your own RNG, you should use the SecretKey::random() constructor, which uses rand::thread_rng() internally as its RNG.

pub fn public_key(&self) -> PublicKey

Returns the matching public key.

pub fn sign_g2<H: Into<G2Affine>>(&self, hash: H) -> Signature

Signs the given element of G2.

pub fn sign<M: AsRef<[u8]>>(&self, msg: M) -> Signature

Signs the given message.

This is equivalent to sign_g2(hash_g2(msg)).

pub fn decrypt(&self, ct: &Ciphertext) -> Option<Vec<u8>>

Returns the decrypted text, or None, if the ciphertext isn't valid.

pub fn reveal(&self) -> String

Generates a non-redacted debug string. This method differs from the Debug implementation in that it does leak the secret prime field element.

Trait Implementations

impl Clone for SecretKey

Creates a new SecretKey by cloning another SecretKey's prime field element.

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for SecretKey

Creates a SecretKey containing the zero prime field element.

fn default() -> Self

Returns the "default value" for a type.

impl PartialEq<SecretKey> for SecretKey

fn eq(&self, other: &SecretKey) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &SecretKey) -> bool

This method tests for !=.

impl Drop for SecretKey

Zeroes out the memory allocated from the SecretKey's field element.

fn drop(&mut self)

Executes the destructor for this type.

impl Eq for SecretKey

impl Debug for SecretKey

A debug statement where the secret prime field element is redacted.

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

Formats the value using the given formatter.

impl Distribution<SecretKey> for Standard

fn sample<R: Rng + ?Sized>(&self, rng: &mut R) -> SecretKey

Creates a new random instance of SecretKey. If you do not need to specify your own RNG, you should use the SecretKey::random() constructor, which uses rand::thread_rng() internally as its RNG.

fn sample_iter<R>(&'a self, rng: &'a mut R) -> DistIter<'a, Self, R, T> where
    R: Rng, 

Create an iterator that generates random values of T, using rng as the source of randomness.

impl<'de> Deserialize<'de> for SecretKey

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
    D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.