Enum Error

#[non_exhaustive]
pub enum Error<C: Ciphersuite> {
    InvalidMinSigners,
    InvalidMaxSigners,
    InvalidCoefficients,
    MalformedIdentifier,
    DuplicatedIdentifier,
    UnknownIdentifier,
    IncorrectNumberOfIdentifiers,
    MalformedSigningKey,
    MalformedVerifyingKey,
    MalformedSignature,
    InvalidSignature,
    DuplicatedShares,
    IncorrectNumberOfShares,
    IdentityCommitment,
    MissingCommitment,
    IncorrectCommitment,
    IncorrectNumberOfCommitments,
    InvalidSignatureShare {
        culprit: Identifier<C>,
    },
    InvalidSecretShare {
        culprit: Option<Identifier<C>>,
    },
    PackageNotFound,
    IncorrectNumberOfPackages,
    IncorrectPackage,
    DKGNotSupported,
    InvalidProofOfKnowledge {
        culprit: Identifier<C>,
    },
    FieldError(FieldError),
    GroupError(GroupError),
    InvalidCoefficient,
    IdentifierDerivationNotSupported,
    SerializationError,
    DeserializationError,
}

An error related to FROST.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

InvalidMinSigners

min_signers is invalid

InvalidMaxSigners

max_signers is invalid

InvalidCoefficients

max_signers is invalid

MalformedIdentifier

This identifier is unserializable.

DuplicatedIdentifier

This identifier is duplicated.

UnknownIdentifier

This identifier does not belong to a participant in the signing process.

IncorrectNumberOfIdentifiers

Incorrect number of identifiers.

MalformedSigningKey

The encoding of a signing key was malformed.

MalformedVerifyingKey

The encoding of a verifying key was malformed.

MalformedSignature

The encoding of a signature was malformed.

InvalidSignature

Signature verification failed.

DuplicatedShares

Duplicated shares provided

IncorrectNumberOfShares

Incorrect number of shares.

IdentityCommitment

Commitment equals the identity

MissingCommitment

The participant’s commitment is missing from the Signing Package

IncorrectCommitment

The participant’s commitment is incorrect

IncorrectNumberOfCommitments

Incorrect number of commitments.

InvalidSignatureShare

Signature share verification failed.

Fields

culprit: Identifier<C>

The identifier of the signer whose share validation failed.

InvalidSecretShare

Secret share verification failed.

Fields

culprit: Option<Identifier<C>>

The identifier of the signer whose secret share validation failed, if possible to identify.

PackageNotFound

Round 1 package not found for Round 2 participant.

IncorrectNumberOfPackages

Incorrect number of packages.

IncorrectPackage

The incorrect package was specified.

DKGNotSupported

The ciphersuite does not support DKG.

InvalidProofOfKnowledge

The proof of knowledge is not valid.

Fields

culprit: Identifier<C>

The identifier of the signer whose share validation failed.

FieldError(FieldError)

Error in scalar Field.

GroupError(GroupError)

Error in elliptic curve Group.

InvalidCoefficient

Error in coefficient commitment deserialization.

IdentifierDerivationNotSupported

The ciphersuite does not support deriving identifiers from strings.

SerializationError

Error serializing value.

DeserializationError

Error deserializing value.

Implementations

impl<C> Error<C>

where C: Ciphersuite,

pub fn culprit(&self) -> Option<Identifier<C>>

Return the identifier of the participant that caused the error. Returns None if not applicable for the error.

This can be used to penalize a participant that does not follow the protocol correctly, e.g. removing them from further signings.

Trait Implementations

impl<C: Clone + Ciphersuite> Clone for Error<C>

fn clone(&self) -> Error<C>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<C: Debug + Ciphersuite> Debug for Error<C>

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

Formats the value using the given formatter.

impl<C: Ciphersuite> Display for Error<C>

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

Formats the value using the given formatter.

impl<C: Ciphersuite> Error for Error<C>

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<C: Ciphersuite> From<FieldError> for Error<C>

fn from(source: FieldError) -> Self

Converts to this type from the input type.

impl<C: Ciphersuite> From<GroupError> for Error<C>

fn from(source: GroupError) -> Self

Converts to this type from the input type.

impl<C: PartialEq + Ciphersuite> PartialEq for Error<C>

fn eq(&self, other: &Error<C>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<C: Copy + Ciphersuite> Copy for Error<C>

impl<C: Eq + Ciphersuite> Eq for Error<C>

impl<C: Ciphersuite> StructuralPartialEq for Error<C>