Enum ServerError 

pub enum ServerError {
    Io(Error),
    Json(Error),
    RequestBodyRead(Error),
    RequestBodyTooLarge,
    RequestQueryTooLarge,
    RequestBodyFrameOutOfBounds,
    NumericConversion(TryFromIntError),
    HashParse(HashParseError),
    ObjectStore(ObjectStoreError),
    Index(IndexError),
    StoredFileMetadataTooLarge {
        observed_bytes: u64,
        maximum_bytes: u64,
    },
    StoredFileMetadataLengthMismatch,
    InvalidFileId,
    InvalidContentHash,
    InvalidXorbPrefix,
    XorbHashMismatch,
    InvalidSerializedXorb,
    InvalidSerializedShard(InvalidSerializedShardError),
    MissingReferencedXorb,
    TooManyShardTerms,
    TooManyBatchReconstructionFileIds,
    NotFound,
    Overflow,
    InvalidRangeHeader,
    RangeNotSatisfiable,
    MissingAuthorization,
    InvalidAuthorizationHeader,
    InvalidToken(TokenCodecError),
    InsufficientScope,
    ProviderTokensDisabled,
    MissingProviderApiKey,
    InvalidProviderApiKey,
    MissingProviderSubject,
    InvalidProviderTokenRequest,
    MissingProviderWebhookAuthentication,
    InvalidProviderWebhookAuthentication,
    InvalidProviderWebhookPayload,
    UnknownProvider,
    ProviderDenied,
    Provider(ProviderServiceError),
    ReconstructionCache(ReconstructionCacheError),
    Config(ServerConfigError),
    ExpectedBodyHashMismatch,
    InvalidDigest,
    InvalidRepositoryName,
    InvalidManifestReference,
    NotAcceptable,
    UnauthorizedChallenge(String),
    InvalidUploadSession,
    TooManyUploadSessions,
    TooManyRegistryTokenRequests,
    MissingReconstructionCacheRedisUrl,
    TransferLimiterClosed,
    BlockingTask(JoinError),
}

Server runtime failure.

This is the unified error type for the Shardline server layer. It maps domain-specific errors from storage, indexing, protocol, auth, and OCI subsystems into a single enum with HTTP status code mapping.

Design

Each variant maps to exactly one HTTP status code via ServerError::status_code. Subsystem errors (e.g., LocalIndexStoreError, S3ObjectStoreError) are converted via From implementations for ergonomic ? usage.

When adding new error sources, prefer adding a new variant with a #[from] attribute over manual From implementations unless the source error maps to multiple variants.

Variants

Io(Error)

Local storage IO failed.

Json(Error)

JSON serialization or deserialization failed.

RequestBodyRead(Error)

Request body streaming failed.

RequestBodyTooLarge

Request body exceeded the configured maximum accepted byte count.

RequestQueryTooLarge

Request query exceeded the bounded metadata parser budget.

RequestBodyFrameOutOfBounds

Request body frame slicing exceeded checked bounds.

NumericConversion(TryFromIntError)

Numeric conversion exceeded supported bounds.

HashParse(HashParseError)

Hash parsing failed.

ObjectStore(ObjectStoreError)

Object-storage subsystem failure.

Index(IndexError)

Metadata index subsystem failure.

StoredFileMetadataTooLarge

Stored file metadata exceeded the bounded parser ceiling.

Fields

observed_bytes: u64

Observed file length in bytes.

maximum_bytes: u64

Maximum accepted file length in bytes.

StoredFileMetadataLengthMismatch

Stored file metadata changed after bounded validation.

InvalidFileId

A file identifier was unsafe.

InvalidContentHash

A content hash was malformed.

InvalidXorbPrefix

The xorb transfer path prefix was unsupported.

XorbHashMismatch

The uploaded xorb bytes did not match the requested hash.

InvalidSerializedXorb

The uploaded xorb bytes were not a valid serialized xorb object.

InvalidSerializedShard(InvalidSerializedShardError)

The uploaded shard bytes were not a valid serialized shard object.

MissingReferencedXorb

A shard upload referenced a missing xorb.

TooManyShardTerms

Shard metadata exceeded bounded parser safety limits.

TooManyBatchReconstructionFileIds

Batch reconstruction requested too many file identifiers.

NotFound

Requested content was not found.

Overflow

Arithmetic overflowed a checked bound.

InvalidRangeHeader

The reconstruction range header was malformed.

RangeNotSatisfiable

The reconstruction range start exceeded the end of the file.

MissingAuthorization

The request did not include an authorization header.

InvalidAuthorizationHeader

The authorization header was malformed.

InvalidToken(TokenCodecError)

The bearer token was invalid.

InsufficientScope

The bearer token did not grant the required scope.

ProviderTokensDisabled

The provider issuance endpoint is not configured.

MissingProviderApiKey

The provider bootstrap key was missing.

InvalidProviderApiKey

The provider bootstrap key was invalid.

MissingProviderSubject

The provider subject was missing from a bootstrap request.

InvalidProviderTokenRequest

The provider token issuance request contained invalid bounded metadata.

MissingProviderWebhookAuthentication

The provider webhook authentication header was missing.

InvalidProviderWebhookAuthentication

The provider webhook authentication header was invalid.

InvalidProviderWebhookPayload

The provider webhook payload was invalid.

UnknownProvider

The requested provider is not configured.

ProviderDenied

Provider authorization denied the request.

Provider(ProviderServiceError)

Provider token issuance failed due to configuration or adapter errors.

ReconstructionCache(ReconstructionCacheError)

Reconstruction cache adapter access failed.

