Skip to content

Commit fae5fcc

Browse files
committed
BOLT 2: make it clear that closing_complete and closing_sig are only used with option_simple_close.
BOLT 3 said, this but BOLT 2 didn't somehow: ``` ## Legacy Closing Transaction This variant is used for `closing_signed` messages (i.e. where `option_simple_close` is not negotiated). ``` Signed-off-by: Rusty Russell <[email protected]>
1 parent 9d96326 commit fae5fcc

File tree

1 file changed

+15
-1
lines changed

1 file changed

+15
-1
lines changed

02-peer-protocol.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1671,6 +1671,9 @@ Once shutdown is complete, the channel is empty of HTLCs, there are no commitmen
16711671
for which a revocation is owed, and all updates are included on both commitments,
16721672
the final current commitment transactions will have no HTLCs.
16731673

1674+
If `option_simple_close` is not negotiated, see [Legacy Closing
1675+
Negotiation](#legacy-closing-negotiation-closing_signed) below.
1676+
16741677
Each peer creates their own closing transaction where they pay the fee, and sends
16751678
`closing_complete` to the other peer with the transaction details. The other peer
16761679
simply signs that transaction and sends back `closing_sig`. Each peer will thus
@@ -1723,6 +1726,10 @@ Note: the details and requirements for the transaction being signed are in [BOLT
17231726

17241727
An output is *dust* if the amount is less than the [Bitcoin Core Dust Thresholds](03-transactions.md#dust-limits).
17251728

1729+
Note: These requirements only apply if `option_simple_close` is
1730+
negotiated, otherwise the requirements are in [Legacy Closing
1731+
Negotiation](#legacy-closing-negotiation-closing_signed).
1732+
17261733
Both nodes:
17271734
- After a `shutdown` has been sent and received, AND no HTLCs remain in either commitment transaction:
17281735
- SHOULD send a `closing_complete` message.
@@ -1849,7 +1856,10 @@ also costs more to spend.
18491856
Once shutdown is complete, the channel is empty of HTLCs, there are no commitments
18501857
for which a revocation is owed, and all updates are included on both commitments,
18511858
the final current commitment transactions will have no HTLCs, and closing fee
1852-
negotiation begins. The funder chooses a fee it thinks is fair, and
1859+
negotiation begins: if `option_simple_close` is negotiated, the section above applies,
1860+
otherwise this legacy section applies.
1861+
1862+
The funder chooses a fee it thinks is fair, and
18531863
signs the closing transaction with the `scriptpubkey` fields from the
18541864
`shutdown` messages (along with its chosen fee) and sends the signature;
18551865
the other node then replies similarly, using a fee it thinks is fair. This
@@ -1877,6 +1887,10 @@ reply with the same value (completing after three messages).
18771887

18781888
#### Requirements
18791889

1890+
Note: These requirements only apply if `option_simple_close` is NOT
1891+
negotiated, otherwise the requirements [Closing Negotiation:
1892+
`closing_complete` and `closing_sig`](#closing-negotiation-closing_complete-and-closing_sig) apply.
1893+
18801894
The funding node:
18811895
- after `shutdown` has been received, AND no HTLCs remain in either commitment transaction:
18821896
- SHOULD send a `closing_signed` message.

0 commit comments

Comments
 (0)