Enum FrostError 

pub enum FrostError {
    InvalidCommitment {
        party: String,
        reason: &'static str,
        code: u32,
    },
    InvalidShareResponse {
        party: String,
        reason: &'static str,
        code: u32,
    },
    BelowThreshold {
        have: u32,
        need: u32,
        code: u32,
    },
    MissingCommitment {
        party: String,
        code: u32,
    },
    InvalidShareSignature {
        party: String,
        code: u32,
    },
    AggregateVerificationFailed {
        code: u32,
    },
    MalformedShare {
        reason: &'static str,
        code: u32,
    },
    VssShareVerificationFailed {
        party: String,
        code: u32,
    },
    RosterConfig {
        reason: &'static str,
        code: u32,
    },
    MalformedMessage {
        reason: &'static str,
        code: u32,
    },
    RoundOverflow {
        round: u8,
        code: u32,
    },
    SessionNotComplete {
        code: u32,
    },
}

FROST-specific failure modes. Each variant maps to a distinct code so a failure cause can be identified without string-matching.

Variants

InvalidCommitment

A round-1 commitment failed to decode or decompress.

Fields

party: String

reason: &'static str

code: u32

InvalidShareResponse

A round-2 share response failed to decode.

Fields

party: String

reason: &'static str

code: u32

BelowThreshold

Fewer than T distinct parties contributed to a signing round.

Fields

have: u32

need: u32

code: u32

MissingCommitment

A party’s commitment list is missing a required participant.

Fields

party: String

code: u32

InvalidShareSignature

A party’s share response failed verification against its commitment — proof of byzantine / malicious behavior.

Fields

party: String

code: u32

AggregateVerificationFailed

The aggregate signature failed verification. Indicates either a broken implementation or coalition-level misbehavior.

Fields

code: u32

MalformedShare

The local share supplied to a signing session is malformed.

Fields

reason: &'static str

code: u32

VssShareVerificationFailed

A VSS share received during DKG failed to verify against its sender’s commitment polynomial.

Fields

party: String

code: u32

RosterConfig

The roster is empty or has no party index for this party.

Fields

reason: &'static str

code: u32

MalformedMessage

A message could not be parsed at all.

Fields

reason: &'static str

code: u32

RoundOverflow

The session was driven past its last round.

Fields

round: u8

code: u32

SessionNotComplete

result() was called before the session completed.

Fields

code: u32

Implementations

impl FrostError

pub fn code(&self) -> u32

Stable sub-code for this error. Combined with FROST_ERROR_BASE it forms the value reported through the framework’s SchemeInternalError.

pub fn framework(self) -> Error

Convert into the framework’s SchemeInternalError with this scheme’s code in the low bits. Used at every session → framework boundary.

Trait Implementations

impl Debug for FrostError

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

Formats the value using the given formatter.

impl Display for FrostError

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

Formats the value using the given formatter.

impl Error for FrostError

where Self: Debug + Display,

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl ErrorCompat for FrostError

fn backtrace(&self) -> Option<&Backtrace>

Returns a Backtrace that may be printed.

fn iter_chain(&self) -> ChainCompat<'_, '_>

where Self: AsErrorSource,

Returns an iterator for traversing the chain of errors, starting with the current error and continuing with recursive calls to Error::source.

impl<__T0, __T1, __T2> IntoError<FrostError> for InvalidCommitmentSnafu<__T0, __T1, __T2>

where FrostError: Error + ErrorCompat, __T0: Into<String>, __T1: Into<&'static str>, __T2: Into<u32>,

type Source = NoneError

The underlying error

fn into_error(self, error: Self::Source) -> FrostError

Combine the information to produce the error

impl<__T0, __T1, __T2> IntoError<FrostError> for InvalidShareResponseSnafu<__T0, __T1, __T2>

where FrostError: Error + ErrorCompat, __T0: Into<String>, __T1: Into<&'static str>, __T2: Into<u32>,

type Source = NoneError

The underlying error

fn into_error(self, error: Self::Source) -> FrostError

Combine the information to produce the error

impl<__T0, __T1, __T2> IntoError<FrostError> for BelowThresholdSnafu<__T0, __T1, __T2>

where FrostError: Error + ErrorCompat, __T0: Into<u32>, __T1: Into<u32>, __T2: Into<u32>,

type Source = NoneError

The underlying error

fn into_error(self, error: Self::Source) -> FrostError

Combine the information to produce the error

impl<__T0, __T1> IntoError<FrostError> for MissingCommitmentSnafu<__T0, __T1>

where FrostError: Error + ErrorCompat, __T0: Into<String>, __T1: Into<u32>,

type Source = NoneError

The underlying error

fn into_error(self, error: Self::Source) -> FrostError

Combine the information to produce the error

impl<__T0, __T1> IntoError<FrostError> for InvalidShareSignatureSnafu<__T0, __T1>

where FrostError: Error + ErrorCompat, __T0: Into<String>, __T1: Into<u32>,

type Source = NoneError

The underlying error

fn into_error(self, error: Self::Source) -> FrostError

Combine the information to produce the error

impl<__T0> IntoError<FrostError> for AggregateVerificationFailedSnafu<__T0>

where FrostError: Error + ErrorCompat, __T0: Into<u32>,

type Source = NoneError

The underlying error

fn into_error(self, error: Self::Source) -> FrostError

Combine the information to produce the error

impl<__T0, __T1> IntoError<FrostError> for MalformedShareSnafu<__T0, __T1>

where FrostError: Error + ErrorCompat, __T0: Into<&'static str>, __T1: Into<u32>,

type Source = NoneError

The underlying error

fn into_error(self, error: Self::Source) -> FrostError

Combine the information to produce the error

impl<__T0, __T1> IntoError<FrostError> for VssShareVerificationFailedSnafu<__T0, __T1>

where FrostError: Error + ErrorCompat, __T0: Into<String>, __T1: Into<u32>,

type Source = NoneError

The underlying error

fn into_error(self, error: Self::Source) -> FrostError

Combine the information to produce the error

impl<__T0, __T1> IntoError<FrostError> for RosterConfigSnafu<__T0, __T1>

where FrostError: Error + ErrorCompat, __T0: Into<&'static str>, __T1: Into<u32>,

type Source = NoneError

The underlying error

fn into_error(self, error: Self::Source) -> FrostError

Combine the information to produce the error

impl<__T0, __T1> IntoError<FrostError> for MalformedMessageSnafu<__T0, __T1>

where FrostError: Error + ErrorCompat, __T0: Into<&'static str>, __T1: Into<u32>,

type Source = NoneError

The underlying error

fn into_error(self, error: Self::Source) -> FrostError

Combine the information to produce the error

impl<__T0, __T1> IntoError<FrostError> for RoundOverflowSnafu<__T0, __T1>

where FrostError: Error + ErrorCompat, __T0: Into<u8>, __T1: Into<u32>,

type Source = NoneError

The underlying error

fn into_error(self, error: Self::Source) -> FrostError

Combine the information to produce the error

impl<__T0> IntoError<FrostError> for SessionNotCompleteSnafu<__T0>

where FrostError: Error + ErrorCompat, __T0: Into<u32>,

type Source = NoneError

The underlying error

fn into_error(self, error: Self::Source) -> FrostError

Combine the information to produce the error