Enum tor_netdoc::doc::hsdesc::HsDescError

#[non_exhaustive]
pub enum HsDescError {
    OuterParsing(Error),
    OuterValidation(Error),
    MissingDecryptionKey,
    WrongDecryptionKey,
    DecryptionFailed,
    InnerParsing(Error),
    InnerValidation(Error),
    Bug(Bug),
}

Available on crate feature hs-common only.

An error returned by HsDesc::parse_decrypt_validate, indicating what kind of failure prevented us from validating an onion service descriptor.

This is distinct from tor_netdoc::Error so that we can tell errors that could be the HsDir’s fault from those that are definitely protocol violations by the onion service.

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.

OuterParsing(Error)

An outer object failed parsing: the HsDir should probably have caught this, and not given us this HsDesc.

(This can be an innocent error if we happen to know about restrictions that the HsDir does not).

OuterValidation(Error)

An outer object failed validation: the HsDir should probably have caught this, and not given us this HsDesc.

(This can happen erroneously if we think that something is untimely but the HSDir’s clock is slightly different, or was different when it decided to give us this object.)

MissingDecryptionKey

Decrypting the inner layer failed because we need to have a decryption key, but we didn’t provide one.

This is probably our fault.

WrongDecryptionKey

Decrypting the inner layer failed because, although we provided a key, we did not provide the key we need to decrypt it.

This is probably our fault.

DecryptionFailed

Decrypting the inner or middle layer failed because of an issue with the decryption itself.

This is the onion service’s fault.

InnerParsing(Error)

We failed to parse something cryptographic in an inner layer of the onion service descriptor.

This is definitely the onion service’s fault.

InnerValidation(Error)

We failed to validate something cryptographic in an inner layer of the onion service descriptor.

This is definitely the onion service’s fault.

Bug(Bug)

We encountered an internal error.

Trait Implementations

impl Clone for HsDescError

fn clone(&self) -> HsDescError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for HsDescError

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

Formats the value using the given formatter.

impl Display for HsDescError

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

Formats the value using the given formatter.

impl Error for HsDescError

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

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<Bug> for HsDescError

fn from(source: Bug) -> Self

Converts to this type from the input type.

impl HasKind for HsDescError

fn kind(&self) -> ErrorKind

Return the kind of this error.