Enum VineError 

pub enum VineError {
    ClientNotConnected(String),
    ConnectionFailed {
        SideCarIdentifier: String,
        Address: String,
        Reason: String,
    },
    ConnectionLost(String),
    RPCError(String),
    RequestTimeout {
        SideCarIdentifier: String,
        MethodName: String,
        TimeoutMilliseconds: u64,
    },
    RequestCanceled {
        SideCarIdentifier: String,
        MethodName: String,
    },
    SerializationError(Error),
    MessageTooLarge {
        ActualSize: usize,
        MaxSize: usize,
    },
    InvalidMessageFormat(String),
    TonicTransportError(Error),
    InternalLockError(String),
    InvalidState(String),
    InvalidUri(InvalidUri),
    AddressParseError(AddrParseError),
}

A comprehensive error enum for the Vine IPC layer.

Each variant carries detailed context so callers can choose between retry, fallback, and surface-to-user strategies.

Variants

ClientNotConnected(String)

A gRPC client channel for the specified sidecar could not be found or is not ready in the connection pool.

ConnectionFailed

Failed to establish a connection to the specified sidecar.

Fields

SideCarIdentifier: String

Address: String

Reason: String

ConnectionLost(String)

An established connection to the sidecar was lost.

RPCError(String)

An RPC call to a sidecar failed with a specific gRPC status.

RequestTimeout

A request did not receive a response within the configured timeout.

Fields

SideCarIdentifier: String

MethodName: String

TimeoutMilliseconds: u64

RequestCanceled

A request was explicitly cancelled before completion.

Fields

SideCarIdentifier: String

MethodName: String

SerializationError(Error)

An error occurred while serializing or deserializing a JSON payload.

MessageTooLarge

Message exceeded the maximum allowed size.

Fields

ActualSize: usize

MaxSize: usize

InvalidMessageFormat(String)

Message format validation failed.

TonicTransportError(Error)

A low-level error occurred in the tonic gRPC transport layer.

InternalLockError(String)

A shared state mutex was “poisoned,” indicating a panic in another thread while holding the lock.

InvalidState(String)

Invalid internal state detected - the system reached an unexpected state that should never happen during normal operation.

InvalidUri(InvalidUri)

An error occurred from an invalid URI.

AddressParseError(AddrParseError)

An error occurred while parsing a socket address.

Implementations

impl VineError

pub fn IsRecoverable(&self) -> bool

Returns true when the error is recoverable (the caller can sensibly retry the operation).

pub fn ToTonicStatus(&self) -> Status

Maps the error to a tonic::Status suitable for a gRPC error response.

Trait Implementations

impl Debug for VineError

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

Formats the value using the given formatter.

impl Display for VineError

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

Formats the value using the given formatter.

impl Error for VineError

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<AddrParseError> for VineError

fn from(source: AddrParseError) -> Self

Converts to this type from the input type.

impl From<Error> for VineError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for VineError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<InvalidUri> for VineError

fn from(source: InvalidUri) -> Self

Converts to this type from the input type.

impl<T> From<PoisonError<MutexGuard<'_, T>>> for VineError

fn from(Error: PoisonError<MutexGuard<'_, T>>) -> Self

Converts to this type from the input type.

impl From<Status> for VineError

fn from(Status: Status) -> Self

Converts to this type from the input type.