Struct RandomizedParams 

pub struct RandomizedParams<C: Ciphersuite> { /* private fields */ }

Randomized parameters for a signing instance of randomized FROST.

Implementations

impl<C: Ciphersuite> RandomizedParams<C>

Auto-generated by derive_getters::Getters.

pub fn randomizer(&self) -> &Randomizer<C>

The randomizer, also called α

pub fn randomizer_element(&self) -> &<C::Group as Group>::Element

The generator multiplied by the randomizer.

pub fn randomized_verifying_key(&self) -> &VerifyingKey<C>

The randomized group public key. The group public key added to the randomizer element.

impl<C> RandomizedParams<C>

where C: RandomizedCiphersuite,

pub fn new<R: RngCore + CryptoRng>( group_verifying_key: &VerifyingKey<C>, signing_package: &SigningPackage<C>, rng: R, ) -> Result<Self, Error<C>>

👎Deprecated: switch to new_from_commitments(), passing the commitments from SigningPackage

Create a new RandomizedParams for the given VerifyingKey and the given SigningPackage.

pub fn new_from_commitments<R: RngCore + CryptoRng>( group_verifying_key: &VerifyingKey<C>, signing_commitments: &BTreeMap<Identifier<C>, SigningCommitments<C>>, rng: R, ) -> Result<(Self, Vec<u8>), Error<C>>

Create a new RandomizedParams for the given VerifyingKey and the given signing commitments.

The SigningCommitments map must be the one being used in the current FROST signing run (built by the Coordinator after receiving from Participants). It is hashed into the randomizer calculation, which binds it to that specific commitments.

Returns the generated RandomizedParams and a randomizer seed. Both can be used to regenerate the RandomizedParams with Self::regenerate_from_seed_and_commitments().

pub fn regenerate_from_seed_and_commitments( group_verifying_key: &VerifyingKey<C>, randomizer_seed: &[u8], signing_commitments: &BTreeMap<Identifier<C>, SigningCommitments<C>>, ) -> Result<Self, Error<C>>

Regenerate a RandomizedParams with the given VerifyingKey from the given given signing commitments.

Returns the generated RandomizedParams and a randomizer seed, which can be used to regenerate the RandomizedParams.

Regenerates a RandomizedParams generated with Self::new_from_commitments(). This can be used by Participants after receiving the randomizer seed and commitments in Round 2. This is better than the Coordinator simply generating a Randomizer and sending it to Participants, because in this approach the participants don’t need to fully trust the Coordinator’s random number generator (i.e. even if the randomizer seed was not randomly generated the randomizer will still be).

This should be used exclusively with the output of Self::new_from_commitments(); it is strongly suggested to not attempt generating the randomizer seed yourself (even if the point of this approach is to hedge against issues in the randomizer seed generation).

impl<C> RandomizedParams<C>

where C: Ciphersuite,

pub fn from_randomizer( group_verifying_key: &VerifyingKey<C>, randomizer: Randomizer<C>, ) -> Self

Create a new RandomizedParams for the given VerifyingKey and the given participants for the given randomizer. The randomizer MUST be generated uniformly at random! Use RandomizedParams::new() which generates a fresh randomizer, unless your application requires generating a randomizer outside.

Trait Implementations

impl<C: Clone + Ciphersuite> Clone for RandomizedParams<C>

where C::Group: Clone,

fn clone(&self) -> RandomizedParams<C>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<C> Debug for RandomizedParams<C>

where C: Ciphersuite,

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

Formats the value using the given formatter.

impl<C: PartialEq + Ciphersuite> PartialEq for RandomizedParams<C>

where C::Group: PartialEq,

fn eq(&self, other: &RandomizedParams<C>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<C: Eq + Ciphersuite> Eq for RandomizedParams<C>

where C::Group: Eq,

impl<C: Ciphersuite> StructuralPartialEq for RandomizedParams<C>