Enum VerificationError 

pub enum VerificationError {
    NoSignaturesField,
    MissingIssuerField,
    MissingSignatureField,
    RecordSerializationFailed {
        error: EncodeError,
    },
    SignatureVerificationFailed {
        error: Error,
    },
    NoValidSignatureForIssuer {
        issuer: String,
    },
    InvalidSignatureObjectType,
    SignatureObjectMissingField {
        field: String,
    },
    KeyOperationFailed {
        error: KeyError,
    },
    SignatureDecodingFailed {
        error: DecodeError,
    },
    CryptographicValidationFailed {
        error: KeyError,
    },
}

Errors that can occur during record signature creation and verification.

This enum covers all failure modes in the signature lifecycle, from creating signatures with missing metadata fields to verifying signatures with invalid cryptographic proofs or serialization failures.

Variants

NoSignaturesField

Error when no signatures field is found in the record.

This error occurs when a record does not contain either a “signatures” or “sigs” field, which is required for signature verification.

MissingIssuerField

Error when issuer field is missing from a signature object.

This error occurs when a signature object in the signatures array does not contain the required “issuer” field.

MissingSignatureField

Error when signature field is missing from a signature object.

This error occurs when a signature object in the signatures array does not contain the required “signature” field.

RecordSerializationFailed

Error when record serialization fails.

This error occurs when the signed record cannot be serialized to IPLD CBOR format for signature verification.

Fields

error: EncodeError

The underlying serialization error

SignatureVerificationFailed

Error when signature verification fails.

This error occurs when the cryptographic verification of the signature against the signed record fails, indicating the signature is invalid for the given data and public key.

Fields

error: Error

The underlying verification error

NoValidSignatureForIssuer

Error when no valid signature is found for the specified issuer.

This error occurs when none of the signatures in the record belong to the specified issuer, or when all signatures from the issuer fail verification.

Fields

issuer: String

The issuer DID for which no valid signature was found

InvalidSignatureObjectType

Error when signature object is not a valid JSON object.

This error occurs when the provided signature object parameter is not a JSON object type, which is required for signature creation.

SignatureObjectMissingField

Error when signature object is missing required fields.

This error occurs when the signature object is missing fields that are necessary during signature creation, such as ‘issuer’.

Fields

field: String

The name of the missing field

KeyOperationFailed

Error when cryptographic key operations fail.

This error occurs when key-related operations such as signing or key parsing fail during signature creation or verification.

Fields

error: KeyError

The underlying key operation error

SignatureDecodingFailed

Error when signature decoding fails.

This error occurs when the multibase-encoded signature cannot be decoded, typically due to invalid encoding format.

Fields

error: DecodeError

The underlying multibase decoding error

CryptographicValidationFailed

Error when cryptographic signature validation fails.

This error occurs when the cryptographic validation of the signature fails, indicating either an invalid signature or mismatched key/data.

Fields

error: KeyError

The underlying validation error

Trait Implementations

impl Debug for VerificationError

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

Formats the value using the given formatter.

impl Display for VerificationError

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

Formats the value using the given formatter.

impl Error for VerificationError

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 From<EncodeError> for VerificationError

fn from(source: EncodeError) -> Self

Converts to this type from the input type.

impl From<KeyError> for VerificationError

fn from(source: KeyError) -> Self

Converts to this type from the input type.