Struct AnchorChannelReserveContext

pub struct AnchorChannelReserveContext {
    pub upper_bound_fee_rate: FeeRate,
    pub expected_accepted_htlcs: u16,
    pub taproot_wallet: bool,
}

Parameters defining the context around the anchor channel reserve requirement calculation.

Fields

upper_bound_fee_rate: FeeRate

An upper bound fee rate estimate used to calculate the anchor channel reserve that is sufficient to provide fees for all required transactions.

expected_accepted_htlcs: u16

The expected number of accepted in-flight HTLCs per channel.

Note that malicious counterparties can saturate the number of accepted in-flight HTLCs up to the maximum prior to forcing a unilateral closure. This estimate can include that case as a weighted average, assuming some percentage of channels are controlled by malicious peers and have the maximum number of accepted in-flight HTLCs.

See ChannelHandshakeConfig::our_max_accepted_htlcs to configure the maximum number of accepted in-flight HTLCs.

taproot_wallet: bool

Whether the wallet handling anchor channel reserves creates Taproot P2TR outputs for any new outputs, or Segwit P2WPKH outputs otherwise.

Trait Implementations

impl Clone for AnchorChannelReserveContext

fn clone(&self) -> AnchorChannelReserveContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AnchorChannelReserveContext

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

Formats the value using the given formatter.

impl Default for AnchorChannelReserveContext

A default for the AnchorChannelReserveContext parameters is provided as follows:

• The upper bound fee rate is set to the 99th percentile of the median block fee rate since 2019: ~50 sats/vbyte.
• The number of accepted in-flight HTLCs per channel is set to 10, providing additional margin above the number seen for a large routing node over a month (average <1, maximum 10 accepted in-flight HTLCS aggregated across all channels).
• The wallet is assumed to be a Segwit wallet.

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for AnchorChannelReserveContext

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for AnchorChannelReserveContext

impl StructuralPartialEq for AnchorChannelReserveContext