Struct Randomizer 

pub struct Randomizer<C: Ciphersuite>(/* private fields */);

A randomizer. A random scalar which is used to randomize the key.

Implementations

impl<C> Randomizer<C>

where C: RandomizedCiphersuite,

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

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

Create a new random Randomizer using a SigningPackage for randomness.

The SigningPackage must be the signing package being used in the current FROST signing run. It is hashed into the randomizer calculation, which binds it to that specific package.

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

Create a new random Randomizer using SigningCommitments for randomness.

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 Randomizer and the generate randomizer seed. Both can be used to regenerate the Randomizer with Self::regenerate_from_seed_and_commitments().

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

where C: RandomizedCiphersuite,

Regenerates a Randomizer 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> Randomizer<C>

where C: Ciphersuite,

pub fn from_scalar(scalar: Scalar<C>) -> Self

Create a new Randomizer from the given scalar. It MUST be randomly generated.

It is not recommended to use this method unless for compatibility reasons with specifications on how the randomizer must be generated. Use Randomizer::new() instead.

pub fn serialize(&self) -> Vec<u8>

Serialize the identifier using the ciphersuite encoding.

pub fn deserialize(buf: &[u8]) -> Result<Self, Error<C>>

Deserialize an Identifier from a serialized buffer. Returns an error if it attempts to deserialize zero.

Trait Implementations

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

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<C> Debug for Randomizer<C>

where C: Ciphersuite,

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

Formats the value using the given formatter.

impl<'de, C> Deserialize<'de> for Randomizer<C>

where C: Ciphersuite,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

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

fn eq(&self, other: &Randomizer<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> Serialize for Randomizer<C>

where C: Ciphersuite,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<C: Copy + Ciphersuite> Copy for Randomizer<C>

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

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