aboutsummaryrefslogtreecommitdiffstats
path: root/docs/peers.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/peers.md')
-rw-r--r--docs/peers.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/docs/peers.md b/docs/peers.md
index e71d726..c63bebe 100644
--- a/docs/peers.md
+++ b/docs/peers.md
@@ -95,6 +95,14 @@ only valid identities (node IDs), and, once it knows the member list, only
its own neighbours; their addresses are hints for its transport, and each gets a
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)). A build from before SPEAKS takes it
+for a message of another wire version, and logs that once of the peer
+([`operations.md`](operations.md), [Upgrading](operations.md#upgrading)).
+
Every HELLO carries a random id of the sender's current run, and the HELLO_REPLY echoes
it. A reply with another id answers a HELLO from an earlier run (delivered late, or
queued in Mycelium while the node was down) and is ignored.