Enum Error 

pub enum Error {
    Network(String),
    Storage(String),
    Payment(String),
    Protocol(String),
    InvalidData(String),
    Serialization(String),
    Crypto(String),
    Io(Error),
    Config(String),
    Timeout(String),
    InsufficientPeers(String),
    SignatureVerification(String),
    Encryption(String),
    AlreadyStored,
    BadQuoteBinding {
        peer_id: String,
        detail: String,
    },
    InsufficientDiskSpace(String),
    CostEstimationInconclusive(String),
    PartialUpload {
        stored: Vec<[u8; 32]>,
        stored_count: usize,
        failed: Vec<([u8; 32], String)>,
        failed_count: usize,
        total_chunks: usize,
        reason: String,
    },
}

Errors that can occur in data operations.

Variants

Network(String)

Network operation failed.

Storage(String)

Storage operation failed.

Payment(String)

Payment operation failed.

Protocol(String)

Protocol error.

InvalidData(String)

Invalid data received.

Serialization(String)

Serialization error.

Crypto(String)

Cryptographic error.

Io(Error)

I/O error.

Config(String)

Configuration error.

Timeout(String)

Timeout waiting for a response.

InsufficientPeers(String)

Insufficient peers for the operation.

SignatureVerification(String)

BLS signature verification failed.

Encryption(String)

Self-encryption operation failed.

AlreadyStored

Data already exists on the network — no payment needed.

BadQuoteBinding

A peer’s quote pub_key does not BLAKE3-hash to the peer ID. The storer would reject any ProofOfPayment containing this quote, so the client drops the response before payment.

Fields

peer_id: String

The peer ID we got the quote from (claimed identity).

detail: String

Diagnostic detail (e.g. “BLAKE3(pub_key) = …, peer_id = …”).

InsufficientDiskSpace(String)

Not enough disk space for the operation.

CostEstimationInconclusive(String)

Cost estimation could not reach a representative quote.

Returned by crate::data::Client::estimate_upload_cost when every sampled chunk address reported AlreadyStored, so the network price for the remainder of the file cannot be inferred from a sample. The attached message describes how many addresses were tried.

PartialUpload

Upload partially succeeded – some chunks stored, some failed after retries.

The stored addresses can be used for progress tracking and resume.

Fields

stored: Vec<[u8; 32]>

Addresses of successfully stored chunks.

stored_count: usize

Number of successfully stored chunks.

failed: Vec<([u8; 32], String)>

Addresses and error messages of chunks that failed after retries.

failed_count: usize

Number of failed chunks.

total_chunks: usize

Total number of chunks the upload was attempting to store.

reason: String

Root cause description.

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)>

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<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.