Enum ServerError 

pub enum ServerError {
    Valkey(Error),
    ValkeyContext {
        source: Error,
        context: String,
    },
    Config(ConfigError),
    LibraryLoad(LoadError),
    PartitionMismatch(String),
    NotFound(String),
    InvalidInput(String),
    OperationFailed(String),
    Script(String),
    ConcurrencyLimitExceeded(&'static str, u32),
    ValkeyVersionTooLow {
        detected: String,
        required: String,
    },
}

Server error type.

Variants

Valkey(Error)

Valkey connection or command error (preserves ErrorKind for caller inspection).

ValkeyContext

Valkey error with additional context (preserves ErrorKind via #[source]).

Fields

source: Error

context: String

Config(ConfigError)

LibraryLoad(LoadError)

PartitionMismatch(String)

NotFound(String)

InvalidInput(String)

OperationFailed(String)

Script(String)

ConcurrencyLimitExceeded(&'static str, u32)

Server-wide concurrency limit reached on a labelled pool. Surfaces as HTTP 429 at the REST boundary so load balancers and clients can retry with backoff. The source label (“stream_ops”, “admin_rotate”, etc.) identifies WHICH pool is exhausted so operators aren’t misled by a single “tail unavailable” string when the real fault is rotation contention.

Fields: (source_label, max_permits).

ValkeyVersionTooLow

Detected Valkey version is below the RFC-011 §13 minimum. The hash-slot co-location design and Valkey Functions API behavior the engine depends on were introduced/stabilized in 8.0; older versions silently behave differently on some cluster edge cases. Operator action: upgrade Valkey.

Fields

detected: String

required: String

Implementations

impl ServerError

pub fn valkey_kind(&self) -> Option<ErrorKind>

Returns the underlying ferriskey ErrorKind, if this error carries one. Covers direct Valkey variants and library-load failures that bubble a ferriskey::Error through LoadError::Valkey.

pub fn is_retryable(&self) -> bool

Whether this error is safely retryable by a caller. Semantics match ScriptError::class() == Retryable for Lua errors plus a kind-aware check for transport/library-load failures. Business-logic rejections (NotFound, InvalidInput, OperationFailed, Script, Config, PartitionMismatch) return false — those won’t change on retry.

Trait Implementations

impl Debug for ServerError

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

Formats the value using the given formatter.

impl Display for ServerError

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

Formats the value using the given formatter.

impl Error for ServerError

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<ConfigError> for ServerError

fn from(source: ConfigError) -> Self

Converts to this type from the input type.

impl From<Error> for ServerError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<LoadError> for ServerError

fn from(source: LoadError) -> Self

Converts to this type from the input type.