Skip to content

Commit 00c6e6f

Browse files
committed
peers: add a funding_tx_id field to funding_locked2
As the `channel_id` no longer includes the tx hash of the confirmed funding transaction, confirm the funding transaction hash in the `funding_locked2` message. In the rare event of a network partition or block reorg, this might be handy.
1 parent b8e37ba commit 00c6e6f

File tree

1 file changed

+15
-2
lines changed

1 file changed

+15
-2
lines changed

02-peer-protocol.md

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -693,11 +693,24 @@ transaction and maintains information symmetry.
693693
1. type: 61 (`funding_locked2`)
694694
2. data:
695695
* [`32`:`channel_id`]
696+
* [`32`:`funding_tx_id`]
696697
* [`33`:`next_per_commitment_point`]
697698

698-
#### Requirements and Rationale
699+
See [`funding_locked`](#the-funding_locked-message) for Requirements and
700+
Rationale, with the following addendum.
699701

700-
See [`funding_locked`](#the-funding_locked-message).
702+
#### Requirements
703+
704+
The receiving node:
705+
- if the `funding_tx_id` does not match your `funding_tx_id`:
706+
- MUST fail the channel.
707+
708+
#### Rationale
709+
710+
`funding_tx_id` is the transaction hash for the funding transaction that
711+
is being locked in. This is to confirm that both nodes are using the same
712+
transaction for funding. This guards against a conflict in the case of a
713+
network partition.
701714

702715

703716
### Kicking Off Replace-By-Fee: `init_rbf`

0 commit comments

Comments
 (0)