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 provides detailed context about the failure, enabling precise error handling and recovery strategies.

Variants

ClientNotConnected(String)

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

This typically occurs when trying to send a request to a sidecar that was never connected or has been disconnected.

ConnectionFailed

Failed to establish a connection to the specified sidecar.

This indicates that connection attempts failed, possibly due to network issues, incorrect address, or the sidecar being unavailable.

Fields

SideCarIdentifier: String

Address: String

Reason: String

ConnectionLost(String)

An established connection to the sidecar was lost.

This occurs when an active connection fails during communication.

RPCError(String)

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

This wraps tonic::Status errors with more context about what went wrong.

RequestTimeout

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

Includes the sidecar identifier, method name, and timeout duration for debugging and retry logic.

Fields

SideCarIdentifier: String

MethodName: String

TimeoutMilliseconds: u64

RequestCanceled

A request was explicitly canceled before completion.

Fields

SideCarIdentifier: String

MethodName: String

SerializationError(Error)

An error occurred while serializing or deserializing a JSON payload.

This is automatically converted from serde_json::Error when using the ? operator.

MessageTooLarge

Message exceeded maximum allowed size.

This prevents denial-of-service attacks via oversized messages.

Fields

ActualSize: usize

MaxSize: usize

InvalidMessageFormat(String)

Message format validation failed.

This occurs when a message doesn’t conform to expected structure.

TonicTransportError(Error)

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

This is automatically converted from tonic::transport::Error.

InternalLockError(String)

A shared state mutex was "poisoned," indicating a panic.

This is a critical error indicating that a thread panicked while holding a lock, leaving the shared state in an inconsistent state.

InvalidState(String)

Invalid internal state detected.

This occurs when the system is in an unexpected state that should never happen during normal operation.

InvalidUri(InvalidUri)

An error occurred from an invalid URI.

This is automatically converted from http::uri::InvalidUri.

AddressParseError(AddrParseError)

An error occurred while parsing a socket address.

This is automatically converted from std::net::AddrParseError.

Implementations

impl VineError

pub fn IsRecoverable(&self) -> bool

Checks if this error is recoverable (can retry the operation).

Recoverable errors include timeouts, connection issues, and temporary failures. Non-recoverable errors include serialization errors and invalid state.

pub fn ToTonicStatus(&self) -> Status

Converts the error to a tonic::Status for gRPC error responses.

This maps VineError variants to appropriate gRPC status codes:

• RequestTimeout → DeadlineExceeded
• ClientNotConnected → Unavailable
• SerializationError → Internal
• etc.

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.