Enum ActrError 

pub enum ActrError {
    Unavailable(String),
    TimedOut,
    NotFound(String),
    PermissionDenied(String),
    InvalidArgument(String),
    UnknownRoute(String),
    DependencyNotFound {
        service_name: String,
        message: String,
    },
    DecodeFailure(String),
    NotImplemented(String),
    Internal(String),
}

Top-level framework error, returned to all callers.

Flat enum — no nested error wrapping. Each variant is self-describing.

Variants

Unavailable(String)

Peer temporarily unavailable: connection lost, overloaded, or reconnecting.

ErrorKind::Transient — retry with backoff.

TimedOut

Request deadline exceeded.

ErrorKind::Transient — may retry with a fresh deadline.

NotFound(String)

Target actor not found.

ErrorKind::Client — do not retry; check service discovery first.

PermissionDenied(String)

Permission denied by ACL.

ErrorKind::Client — do not retry; fix authorization.

InvalidArgument(String)

Invalid argument or malformed request.

ErrorKind::Client — do not retry; fix the request.

UnknownRoute(String)

No handler registered for the given route key.

ErrorKind::Client — do not retry; check service definition.

DependencyNotFound

Required dependency not found in the lock file.

ErrorKind::Client — do not retry; fix the manifest.

Fields

service_name: String

message: String

DecodeFailure(String)

Protobuf decode failure — message data is corrupted.

ErrorKind::Corrupt — route to Dead Letter Queue; do not retry.

NotImplemented(String)

Feature not yet implemented.

ErrorKind::Internal — do not retry.

Internal(String)

Internal framework error: bug, panic, or unrecoverable state.

ErrorKind::Internal — do not retry; investigate logs.

Trait Implementations

impl Classify for ActrError

fn kind(&self) -> ErrorKind

Returns the fault domain this error belongs to.

fn is_retryable(&self) -> bool

Returns true if the operation may be retried.

fn requires_dlq(&self) -> bool

Returns true if the message should be routed to the Dead Letter Queue.

impl Clone for ActrError

fn clone(&self) -> ActrError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ActrError

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

Formats the value using the given formatter.

impl Display for ActrError

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

Formats the value using the given formatter.

impl Error for ActrError

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<NetworkError> for ActrError

Convert NetworkError to the public top-level ActrError.

This is the single boundary where transport failures become user-visible errors.

fn from(err: NetworkError) -> Self

Converts to this type from the input type.