molpha-verifier 0.3.0-dev.3

Solana program library for verifying Molpha threshold-signed oracle updates
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
81
82
83
84
85
86
87
88
89
90
91
92

//! Error type for attestation verification.
//!
//! These are pure verification errors, mapped by downstream programs at the call boundary.
//! Account-borrow/deserialization errors are produced and handled by the caller (which owns the
//! framework-specific account I/O) and never cross the crate boundary.
//!
//! Enable the `thiserror` feature for [`std::error::Error`] and [`std::fmt::Display`] when using
//! this crate in off-chain tooling.

#[cfg_attr(feature = "thiserror", derive(thiserror::Error))]
#[derive(Debug, PartialEq, Eq, Copy, Clone)]
pub enum AttestationError {
    /// Aggregate Schnorr signature failed verification (recovered address mismatch,
    /// invalid coalition key, or invalid scalar `s`).
    #[cfg_attr(
        feature = "thiserror",
        error("aggregate Schnorr signature verification failed")
    )]
    InvalidAggregateSignature,
    /// A signature component was malformed (e.g. non-canonical scalar during the
    /// Schnorr→ECDSA conversion).
    #[cfg_attr(
        feature = "thiserror",
        error("malformed signature component (e.g. non-canonical Schnorr scalar)")
    )]
    InvalidSignature,
    /// `popcount(signers_bitmap) < signatures_required`.
    #[cfg_attr(
        feature = "thiserror",
        error("insufficient signers: popcount(signers_bitmap) < signatures_required")
    )]
    InsufficientSigners,
    /// `signers_bitmap` is not a subset of the deterministically derived selection bitmap.
    #[cfg_attr(
        feature = "thiserror",
        error("signers_bitmap is not a subset of the derived selection bitmap")
    )]
    SignersNotSubsetOfSelection,
    /// `signers_bitmap` has bits set outside `[0, node_count)`, or is otherwise invalid.
    #[cfg_attr(
        feature = "thiserror",
        error("invalid signers_bitmap (bits outside [0, node_count) or malformed)")
    )]
    InvalidSignersBitmap,
    /// Selection-group bitmap derivation failed (bad node count / group size, or the
    /// bounded sampling loop did not converge).
    #[cfg_attr(
        feature = "thiserror",
        error("selection-group bitmap derivation failed")
    )]
    GroupBitmapDerivationFailed,
    /// `ordered_signers.len()` does not equal `popcount(signers_bitmap)`.
    #[cfg_attr(
        feature = "thiserror",
        error("ordered_signers.len() does not match popcount(signers_bitmap)")
    )]
    SignerCountMismatch,
    /// The requested registry version is neither current nor a live previous version.
    #[cfg_attr(feature = "thiserror", error("invalid registry version"))]
    InvalidRegistryVersion,
    /// A signer account is missing, extra, or owned by another program.
    #[cfg_attr(
        feature = "thiserror",
        error("signer account missing, extra, or owned by another program")
    )]
    MissingSignerAccount,
    /// A `Node` account does not match its expected bitmap index.
    #[cfg_attr(
        feature = "thiserror",
        error("node account index does not match bitmap")
    )]
    InvalidNodeIndex,
    /// Previous-version remove remapping was requested without valid transition metadata.
    #[cfg_attr(
        feature = "thiserror",
        error("previous-version remove remapping requested without valid transition metadata")
    )]
    InvalidTransitionAccount,
}

#[cfg(all(test, feature = "thiserror"))]
mod tests {
    use super::*;
    use std::error::Error;

    #[test]
    fn implements_error_and_display() {
        let err = AttestationError::InsufficientSigners;
        assert!(err.source().is_none());
        assert!(err.to_string().contains("insufficient signers"));
    }
}