Struct frost_schnorrkel::frost::dkg::pedpop::BlameMachine

pub struct BlameMachine<C>
where
    C: Ciphersuite,
{ /* private fields */ }

Available on crate feature std only.

A machine capable of handling blame proofs.

Implementations

impl<C> BlameMachine<C>

where C: Ciphersuite,

pub fn complete(self) -> ThresholdCore<C>

Mark the protocol as having been successfully completed, returning the generated keys. This should only be called after having confirmed, with all participants, successful completion.

Confirming successful completion is not necessarily as simple as everyone reporting their completion. Everyone must also receive everyone’s report of completion, entering into the territory of consensus protocols. This library does not handle that nor does it provide any tooling to do so. This function is solely intended to force users to acknowledge they’re completing the protocol, not processing any blame.

pub fn blame( self, sender: Participant, recipient: Participant, msg: EncryptedMessage<C, SecretShare<<C as Ciphersuite>::F>>, proof: Option<EncryptionKeyProof<C>>, ) -> (AdditionalBlameMachine<C>, Participant)

Given an accusation of fault, determine the faulty party (either the sender, who sent an invalid secret share, or the receiver, who claimed a valid secret share was invalid). No matter which, prevent completion of the machine, forcing an abort of the protocol.

The message should be a copy of the encrypted secret share from the accused sender to the accusing recipient. This message must have been authenticated as actually having come from the sender in question.

In order to enable detecting multiple faults, an AdditionalBlameMachine is returned, which can be used to determine further blame. These machines will process the same blame statements multiple times, always identifying blame. It is the caller’s job to ensure they’re unique in order to prevent multiple instances of blame over a single incident.

Trait Implementations

impl<C> Debug for BlameMachine<C>

where C: Ciphersuite,

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

Formats the value using the given formatter.

impl<C> Zeroize for BlameMachine<C>

where C: Ciphersuite,

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.