<div dir="ltr"><div dir="ltr"><div dir="ltr">We started to look at the `push_me` outputs again. Will refer to them as `anchor` outputs from now on, to prevent confusion with `push_msat` on the `open_channel` message.<br><br>The cpfp carve-out <a href="https://github.com/bitcoin/bitcoin/pull/15681" target="_blank">https://github.com/bitcoin/bitcoin/pull/15681</a> has been merged and for reasons described earlier in this thread, we now need to add a csv time lock to every non-anchor output on the commitment transaction. <br><br>To realize this, we are currently considering the following changes:<br><br>* Add `to_remote_delay OP_CHECKSEQUENCEVERIFY OP_DROP` to the `to_remote` output. `to_remote_delay` is the csv delay that the remote party accepted in the funding flow for their outputs. This not only ensures that the carve-out works as intended, but also removes the incentive to game the other party into force-closing. If desired, both parties can still agree to have different `to_self_delay` values.<br><br>* Add `1 OP_CHECKSEQUENCEVERIFY OP_DROP` to the non-revocation clause of the HTLC outputs.<br><br>For the anchor outputs we consider:<br><br>* Output type: normal P2WKH. At one point, an additional spending path was proposed that was unconditional except for a 10 block csv lock. The intention of this was to prevent utxo set pollution by allowing anyone to clean up. This however also opens up the possibility for an attacker to 'use up' the cpfp carve-out after those 10 blocks. If the user A is offline for that period of time, a malicious peer B may already have broadcasted the commitment tx and pinned down user A's anchor output with a low fee child. That way, the commitment tx could still remain unconfirmed while an important htlc expires.<br><br>* For the keys to use for `to_remote_anchor` and `to_local_anchor`, we’d like to introduce new addresses that both parties communicate in the `open_channel` and `accept_channel` messages. We don’t want to reuse the main commitment output addresses, because those may (at some point) be cold storage addresses and the cpfp is likely to happen from a hot wallet.<br><br>* Within each version of the commitment transaction, both anchors always have equal values and are paid for by the initiator. The value of the anchors is the dust limit that was negotiated in the `open_channel` or `accept_channel` message of the party that publishes the transaction. It means that the definitive balance of an endpoint is dependent on which version of the commitment transaction confirms. This however is nothing new. In the current commitment format, there are always two or three valid versions of the commitment transaction (local, remote and sometimes the not yet revoked previous remote tx) which can have slightly different balances. For the initiator, it is important to validate the other party's dust limit. The initiator pays for it and doesn't want to give away more free money than necessary. </div><div dir="ltr"><br>Furthermore, there doesn’t seem to be a compelling reason anymore for tweaking the keys (new insights into watchtower designs, encrypt by txid). Therefore we think we can remove them entirely in this new commitment format and require less channel state data to sweep the outputs.</div><div><br></div><div>Joost</div><span class="gmail-HOEnZb gmail-adL"><font color="#888888"><div dir="ltr"><br></div></font></span></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Nov 21, 2018 at 3:17 AM Rusty Russell <<a href="mailto:rusty@rustcorp.com.au">rusty@rustcorp.com.au</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">I'm also starting to implement this, to see what I missed!<br>
<br>
Original at <a href="https://github.com/lightningnetwork/lightning-rfc/pull/513" rel="noreferrer" target="_blank">https://github.com/lightningnetwork/lightning-rfc/pull/513</a><br>
<br>
Pasted here for your reading convenience:<br>
<br>
- Option is sticky; it set at open time, it stays with channel<br>
- I didn't want to have to handle penalty txs on channels which switch<br>
- We could, however, upgrade on splice.<br>
- Feerate is fixed at 253<br>
- `feerate_per_kw` is still in open /accept (just ignored): multifund may want it.<br>
- closing tx negotiates *upwards* not *downwards*<br>
- Starting from base fee of commitment tx = 282 satoshi.<br>
- to_remote output is always CSV delayed.<br>
- pushme outputs are paid for by funder, but only exist if the matching<br>
to_local/remote output exists.<br>
- After 10 blocks, they become anyone-can-spend (they need to see the<br>
to-local/remote witness script though).<br>
- remotepubkey is not rotated.<br>
- You must spend your pushme output; you may sweep for others.<br>
<br>
Signed-off-by: Rusty Russell <<a href="mailto:rusty@rustcorp.com.au" target="_blank">rusty@rustcorp.com.au</a>><br>
<br>
diff --git a/02-peer-protocol.md b/02-peer-protocol.md<br>
index 7cf9ebf..6ec1155 100644<br>
--- a/02-peer-protocol.md<br>
+++ b/02-peer-protocol.md<br>
@@ -133,7 +133,9 @@ node can offer.<br>
(i.e. 1/4 the more normally-used 'satoshi per 1000 vbytes') that this<br>
side will pay for commitment and HTLC transactions, as described in<br>
[BOLT #3](03-transactions.md#fee-calculation) (this can be adjusted<br>
-later with an `update_fee` message).<br>
+later with an `update_fee` message). Note that if<br>
+`option_simplified_commitment` is negotiated, this `feerate_per_kw`<br>
+is treated as 253 for all transactions.<br>
<br>
`to_self_delay` is the number of blocks that the other node's to-self<br>
outputs must be delayed, using `OP_CHECKSEQUENCEVERIFY` delays; this<br>
@@ -208,7 +210,8 @@ The receiving node MUST fail the channel if:<br>
- `push_msat` is greater than `funding_satoshis` * 1000.<br>
- `to_self_delay` is unreasonably large.<br>
- `max_accepted_htlcs` is greater than 483.<br>
- - it considers `feerate_per_kw` too small for timely processing or unreasonably large.<br>
+ - if `option_simplified_commitment` is not negotiated:<br>
+ - it considers `feerate_per_kw` too small for timely processing or unreasonably large.<br>
- `funding_pubkey`, `revocation_basepoint`, `htlc_basepoint`, `payment_basepoint`, or `delayed_payment_basepoint`<br>
are not valid DER-encoded compressed secp256k1 pubkeys.<br>
- `dust_limit_satoshis` is greater than `channel_reserve_satoshis`.<br>
@@ -228,7 +231,7 @@ The *channel reserve* is specified by the peer's `channel_reserve_satoshis`: 1%<br>
<br>
The sender can unconditionally give initial funds to the receiver using a non-zero `push_msat`, but even in this case we ensure that the funder has sufficient remaining funds to pay fees and that one side has some amount it can spend (which also implies there is at least one non-dust output). Note that, like any other on-chain transaction, this payment is not certain until the funding transaction has been confirmed sufficiently (with a danger of double-spend until this occurs) and may require a separate method to prove payment via on-chain confirmation.<br>
<br>
-The `feerate_per_kw` is generally only of concern to the sender (who pays the fees), but there is also the fee rate paid by HTLC transactions; thus, unreasonably large fee rates can also penalize the recipient.<br>
+The `feerate_per_kw` is generally only of concern to the sender (who pays the fees), but there is also the fee rate paid by HTLC transactions; thus, unreasonably large fee rates can also penalize the recipient. It is ignored for `option_simplified_commitment`.<br>
<br>
Separating the `htlc_basepoint` from the `payment_basepoint` improves security: a node needs the secret associated with the `htlc_basepoint` to produce HTLC signatures for the protocol, but the secret for the `payment_basepoint` can be in cold storage.<br>
<br>
@@ -340,6 +343,12 @@ This message introduces the `channel_id` to identify the channel. It's derived f<br>
<br>
#### Requirements<br>
<br>
+Both peers:<br>
+ - if `option_simplified_commitment` was negotiated:<br>
+ - `option_simplified_commitment` applies to all commitment and HTLC transactions<br>
+ - otherwise:<br>
+ - `option_simplified_commitment` does not apply to any commitment or HTLC transactions<br>
+<br>
The sender MUST set:<br>
- `channel_id` by exclusive-OR of the `funding_txid` and the `funding_output_index` from the `funding_created` message.<br>
- `signature` to the valid signature, using its `funding_pubkey` for the initial commitment transaction, as defined in [BOLT #3](03-transactions.md#commitment-transaction).<br>
@@ -351,6 +360,12 @@ The recipient:<br>
- on receipt of a valid `funding_signed`:<br>
- SHOULD broadcast the funding transaction.<br>
<br>
+#### Rationale<br>
+<br>
+We decide on `option_simplified_commitment` at this point when we first have to generate the commitment<br>
+transaction. Even if a later reconnection does not negotiate this parameter, this channel will honor it.<br>
+This simplifies channel state, particularly penalty transaction handling.<br>
+<br>
### The `funding_locked` Message<br>
<br>
This message indicates that the funding transaction has reached the `minimum_depth` asked for in `accept_channel`. Once both nodes have sent this, the channel enters normal operating mode.<br>
@@ -508,8 +523,11 @@ The funding node:<br>
- SHOULD send a `closing_signed` message.<br>
<br>
The sending node:<br>
- - MUST set `fee_satoshis` less than or equal to the<br>
- base fee of the final commitment transaction, as calculated in [BOLT #3](03-transactions.md#fee-calculation).<br>
+ - if `option_upfront_shutdown_script` applies to the final commitment transaction:<br>
+ - MUST set `fee_satoshis` greater than or equal to 282.<br>
+ - otherwise:<br>
+ - MUST set `fee_satoshis` less than or equal to the<br>
+ base fee of the final commitment transaction, as calculated in [BOLT #3](03-transactions.md#fee-calculation).<br>
- SHOULD set the initial `fee_satoshis` according to its<br>
estimate of cost of inclusion in a block.<br>
- MUST set `signature` to the Bitcoin signature of the close<br>
@@ -543,9 +561,18 @@ progress is made, even if only by a single satoshi at a time. To avoid<br>
keeping state and to handle the corner case, where fees have shifted<br>
between disconnection and reconnection, negotiation restarts on reconnection.<br>
<br>
-Note there is limited risk if the closing transaction is<br>
-delayed, but it will be broadcast very soon; so there is usually no<br>
-reason to pay a premium for rapid processing.<br>
+In the `option_simplified_commitment` case, the fees on the commitment<br>
+transaction itself are minimal (it is assumed that a child transaction will<br>
+supply additional fee incentive), so that forms a floor for negotiation.<br>
+[BOLT #3](03-transactions.md#fee-calculation), gives 282 satoshis (1116<br>
+weight, 254 `feerate_per_kw`).<br>
+<br>
+Otherwise, the commitment transaction usually pays a premium fee, so that<br>
+forms a ceiling.<br>
+<br>
+Note there is limited risk if the closing transaction is delayed, but it will<br>
+be broadcast very soon; so there is usually no reason to pay a premium for<br>
+rapid processing.<br>
<br>
## Normal Operation<br>
<br>
@@ -763,7 +790,10 @@ is destined, is described in [BOLT #4](04-onion-routing.md).<br>
A sending node:<br>
- MUST NOT offer `amount_msat` it cannot pay for in the<br>
remote commitment transaction at the current `feerate_per_kw` (see "Updating<br>
-Fees") while maintaining its channel reserve.<br>
+Fees") while maintaining its channel reserve<br>
+ - if `option_simplified_commitment` applies to this commitment transaction and the sending<br>
+ node is the funder:<br>
+ - MUST be able to additionally pay for `to_local_pushme` and `to_remote_pushme` above its reserve.<br>
- MUST offer `amount_msat` greater than 0.<br>
- MUST NOT offer `amount_msat` below the receiving node's `htlc_minimum_msat`<br>
- MUST set `cltv_expiry` less than 500000000.<br>
@@ -782,7 +812,7 @@ Fees") while maintaining its channel reserve.<br>
A receiving node:<br>
- receiving an `amount_msat` equal to 0, OR less than its own `htlc_minimum_msat`:<br>
- SHOULD fail the channel.<br>
- - receiving an `amount_msat` that the sending node cannot afford at the current `feerate_per_kw` (while maintaining its channel reserve):<br>
+ - receiving an `amount_msat` that the sending node cannot afford at the current `feerate_per_kw` (while maintaining its channel reserve and any `to_local_pushme` and `to_remote_pushme` fees):<br>
- SHOULD fail the channel.<br>
- if a sending node adds more than its `max_accepted_htlcs` HTLCs to<br>
its local commitment transaction, OR adds more than its `max_htlc_value_in_flight_msat` worth of offered HTLCs to its local commitment transaction:<br>
@@ -997,6 +1027,11 @@ A node:<br>
<br>
### Updating Fees: `update_fee`<br>
<br>
+If `option_simplified_commitment` applies to the commitment transaction,<br>
+`update_fee` is never used: the `feerate_per_kw` is always considered 253, but<br>
+the funder also pays 2000 satoshi for the `to_local_pushme` and<br>
+`to_remote_pushme` outputs.<br>
+<br>
An `update_fee` message is sent by the node which is paying the<br>
Bitcoin fee. Like any update, it's first committed to the receiver's<br>
commitment transaction and then (once acknowledged) committed to the<br>
@@ -1020,13 +1055,19 @@ given in [BOLT #3](03-transactions.md#fee-calculation).<br>
#### Requirements<br>
<br>
The node _responsible_ for paying the Bitcoin fee:<br>
- - SHOULD send `update_fee` to ensure the current fee rate is sufficient (by a<br>
+ - if `option_simplified_commitment` applies to the commitment transaction:<br>
+ - MUST NOT send `update_fee`.<br>
+ - otherwise:<br>
+ - SHOULD send `update_fee` to ensure the current fee rate is sufficient (by a<br>
significant margin) for timely processing of the commitment transaction.<br>
<br>
The node _not responsible_ for paying the Bitcoin fee:<br>
- MUST NOT send `update_fee`.<br>
<br>
A receiving node:<br>
+ - if `option_simplified_commitment` applies to the commitment transaction:<br>
+ - SHOULD fail the channel.<br>
+ - MUST NOT update the `feerate_per_kw`.<br>
- if the `update_fee` is too low for timely processing, OR is unreasonably large:<br>
- SHOULD fail the channel.<br>
- if the sender is not responsible for paying the Bitcoin fee:<br>
@@ -1038,7 +1079,12 @@ A receiving node:<br>
<br>
#### Rationale<br>
<br>
-Bitcoin fees are required for unilateral closes to be effective —<br>
+Fee adjustments are unnecessary for `option_simplified_commitment` which<br>
+relies on "pushme" outputs and a child transaction which will provide<br>
+additional fee incentive which can be calculated at the time it is spent, and<br>
+replaced by higher-fee children if required.<br>
+<br>
+Without this option, bitcoin fees are required for unilateral closes to be effective —<br>
particularly since there is no general method for the broadcasting node to use<br>
child-pays-for-parent to increase its effective fee.<br>
<br>
diff --git a/03-transactions.md b/03-transactions.md<br>
index e769961..440bd0d 100644<br>
--- a/03-transactions.md<br>
+++ b/03-transactions.md<br>
@@ -82,6 +82,8 @@ To allow an opportunity for penalty transactions, in case of a revoked commitmen<br>
The reason for the separate transaction stage for HTLC outputs is so that HTLCs can timeout or be fulfilled even though they are within the `to_self_delay` delay.<br>
Otherwise, the required minimum timeout on HTLCs is lengthened by this delay, causing longer timeouts for HTLCs traversing the network.<br>
<br>
+If `option_simplified_commitment` applies to the commitment transaction, then the `to_self_delay` used for all transactions is the greater of the `to_self_delay` sent by each peer. Otherwise, each peer sends the `to_self_delay` to be used for the other peer's commitment amd HTLC transactions.<br>
+<br>
The amounts for each output MUST be rounded down to whole satoshis. If this amount, minus the fees for the HTLC transaction, is less than the `dust_limit_satoshis` set by the owner of the commitment transaction, the output MUST NOT be produced (thus the funds add to fees).<br>
<br>
#### `to_local` Output<br>
@@ -109,7 +111,40 @@ If a revoked commitment transaction is published, the other party can spend this<br>
<br>
#### `to_remote` Output<br>
<br>
-This output sends funds to the other peer and thus is a simple P2WPKH to `remotepubkey`.<br>
+This output sends funds to the other peer, thus is not encumbered by a<br>
+revocation private key.<br>
+<br>
+If `option_simplified_commitment` applies to the commitment transaction, the `to_remote` output is delayed similarly to the `to_local` output, and is to a fixed key:<br>
+<br>
+ `to_self_delay`<br>
+ OP_CSV<br>
+ OP_DROP<br>
+ <remote_pubkey><br>
+<br>
+The output is spent by a transaction with `nSequence` field set to `to_self_delay` (which can only be valid after that duration has passed) and witness:<br>
+<br>
+ <remote_sig><br>
+<br>
+Otherwise, this output is a simple P2WPKH to `remotepubkey`.<br>
+<br>
+<br>
+#### `to_local_pushme` and `to_remote_pushme` Output (option_simplified_commitment)<br>
+<br>
+This output can be spent by the local and remote nodes respectivey to provide incentive to mine the transaction, using child-pays-for-parent. They are only added if the `to_local` and `to_remote` outputs exist, respectively.<br>
+<br>
+ OP_DEPTH<br>
+ OP_IF<br>
+ <pubkey> OP_CHECKSIG<br>
+ OP_ELSE<br>
+ 10 OP_CSV<br>
+ OP_ENDIF<br>
+<br>
+The `<pubkey>` is `<local_delayedpubkey>` to `to_local_pushme` and<br>
+`<remote_delayedpubkey>` for `to_remote_pushme`. The output amount is<br>
+1000 satoshi, to encourage spending of the output. Once the<br>
+`remote_pubkey` is revealed (by spending the `to_local` output) and<br>
+the commitment transaction is 10 blocks deep, anyone can spend it.<br>
+<br>
<br>
#### Offered HTLC Outputs<br>
<br>
@@ -294,6 +329,9 @@ The fee calculation for both commitment transactions and HTLC<br>
transactions is based on the current `feerate_per_kw` and the<br>
*expected weight* of the transaction.<br>
<br>
+Note that if `option_simplified_commitment` applies to the commitment<br>
+transaction then `feerate_per_kw` is 253.<br>
+<br>
The actual and expected weights vary for several reasons:<br>
<br>
* Bitcoin uses DER-encoded signatures, which vary in size.<br>
@@ -306,10 +344,12 @@ Thus, a simplified formula for *expected weight* is used, which assumes:<br>
* Signatures are 73 bytes long (the maximum length).<br>
* There are a small number of outputs (thus 1 byte to count them).<br>
* There are always both a `to_local` output and a `to_remote` output.<br>
+* (if `option_simplified_commitment`) there are always both a `to_local_pushme` and `to_remote_pushme` output.<br>
<br>
This yields the following *expected weights* (details of the computation in [Appendix A](#appendix-a-expected-weights)):<br>
<br>
- Commitment weight: 724 + 172 * num-untrimmed-htlc-outputs<br>
+ Commitment weight (no option_simplified_commitment): 724 + 172 * num-untrimmed-htlc-outputs<br>
+ Commitment weight (option_simplified_commitment: 1116 + 172 * num-untrimmed-htlc-outputs<br>
HTLC-timeout weight: 663<br>
HTLC-success weight: 703<br>
<br>
@@ -366,7 +406,7 @@ outputs) is 7140 satoshi. The final fee may be even higher if the<br>
<br>
### Fee Payment<br>
<br>
-Base commitment transaction fees are extracted from the funder's amount; if that amount is insufficient, the entire amount of the funder's output is used.<br>
+Base commitment transaction fees and amounts for `to_local_pushme` and `to_remote_pushme` outputs are extracted from the funder's amount; if that amount is insufficient, the entire amount of the funder's output is used.<br>
<br>
Note that after the fee amount is subtracted from the to-funder output,<br>
that output may be below `dust_limit_satoshis`, and thus will also<br>
@@ -390,23 +430,29 @@ committed HTLCs:<br>
2. Calculate the base [commitment transaction fee](#fee-calculation).<br>
3. Subtract this base fee from the funder (either `to_local` or `to_remote`),<br>
with a floor of 0 (see [Fee Payment](#fee-payment)).<br>
+4. If `option_simplified_commitment` applies to the commitment transaction,<br>
+ subtract 2000 satoshis from the funder (either `to_local` or `to_remote`).<br>
3. For every offered HTLC, if it is not trimmed, add an<br>
[offered HTLC output](#offered-htlc-outputs).<br>
4. For every received HTLC, if it is not trimmed, add an<br>
[received HTLC output](#received-htlc-outputs).<br>
5. If the `to_local` amount is greater or equal to `dust_limit_satoshis`,<br>
add a [`to_local` output](#to_local-output).<br>
+6. If `option_simplified_commitment` applies to the commitment transaction,<br>
+ and `to_local` was added, add `to_local_pushme`.<br>
6. If the `to_remote` amount is greater or equal to `dust_limit_satoshis`,<br>
add a [`to_remote` output](#to_remote-output).<br>
+6. If `option_simplified_commitment` applies to the commitment transaction,<br>
+ and `to_remote` was added, add `to_remote_pushme`.<br>
7. Sort the outputs into [BIP 69 order](#transaction-input-and-output-ordering).<br>
<br>
# Keys<br>
<br>
## Key Derivation<br>
<br>
-Each commitment transaction uses a unique set of keys: `localpubkey` and `remotepubkey`.<br>
+Each commitment transaction uses a unique `localpubkey`, and a `remotepubkey`.<br>
The HTLC-success and HTLC-timeout transactions use `local_delayedpubkey` and `revocationpubkey`.<br>
-These are changed for every transaction based on the `per_commitment_point`.<br>
+These are changed for every transaction based on the `per_commitment_point`, with the exception of `remotepubkey` if `option_simplified_commitment` is negotiated.<br>
<br>
The reason for key change is so that trustless watching for revoked<br>
transactions can be outsourced. Such a _watcher_ should not be able to<br>
@@ -419,8 +465,9 @@ avoid storage of every commitment transaction, a _watcher_ can be given the<br>
the scripts required for the penalty transaction; thus, a _watcher_ need only be<br>
given (and store) the signatures for each penalty input.<br>
<br>
-Changing the `localpubkey` and `remotepubkey` every time ensures that commitment<br>
-transaction ID cannot be guessed; every commitment transaction uses an ID<br>
+Changing the `localpubkey` every time ensures that commitment<br>
+transaction ID cannot be guessed except in the trivial case where there is no<br>
+`to_local` output, as every commitment transaction uses an ID<br>
in its output script. Splitting the `local_delayedpubkey`, which is required for<br>
the penalty transaction, allows it to be shared with the _watcher_ without<br>
revealing `localpubkey`; even if both peers use the same _watcher_, nothing is revealed.<br>
@@ -434,14 +481,13 @@ For efficiency, keys are generated from a series of per-commitment secrets<br>
that are generated from a single seed, which allows the receiver to compactly<br>
store them (see [below](#efficient-per-commitment-secret-storage)).<br>
<br>
-### `localpubkey`, `remotepubkey`, `local_htlcpubkey`, `remote_htlcpubkey`, `local_delayedpubkey`, and `remote_delayedpubkey` Derivation<br>
+### `localpubkey``local_htlcpubkey`, `remote_htlcpubkey`, `local_delayedpubkey`, and `remote_delayedpubkey` Derivation<br>
<br>
These pubkeys are simply generated by addition from their base points:<br>
<br>
pubkey = basepoint + SHA256(per_commitment_point || basepoint) * G<br>
<br>
-The `localpubkey` uses the local node's `payment_basepoint`; the `remotepubkey`<br>
-uses the remote node's `payment_basepoint`; the `local_delayedpubkey`<br>
+The `localpubkey` uses the local node's `payment_basepoint`; the `local_delayedpubkey`<br>
uses the local node's `delayed_payment_basepoint`; the `local_htlcpubkey` uses the<br>
local node's `htlc_basepoint`; and the `remote_delayedpubkey` uses the remote<br>
node's `delayed_payment_basepoint`.<br>
@@ -451,6 +497,17 @@ secrets are known (i.e. the private keys corresponding to `localpubkey`, `local_<br>
<br>
privkey = basepoint_secret + SHA256(per_commitment_point || basepoint)<br>
<br>
+### `remotepubkey` Derivation<br>
+<br>
+If `option_simplified_commitment` is negotiated the `remotepubkey` is simply the remote node's `payment_basepoint`, otherwise it is calculated as above using the remote node's `payment_basepoint`.<br>
+<br>
+The simplified derivation means that a node can spend a commitment<br>
+transaction even if it has lost data and doesn't know the<br>
+corresponding `payment_basepoint`. A watchtower could correlate<br>
+transactions given to it which only have a `to_remote` output if it<br>
+sees one of them onchain, but such transactions do not need any<br>
+enforcement and should not be handed to a watchtower.<br>
+<br>
### `revocationpubkey` Derivation<br>
<br>
The `revocationpubkey` is a blinded key: when the local node wishes to create a new<br>
@@ -636,12 +693,22 @@ The *expected weight* of a commitment transaction is calculated as follows:<br>
- var_int: 1 byte (pk_script length)<br>
- pk_script (p2wsh): 34 bytes<br>
<br>
- output_paying_to_remote: 31 bytes<br>
+ output_paying_to_remote (no option_simplified_commitment): 31 bytes<br>
- value: 8 bytes<br>
- var_int: 1 byte (pk_script length)<br>
- pk_script (p2wpkh): 22 bytes<br>
<br>
- htlc_output: 43 bytes<br>
+ output_paying_to_remote (option_simplified_commitment): 43 bytes<br>
+ - value: 8 bytes<br>
+ - var_int: 1 byte (pk_script length)<br>
+ - pk_script (p2wsh): 34 bytes<br>
+<br>
+ output_pushme (option_simplified_commitment): 43 bytes<br>
+ - value: 8 bytes<br>
+ - var_int: 1 byte (pk_script length)<br>
+ - pk_script (p2wsh): 34 bytes<br>
+<br>
+ htlc_output: 43 bytes<br>
- value: 8 bytes<br>
- var_int: 1 byte (pk_script length)<br>
- pk_script (p2wsh): 34 bytes<br>
@@ -650,7 +717,7 @@ The *expected weight* of a commitment transaction is calculated as follows:<br>
- flag: 1 byte<br>
- marker: 1 byte<br>
<br>
- commitment_transaction: 125 + 43 * num-htlc-outputs bytes<br>
+ commitment_transaction (no option_simplified_commitment): 125 + 43 * num-htlc-outputs bytes<br>
- version: 4 bytes<br>
- witness_header <---- part of the witness data<br>
- count_tx_in: 1 byte<br>
@@ -663,15 +730,32 @@ The *expected weight* of a commitment transaction is calculated as follows:<br>
....htlc_output's...<br>
- lock_time: 4 bytes<br>
<br>
+ commitment_transaction (option_simplified_commitment): 223 + 43 * num-htlc-outputs bytes<br>
+ - version: 4 bytes<br>
+ - witness_header <---- part of the witness data<br>
+ - count_tx_in: 1 byte<br>
+ - tx_in: 41 bytes<br>
+ funding_input<br>
+ - count_tx_out: 1 byte<br>
+ - tx_out: 172 + 43 * num-htlc-outputs bytes<br>
+ output_paying_to_remote,<br>
+ output_paying_to_local,<br>
+ output_pushme,<br>
+ output_pushme,<br>
+ ....htlc_output's...<br>
+ - lock_time: 4 bytes<br>
+<br>
Multiplying non-witness data by 4 results in a weight of:<br>
<br>
- // 500 + 172 * num-htlc-outputs weight<br>
+ // 500 + 172 * num-htlc-outputs weight (no option_simplified_commitment)<br>
+ // 892 + 172 * num-htlc-outputs weight (option_simplified_commitment)<br>
commitment_transaction_weight = 4 * commitment_transaction<br>
<br>
// 224 weight<br>
witness_weight = witness_header + witness<br>
<br>
- overall_weight = 500 + 172 * num-htlc-outputs + 224 weight<br>
+ overall_weight (no option_simplified_commitment) = 500 + 172 * num-htlc-outputs + 224 weight<br>
+ overall_weight (option_simplified_commitment) = 892 + 172 * num-htlc-outputs + 224 weight<br>
<br>
## Expected Weight of HTLC-timeout and HTLC-success Transactions<br>
<br>
diff --git a/05-onchain.md b/05-onchain.md<br>
index 231c209..c5fb5e1 100644<br>
--- a/05-onchain.md<br>
+++ b/05-onchain.md<br>
@@ -89,21 +89,29 @@ trigger any action.<br>
# Commitment Transaction<br>
<br>
The local and remote nodes each hold a *commitment transaction*. Each of these<br>
-commitment transactions has four types of outputs:<br>
+commitment transactions has six types of outputs:<br>
<br>
1. _local node's main output_: Zero or one output, to pay to the *local node's*<br>
-commitment pubkey.<br>
+delayed pubkey.<br>
2. _remote node's main output_: Zero or one output, to pay to the *remote node's*<br>
-commitment pubkey.<br>
+pubkey.<br>
+1. _local node's push output_: Zero or one output, to pay to the *local node's*<br>
+delayed pubkey.<br>
+2. _remote node's push output_: Zero or one output, to pay to the *remote node's*<br>
+pubkey.<br>
3. _local node's offered HTLCs_: Zero or more pending payments (*HTLCs*), to pay<br>
the *remote node* in return for a payment preimage.<br>
4. _remote node's offered HTLCs_: Zero or more pending payments (*HTLCs*), to<br>
pay the *local node* in return for a payment preimage.<br>
<br>
To incentivize the local and remote nodes to cooperate, an `OP_CHECKSEQUENCEVERIFY`<br>
-relative timeout encumbers the *local node's outputs* (in the *local node's<br>
+relative timeout encumbers some outputs: the *local node's outputs* (in the *local node's<br>
commitment transaction*) and the *remote node's outputs* (in the *remote node's<br>
-commitment transaction*). So for example, if the local node publishes its<br>
+commitment transaction*). If `option_simplified_commitment` applies<br>
+to the commitment transaction, then the *to_remote* output of each commitment is<br>
+identically encumbered, for fairness.<br>
+<br>
+Without `option_simplified_commitment`, if the local node publishes its<br>
commitment transaction, it will have to wait to claim its own funds,<br>
whereas the remote node will have immediate access to its own funds. As a<br>
consequence, the two commitment transactions are not identical, but they are<br>
@@ -140,6 +148,11 @@ A node:<br>
- otherwise:<br>
- MUST use the *last commitment transaction*, for which it has a<br>
signature, to perform a *unilateral close*.<br>
+ - MUST spend any `to_local_pushme` output, providing sufficient fees as incentive to include the commitment transaction in a block<br>
+ - SHOULD use [replace-by-fee](<a href="https://github.com/bitcoin/bips/blob/master/bip-0125.mediawiki" rel="noreferrer" target="_blank">https://github.com/bitcoin/bips/blob/master/bip-0125.mediawiki</a>) or other mechanism on the spending transaction if it proves insufficient for timely inclusion in a block.<br>
+<br>
+A node:<br>
+ - MAY monitor the blockchain for unspent `to_local_pushme` and `to_remote_pushme` outputs and try to spend them after 10 confirmations.<br>
<br>
## Rationale<br>
<br>
@@ -154,7 +167,8 @@ need not consume resources monitoring the channel state.<br>
There exists a bias towards preferring mutual closes over unilateral closes,<br>
because outputs of the former are unencumbered by a delay and are directly<br>
spendable by wallets. In addition, mutual close fees tend to be less exaggerated<br>
-than those of commitment transactions. So, the only reason not to use the<br>
+than those of commitment transactions (or in the case of `option_simplified_commitment`,<br>
+the commitment transaction may require a child transaction to cause it to be mined). So, the only reason not to use the<br>
signature from `closing_signed` would be if the fee offered was too small for<br>
it to be processed.<br>
<br>
diff --git a/09-features.md b/09-features.md<br>
index d06fcff..caea38b 100644<br>
--- a/09-features.md<br>
+++ b/09-features.md<br>
@@ -26,6 +26,7 @@ These flags may only be used in the `init` message:<br>
| 3 | `initial_routing_sync` | Indicates that the sending node needs a complete routing information dump | [BOLT #7](07-routing-gossip.md#initial-sync) |<br>
| 4/5 | `option_upfront_shutdown_script` | Commits to a shutdown scriptpubkey when opening channel | [BOLT #2](02-peer-protocol.md#the-open_channel-message) |<br>
| 6/7 | `gossip_queries` | More sophisticated gossip control | [BOLT #7](07-routing-gossip.md#query-messages) |<br>
+| 8/9 | `option_simplified_commitment` | Simplified commitment transactions | [BOLT #3](03-transactions.md) |<br>
<br>
## Assigned `globalfeatures` flags<br>
<br>
_______________________________________________<br>
Lightning-dev mailing list<br>
<a href="mailto:Lightning-dev@lists.linuxfoundation.org" target="_blank">Lightning-dev@lists.linuxfoundation.org</a><br>
<a href="https://lists.linuxfoundation.org/mailman/listinfo/lightning-dev" rel="noreferrer" target="_blank">https://lists.linuxfoundation.org/mailman/listinfo/lightning-dev</a><br>
</blockquote></div></div>