From 59e889254b1fda2dcc8e3e6d596635d1b77f589f Mon Sep 17 00:00:00 2001 From: tv Date: Thu, 19 Nov 2026 17:44:03 +0000 Subject: transport: wire versions spoken side by side A build speaks wire versions OLDEST to VERSION and writes each node the newest both speak (wire::choose), as the node's SPEAKS says; the oldest until it says. The identity layer keeps that per address (Book::speaks): a SPEAKS from an address sets it for the address, and for every address of the node proven there, and a new address of a node takes it over. Paths encodes each message for an address in its version (Transport::encode_in; Transport::encode is the newest). So that two nodes know what the other speaks once they have proven themselves to each other, before any other message goes between them, a SPEAKS goes ahead of every WHO and ME, and WHO and ME are read in every version from 52 on (wire::PROOFS): their tags and layout never change. Without that, a node whose oldest version is past the other's couldn't read its proofs, and the two would never get to the handshake that says what each speaks. A SPEAKS naming no version this build speaks is logged as a message of another version is, naming the node to upgrade, the versions as ranges. A 0.0.1 node takes a SPEAKS from an address not yet proven for any other message from there: it drops it, and asks WHO. This build speaks 52 alone, so nothing it sends changes but the SPEAKS ahead of the proofs. A release adding a version encodes and decodes the older ones from their own, frozen, types. --- docs/peers.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) (limited to 'docs/peers.md') 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 -- cgit v1.3.1