Struct DistributedKeyGeneration 

pub struct DistributedKeyGeneration<S: DkgState> { /* private fields */ }

State machine structures for holding intermediate values during a distributed key generation protocol run, to prevent misuse.

Implementations

impl DistributedKeyGeneration<RoundOne>

pub fn new( parameters: &Parameters, my_index: &u32, my_coefficients: &Coefficients, other_participants: &mut Vec<Participant>, ) -> Result<Self, Vec<u32>>

Check the zero-knowledge proofs of knowledge of secret keys of all the other participants.

Note

The participants will be sorted by their indices.

Returns

An updated state machine for the distributed key generation protocol if all of the zero-knowledge proofs verified successfully, otherwise a vector of participants whose zero-knowledge proofs were incorrect.

pub fn their_secret_shares(&self) -> Result<&Vec<SecretShare>, ()>

Retrieve a secret share for each other participant, to be given to them at the end of DistributedKeyGeneration::<RoundOne>.

pub fn to_round_two( self, my_secret_shares: Vec<SecretShare>, ) -> Result<DistributedKeyGeneration<RoundTwo>, ()>

Progress to round two of the DKG protocol once we have sent each share from DistributedKeyGeneration::<RoundOne>.their_secret_shares() to its respective other participant, and collected our shares from the other participants in turn.

impl DistributedKeyGeneration<RoundTwo>

pub fn finish( self, my_commitment: &RistrettoPoint, ) -> Result<(GroupKey, SecretKey), ()>

Calculate this threshold signing protocol participant’s long-lived secret signing keyshare and the group’s public verification key.

Example

let (group_key, secret_key) = state.finish(participant.public_key()?)?;

Trait Implementations

impl<S: Clone + DkgState> Clone for DistributedKeyGeneration<S>

fn clone(&self) -> DistributedKeyGeneration<S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Debug + DkgState> Debug for DistributedKeyGeneration<S>

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

Formats the value using the given formatter.