Struct SetupMessage

pub struct SetupMessage<SK = NoSigningKey, VK = NoVerifyingKey, MS = NoSignature> { /* private fields */ }

A message used for setting up key generation in a multi-party computation protocol.

This struct encapsulates all necessary information for setting up a key generation protocol, including participant information, cryptographic keys, and protocol parameters.

Type Parameters

• SK - The type of signing key used for message signatures
• VK - The type of verifying key used to verify message signatures
• MS - The type of message signature

Implementations

impl<SK, VK, MS> SetupMessage<SK, VK, MS>

pub fn new( inst: InstanceId, sk: SK, party_id: usize, vk: Vec<VK>, ranks: &[u8], t: usize, ) -> Self

Creates a new setup message for key generation.

Arguments

• inst - Instance identifier for the protocol
• sk - Signing key for the current party
• party_id - ID of the current party
• vk - Vector of verifying keys for all participants
• ranks - Ranks of all participants
• t - Threshold value for the protocol

Returns

A new SetupMessage instance with default TTL and no key ID

pub fn with_ttl(self, ttl: Duration) -> Self

Sets a custom time-to-live duration for messages.

Arguments

• ttl - The new time-to-live duration

Returns

The modified SetupMessage instance

pub fn with_key_id(self, key_id: Option<[u8; 32]>) -> Self

Sets a custom key identifier.

Arguments

• key_id - Optional key identifier

Returns

The modified SetupMessage instance

pub fn key_id(&self) -> Option<&[u8]>

Returns the key identifier if it exists.

Returns

An optional reference to the key identifier bytes

Trait Implementations

impl<SK, VK, MS> KeygenSetupMessage for SetupMessage<SK, VK, MS>

where SK: Signer<MS>, MS: SignatureEncoding, VK: AsRef<[u8]> + Verifier<MS>,

fn threshold(&self) -> u8

Returns the threshold value for the protocol.

fn participant_rank(&self, index: usize) -> u8

Returns the rank of a specific participant.

Arguments

• index - The index of the participant

Returns

The rank of the participant

fn derive_key_id(&self, public_key: &[u8]) -> [u8; 32]

Derives a key identifier from a public key.

Arguments

• public_key - The public key to derive the identifier from

Returns

A 32-byte key identifier

fn keyshare_extra(&self) -> &[u8]

Additional data to amend into the Keyshare.

impl<SK, VK, MS> ProtocolParticipant for SetupMessage<SK, VK, MS>

where SK: Signer<MS>, MS: SignatureEncoding, VK: AsRef<[u8]> + Verifier<MS>,

fn total_participants(&self) -> usize

Returns the total number of participants in the protocol.

fn participant_index(&self) -> usize

Returns the index of the current participant.

fn instance_id(&self) -> &InstanceId

Returns the instance identifier for the protocol.

fn message_ttl(&self) -> Duration

Returns the time-to-live duration for messages.

fn verifier(&self, index: usize) -> &Self::MessageVerifier

Returns the verifying key for a specific participant.

Arguments

• index - The index of the participant

Returns

A reference to the verifying key

fn signer(&self) -> &Self::MessageSigner

Returns the signing key for the current participant.

type MessageSignature = MS

Type of a signature, added at end of all broadcast messages passed between participants.

type MessageSigner = SK

Type to sign broadcast messages, some kind of SecretKey.

type MessageVerifier = VK

Type to verify signed message, a verifying key. AsRef<u8> is used to get external representation of the key to derive message ID.

fn participant_verifier(&self) -> &Self::MessageVerifier

Return reference to participant’s own verifier

fn all_other_parties(&self) -> AllOtherParties

Return iterator of all participant’s indexes except own one.

fn msg_id(&self, receiver: Option<usize>, tag: MessageTag) -> MsgId

Generate ID of a message from this party to some other (or broadcast) if passed receiver is None.

fn msg_id_from( &self, sender: usize, receiver: Option<usize>, tag: MessageTag, ) -> MsgId

Generate ID of a message from given sender to a given receiver. Receiver is designed by its index and is None for a broadcase message.