hashgraph-like-consensus 0.2.0

A lightweight Rust library for making binary decisions in networks using hashgraph-style consensus
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

//! Error types for the consensus library.
//!
//! All fallible operations return [`ConsensusError`]. Variants are grouped into
//! configuration validation, vote/proposal validation, session state, and
//! consensus result categories.

use alloy::primitives::SignatureError;

/// Enumerates everything that can go wrong during consensus operations.
#[derive(Debug, thiserror::Error)]
pub enum ConsensusError {
    // Configuration Validation Errors
    #[error("consensus_threshold must be between 0.0 and 1.0")]
    InvalidConsensusThreshold,
    #[error("timeout must be greater than 0")]
    InvalidTimeout,
    #[error("expected_voters_count must be greater than 0")]
    InvalidExpectedVotersCount,
    #[error("max_rounds must be greater than 0")]
    InvalidMaxRounds,

    // Vote and Proposal Validation Errors
    #[error("Invalid vote signature")]
    InvalidVoteSignature,
    #[error("Empty signature")]
    EmptySignature,
    #[error("Duplicate vote")]
    DuplicateVote,
    #[error("User already voted")]
    UserAlreadyVoted,
    #[error("Vote expired")]
    VoteExpired,
    #[error("Empty vote owner")]
    EmptyVoteOwner,
    #[error("Invalid vote hash")]
    InvalidVoteHash,
    #[error("Empty vote hash")]
    EmptyVoteHash,
    #[error("Proposal expired")]
    ProposalExpired,
    #[error("Vote proposal_id mismatch: vote belongs to different proposal")]
    VoteProposalIdMismatch,
    #[error("Received hash mismatch")]
    ReceivedHashMismatch,
    #[error("Parent hash mismatch")]
    ParentHashMismatch,
    #[error("Invalid vote timestamp")]
    InvalidVoteTimestamp,
    #[error("Vote timestamp is older than creation time")]
    TimestampOlderThanCreationTime,
    #[error("Mismatched length: expected {expect}, actual {actual}")]
    MismatchedLength { expect: usize, actual: usize },

    // Session/State Errors
    #[error("Session not active")]
    SessionNotActive,
    #[error("Session not found")]
    SessionNotFound,
    #[error("Proposal already exist in consensus service")]
    ProposalAlreadyExist,
    #[error("Scope not found")]
    ScopeNotFound,

    // Consensus Result Errors
    #[error("Insufficient votes at timeout")]
    InsufficientVotesAtTimeout,
    #[error("Consensus exceeded configured max rounds")]
    MaxRoundsExceeded,
    #[error("Consensus not reached")]
    ConsensusNotReached,
    #[error("Consensus failed")]
    ConsensusFailed,

    #[error("Invalid signature: {0}")]
    InvalidSignature(#[from] SignatureError),
    #[error("Failed to sign message: {0}")]
    FailedToSignMessage(#[from] alloy_signer::Error),
    #[error("Failed to get current time")]
    FailedToGetCurrentTime(#[from] std::time::SystemTimeError),
}