Struct GroupPrivateKey 

pub struct GroupPrivateKey { /* private fields */ }

A group private key.

In normal FROST usage, the group private key is not supposed to be kept anywhere once the private key shares have been computed. In single-signer usage, the group private key is handled like a normal cryptographic private key.

Implementations

impl GroupPrivateKey

pub const ENC_LEN: usize = 32usize

Encoded private key length (in bytes).

pub fn generate<T: CryptoRng + RngCore>(rng: &mut T) -> Self

Generates a new (group) private key.

A private key is a randomly selected non-zero scalar.

pub fn get_public_key(self) -> GroupPublicKey

Gets the public key corresponding to this private key.

pub fn encode(self) -> [u8; 32]

Encodes this private key into bytes.

In normal FROST usage, group private keys are only transient in-memory object discarded at the end of the key split process. Private key encoding is meant to support single-signer FROST usage.

pub fn decode(buf: &[u8]) -> Option<Self>

Decodes this private key from bytes.

This function may fail (i.e. return None) if the source does not have the length of an encoded private key, or if the provided bytes are not a proper canonical encoding for a non-zero scalar.

pub fn sign<T: CryptoRng + RngCore>(self, rng: &mut T, msg: &[u8]) -> Signature

Generates a signature (single-signer version).

This function uses the (group) private key to sign the provided message. The signature is randomized, though it also uses a derandomization process internally so that safety is maintained even if the provided random generator has poor quality.

pub fn sign_seeded(self, seed: &[u8], msg: &[u8]) -> Signature

Generates a signature (single-signer version, seeded).

This function uses the (group) private key to sign the provided message. The signature uses an internal derandomization process to compute the per-signature nonce; an additional seed can be provided, which is integrated in that process. If that extra seed is fixed (e.g. it is empty), then the signature is deterministic (but still safe).

Trait Implementations

impl Clone for GroupPrivateKey

fn clone(&self) -> GroupPrivateKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GroupPrivateKey

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

Formats the value using the given formatter.

impl Copy for GroupPrivateKey