Enum lightning::chain::channelmonitor::Balance

pub enum Balance {
    ClaimableOnChannelClose {
        claimable_amount_satoshis: u64,
    },
    ClaimableAwaitingConfirmations {
        claimable_amount_satoshis: u64,
        confirmation_height: u32,
    },
    ContentiousClaimable {
        claimable_amount_satoshis: u64,
        timeout_height: u32,
    },
    MaybeClaimableHTLCAwaitingTimeout {
        claimable_amount_satoshis: u64,
        claimable_height: u32,
    },
}

Details about the balance(s) available for spending once the channel appears on chain.

See ChannelMonitor::get_claimable_balances for more details on when these will or will not be provided.

Variants

ClaimableOnChannelClose

Fields

claimable_amount_satoshis: u64

The amount available to claim, in satoshis, excluding the on-chain fees which will be required to do so.

The channel is not yet closed (or the commitment or closing transaction has not yet appeared in a block). The given balance is claimable (less on-chain fees) if the channel is force-closed now.

ClaimableAwaitingConfirmations

Fields

claimable_amount_satoshis: u64

The amount available to claim, in satoshis, possibly excluding the on-chain fees which were spent in broadcasting the transaction.

confirmation_height: u32

The height at which an Event::SpendableOutputs event will be generated for this amount.

The channel has been closed, and the given balance is ours but awaiting confirmations until we consider it spendable.

ContentiousClaimable

Fields

claimable_amount_satoshis: u64

The amount available to claim, in satoshis, excluding the on-chain fees which will be required to do so.

timeout_height: u32

The height at which the counterparty may be able to claim the balance if we have not done so.

The channel has been closed, and the given balance should be ours but awaiting spending transaction confirmation. If the spending transaction does not confirm in time, it is possible our counterparty can take the funds by broadcasting an HTLC timeout on-chain.

Once the spending transaction confirms, before it has reached enough confirmations to be considered safe from chain reorganizations, the balance will instead be provided via Balance::ClaimableAwaitingConfirmations.

MaybeClaimableHTLCAwaitingTimeout

Fields

claimable_amount_satoshis: u64

The amount available to claim, in satoshis, excluding the on-chain fees which will be required to do so.

claimable_height: u32

The height at which we will be able to claim the balance if our counterparty has not done so.

HTLCs which we sent to our counterparty which are claimable after a timeout (less on-chain fees) if the counterparty does not know the preimage for the HTLCs. These are somewhat likely to be claimed by our counterparty before we do.

Trait Implementations

impl Clone for Balance

fn clone(&self) -> Balance

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Balance

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

Formats the value using the given formatter.

impl PartialEq<Balance> for Balance

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

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

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

This method tests for !=.

impl Eq for Balance

impl StructuralEq for Balance

impl StructuralPartialEq for Balance