Skip to content

Commit 37f1540

Browse files
committed
Reject update_fee beyond max_dust_htlc_exposure_msat
1 parent 9c7f004 commit 37f1540

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

02-peer-protocol.md

+21
Original file line numberDiff line numberDiff line change
@@ -1173,6 +1173,15 @@ 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 `update_fee` is above the `dust_buffer_feerate`:
1178+
- if the `dust_balance_on_counterparty_tx` at the current `dust_buffer_feerate` is superior to `max_dust_htlc_exposure_msat`:
1179+
- MAY NOT send `update_fee`
1180+
- MAY fail the channel
1181+
- if the `dust_balance_on_holder_tx` at the current `dust_buffer_feerate` is superior to `max_dust_htlc_exposure_msat`:
1182+
- MAY NOT send `update_fee`
1183+
- MAY fail the channel
1184+
11761185
A receiving node:
11771186
- if the `update_fee` is too low for timely processing, OR is unreasonably large:
11781187
- SHOULD fail the channel.
@@ -1182,6 +1191,18 @@ A receiving node:
11821191
current commitment transaction:
11831192
- SHOULD fail the channel,
11841193
- but MAY delay this check until the `update_fee` is committed.
1194+
- if the `update_fee` is above the `dust_buffer_feerate`:
1195+
- if the `dust_balance_on_counterparty_tx` at the current `dust_buffer_feerate` is superior to `max_dust_htlc_exposure_msat`:
1196+
- MAY fail the channel
1197+
- if the `dust_balance_on_holder_tx` at the current `dust_buffer_feerate` is superior to `max_dust_htlc_exposure_msat`:
1198+
- MAY fail the channel
1199+
1200+
There is a possibility of triggering a third-party channel closure in case
1201+
of high-fee spikes by forwarding many trimmed HTLCs on this channel and
1202+
waiting for an automatic `update_fee` provoking an unilateral close. For this
1203+
reason, closing the channel in case of `update_fee` overflowing the
1204+
`max_dust_htlc_exposure_msat` is deferred to the node operator, where it should
1205+
be ultimately evaluated in function of the channel trust and robustness.
11851206

11861207
#### Rationale
11871208

0 commit comments

Comments
 (0)