Enum WebVHDIDError 

pub enum WebVHDIDError {
    InvalidDIDPrefix,
    MissingSCID,
    MissingHostname,
    HttpRequestFailed {
        url: String,
        error: Error,
    },
    LogEntryParseFailed {
        line: usize,
        details: String,
    },
    EmptyLog,
    InvalidVersionId {
        entry: usize,
        details: String,
    },
    VersionTimeNotMonotonic {
        entry: usize,
    },
    SCIDVerificationFailed,
    EntryHashVerificationFailed {
        entry: usize,
    },
    ProofVerificationFailed {
        entry: usize,
        details: String,
    },
    PreRotationKeyMismatch {
        entry: usize,
    },
    InvalidParameters {
        entry: usize,
        details: String,
    },
    WitnessVerificationFailed {
        entry: usize,
        details: String,
    },
    DocumentExtractionFailed {
        details: String,
    },
    InvalidSCIDFormat {
        details: String,
    },
    DeactivatedDID {
        did: String,
    },
    VersionNotFound {
        details: String,
    },
    VersionTimeInFuture {
        entry: usize,
        version_time: String,
    },
    DIDDocIdMismatch {
        entry: usize,
        expected: String,
        found: String,
    },
    UnsupportedHashAlgorithm {
        details: String,
    },
    UnknownParameter {
        entry: usize,
        parameter: String,
    },
    HostnameNormalizationFailed {
        details: String,
    },
    GenesisCreationFailed {
        details: String,
    },
    UpdateCreationFailed {
        details: String,
    },
    SigningFailed {
        details: String,
    },
}

Error types that can occur when working with WebVH DIDs

Variants

InvalidDIDPrefix

Occurs when the DID is missing the ‘did:webvh:’ prefix

MissingSCID

Occurs when the DID is missing a SCID component

MissingHostname

Occurs when the DID is missing a hostname component

HttpRequestFailed

Occurs when the HTTP request to fetch the DID log fails

Fields

url: String

The URL that was requested

error: Error

The underlying HTTP error

LogEntryParseFailed

Occurs when a log entry cannot be parsed from the JSONL response

Fields

line: usize

The line number (1-indexed) that failed to parse

details: String

Details about the parse failure

EmptyLog

Occurs when the DID log file is empty

InvalidVersionId

Occurs when a version ID is invalid or has incorrect format

Fields

entry: usize

The entry number (1-indexed) with the invalid version ID

details: String

Details about the validation failure

VersionTimeNotMonotonic

Occurs when version times are not monotonically increasing

Fields

entry: usize

The entry number (1-indexed) with the non-monotonic timestamp

SCIDVerificationFailed

Occurs when the SCID does not match the computed value from the genesis entry

EntryHashVerificationFailed

Occurs when an entry’s hash does not match the expected value in the version ID

Fields

entry: usize

The entry number (1-indexed) with the hash mismatch

ProofVerificationFailed

Occurs when a Data Integrity proof cannot be verified

Fields

entry: usize

The entry number (1-indexed) with the failed proof

details: String

Details about the verification failure

PreRotationKeyMismatch

Occurs when pre-rotation key hashes do not match

Fields

entry: usize

The entry number (1-indexed) with the key mismatch

InvalidParameters

Occurs when log entry parameters are invalid

Fields

entry: usize

The entry number (1-indexed) with the invalid parameters

details: String

Details about the validation failure

WitnessVerificationFailed

Occurs when witness verification fails

Fields

entry: usize

The entry number (1-indexed) with the failed witness verification

details: String

Details about the verification failure

DocumentExtractionFailed

Occurs when the DID document cannot be extracted from the log state

Fields

details: String

Details about the extraction failure

InvalidSCIDFormat

Occurs when the SCID format is invalid

Fields

details: String

Details about the format violation

DeactivatedDID

Occurs when the resolved DID has been deactivated

Fields

did: String

The deactivated DID

VersionNotFound

Occurs when a requested version is not found in the log

Fields

details: String

Details about the lookup that failed

VersionTimeInFuture

Occurs when a version time is in the future

Fields

entry: usize

The entry number (1-indexed) with the future timestamp

version_time: String

The future timestamp value

DIDDocIdMismatch

Occurs when the DIDDoc id does not match the DID

Fields

entry: usize

The entry number (1-indexed) with the mismatch

expected: String

The expected DID

found: String

The actual id found in the DIDDoc

UnsupportedHashAlgorithm

Occurs when the hash algorithm in the SCID is not supported

Fields

details: String

Details about the unsupported algorithm

UnknownParameter

Occurs when an unknown parameter is found in a log entry

Fields

entry: usize

The entry number (1-indexed) with the unknown parameter

parameter: String

The unknown parameter name

HostnameNormalizationFailed

Occurs when hostname normalization fails

Fields

details: String

Details about the normalization failure

GenesisCreationFailed

Occurs when genesis document creation fails

Fields

details: String

Details about the creation failure

UpdateCreationFailed

Occurs when update entry creation fails

Fields

details: String

Details about the creation failure

SigningFailed

Occurs when signing a log entry fails

Fields

details: String

Details about the signing failure

Implementations

impl WebVHDIDError

pub fn to_resolution_error(&self) -> ResolutionError

Converts this error to a spec-compliant resolution error.

Trait Implementations

impl Debug for WebVHDIDError

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

Formats the value using the given formatter.

impl Display for WebVHDIDError

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

Formats the value using the given formatter.

impl Error for WebVHDIDError

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.