Config(ServerConfigError)

Server configuration was invalid for the selected runtime surface.

ExpectedBodyHashMismatch

The uploaded body did not match the expected SHA-256 identifier.

InvalidDigest

A digest string was malformed.

InvalidRepositoryName

A repository name or namespace path was malformed.

InvalidManifestReference

A manifest reference or tag was malformed.

NotAcceptable

The requested representation does not match any accepted media type.

UnauthorizedChallenge(String)

The request requires a protocol-specific authentication challenge.

InvalidUploadSession

An upload session identifier was malformed.

TooManyUploadSessions

Too many OCI upload sessions are currently active.

TooManyRegistryTokenRequests

Too many OCI registry token exchanges are currently active.

MissingReconstructionCacheRedisUrl

Redis reconstruction cache was selected without a URL.

TransferLimiterClosed

The transfer concurrency limiter was unexpectedly unavailable.

BlockingTask(JoinError)

A blocking worker task failed before it could finish storage work.

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

fn from(error: AuthError) -> Self

Converts to this type from the input type.

impl From<Error> for ServerError

fn from(source: IoError) -> Self

Converts to this type from the input type.

impl From<Error> for ServerError

fn from(source: JsonError) -> Self

Converts to this type from the input type.

impl From<FileRecordInvariantError> for ServerError

fn from(e: FileRecordInvariantError) -> Self

Converts to this type from the input type.

impl From<FsckError> for ServerError

fn from(value: FsckError) -> Self

Converts to this type from the input type.

impl From<GcError> for ServerError

fn from(err: GcError) -> Self

Converts to this type from the input type.

impl From<HashParseError> for ServerError

fn from(source: HashParseError) -> Self

Converts to this type from the input type.

impl From<HttpRangeParseError> for ServerError

fn from(value: HttpRangeParseError) -> Self

Converts to this type from the input type.

impl From<InvalidLifecycleMetadataError> for ServerError

fn from(e: InvalidLifecycleMetadataError) -> Self

Converts to this type from the input type.

impl From<InvalidReconstructionResponseError> for ServerError

fn from(e: InvalidReconstructionResponseError) -> Self

Converts to this type from the input type.

impl From<InvalidSerializedShardError> for ServerError

fn from(source: InvalidSerializedShardError) -> Self

Converts to this type from the input type.

impl From<LocalIndexStoreError> for ServerError

fn from(e: LocalIndexStoreError) -> Self

Converts to this type from the input type.

impl From<LocalObjectStoreError> for ServerError

fn from(e: LocalObjectStoreError) -> Self

Converts to this type from the input type.

impl From<MemoryIndexStoreError> for ServerError

fn from(e: MemoryIndexStoreError) -> Self

Converts to this type from the input type.

impl From<MemoryRecordStoreError> for ServerError

fn from(e: MemoryRecordStoreError) -> Self

Converts to this type from the input type.

impl From<ObjectPrefixError> for ServerError

fn from(e: ObjectPrefixError) -> Self

Converts to this type from the input type.

impl From<OciAdapterError> for ServerError

fn from(value: OciAdapterError) -> Self

Converts to this type from the input type.

impl From<ParseStoredFileRecordError> for ServerError

fn from(e: ParseStoredFileRecordError) -> Self

Converts to this type from the input type.

impl From<PostgresMetadataStoreError> for ServerError

fn from(e: PostgresMetadataStoreError) -> Self

Converts to this type from the input type.

impl From<ProtocolError> for ServerError

fn from(error: ProtocolError) -> Self

Converts to this type from the input type.

impl From<ProviderEventsError> for ServerError

fn from(value: ProviderEventsError) -> Self

Converts to this type from the input type.

impl From<QuarantineCandidateError> for ServerError

fn from(e: QuarantineCandidateError) -> Self

Converts to this type from the input type.

impl From<RebuildError> for ServerError

fn from(value: RebuildError) -> Self

Converts to this type from the input type.

impl From<ReconstructionCacheError> for ServerError

fn from(source: ReconstructionCacheError) -> Self

Converts to this type from the input type.

impl From<RetentionHoldError> for ServerError

fn from(e: RetentionHoldError) -> Self

Converts to this type from the input type.

impl From<S3ObjectStoreError> for ServerError

fn from(e: S3ObjectStoreError) -> Self

Converts to this type from the input type.

impl From<ServerConfigError> for ServerError

fn from(source: ServerConfigError) -> Self

Converts to this type from the input type.

impl From<ServerObjectStoreError> for ServerError

fn from(value: ServerObjectStoreError) -> Self

Converts to this type from the input type.

impl From<TokenCodecError> for ServerError

fn from(error: TokenCodecError) -> Self

Converts to this type from the input type.

impl From<TryFromIntError> for ServerError

fn from(source: TryFromIntError) -> Self

Converts to this type from the input type.

impl From<WebhookDeliveryError> for ServerError

fn from(e: WebhookDeliveryError) -> Self

Converts to this type from the input type.

impl From<XetAdapterError> for ServerError

fn from(value: XetAdapterError) -> Self

Converts to this type from the input type.

impl From<XorbParseError> for ServerError

fn from(value: XorbParseError) -> Self

Converts to this type from the input type.

impl IntoResponse for ServerError

fn into_response(self) -> Response

Create a response.

impl ProtocolValidation for ServerError

fn invalid_digest() -> Self

fn invalid_content_hash() -> Self

fn invalid_repository_name() -> Self

fn not_found() -> Self

fn invalid_manifest_reference() -> Self

fn invalid_upload_session() -> Self