Enum RelayError 

pub enum RelayError {
    Chain {
        device_id: String,
        detail: String,
    },
    Fork {
        device_id: String,
        seq: u64,
    },
    Gap {
        device_id: String,
        expected: u64,
        found: u64,
    },
    ForeignOps {
        device_id: String,
        op_device: String,
    },
    FrontierTruncated {
        device_id: String,
        dropped_below: u64,
    },
    Checkpoint(CheckpointError),
    CheckpointFrontierUnverified {
        device_id: String,
        seq: u64,
        detail: String,
    },
    Io(Error),
}

A relay operation failure.

Variants

Chain

A pushed op fails self-verification (id/device mismatch) or does not link the relay-held chain head.

Fields

device_id: String

detail: String

Fork

A different op claims a seq the relay already holds — the permanent chain fork, refused at the transport.

Fields

device_id: String

seq: u64

Gap

A pushed op skips ahead of the relay-held chain (ops must arrive contiguously).

Fields

device_id: String

expected: u64

found: u64

ForeignOps

A device may only push its own chain.

Fields

device_id: String

op_device: String

FrontierTruncated

The pull’s since frontier reaches into GC’d space — the puller cannot be served a gapless log and must cold-bootstrap from the latest checkpoint (checkpoint_get + pull(since = checkpoint frontier) + resume_anchored).

Fields

device_id: String

dropped_below: u64

Checkpoint(CheckpointError)

The uploaded checkpoint does not verify.

CheckpointFrontierUnverified

The uploaded checkpoint is internally self-consistent (Checkpoint::verify passed) but its frontier claims a chain position that does not match the relay-held chain for a device — a checkpoint built from a different chain merely claiming the device’s name (a restored-from-backup re-mint, or two accounts colliding on a device id in a shared FsRelay folder). Rejected so it can never become GC coverage evidence and drop the device’s real ops. (op_id/seq/prev stay cleartext metadata under B6 E2E, so this cross-check survives encryption.)

Fields

device_id: String

seq: u64

detail: String

Io(Error)

Trait Implementations

impl Debug for RelayError

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

Formats the value using the given formatter.

impl Display for RelayError

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

Formats the value using the given formatter.

impl Error for RelayError

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<RelayError> for SessionError

fn from(e: RelayError) -> Self

Converts to this type from the input type.