Enum sn_client::Error

#[non_exhaustive]
pub enum Error {
    AsymmetricDecipherFailure,
    SymmetricDecipherFailure,
    ReceivedUnexpectedData,
    ReceivedUnexpectedEvent,
    ElderQuery,
    ElderConnection,
    NotBootstrapped,
    InsufficientElderConnections(usize),
    ReceivingQuery,
    SendingQuery,
    QueryReceiverError,
    NoResponse,
    NoBlsSectionKey,
    NoSectionPrefixKnown,
    NoTransferValidationListener,
    UnexpectedMessageOnJoin(String),
    NotPublicPermissions,
    NotPrivatePermissions,
    NoElderListenerEstablished,
    IncorrectPermissions,
    UnexpectedTransferEvent(Event),
    UnexpectedQueryResponse(QueryResponse),
    UnexpectedHistoryResponse(QueryResponse),
    UnexpectedStoreCostResponse(QueryResponse),
    UnexpectedReplicaKeysResponse(PublicKey),
    NoTransferGenerated,
    NoTransferEventsForLocalActor,
    NotBuiltWithSimulatedPayouts,
    NetworkDataError(DtError),
    Transfer(TransfersError),
    ErrorMessage {
        source: ErrorMessage,
        msg_id: MessageId,
    },
    MessagingProtocol(MessagingError),
    SelfEncryption(SelfEncryptionError),
    ConfigError(Error),
    IoError(Error),
    QuicP2p(QuicP2pError),
    Serialisation(Box<ErrorKind>),
}

Client Errors

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.

AsymmetricDecipherFailure

Asymmetric Key Decryption Failed.

SymmetricDecipherFailure

Symmetric Key Decryption Failed.

ReceivedUnexpectedData

Received unexpected data.

ReceivedUnexpectedEvent

Received unexpected event.

ElderQuery

Could not query elder.

ElderConnection

Could not connect to elder.

NotBootstrapped

Client has not gone trhough qp2p bootstrap process yet

InsufficientElderConnections(usize)

Could not connect to sufficient elder to retrieve reliable responses.

ReceivingQuery

Could not query elder.

SendingQuery

Could not send query to elder.

QueryReceiverError

Could not query elder.

NoResponse

Could not query elder.

NoBlsSectionKey

No BLS section key known.

NoSectionPrefixKnown

No section prefix found for session

NoTransferValidationListener

No transfer validation listener .

UnexpectedMessageOnJoin(String)

Unexpected message type receivied while joining.

NotPublicPermissions

Permission set provided is not a PublicPermissionSet.

NotPrivatePermissions

Permission set provided is not a PrivatePermissionSet.

NoElderListenerEstablished

Did not receive an incoming connection listener from qp2p

IncorrectPermissions

Incorrect user permissions were returned

UnexpectedTransferEvent(Event)

Unexpcted transfer event received

UnexpectedQueryResponse(QueryResponse)

Unexpcted response received

UnexpectedHistoryResponse(QueryResponse)

Unexpected response received

UnexpectedStoreCostResponse(QueryResponse)

Unexpected response received

UnexpectedReplicaKeysResponse(PublicKey)

Unexpected response received

NoTransferGenerated

Transfer actor failed generating a transfer

NoTransferEventsForLocalActor

Transfer actor did not find any events to register locally

NotBuiltWithSimulatedPayouts

Not in testnet “simulated payout” mode

NetworkDataError(DtError)

Other sn_data_types errors

Transfer(TransfersError)

Transfers errors

ErrorMessage

Errors received from the network via sn_messaging

Fields of ErrorMessage

source: ErrorMessage

The source of an error message

msg_id: MessageId

Message ID that was used to send the query

MessagingProtocol(MessagingError)

Errors occurred when serialising or deserialising messages

SelfEncryption(SelfEncryptionError)

self_enryption errors

ConfigError(Error)

Other sn_data_types errors

IoError(Error)

Io error.

QuicP2p(QuicP2pError)

QuicP2p error.

Serialisation(Box<ErrorKind>)

Bincode error

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<(CmdError, MessageId)> for Error

fn from((error, msg_id): (CmdError, MessageId)) -> Self

Performs the conversion.

impl From<(Error, MessageId)> for Error

fn from((source, msg_id): (ErrorMessage, MessageId)) -> Self

Performs the conversion.

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

fn from(source: Box<ErrorKind>) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(source: DtError) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(source: TransfersError) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(source: MessagingError) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(source: Error) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(source: Error) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(source: QuicP2pError) -> Self

Performs the conversion.

impl From<SelfEncryptionError> for Error

fn from(source: SelfEncryptionError) -> Self

Performs the conversion.