Enum qp2p::Error

#[non_exhaustive]
pub enum Error {
    BootstrapFailure,
    EmptyBootstrapNodesList,
    InvalidPath(String),
    UserHomeDir,
    Io(Error),
    Connect(ConnectError),
    Connection(ConnectionError),
    Endpoint(EndpointError),
    CertificateParse,
    CertificatePkParse,
    NoEchoServerEndpointDefined,
    NoEchoServiceResponse,
    EchoServiceFailure(String),
    Tls(TLSError),
    Serialisation(Error),
    Base64Decode(DecodeError),
    Configuration(String),
    InvalidMsgFlag(u8),
    StreamWrite(WriteError),
    StreamRead(ReadExactError),
    IgdAddPort(AddAnyPortError),
    IgdRenewPort(AddPortError),
    IgdSearch(SearchError),
    IgdNotSupported,
    CertificateGen(RcgenError),
    EmptyResponse,
    UnexpectedMessageType(WireMsg),
    MaxLengthExceeded(usize),
    IncorrectPublicAddress,
    MissingConnection,
    UnexpectedError(String),
    UnspecifiedLocalIp,
    UnresolvedPublicIp,
}

Error types returned by the qp2p public API.

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.

BootstrapFailure

Error occurred when attempting to connect to any of the peers provided as a list of contacts.

EmptyBootstrapNodesList

No peers/contacts found in the bootstrap nodes list.

InvalidPath(String)

The path provided is not valid for the operation.

UserHomeDir

The user’s home directory couldn’t be determined.

Io(Error)

I/O failure when attempting to access a local resource.

Connect(ConnectError)

Failure encountered when establishing a connection with another peer.

Connection(ConnectionError)

An existing connection with another peer has been lost.

Endpoint(EndpointError)

Failed to create a new endpoint.

CertificateParse

Certificate for secure communication couldn’t be parsed.

CertificatePkParse

The certificate’s private key for secure communication couldn’t be parsed.

NoEchoServerEndpointDefined

The contacts list was found empty when attempting to contact peers for the echo service.

NoEchoServiceResponse

Timeout occurred when awaiting for a response from any of the peers contacted for the echo service.

EchoServiceFailure(String)

Failure occurred when sending an echo request.

Tls(TLSError)

TLS error

Serialisation(Error)

Serialisation error, which can happen on different type of data.

Base64Decode(DecodeError)

Failed to decode a base64-encoded string.

Configuration(String)

An error occurred which could be resolved by changing some config value.

InvalidMsgFlag(u8)

The message type flag decoded in an incoming stream is invalid/unsupported.

StreamWrite(WriteError)

Error occurred when trying to write on a currently opened message stream.

StreamRead(ReadExactError)

The expected amount of message bytes couldn’t be read from the stream.

IgdAddPort(AddAnyPortError)

Failure when trying to map a new port using IGD for automatic port forwarding.

IgdRenewPort(AddPortError)

Failure when trying to renew leasing of a port mapped using IGD.

IgdSearch(SearchError)

IGD gateway deice was not found.

IgdNotSupported

IGD is not supported on IPv6

CertificateGen(RcgenError)

An error was encountered when trying to either generate or serialise a self-signed certificate.

EmptyResponse

Response message received contains an empty payload.

UnexpectedMessageType(WireMsg)

The type of message received is not the expected one.

MaxLengthExceeded(usize)

The message exceeds the maximum message length allowed.

IncorrectPublicAddress

Incorrect Public Address provided

MissingConnection

Missing connection

UnexpectedError(String)

A supposedly impossible internal error occurred

UnspecifiedLocalIp

Unspecified local IP address

UnresolvedPublicIp

Couldn’t resolve Public IP address

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

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

impl From<AddAnyPortError> for Error

fn from(source: AddAnyPortError) -> Self

Performs the conversion.

impl From<AddPortError> for Error

fn from(source: AddPortError) -> Self

Performs the conversion.

impl From<Box<ErrorKind, Global>> for Error

fn from(source: Error) -> Self

Performs the conversion.

impl From<ConnectError> for Error

fn from(source: ConnectError) -> Self

Performs the conversion.

impl From<ConnectionError> for Error

fn from(source: ConnectionError) -> Self

Performs the conversion.

impl From<DecodeError> for Error

fn from(source: DecodeError) -> Self

Performs the conversion.

impl From<EndpointError> for Error

fn from(source: EndpointError) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(source: Error) -> Self

Performs the conversion.

impl From<RcgenError> for Error

fn from(source: RcgenError) -> Self

Performs the conversion.

impl From<ReadExactError> for Error

fn from(source: ReadExactError) -> Self

Performs the conversion.

impl From<SearchError> for Error

fn from(source: SearchError) -> Self

Performs the conversion.

impl From<TLSError> for Error

fn from(source: TLSError) -> Self

Performs the conversion.

impl From<WriteError> for Error

fn from(source: WriteError) -> Self

Performs the conversion.