aboutsummaryrefslogtreecommitdiffstats
path: root/docs/peers.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/peers.md')
-rw-r--r--docs/peers.md10
1 files changed, 8 insertions, 2 deletions
diff --git a/docs/peers.md b/docs/peers.md
index 34023db..a03d15f 100644
--- a/docs/peers.md
+++ b/docs/peers.md
@@ -44,6 +44,12 @@ there are that node's; messages from an address no node proved itself at are dro
and the address is asked WHO (at most every 5 s), so after a restart the first message
from a peer brings its proof back.
+Ahead of each WHO and each ME goes a SPEAKS ([Handshake and join](#handshake-and-join)),
+and WHO and ME read alike in every wire version: so once two nodes proved themselves to
+each other, each knows which versions the other speaks, and writes it the newest both
+do, at each of its addresses ([`operations.md`](operations.md),
+[Upgrading](operations.md#upgrading)). Until a node says, it is written the oldest.
+
A seed is an address (or something the transport resolves to one: a Mycelium public
key, IPv6 address or host name); it is asked WHO, and its ME names the node. Where other
nodes are comes from HELLO_REPLYs and the member list: hints, which are asked WHO before
@@ -98,8 +104,8 @@ HELLO.
Before each HELLO and each HELLO_REPLY, a node sends SPEAKS: the wire versions it speaks
and the newest revision of the federation it knows, as its build has them. It stands
outside the wire versions, laid out as no build changes, so that a peer on another build
-reads it too, once that peer reads the node's WHO and ME
-([Node IDs and addresses](#node-ids-and-addresses)): what each peer said shows as its
+reads it too; it goes ahead of each WHO and ME as well
+([Node IDs and addresses](#node-ids-and-addresses)). What each peer said shows as its
`knows` in `GET /peers`, the node's own as `localKnows`, and in `GET /events/counts` for
the nodes a federated store's parties list. A build from before SPEAKS takes it for a
message of another wire version, and logs that once of the peer