Enum HoprLibError 

pub enum HoprLibError {
    GeneralError(String),
    BuilderError(&'static str),
    ConfigurationError(ValidationErrors),
    ChainError(Error),
    NotReady(HoprState, String),
    Timeout {
        context: String,
    },
    InsufficientFunds(String),
    TransportError(HoprTransportError),
    NetworkTypeError(NetworkTypeError),
    Other(Error),
}

Enumeration of errors thrown from this library.

Consumers should prefer matching on specific variants over catching GeneralError. Transport and network sub-variant types (HoprTransportError, ProbeError, ProtocolError, NetworkTypeError) are re-exported from this module for convenient pattern matching.

Variants

GeneralError(String)

A general-purpose error with a descriptive message.

Prefer matching on specific variants when possible.

BuilderError(&'static str)

The Hopr object could not be built due to a missing component.

ConfigurationError(ValidationErrors)

The node configuration failed validation.

ChainError(Error)

An error originating from the blockchain/chain connector layer.

The inner error is type-erased because the chain connector is injected via trait objects. Use the Display output for diagnostics.

NotReady(HoprState, String)

The node is not in the required operational state.

Contains the current [HoprState] and a message describing what was expected. REST API consumers typically map this to HTTP 412 Precondition Failed.

Timeout

An operation timed out.

Fields

context: String

Description of what timed out and how long it waited.

InsufficientFunds(String)

The node’s wallet has insufficient native token balance.

TransportError(HoprTransportError)

An error from the transport layer (messaging, sessions, probing).

Sub-variant types ProtocolError and ProbeError are re-exported from this module for convenient pattern matching.

NetworkTypeError(NetworkTypeError)

A network-layer type error (address parsing, sealed targets, IO).

The NetworkTypeError type is re-exported from this module.

Other(Error)

An unclassified internal error.

Used for subsystems where a typed error variant does not exist. Use the Display output for diagnostics.

Implementations

impl HoprLibError

pub fn chain<E: Into<Error>>(e: E) -> Self

pub fn other(e: impl Into<Error>) -> Self

Trait Implementations

impl Debug for HoprLibError

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

Formats the value using the given formatter.

impl Display for HoprLibError

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

Formats the value using the given formatter.

impl Error for HoprLibError

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<HoprTransportError> for HoprLibError

fn from(source: HoprTransportError) -> Self

Converts to this type from the input type.

impl From<NetworkTypeError> for HoprLibError

fn from(source: NetworkTypeError) -> Self

Converts to this type from the input type.

impl From<ValidationErrors> for HoprLibError

fn from(source: ValidationErrors) -> Self

Converts to this type from the input type.