Enum RuntimeError 

pub enum RuntimeError {
    Config(ConfigError),
    Store(StoreError),
    Server(ServerError),
    LeadershipTimeout {
        seconds: u32,
    },
    ListenAddr {
        addr: String,
        source: AddrParseError,
    },
    StoreStillShared {
        strong_count: usize,
    },
    Kubeconfig(String),
    KubeconfigIo {
        path: PathBuf,
        source: Error,
    },
}

Everything that can go wrong booting or shutting down a crate::Runtime.

Variants

Config(ConfigError)

Config failed validate() or a section was incoherent.

Store(StoreError)

The store mesh failed to start, initialize, or take leadership.

Server(ServerError)

The apiserver failed to bind or serve.

LeadershipTimeout

Raft leadership wasn’t reached within the configured timeout. The store started but never elected a leader, so no propose (Node registration, apiserver writes) could ever succeed.

Fields

seconds: u32

The configured leadership timeout that elapsed.

ListenAddr

listen_addr couldn’t be parsed into a SocketAddr.

Fields

addr: String

The unparseable address string.

source: AddrParseError

The parse error.

StoreStillShared

At shutdown, the Runtime could not become the sole owner of the store Arc (a driver task or apiserver handler still holds a clone). terminate consumes StoreMesh and requires the only strong ref; this surfaces the leak rather than hanging.

Fields

strong_count: usize

How many strong refs remained when try_unwrap failed.

Kubeconfig(String)

Failed to build or persist the boot-time kubeconfig (data_dir/kubeconfig). Carries the emitter / io message.

KubeconfigIo

A filesystem operation while writing the kubeconfig failed.

Fields

path: PathBuf

The path the operation targeted.

source: Error

The underlying io error.

Implementations

impl RuntimeError

pub fn kind(&self) -> &'static str

Stable identifier — see engenho_substrate::ErrorKind.

Trait Implementations

impl Debug for RuntimeError

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

Formats the value using the given formatter.

impl Display for RuntimeError

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

Formats the value using the given formatter.

impl Error for RuntimeError

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 ErrorKind for RuntimeError

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

Stable identifier — snake_case, stable across substrate releases. Operators use this for log filtering + metric dimensions + SDK-side error dispatch.

impl From<ConfigError> for RuntimeError

fn from(source: ConfigError) -> Self

Converts to this type from the input type.

impl From<ServerError> for RuntimeError

fn from(source: ServerError) -> Self

Converts to this type from the input type.

impl From<StoreError> for RuntimeError

fn from(source: StoreError) -> Self

Converts to this type from the input type.