Enum ClientError 

#[non_exhaustive]
pub enum ClientError {
    Network(String),
    Framing(TransportError),
    CasMismatch {
        ref_name: String,
        expected: Cid,
        actual: Cid,
    },
    Auth(String),
    Protocol(String),
    Serde(String),
}

Errors raised by the async HTTP RemoteClient (only meaningful with the client feature). Kept separate from TransportError so the pure-sync CAR surface stays free of async / reqwest types.

Variants split the failure modes a caller cares about:

• Network - the HTTP request never reached a response (DNS, TLS, connect, body-read mid-flight). Retryable at the caller’s discretion.
• Framing - the response arrived but the CAR body was malformed. Not retryable on the same URL without a server fix; wraps the pure-sync TransportError.
• CasMismatch - the server rejected advance-head because the stored old CID no longer matches the one the client sent. Caller must refresh refs and retry.
• Auth - 401 / 403 on a push endpoint. The bearer token is missing, expired, or lacks the required capability.
• Protocol - the server responded with an unexpected status code, missing header, or a mnem-protocol version mismatch.

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.

Network(String)

Underlying HTTP request failed before a complete response was received (connect, TLS handshake, mid-body socket close, …).

Framing(TransportError)

CAR body received but failed framing / CID verification.

CasMismatch

advance-head rejected: the stored old value drifted between the client’s read and its write. Caller refreshes refs and retries.

Fields

ref_name: String

Ref name the client tried to advance (e.g. main).

expected: Cid

old CID the client sent.

actual: Cid

old CID the server actually holds.

Auth(String)

401 / 403 on a push endpoint. The bearer token is missing, expired, or lacks the required capability.

Protocol(String)

Server responded with an unexpected status code, missing header, or mnem-protocol version mismatch.

Serde(String)

JSON serialisation or deserialisation failed. Only raised by the client feature.

Trait Implementations

impl Debug for ClientError

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

Formats the value using the given formatter.

impl Display for ClientError

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

Formats the value using the given formatter.

impl Error for ClientError

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 ClientError

Available on crate feature client only.

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ClientError

Available on crate feature client only.

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<TransportError> for ClientError

fn from(source: TransportError) -> Self

Converts to this type from the input type.