Enum CircleError 

pub enum CircleError {
    NotConfigured,
    LoopNotRunning,
    BrowsableStorage,
    RotationRequired {
        circle_id: CircleId,
        removed_members: Vec<String>,
    },
    Conflicted {
        circle_id: CircleId,
    },
    Deleted {
        circle_id: CircleId,
    },
    NotConflicted {
        circle_id: CircleId,
    },
    ChosenBranchNotRetained {
        circle_id: CircleId,
    },
    NoCloseToCancel {
        circle_id: CircleId,
    },
    NoCloseToExclude {
        circle_id: CircleId,
    },
    DeviceNotACloseParticipant {
        circle_id: CircleId,
        device_id: StoreDeviceId,
    },
    NotBlocked {
        operation_id: CircleOperationId,
    },
    DiscardRequiresNonactivation {
        operation_id: CircleOperationId,
    },
    Blocked {
        circle_id: CircleId,
        block: CircleOperationBlock,
    },
    Identity(String),
    Protocol(String),
}

Why a Circle command or query failed. Maps the internal typed refusals 1:1 with stable identifiers and carries the ids a caller needs to display or retry. Write-path outcomes (a durable write’s local/published/blocked/conflicted status) are not here — those stay on WriteStatus/WriteBlock.

Variants

NotConfigured

No sync provider is configured, so there is no Store to command.

LoopNotRunning

The sync loop is not running, so a Circle write cannot be dispatched.

BrowsableStorage

Circles require opaque object storage; a browsable provider cannot hold them.

RotationRequired

The Circle’s resolved roster names Store identities that are no longer active Store members. New content is refused until an Owner closes the epoch and activates a successor roster without them.

Fields

circle_id: CircleId

removed_members: Vec<String>

Conflicted

The Circle’s control history has forked and awaits Owner resolution.

Fields

circle_id: CircleId

Deleted

The Circle’s control history terminated in an Owner-signed deletion.

Fields

circle_id: CircleId

NotConflicted

Resolution was requested for a Circle that holds no retained control conflict.

Fields

circle_id: CircleId

ChosenBranchNotRetained

The resolution’s chosen branch is not among the Circle’s retained conflicting branches.

Fields

circle_id: CircleId

NoCloseToCancel

Cancellation was requested for a Circle with no in-flight epoch close.

Fields

circle_id: CircleId

NoCloseToExclude

Device exclusion was requested for a Circle with no in-flight epoch close.

Fields

circle_id: CircleId

DeviceNotACloseParticipant

The named device is not a participant in the Circle’s in-flight epoch close.

Fields

circle_id: CircleId

device_id: StoreDeviceId

NotBlocked

Retry was requested for a durable operation that is not blocked.

Fields

operation_id: CircleOperationId

DiscardRequiresNonactivation

Discard was requested without proof the candidate can never activate. The operation stays durable; it never assumes an unseen candidate failed to activate.

Fields

operation_id: CircleOperationId

Blocked

A durable operation cannot publish because its author lost signed authority; the initiator may retry it once authority is restored.

Fields

circle_id: CircleId

block: CircleOperationBlock

Identity(String)

The local signing identity is not established.

Protocol(String)

An internal protocol or database failure with no distinct public category.

Trait Implementations

impl Debug for CircleError

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

Formats the value using the given formatter.

impl Display for CircleError

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

Formats the value using the given formatter.

impl Error for CircleError

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<CircleOperationError> for CircleError

fn from(error: CircleOperationError) -> Self

Converts to this type from the input type.

impl From<SyncError> for CircleError

fn from(error: SyncError) -> Self

Converts to this type from the input type.