Struct threshold_crypto::SecretKeyShare

pub struct SecretKeyShare(_);

A secret key share.

Serde integration

SecretKeyShare 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.

Implementations

impl SecretKeyShare

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

Creates a new SecretKeyShare from a mutable reference to a field element. This constructor takes a reference to avoid any unnecessary stack copying/moving of secrets field elements. The field element will be copied bytewise onto the heap, the resulting Box is stored in the SecretKey which is then wrapped in a SecretKeyShare.

WARNING this constructor will overwrite the pointed to Fr element with zeros once it has been copied into a new SecretKeyShare.

pub fn public_key_share(&self) -> PublicKeyShare

Returns the matching public key share.

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

Signs the given element of G2.

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

Signs the given message.

pub fn decrypt_share(&self, ct: &Ciphertext) -> Option<DecryptionShare>

Returns a decryption share, or None, if the ciphertext isn't valid.

pub fn decrypt_share_no_verify(&self, ct: &Ciphertext) -> DecryptionShare

Returns a decryption share, without validating the ciphertext.

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 SecretKeyShare

fn clone(&self) -> SecretKeyShare

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SecretKeyShare

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

Formats the value using the given formatter.

impl Default for SecretKeyShare

fn default() -> SecretKeyShare

Returns the "default value" for a type.

impl<'de> Deserialize<'de> for SecretKeyShare

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

Deserialize this value from the given Serde deserializer.

impl Distribution<SecretKeyShare> for Standard

Can be used to create a new random instance of SecretKeyShare. This is only useful for testing purposes as such a key has not been derived from a SecretKeySet.

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

Generate a random value of T, using rng as the source of randomness.

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

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

impl Eq for SecretKeyShare

impl PartialEq<SecretKeyShare> for SecretKeyShare

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

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

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

This method tests for !=.

impl StructuralEq for SecretKeyShare

impl StructuralPartialEq for SecretKeyShare