Struct SetupMessage

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

A message used for setting up signing operations in a multi-party computation protocol.

This struct encapsulates all necessary information for signing operations, 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
• KS - The type of keyshare used in the protocol

Implementations

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

pub fn new( instance: InstanceId, sk: SK, party_idx: usize, vk: Vec<VK>, share: Arc<KS>, ) -> Self

Creates a new setup message for signing operations.

Arguments

• instance - Instance identifier for the protocol
• sk - Signing key for the current party
• party_idx - Index of the current party
• vk - Vector of verifying keys for all participants
• share - Reference to the keyshare used in signing

Returns

A new SetupMessage instance with default TTL, root derivation path, and zero hash

pub fn with_chain_path(self, chain_path: DerivationPath) -> Self

Sets a custom derivation path for key derivation.

Arguments

• chain_path - The new derivation path

Returns

The modified SetupMessage instance

pub fn with_hash(self, hash: [u8; 32]) -> Self

Sets the hash of the message to be signed.

Arguments

• hash - The 32-byte hash of the message

Returns

The modified SetupMessage instance

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

Optionally sets the hash of the message to be signed.

Arguments

• hash - Optional 32-byte hash of the message

Returns

The modified SetupMessage instance

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 clone_keyshare(&self) -> Arc<KS>

Returns a clone of the keyshare.

pub fn get_chain_path(&self) -> &DerivationPath

Returns a reference to the derivation path.

Trait Implementations

impl<SK, VK, MS> PreSignSetupMessage for SetupMessage<SK, VK, MS, Keyshare>

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

fn chain_path(&self) -> &DerivationPath

Returns the derivation path for key derivation.

fn keyshare(&self) -> &Keyshare

Returns a reference to the keyshare.

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

Additional data to incorpatate into resulting PreSignature.

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

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

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

Returns the signing key for the current participant.

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 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 participant_index(&self) -> usize

Returns the index of the current participant.

fn total_participants(&self) -> usize

Returns the total number of participants in the protocol.

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.

impl<SK, VK, MS> SignSetupMessage for SetupMessage<SK, VK, MS, Keyshare>

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

fn message_hash(&self) -> [u8; 32]

Returns the hash of the message to be signed.