mithril-stm 0.10.5

A Rust implementation of Mithril Stake-based Threshold Multisignatures (STMs).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

use crate::SignerIndex;

use super::AggregateSignatureType;

/// Error types for aggregation.
#[derive(Debug, Clone, thiserror::Error)]
pub enum AggregationError {
    /// Not enough signatures were collected, got this many instead.
    #[error("Not enough signatures. Got only {0} out of {1}.")]
    NotEnoughSignatures(u64, u64),

    #[error("Unsupported proof system: {0}")]
    UnsupportedProofSystem(AggregateSignatureType),

    /// There is a duplicate index
    #[error("Indices are not unique.")]
    IndexNotUnique,

    /// Signer registration data could not be found during witness assembly for SNARK prover input.
    #[error("Missing SNARK signer data for signer index {0}.")]
    MissingSnarkSignerData(SignerIndex),

    /// A signature selected for witness assembly is missing its SNARK component.
    #[error("Missing SNARK signature for lottery index {0}.")]
    MissingSnarkSignature(SignerIndex),
}

/// Errors which can be output by Mithril aggregate verification.
#[derive(Debug, Clone, thiserror::Error)]
pub enum AggregateSignatureError {
    /// This error occurs when the serialization of the raw bytes failed
    #[error("Invalid bytes")]
    SerializationError,

    /// Batch verification of STM aggregate signatures failed
    #[error(
        "Invalid batch: signatures, aggregate verification keys, message and parameters must have the same length"
    )]
    BatchInvalid,

    /// Missing SNARK aggregate verification key
    #[error("Missing SNARK aggregate verification key")]
    MissingSnarkAggregateVerificationKey,

    /// Missing SNARK clerk for aggregate signature verification
    #[error("Missing SNARK clerk for aggregate signature verification")]
    MissingSnarkClerk,

    /// The proof system used in the aggregate signature is not supported
    #[error("Unsupported proof system: {0}")]
    UnsupportedProofSystem(AggregateSignatureType),

    /// The proof system is unknown
    #[error("Unknown proof system: {0}")]
    UnknownProofSystem(String),
}