Enum NodeSupervisorError 

#[non_exhaustive]
pub enum NodeSupervisorError {
    LocalFundingState {
        path: PathBuf,
        reason: String,
    },
    InvalidLocalAirdropConfig {
        reason: &'static str,
    },
    InvalidProtocolOverride {
        source: ProtocolTokenWidthError,
    },
    ConfiguredPathMissing {
        path: PathBuf,
    },
    ConfiguredPathNotExecutable {
        path: PathBuf,
    },
    HogdDevNotFound,
    CurrentExe {
        source: Error,
    },
    Spawn {
        program: String,
        source: Error,
    },
    InvalidBootstrapManifestConfig {
        reason: String,
    },
    BootstrapManifestTempDir {
        source: Error,
    },
    BootstrapManifestSerialize {
        source: Error,
    },
    BootstrapManifestWrite {
        path: PathBuf,
        source: Error,
    },
    MissingStdout {
        program: String,
    },
    MissingStderr {
        program: String,
    },
    ReadinessTimeout {
        program: String,
        timeout: Duration,
    },
    ReadinessTooLarge {
        program: String,
        max_bytes: usize,
    },
    ExitedBeforeReady {
        program: String,
        status: ExitStatus,
    },
    ReadinessRead {
        program: String,
        source: Error,
    },
    InvalidReadinessJson {
        program: String,
        line: String,
        source: Error,
    },
    InvalidReadinessSchemaVersion {
        program: String,
        expected: u32,
        actual: u32,
    },
    InvalidReadinessStatus {
        program: String,
        status: String,
    },
    RuntimeManifestRead {
        program: String,
        path: String,
        source: Error,
    },
    RuntimeManifestUnsafePermissions {
        program: String,
        path: String,
        reason: String,
    },
    InvalidRuntimeManifestHash {
        program: String,
        hash: String,
    },
    RuntimeManifestHashMismatch {
        program: String,
        path: String,
        expected: String,
        actual: String,
    },
    InvalidRuntimeManifest {
        program: String,
        reason: String,
    },
    RuntimeNetworkHashMismatch {
        expected: NetworkHashText,
        observed: NetworkHashText,
    },
    RuntimeProtocolMismatch {
        expected: String,
        observed: Option<String>,
    },
    Signal {
        program: String,
        signal: ChildSignal,
        source: Error,
    },
    Status {
        program: String,
        source: Error,
    },
    Wait {
        program: String,
        source: Error,
    },
    Stop {
        program: String,
        source: Error,
    },
    RpcBind {
        address: String,
        source: Error,
    },
    RpcNofileLimit {
        target: u64,
        source: Error,
    },
    RpcNofileHardLimit {
        target: u64,
        hard: u64,
    },
    RpcLocalAddr {
        source: Error,
    },
    StopSignal {
        source: Error,
    },
    SchedulerConnect {
        endpoint: SocketAddr,
        source: ConnectError,
    },
    SchedulerGatewayConnect {
        endpoint: SocketAddr,
        source: ConnectError,
    },
    SchedulerNetworkHashMismatch {
        expected: NetworkHashText,
        observed: NetworkHashText,
    },
    SchedulerPlaneTipMismatch {
        coordinator: String,
        gateway: String,
    },
    SchedulerRpc {
        op: &'static str,
        source: RpcError,
    },
    SchedulerGatewayRpc {
        op: &'static str,
        source: RpcError,
    },
    SchedulerRejected {
        op: &'static str,
        result: String,
    },
    IndexerConnect {
        endpoint: SocketAddr,
        source: ConnectError,
    },
    IndexerRpc {
        op: &'static str,
        error: String,
    },
    DbGatewayConnect {
        endpoint: SocketAddr,
        source: ConnectError,
    },
    DbGatewayRpc {
        op: &'static str,
        error: String,
    },
    ViewGatewayConnect {
        endpoint: SocketAddr,
        source: ConnectError,
    },
    ViewGatewayRpc {
        op: &'static str,
        error: String,
    },
    ProtocolIntroRejected {
        service: &'static str,
        outcome: i32,
        outcome_name: &'static str,
        is_protocol_mismatch: bool,
        protocol: String,
        expected_protocol: Option<String>,
    },
    PidFile {
        path: PathBuf,
        source: Error,
    },
    LocalNodeAlreadyRunning {
        path: PathBuf,
        pid: Option<u32>,
    },
    ShutdownIncomplete {
        program: String,
        process_group: Option<i32>,
    },
    PersistentStateUnsupported,
    DataDir {
        path: PathBuf,
        source: Error,
    },
}

Errors returned by the node supervisor.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

LocalFundingState

The chain’s private faucet state cannot be safely loaded or persisted.

Fields

path: PathBuf

File or directory whose state failed validation.

reason: String

Diagnostic without private material.

InvalidLocalAirdropConfig

Local airdrop resource or transfer configuration is invalid.

Fields

reason: &'static str

Human-readable validation failure.

InvalidProtocolOverride

