Skip to content

Commit c7c8691

Browse files
Shannon Appelclinerustyrussell
Shannon Appelcline
authored andcommitted
BOLT-09 Edits (lightning#321)
I regularized the descriptions in the localfeatures table, so keep a careful eye on the accuracy of those. Otherwise, fairly standard editing in this very short section. Added text for lack of globalfeatures flags.
1 parent 6586287 commit c7c8691

File tree

1 file changed

+15
-13
lines changed

1 file changed

+15
-13
lines changed

09-features.md

+15-13
Original file line numberDiff line numberDiff line change
@@ -5,34 +5,36 @@ They are tracked separately since new flags will likely be added over time.
55

66
The `features` flags in the routing messages are a subset of the `globalfeatures` flags, since the `localfeatures` are by definition only of interest to direct peers.
77

8-
Flags are numbered from the least-significant bit at bit 0 (ie. 0x1,
9-
an even bit). They are generally assigned in pairs, so that features
10-
can be introduced as optional (odd bits), and later upgraded to refuse
11-
old nodes (even bits). See [BOLT #1: The `init` message](01-messaging.md#the-init-message).
8+
Flags are numbered from the least-significant bit, at bit 0 (i.e. 0x1,
9+
an even bit). They are generally assigned in pairs so that features
10+
can be introduced as optional (odd bits) and later upgraded to be compulsory, refusing
11+
old nodes (even bits). See [BOLT #1: The `init` Message](01-messaging.md#the-init-message).
1212

1313
## Assigned `localfeatures` flags
1414

1515
These flags may only be used in the `init` message:
1616

17-
1817
| Bits | Name |Description | Link |
1918
|------|------------------|------------------------------------------------|---------------------------------------------------------------------|
20-
| 0/1 | `option-data-loss-protect` | Requires/supports extra `channel_reestablish` fields | [BOLT #2](02-peer-protocol.md#message-retransmission) |
21-
| 3 | `initial_routing_sync` | The sending node needs a complete routing information dump | [BOLT #7](07-routing-gossip.md#initial-sync) |
22-
| 4/5 | `option_upfront_shutdown_script` | Commit to a shutdown scriptpubkey when opening | [BOLT #2](02-peer-protocol.md#the-open_channel-message) |
19+
| 0/1 | `option-data-loss-protect` | Requires or supports extra `channel_reestablish` fields | [BOLT #2](02-peer-protocol.md#message-retransmission) |
20+
| 3 | `initial_routing_sync` | Indicates that the sending node needs a complete routing information dump | [BOLT #7](07-routing-gossip.md#initial-sync) |
21+
| 4/5 | `option_upfront_shutdown_script` | Commits to a shutdown scriptpubkey when opening | [BOLT #2](02-peer-protocol.md#the-open_channel-message) |
2322

2423
## Assigned `globalfeatures` flags
2524

25+
There are currently no `globalfeatures` flags.
26+
2627
## Requirements
2728

28-
(Note that the requirements for feature bits which are not defined
29-
above, can be found in [BOLT #1: The `init` message](01-messaging.md#the-init-message)). The requirements when receiving set bits are defined in the linked section in the table above).
29+
The requirements for receiving specific bits are defined in the linked sections in the table above.
30+
The requirements for feature bits that are not defined
31+
above can be found in [BOLT #1: The `init` Message](01-messaging.md#the-init-message).
3032

3133
## Rationale
3234

33-
There's little point insisting on an `initial_routing_sync` (you can't
34-
tell if the remote node complies, and it has to know what it means as
35-
it's defined in the initial spec) so there's no even bit for that.
35+
There's little point in insisting on an `initial_routing_sync`. You can't
36+
tell if the remote node complies, and it has to know what the flag means as
37+
it's defined in the initial spec. So, there's no even bit for this.
3638

3739
![Creative Commons License](https://i.creativecommons.org/l/by/4.0/88x31.png "License CC-BY")
3840
<br>

0 commit comments

Comments
 (0)