Enum ChannelError 

pub enum ChannelError {
    NotFound(ChannelId),
    InvalidState {
        from: String,
        to: String,
    },
    ParentNotFound(ChannelId),
    AlreadyExists(ChannelId),
}

Channel layer error.

Represents failures within the Channel management layer. Implements ErrorCode for standardized error handling.

Example

use orcs_runtime::ChannelError;
use orcs_types::{ChannelId, ErrorCode};

fn handle_error(err: ChannelError) {
    match err.code() {
        "CHANNEL_NOT_FOUND" => eprintln!("Channel missing"),
        "CHANNEL_INVALID_STATE" => eprintln!("State error"),
        _ => eprintln!("Other error: {err}"),
    }
}

Variants

NotFound(ChannelId)

The specified channel does not exist.

This typically occurs when:

• Querying a channel that was never created
• Accessing a channel that was killed

InvalidState

Attempted an invalid state transition.

Channel state transitions are strict:

• Only Running → Completed is allowed via complete()
• Only Running → Aborted is allowed via abort()
• Terminal states cannot transition further

Fields

from: String

The current state name.

to: String

The attempted target state name.

ParentNotFound(ChannelId)

The parent channel for a spawn operation does not exist.

When spawning a child channel, the specified parent must exist.

AlreadyExists(ChannelId)

A channel with this ID already exists.

Channel IDs are UUIDs and should be globally unique. This error indicates a potential bug or UUID collision.

Trait Implementations

impl Clone for ChannelError

fn clone(&self) -> ChannelError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChannelError

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

Formats the value using the given formatter.

impl Display for ChannelError

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

Formats the value using the given formatter.

impl Error for ChannelError

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 ErrorCode for ChannelError

fn code(&self) -> &'static str

Returns a machine-readable error code.

fn is_recoverable(&self) -> bool

Returns whether the error is recoverable.