Enum StateError 

#[non_exhaustive]
pub enum StateError {
    EmptySchemaId,
    SchemaIdTooLong {
        max_bytes: usize,
    },
    SchemaIdHasSurroundingWhitespace,
    SchemaIdContainsControl,
    ZeroSchemaVersion,
    InvalidByteLimit {
        maximum: usize,
    },
    InvalidDepthLimit {
        maximum: usize,
    },
    TooLarge {
        kind: DurableStateKind,
        max_bytes: usize,
    },
    TooDeep {
        kind: DurableStateKind,
        max_depth: usize,
    },
    Malformed {
        kind: DurableStateKind,
    },
    FormatMismatch {
        kind: DurableStateKind,
    },
    UnsupportedFormatVersion {
        kind: DurableStateKind,
        version: u16,
    },
    SchemaMismatch {
        kind: DurableStateKind,
    },
    NonIncreasingUpgrade {
        from: StateSchemaVersion,
        to: StateSchemaVersion,
    },
    NoUpgradePath {
        kind: DurableStateKind,
        found: StateSchemaVersion,
        current: StateSchemaVersion,
    },
    AmbiguousUpgrade {
        kind: DurableStateKind,
        from: StateSchemaVersion,
    },
    UpgradeOvershootsCurrent {
        kind: DurableStateKind,
        to: StateSchemaVersion,
        current: StateSchemaVersion,
    },
    UpgradeChainTooLong {
        kind: DurableStateKind,
        max_upgrades: usize,
    },
    UpgradeProducedInvalidJson {
        kind: DurableStateKind,
    },
    UnsupportedSchemaVersion {
        kind: DurableStateKind,
        found: StateSchemaVersion,
        current: StateSchemaVersion,
    },
    InvalidPayload,
    PayloadNotObject,
    Codec(StateCodecError),
}

Stable, value-redacted durable-state validation failure.

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.

EmptySchemaId

A schema identifier was empty.

SchemaIdTooLong

A schema identifier exceeded its UTF-8 byte limit.

Fields

max_bytes: usize

Maximum accepted UTF-8 bytes.

SchemaIdHasSurroundingWhitespace

A schema identifier had surrounding whitespace.

SchemaIdContainsControl

A schema identifier contained a control character.

ZeroSchemaVersion

A schema version was zero.

InvalidByteLimit

A configured byte limit was zero or above the durable hard ceiling.

Fields

maximum: usize

Largest configurable byte limit.

InvalidDepthLimit

A configured depth limit was zero or above the durable hard ceiling.

Fields

maximum: usize

Largest configurable JSON depth.

TooLarge

A serialized value exceeded its configured byte limit.

Fields

kind: DurableStateKind

Durable state category.

max_bytes: usize

Configured maximum bytes.

TooDeep

A serialized value exceeded its configured JSON depth.

Fields

kind: DurableStateKind

Durable state category.

max_depth: usize

Configured maximum depth.

Malformed

The bytes were not a valid framework envelope.

Fields

kind: DurableStateKind

Durable state category.

FormatMismatch

The envelope belongs to the other durable-state category.

Fields

kind: DurableStateKind

Expected durable state category.

UnsupportedFormatVersion

The framework envelope format version is unsupported.

Fields

kind: DurableStateKind

Durable state category.

version: u16

Version observed in durable data.

SchemaMismatch

The envelope schema does not match the selected codec.

Fields

kind: DurableStateKind

Durable state category.

NonIncreasingUpgrade

A declared upgrade did not strictly increase the schema version.

Fields

from: StateSchemaVersion

Version the rejected edge reads.

to: StateSchemaVersion

Version the rejected edge claims to produce.

NoUpgradePath

The codec declares no directed upgrade reaching its current version.

Fields

kind: DurableStateKind

Durable state category.

found: StateSchemaVersion

Version the chain stalled at.

current: StateSchemaVersion

Current version supported by the selected codec.

AmbiguousUpgrade

Two declared upgrades leave the same version, so the chain is not deterministic.

Fields

kind: DurableStateKind

Durable state category.

from: StateSchemaVersion

Version left by more than one declared upgrade.

UpgradeOvershootsCurrent

A declared upgrade produces a version past the codec’s current version.

Fields

kind: DurableStateKind

Durable state category.

to: StateSchemaVersion

Version the rejected edge produces.

current: StateSchemaVersion

Current version supported by the selected codec.

UpgradeChainTooLong

The resolved upgrade chain exceeded its bound.

Fields

kind: DurableStateKind

Durable state category.

max_upgrades: usize

Most upgrades one decode may apply.

UpgradeProducedInvalidJson

A declared upgrade returned bytes that are not valid JSON.

Fields

kind: DurableStateKind

Durable state category.

UnsupportedSchemaVersion

Durable data was produced by a newer application schema.

Fields

kind: DurableStateKind

Durable state category.

found: StateSchemaVersion

Version observed in durable data.

current: StateSchemaVersion

Current version supported by the selected codec.

InvalidPayload

The application payload was not valid JSON.

PayloadNotObject

The application payload was valid JSON but not an object.

Codec(StateCodecError)

The application codec rejected the payload without exposing its value.

Trait Implementations

impl Clone for StateError

fn clone(&self) -> StateError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StateError

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

Formats the value using the given formatter.

impl Display for StateError

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

Formats the value using the given formatter.

impl Eq for StateError

impl Error for StateError

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 PartialEq for StateError

fn eq(&self, other: &StateError) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for StateError