Enum SpawnError 

pub enum SpawnError {
    Config(ConfigError),
    Docker(Box<DockerError>),
    BitcoinCore {
        group_index: usize,
        source: Box<BitcoinCoreError>,
    },
    BitcoinPeer {
        from_group: usize,
        to_group: usize,
        source: Box<BitcoinRpcError>,
    },
    BitcoinRpc {
        group_index: usize,
        source: Box<BitcoinRpcError>,
    },
    BitcoinSyncTimeout {
        attempts: usize,
        last_tips: Vec<String>,
    },
    MissingBitcoindIp {
        group_index: usize,
    },
    UnknownNode {
        alias: String,
    },
    UnknownBitcoindGroup {
        group_index: usize,
    },
    InvalidFundingAmount {
        amount_btc: f64,
    },
    MissingLndIp {
        alias: String,
    },
    Lnd {
        alias: String,
        source: Box<LndError>,
    },
    ConnectNodes(LndConnectError),
    InvalidClusterNetworkSubnet {
        subnet: String,
        message: String,
    },
    StaticIpUnavailable {
        subnet: String,
        offset: u32,
        largest_usable_offset: u32,
    },
    StartupCleanup {
        cluster_id: String,
        startup_error: String,
        source: Box<DockerError>,
    },
}

Error returned by cluster lifecycle and orchestration operations.

Variants

Config(ConfigError)

Invalid cluster configuration.

Docker(Box<DockerError>)

Docker operation failed.

BitcoinCore

Failed to spawn a Bitcoin Core chain group.

Fields

group_index: usize

Chain group index.

source: Box<BitcoinCoreError>

Underlying Bitcoin Core error.

BitcoinPeer

Failed to connect two Bitcoin Core chain groups.

Fields

from_group: usize

Source chain group index.

to_group: usize

Destination chain group index.

source: Box<BitcoinRpcError>

Underlying Bitcoin RPC error.

BitcoinRpc

Bitcoin Core RPC failed for a chain group.

Fields

group_index: usize

Chain group index.

source: Box<BitcoinRpcError>

Underlying Bitcoin RPC error.

BitcoinSyncTimeout

Bitcoin Core chain groups did not converge on a common tip.

Fields

attempts: usize

Number of sync attempts.

last_tips: Vec<String>

Last observed best block hashes.

MissingBitcoindIp

A Bitcoin Core container had no Docker bridge IP.

Fields

group_index: usize

Chain group index.

UnknownNode

A requested LND node alias does not exist.

Fields

alias: String

Missing alias.

UnknownBitcoindGroup

A requested Bitcoin Core chain group does not exist.

Fields

group_index: usize

Missing chain group index.

InvalidFundingAmount

A funding amount was not positive and finite.

Fields

amount_btc: f64

Invalid amount in BTC.

MissingLndIp

An LND container had no Docker bridge IP.

Fields

alias: String

Node alias.

Lnd

LND operation failed.

Fields

alias: String

Node alias.

source: Box<LndError>

Underlying LND error.

ConnectNodes(LndConnectError)

Connecting to all LND nodes failed.

InvalidClusterNetworkSubnet

The managed Docker network did not report a usable IPv4 subnet.

Fields

subnet: String

Docker network subnet.

message: String

Validation failure.

StaticIpUnavailable

The managed Docker network subnet was too small for this cluster.

Fields

subnet: String

Docker network subnet.

offset: u32

Requested host offset.

largest_usable_offset: u32

Largest usable host offset in the subnet.

StartupCleanup

Startup failed and the attempted cleanup also failed.

Fields

cluster_id: String

Cluster id.

startup_error: String

Original startup error as text.

source: Box<DockerError>

Cleanup failure.

Trait Implementations

impl Debug for SpawnError

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

Formats the value using the given formatter.

impl Display for SpawnError

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

Formats the value using the given formatter.

impl Error for SpawnError

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<Box<DockerError>> for SpawnError

fn from(source: Box<DockerError>) -> Self

Converts to this type from the input type.

impl From<ConfigError> for SpawnError

fn from(source: ConfigError) -> Self

Converts to this type from the input type.

impl From<DockerError> for SpawnError

fn from(source: DockerError) -> Self

Converts to this type from the input type.

impl From<LndConnectError> for SpawnError

fn from(source: LndConnectError) -> Self

Converts to this type from the input type.