Enum ForkError 

#[non_exhaustive]
pub enum ForkError {
    Transport(String),
    RpcError(String),
    RpcNoResult,
    Xdr(String),
    Base64(DecodeError),
    Json(Error),
    Cache {
        path: PathBuf,
        message: String,
    },
    Host(String),
    Workspace(String),
}

The crate’s unified error type.

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.

Transport(String)

A JSON-RPC HTTP request failed (network error, timeout, or non-success status after all retries).

RpcError(String)

The RPC endpoint returned a JSON-RPC level error object.

RpcNoResult

The RPC response was well-formed JSON but didn’t contain a result field (protocol violation on the server side).

Xdr(String)

An XDR payload failed to encode or decode. Usually indicates an incompatibility between the pinned stellar-xdr version and the protocol version the RPC server is serving.

Base64(DecodeError)

A base64 payload from the RPC failed to decode.

Json(Error)

JSON (de)serialization error.

Cache

Reading or writing the on-disk cache snapshot failed.

Fields

path: PathBuf

The path we were trying to read or write.

message: String

The underlying I/O-or-serialization error, stringified because soroban_ledger_snapshot returns a non-std::error::Error type for its file operations. Not named source so thiserror doesn’t confuse it with the error-chain source attribute.

Host(String)

An out-of-band operation on the underlying soroban-env-host failed.

Currently only emitted by super::ForkConfig::tracing when switching the host’s diagnostic level. Per-call contract failures surface as panics from Env::invoke_contract and never travel through this enum — that’s an SDK boundary we don’t reach across.

Workspace(String)

Building or locating a workspace member’s contract WASM failed.

Emitted by super::workspace_wasm when cargo metadata / cargo build fails, when the named crate isn’t a workspace member, or when the expected .wasm artifact is missing or unreadable after a successful build. The message carries the underlying cause verbatim — compilation errors from cargo surface as-is so the failing test reports them straight.

Trait Implementations

impl Debug for ForkError

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

Formats the value using the given formatter.

impl Display for ForkError

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

Formats the value using the given formatter.

impl Error for ForkError

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<DecodeError> for ForkError

fn from(source: DecodeError) -> Self

Converts to this type from the input type.

impl From<Error> for ForkError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ForkError

fn from(value: Error) -> Self

Converts to this type from the input type.