Skip to content

Commit 6eddaf5

Browse files
zsfelfoldifjl
andauthored
caps/les.md: define les version 4 (#173)
Co-authored-by: Felix Lange <[email protected]>
1 parent db278b3 commit 6eddaf5

File tree

1 file changed

+10
-1
lines changed

1 file changed

+10
-1
lines changed

caps/les.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ They provide full functionality in terms of safely accessing the blockchain, but
66
mine and therefore do not take part in the consensus process. Full and archive nodes can
77
also support the 'les' protocol besides 'eth' in order to be able to serve light nodes.
88

9-
The current protocol version is **les/3**. See end of document for a list of changes in
9+
The current protocol version is **les/4**. See end of document for a list of changes in
1010
past protocol versions. Some of the les protocol messages are similar to of the [Ethereum
1111
Wire Protocol], with the addition of a few new fields.
1212

@@ -172,6 +172,11 @@ are required (value types are noted after the key string):
172172
- `"headHash"` `B_32`: the hash of the best (i.e. highest TD) known block.
173173
- `"headNum"` `P`: the number of the best (i.e. highest TD) known block.
174174
- `"genesisHash"` `B_32`: the hash of the Genesis block.
175+
- `"forkID"` `[crc32, nextFork: P]`: mandatory since **les/4**.
176+
The value identifies the chain/fork the node is operating on.
177+
- `"recentTxLookup"` `P`: announced by servers since **les/4**. Transaction status
178+
is served for transactions included in the N-1 most recent blocks (N=1 means that
179+
mined transactions are not served at all). N=0 means all transactions are available.
175180

176181
There are several optional key/value pairs which can be set:
177182

@@ -437,6 +442,10 @@ Update flow control buffer and allow sending requests again. Note that the reque
437442

438443
## Change Log
439444

445+
### les/4 (March 2021)
446+
447+
- Keys `"forkID"` and `"recentTxLookup"` were added to the [Status] message.
448+
440449
### les/3 (May 2019)
441450

442451
- Keys `"serveRecentChain"` and `"serveRecentState"` were added to the [Status] message.

0 commit comments

Comments
 (0)