Struct SigningSession 

pub struct SigningSession { /* private fields */ }

A stateful signing session for a single message under a ThresholdConfig.

The session verifies each partial signature at the time it is added, so SigningSession::verify is a pure threshold check — it does not re-verify individual signatures.

Sessions are single-use: one session corresponds to exactly one message. Create a new session for each message that requires threshold authorisation.

Implementations

impl SigningSession

pub fn new(config: &ThresholdConfig, message: &[u8]) -> Self

Create a new signing session.

Parameters

• config: The threshold configuration for this session.
• message: The raw message payload to be authorised. Domain separation is applied internally; pass the plaintext message, not a pre-computed hash.

pub fn add_signature( &mut self, signer_index: usize, signature: Vec<u8>, ) -> Result<(), Error>

Add a partial signature from committee member at signer_index.

The signature is verified cryptographically before being recorded. Adding the same index twice returns Error::DuplicateSignature.

Errors

• Error::SignerIndexOutOfRange if signer_index >= total.
• Error::DuplicateSignature if this index has already been signed.
• Error::VerificationFailed if the Falcon-512 check fails.
• Propagates length-validation errors from verify_partial.

pub fn is_complete(&self) -> bool

Return true if the session holds at least M valid signatures.

pub fn verify(&self) -> Result<bool, Error>

Verify that the threshold is met.

Because individual signatures are verified at insertion time, this method only checks that valid_count >= required.

Errors

Returns Error::ThresholdNotMet if the session does not yet hold enough valid signatures.

pub fn valid_signature_count(&self) -> usize

Return the number of valid signatures collected so far.

pub fn required(&self) -> usize

Return the threshold requirement.

pub fn progress(&self) -> (usize, usize)

Return progress as (collected, required).

pub fn message(&self) -> &[u8]

Return a reference to the message this session is authorising.

pub fn config(&self) -> &ThresholdConfig

Return a reference to the threshold configuration.

pub fn get_signature(&self, signer_index: usize) -> Option<&[u8]>

Retrieve the recorded signature for signer_index, if present.

Returns None if no valid signature has been submitted for that index.

pub fn signed_indices(&self) -> Vec<usize>

Return the indices of all signers who have submitted valid signatures.

Trait Implementations

impl Debug for SigningSession

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

Formats the value using the given formatter.