The configured protocol override is not the wire width of a token.

Fields

source: ProtocolTokenWidthError

Why the text cannot name a protocol token.

ConfiguredPathMissing

A configured binary path does not exist.

Fields

path: PathBuf

Missing configured path.

ConfiguredPathNotExecutable

A configured binary path exists but is not executable.

Fields

path: PathBuf

Non-executable configured path.

HogdDevNotFound

The supervisor could not locate a devnode binary.

CurrentExe

The supervisor could not determine its current executable path.

Fields

source: Error

Underlying I/O error.

Spawn

The supervisor could not start the configured child process.

Fields

program: String

Program path or name.

source: Error

Underlying I/O error.

InvalidBootstrapManifestConfig

The configured hogd-dev bootstrap manifest request could not be represented.

Fields

reason: String

Human-readable reason.

BootstrapManifestTempDir

The supervisor could not create a private bootstrap-manifest directory.

Fields

source: Error

Underlying I/O error.

BootstrapManifestSerialize

The supervisor could not serialize the bootstrap manifest.

Fields

source: Error

Underlying JSON error.

BootstrapManifestWrite

The supervisor could not write the bootstrap manifest file.

Fields

path: PathBuf

Manifest path.

source: Error

Underlying I/O error.

MissingStdout

The child process was spawned without a stdout pipe.

Fields

program: String

Program path or name.

MissingStderr

The child process was spawned without a stderr pipe.

Fields

program: String

Program path or name.

ReadinessTimeout

The child process did not report readiness before the startup timeout.

Fields

program: String

Program path or name.

timeout: Duration

Startup timeout.

ReadinessTooLarge

The child process wrote a readiness line exceeding the configured cap.

Fields

program: String

Program path or name.

max_bytes: usize

Maximum allowed readiness line size.

ExitedBeforeReady

The child process exited before reporting readiness.

Fields

program: String

Program path or name.

status: ExitStatus

Child exit status.

ReadinessRead

The supervisor could not read the readiness line.

Fields

program: String

Program path or name.

source: Error

Underlying I/O error.

InvalidReadinessJson

The child process wrote malformed readiness JSON.

Fields

program: String

Program path or name.

line: String

Raw readiness line.

source: Error

JSON parsing error.

InvalidReadinessSchemaVersion

The child process wrote a readiness line with an unsupported schema.

Fields

program: String

Program path or name.

expected: u32

Expected schema version.

actual: u32

Actual schema version.

InvalidReadinessStatus

The child process wrote a readiness line with an unexpected status.

Fields

program: String

Program path or name.

status: String

Status value from the readiness line.

RuntimeManifestRead

The supervisor could not read the readiness runtime manifest.

Fields

program: String

Program path or name.

path: String

Manifest path advertised in readiness.

source: Error

Underlying I/O error.

RuntimeManifestUnsafePermissions

The advertised runtime manifest path or permissions are unsafe.

Fields

program: String

Program path or name.

path: String

Manifest path advertised in readiness.

reason: String

Validation failure.

InvalidRuntimeManifestHash

The child process advertised a malformed runtime manifest hash.

Fields

program: String

Program path or name.

hash: String

Advertised hash.

RuntimeManifestHashMismatch

The runtime manifest bytes did not match the advertised hash.

Fields

program: String

Program path or name.

path: String

Manifest path advertised in readiness.

expected: String

Hash advertised in readiness.

actual: String

Hash computed from manifest bytes.

InvalidRuntimeManifest

The runtime manifest could not be parsed or projected.

Fields

program: String

Program path or name.

reason: String

Validation failure.

RuntimeNetworkHashMismatch

The runtime manifest advertised a different network than the bootstrap request.

Fields

expected: NetworkHashText

Network hash requested in the bootstrap manifest.

observed: NetworkHashText

Network hash advertised by the runtime manifest.

RuntimeProtocolMismatch

The runtime manifest advertised a different protocol token than requested.

Fields

expected: String

Protocol token requested by the supervisor.

observed: Option<String>

Protocol token advertised by the runtime manifest, if present.

Signal

The supervisor could not signal the child process group.

Fields

program: String

Program path or name.

signal: ChildSignal

Signal sent to the child process group.

source: Error

Underlying I/O error.

Status

The supervisor could not query the child process state.

Fields

program: String

Program path or name.

source: Error

Underlying I/O error.

Wait

The supervisor could not wait for the child process to exit.

Fields

program: String

Program path or name.

source: Error

Underlying I/O error.

Stop

The supervisor could not request child process termination.

Fields

program: String

Program path or name.

source: Error

Underlying I/O error.

RpcBind

The supervisor could not bind the JSON-RPC server to its listen address.

Fields

address: String

Configured listen address.

source: Error

Underlying I/O error.

RpcNofileLimit

The supervisor could not raise the process file-descriptor limit for JSON-RPC.

Fields

target: u64

Desired soft nofile limit.

source: Error

Underlying OS error.

RpcNofileHardLimit

