Skip to content

Commit ed9eabb

Browse files
committed
Improve comment around dust exposure
1 parent 6fb3fa0 commit ed9eabb

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

lightning/src/util/config.rs

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -320,10 +320,13 @@ impl Default for ChannelHandshakeLimits {
320320
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
321321
pub enum MaxDustHTLCExposure {
322322
/// This sets a fixed limit on the total dust exposure in millisatoshis. Setting this too low
323-
/// may prevent the sending or receipt of low-value HTLCs on high-traffic nodes, however this
324-
/// limit is very important to prevent stealing of large amounts of dust HTLCs by miners
325-
/// through [fee griefing
326-
/// attacks](https://lists.linuxfoundation.org/pipermail/lightning-dev/2020-May/002714.html).
323+
/// may prevent the sending or receipt of low-value HTLCs on high-traffic nodes. However this
324+
/// limit is very important to prevent two types of risks:
325+
/// - dust HTLCs balance stealing by Lightning counterparties with hashrate capabilities
326+
/// - fee griefing attacks by colluding Lightning counterparties on the routing of HTLC without _hashrate_ capabilities
327+
///
328+
/// For more information see ["dust inflation attacks"](https://lists.linuxfoundation.org/pipermail/lightning-dev/2020-May/002714.html)
329+
/// and ["dust HTLC exposure considered harmful"](https://lists.linuxfoundation.org/pipermail/lightning-dev/2020-May/002714.html).
327330
///
328331
/// Note that if the feerate increases significantly, without a manually increase
329332
/// to this maximum the channel may be unable to send/receive HTLCs between the maximum dust

0 commit comments

Comments
 (0)