Enum lightning::util::errors::APIError

pub enum APIError {
    APIMisuseError {
        err: String,
    },
    FeeRateTooHigh {
        err: String,
        feerate: u32,
    },
    RouteError {
        err: &'static str,
    },
    ChannelUnavailable {
        err: String,
    },
    MonitorUpdateInProgress,
    IncompatibleShutdownScript {
        script: ShutdownScript,
    },
}

Indicates an error on the client’s part (usually some variant of attempting to use too-low or too-high values)

Variants

APIMisuseError

Fields

err: String

A human-readable error message

Indicates the API was wholly misused (see err for more). Cases where these can be returned are documented, but generally indicates some precondition of a function was violated.

FeeRateTooHigh

Fields

err: String

A human-readable error message

feerate: u32

The feerate which was too high.

Due to a high feerate, we were unable to complete the request. For example, this may be returned if the feerate implies we cannot open a channel at the requested value, but opening a larger channel would succeed.

RouteError

Fields

err: &'static str

A human-readable error message

A malformed Route was provided (eg overflowed value, node id mismatch, overly-looped route, too-many-hops, etc).

ChannelUnavailable

Fields

err: String

A human-readable error message

We were unable to complete the request as the Channel required to do so is unable to complete the request (or was not found). This can take many forms, including disconnected peer, channel at capacity, channel shutting down, etc.

MonitorUpdateInProgress

An attempt to call chain::Watch::watch_channel/chain::Watch::update_channel returned a ChannelMonitorUpdateStatus::InProgress indicating the persistence of a monitor update is awaiting async resolution. Once it resolves the attempted action should complete automatically.

IncompatibleShutdownScript

Fields

script: ShutdownScript

The incompatible shutdown script.

KeysInterface::get_shutdown_scriptpubkey returned a shutdown scriptpubkey incompatible with the channel counterparty as negotiated in InitFeatures.

Using a SegWit v0 script should resolve this issue. If you cannot, you won’t be able to open a channel or cooperatively close one with this peer (and will have to force-close instead).

Trait Implementations

impl Clone for APIError

fn clone(&self) -> APIError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for APIError

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

Formats the value using the given formatter.

impl PartialEq<APIError> for APIError

fn eq(&self, other: &APIError) -> bool

This method tests for self and other values to be equal, and is used by ==.

const fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for APIError

impl StructuralEq for APIError

impl StructuralPartialEq for APIError