Enum Error 

pub enum Error {
    Network(String),
    Storage(String),
    Payment(String),
    Protocol(String),
    RemotePut {
        address: String,
        source: ProtocolError,
    },
    InvalidData(String),
    Serialization(String),
    Crypto(String),
    Io(Error),
    Config(String),
    Timeout(String),
    InsufficientPeers(String),
    SignatureVerification(String),
    Encryption(String),
    Cancelled(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,
        spend: Box<PartialUploadSpend>,
        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.

RemotePut

A remote node rejected a chunk PUT at the application layer.

The node responded with a structured ProtocolError, so the transport round-trip succeeded — this is an application-level rejection (payment-failed, storage/disk-full, quote-stale, merkle-pool-rejected), NOT evidence the client is sending too fast. It therefore classifies as Outcome::ApplicationError (see classify_error) and does not push the adaptive store limiter down. The structured source is preserved (rather than flattened into Protocol) so the controller — and a future full-node skip-list (V2-469) — can key on the reason.

Fields

address: String

Hex-encoded chunk address the rejection was for.

source: ProtocolError

The structured remote rejection reason.

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.

Cancelled(String)

The operation was cancelled by the caller rather than failing.

Returned, for example, by streaming downloads when the consumer drops its receiver (a client disconnect) — distinct from a transport Error::Network failure, since nothing went wrong on the wire.

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.

spend: Box<PartialUploadSpend>

On-chain spend incurred so far. Boxed to keep the Error enum small (the variant is returned in Result across the crate; without the box the two cost fields would trip clippy::result_large_err).

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.