The configured JSON-RPC connection budget exceeds the hard file-descriptor limit.

Fields

target: u64

Desired soft nofile limit.

hard: u64

Current hard nofile limit.

RpcLocalAddr

The supervisor could not read the JSON-RPC server’s bound address.

Fields

source: Error

Underlying I/O error.

StopSignal

The supervisor stop signal failed.

Fields

source: Error

Underlying I/O error.

SchedulerConnect

The supervisor could not connect to hogd-dev’s SchedulerCoord x23 endpoint.

Fields

endpoint: SocketAddr

SchedulerCoord endpoint advertised by hogd-dev readiness.

source: ConnectError

x23 connection error.

SchedulerGatewayConnect

The supervisor could not connect to hogd-dev’s SchedGateway x23 endpoint.

Fields

endpoint: SocketAddr

SchedGateway endpoint advertised by hogd-dev readiness.

source: ConnectError

x23 connection error.

SchedulerNetworkHashMismatch

The scheduler tip belongs to a different network than the runtime manifest.

Fields

expected: NetworkHashText

Network hash advertised by the runtime manifest.

observed: NetworkHashText

Network hash observed in the scheduler tip proposal header.

SchedulerPlaneTipMismatch

The coordinator and public scheduler gateway advertised different startup tips.

Fields

coordinator: String

Debug representation of the coordinator tip.

gateway: String

Debug representation of the scheduler gateway tip.

SchedulerRpc

A hogd-dev scheduler RPC failed.

Fields

op: &'static str

Scheduler RPC operation name.

source: RpcError

x23 RPC error.

SchedulerGatewayRpc

A hogd-dev scheduler gateway RPC failed during startup.

Fields

op: &'static str

Scheduler gateway RPC operation name.

source: RpcError

x23 RPC error.

SchedulerRejected

The scheduler rejected a startup operation.

Fields

op: &'static str

Scheduler RPC operation name.

result: String

Scheduler result value.

IndexerConnect

The supervisor could not connect to hogd-dev’s IndexerBlockExplorer x23 endpoint.

Fields

endpoint: SocketAddr

IndexerBlockExplorer endpoint advertised by hogd-dev readiness.

source: ConnectError

x23 connection error.

IndexerRpc

A hogd-dev indexer RPC failed during startup probing.

Fields

op: &'static str

Indexer RPC operation name.

error: String

x23 RPC error message.

DbGatewayConnect

The supervisor could not connect to hogd-dev’s DbGateway x23 endpoint.

Fields

endpoint: SocketAddr

DbGateway endpoint advertised by hogd-dev readiness.

source: ConnectError

x23 connection error.

DbGatewayRpc

A hogd-dev DbGateway RPC failed during startup probing.

Fields

op: &'static str

DbGateway RPC operation name.

error: String

x23 RPC error message.

ViewGatewayConnect

The supervisor could not connect to hogd-dev’s ViewGateway x23 endpoint.

Fields

endpoint: SocketAddr

ViewGateway endpoint advertised by hogd-dev readiness.

source: ConnectError

x23 connection error.

ViewGatewayRpc

A hogd-dev ViewGateway RPC failed during startup probing.

Fields

op: &'static str

ViewGateway RPC operation name.

error: String

x23 RPC error message.

ProtocolIntroRejected

An x23 service rejected the intro handshake with protocol details.

Fields

service: &'static str

x23 service that rejected the intro handshake.

outcome: i32

Raw outcome discriminant from the x23 service.

outcome_name: &'static str

Decoded intro outcome name when known.

is_protocol_mismatch: bool

Whether the intro outcome is a protocol mismatch.

protocol: String

Protocol token sent by the Rust supervisor.

expected_protocol: Option<String>

Protocol token advertised by readiness, when available.

PidFile

The supervisor could not operate on the hogd-dev PID file.

Fields

path: PathBuf

PID file path or parent directory involved in the failed operation.

source: Error

Underlying I/O error.

LocalNodeAlreadyRunning

Another managed local node appears to be running.

Fields

path: PathBuf

PID file path that is locked by the running node.

pid: Option<u32>

Existing hogd-dev PID if it could be read from the PID file.

ShutdownIncomplete

Forced shutdown did not conclusively stop the supervised process group.

Fields

program: String

Program path or name used to spawn the child.

process_group: Option<i32>

Process group that may still be alive.

PersistentStateUnsupported

Persistent local-node lifecycle guarantees require Unix process groups.

DataDir

The supervisor could not prepare a private persistent data directory.

Fields

path: PathBuf

Persistent data directory involved in the failed operation.

source: Error

Underlying I/O error.

Trait Implementations

impl Debug for NodeSupervisorError

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

Formats the value using the given formatter.

impl Display for NodeSupervisorError

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

Formats the value using the given formatter.

impl Error for NodeSupervisorError

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<ProtocolTokenWidthError> for NodeSupervisorError

fn from(source: ProtocolTokenWidthError) -> Self

Converts to this type from the input type.