mirrors/lightning-bolts
1
0
Fork 0
mirror of https://github.com/lightning/bolts.git synced 2025-03-13 11:35:41 +01:00
Code Issues Projects Releases Wiki Activity

Clarify OP_RETURN requirements

Browse source 
As suggested by @roasbeef.
This commit is contained in:
t-bast 2025-01-24 11:08:57 +01:00
parent 1a47d2e587
commit 0a2650bef8
No known key found for this signature in database
GPG key ID: 34F377B0100ED6BB
1 changed files with 10 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
02-peer-protocol.md
View file

@ -1857,22 +1857,25 @@ The sender of `closing_complete` (aka. "the closer"):
- MUST set `closer_scriptpubkey` to its desired output script. - MUST set `closer_scriptpubkey` to its desired output script.
- MUST set `closee_scriptpubkey` to the last script it received from its peer (from `closing_complete` or from the initial `shutdown`). - MUST set `closee_scriptpubkey` to the last script it received from its peer (from `closing_complete` or from the initial `shutdown`).
- MUST set `locktime` to the desired `nLockTime` of the closing transaction. - MUST set `locktime` to the desired `nLockTime` of the closing transaction.
- MUST generate its closing transaction as specified in [BOLT #3](03-transactions.md#closing-transaction).
- MUST set `signature` fields as valid signature using its `funding_pubkey` of:
- `closer_output_only`: closing transaction with only the local ("closer") output.
- `closee_output_only`: closing transaction with only the remote ("closee") output.
- `closer_and_closee_outputs`: closing transaction with both the closer and closee outputs.
- If the local outstanding balance (in millisatoshi) is less than the remote outstanding balance: - If the local outstanding balance (in millisatoshi) is less than the remote outstanding balance:
- MUST NOT set `closer_output_only`. - MUST NOT set `closer_output_only`.
- MUST set `closee_output_only` if the local output amount is dust. - MUST set `closee_output_only` if the local output amount is dust.
- MAY set `closee_output_only` if it considers the local output amount uneconomical AND its `closer_scriptpubkey` is not `OP_RETURN`. - MAY set `closee_output_only` if it considers the local output amount uneconomical AND its `closer_scriptpubkey` is not `OP_RETURN`.
- Otherwise (not lesser amount, cannot remove its own output): - Otherwise (not lesser amount, cannot remove its own output):
- MUST NOT set `closee_output_only`. - MUST NOT set `closee_output_only`.
- If it considers the local output amount uneconomical:
- MAY send a `closer_scriptpubkey` that is a valid `OP_RETURN` script.
- If it does, the output value MUST be set to zero so that all funds go to fees, as specified in [BOLT #3](03-transactions.md#closing-transaction).
- If the closee's output amount is dust: - If the closee's output amount is dust:
- MUST set `closer_output_only`. - MUST set `closer_output_only`.
- SHOULD NOT set `closer_and_closee_outputs`. - SHOULD NOT set `closer_and_closee_outputs`.
- Otherwise: - Otherwise:
- MUST set both `closer_output_only` and `closer_and_closee_outputs`. - MUST set both `closer_output_only` and `closer_and_closee_outputs`.
- MUST generate its closing transaction as specified in [BOLT #3](03-transactions.md#closing-transaction).
- MUST set `signature` fields as valid signature using its `funding_pubkey` of:
- `closer_output_only`: closing transaction with only the local ("closer") output.
- `closee_output_only`: closing transaction with only the remote ("closee") output.
- `closer_and_closee_outputs`: closing transaction with both the closer and closee outputs.
- If it wants to send another `closing_complete` (e.g. with a different `fee_satoshis` or `closer_scriptpubkey`): - If it wants to send another `closing_complete` (e.g. with a different `fee_satoshis` or `closer_scriptpubkey`):
- MUST wait until it has received `closing_sig` first. - MUST wait until it has received `closing_sig` first.
- SHOULD close the connection if it doesn't receive `closing_sig`. - SHOULD close the connection if it doesn't receive `closing_sig`.
@ -1884,6 +1887,8 @@ The receiver of `closing_complete` (aka. "the closee"):
- SHOULD ignore `closing_complete`. - SHOULD ignore `closing_complete`.
- SHOULD send a `warning`. - SHOULD send a `warning`.
- SHOULD close the connection. - SHOULD close the connection.
- If `closer_scriptpubkey` is a valid `OP_RETURN` script:
- MUST set its output amount to zero so that all funds go to fees, as specified in [BOLT #3](03-transactions.md#closing-transaction).
- MUST generate the remote closing transaction as specified in [BOLT #3](03-transactions.md#closing-transaction). - MUST generate the remote closing transaction as specified in [BOLT #3](03-transactions.md#closing-transaction).
- Select a signature for validation: - Select a signature for validation:
- If the local output amount is dust: - If the local output amount is dust: