X-Git-Url: http://git.bitcoin.ninja/index.cgi?a=blobdiff_plain;f=lightning%2Fsrc%2Fchain%2Fchaininterface.rs;h=2bf6d6130e1123eef41a77fd3e5ffd1e5e3b72be;hb=4b5504366b2e0c7e29e8bf4bee5d05445f363c35;hp=10676b7190d49a9950ffeaac5d123ff8d29688a3;hpb=d7668e1d12249b8e064fbdecabaab1caba6572c8;p=rust-lightning diff --git a/lightning/src/chain/chaininterface.rs b/lightning/src/chain/chaininterface.rs index 10676b71..2bf6d613 100644 --- a/lightning/src/chain/chaininterface.rs +++ b/lightning/src/chain/chaininterface.rs @@ -14,7 +14,8 @@ //! disconnections, transaction broadcasting, and feerate information requests. use core::{cmp, ops::Deref}; -use core::convert::TryInto; + +use crate::prelude::*; use bitcoin::blockdata::transaction::Transaction; @@ -40,7 +41,7 @@ pub trait BroadcasterInterface { /// be sure to manage both cases correctly. /// /// Bitcoin transaction packages are defined in BIP 331 and here: - /// https://github.com/bitcoin/bitcoin/blob/master/doc/policy/packages.md + /// fn broadcast_transactions(&self, txs: &[&Transaction]); } @@ -53,23 +54,6 @@ pub enum ConfirmationTarget { /// to low hundreds of blocks to get our transaction on-chain, but we shouldn't risk too low a /// fee - this should be a relatively high priority feerate. OnChainSweep, - /// The highest feerate we will allow our channel counterparty to have in a non-anchor channel. - /// - /// This is the feerate on the transaction which we (or our counterparty) will broadcast in - /// order to close the channel unilaterally. Because our counterparty must ensure they can - /// always broadcast the latest state, this value being too low will cause immediate - /// force-closures. - /// - /// Allowing this value to be too high can allow our counterparty to burn our HTLC outputs to - /// dust, which can result in HTLCs failing or force-closures (when the dust HTLCs exceed - /// [`ChannelConfig::max_dust_htlc_exposure`]). - /// - /// Because most nodes use a feerate estimate which is based on a relatively high priority - /// transaction entering the current mempool, setting this to a small multiple of your current - /// high priority feerate estimate should suffice. - /// - /// [`ChannelConfig::max_dust_htlc_exposure`]: crate::util::config::ChannelConfig::max_dust_htlc_exposure - MaxAllowedNonAnchorChannelRemoteFee, /// This is the lowest feerate we will allow our channel counterparty to have in an anchor /// channel in order to close the channel if a channel party goes away. /// @@ -85,13 +69,10 @@ pub enum ConfirmationTarget { /// (package relay) may obviate the need for this entirely. MinAllowedAnchorChannelRemoteFee, /// The lowest feerate we will allow our channel counterparty to have in a non-anchor channel. - /// This needs to be sufficient to get confirmed when the channel needs to be force-closed. - /// Setting too low may result in force-closures. /// /// This is the feerate on the transaction which we (or our counterparty) will broadcast in - /// order to close the channel if a channel party goes away. Because our counterparty must - /// ensure they can always broadcast the latest state, this value being too high will cause - /// immediate force-closures. + /// order to close the channel if a channel party goes away. Setting this value too high will + /// cause immediate force-closures in order to avoid having an unbroadcastable state. /// /// This feerate represents the fee we pick now, which must be sufficient to enter a block at an /// arbitrary time in the future. Obviously this is not an estimate which is very easy to