Skip to content

Commit c5b7b89

Browse files
committed
Reject update_fee beyond max_dust_htlc_exposure_msat
1 parent f5fe68b commit c5b7b89

File tree

1 file changed

+19
-0
lines changed

1 file changed

+19
-0
lines changed

02-peer-protocol.md

+19
Original file line numberDiff line numberDiff line change
@@ -1173,6 +1173,14 @@ The node _responsible_ for paying the Bitcoin fee:
11731173
The node _not responsible_ for paying the Bitcoin fee:
11741174
- MUST NOT send `update_fee`.
11751175

1176+
A sending node:
1177+
- if the `dust_balance_on_counterparty_tx` at the new `dust_buffer_feerate` is superior to `max_dust_htlc_exposure_msat`:
1178+
- MAY NOT send `update_fee`
1179+
- MAY fail the channel
1180+
- if the `dust_balance_on_holder_tx` at the new `dust_buffer_feerate` is superior to the `max_dust_htlc_exposure_msat`:
1181+
- MAY NOT send `update_fee`
1182+
- MAY fail the channel
1183+
11761184
A receiving node:
11771185
- if the `update_fee` is too low for timely processing, OR is unreasonably large:
11781186
- SHOULD fail the channel.
@@ -1182,6 +1190,17 @@ A receiving node:
11821190
current commitment transaction:
11831191
- SHOULD fail the channel,
11841192
- but MAY delay this check until the `update_fee` is committed.
1193+
- if the `dust_balance_on_counterparty_tx` at the new `dust_buffer_feerate` is superior to `max_dust_htlc_exposure_msat`:
1194+
- MAY fail the channel
1195+
- if the `dust_balance_on_holder_tx` at the new `dust_buffer_feerate` is superior to the `max_dust_htlc_exposure_msat`:
1196+
- MAY fail the channel
1197+
1198+
There is a possibility of triggering a third-party channel closure in case
1199+
of high-fee spikes by forwarding many trimmed HTLCs on this channel and
1200+
waiting for an automatic `update_fee` provoking an unilateral close. For this
1201+
reason, closing the channel in case of `update_fee` overflowing the
1202+
`max_dust_htlc_exposure_msat` is deferred to the node operator, where it should
1203+
be ultimately evaluated in function of the channel trust and robustness.
11851204

11861205
#### Rationale
11871206

0 commit comments

Comments
 (0)