From 54bcc0e4ee8e1e6a29e0e01369c2ba95b27abce8 Mon Sep 17 00:00:00 2001 From: tv Date: Thu, 19 Nov 2026 03:48:03 +0000 Subject: federation: a version names the revision of federation 1 it follows What every node must agree on was named by the federation's number alone, and a change that only took more kept it: a party could use it before every node ran it, and nodes not upgraded refused what followed and parted from the others. A version now names the revision it follows by its ID (`"revision": ""`), the SHA-256 of the JCS list of the features it adds to the base revision federation 1 began with (`federation::revision`); a version naming none follows the base revision, ECDSA keys among it, so the versions written so far read as they did. A version names the base revision only by leaving `revision` out, and a revision no earlier than the one of the version it changes. A continuum that doesn't know a revision, another build's among them, can't read a version naming it: it stops at a version event writing one, and says which revision and what it knows. There are no revisions yet but the base revision. `federation.md` says how a revision is rolled out, then passed, and what a later continuum may leave out; the upgrades guide, and the one on a node stopped, alike. --- docs/guides/federation/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/guides/federation/README.md') diff --git a/docs/guides/federation/README.md b/docs/guides/federation/README.md index 5a44306..32f8756 100644 --- a/docs/guides/federation/README.md +++ b/docs/guides/federation/README.md @@ -31,7 +31,7 @@ by them, in its words. * [`remakes.md`](remakes.md): compactions only, the electorate, the snapshot, putting again after a switch, two epochs for one, and rejoining. * [`upgrades.md`](upgrades.md): upgrading the nodes of a federated swarm, and what the - federation's number says. + federation's number and its revision say. * [`watching.md`](watching.md): what a node's API and its log say that needs an operator or a party. * [`building-on-the-api.md`](building-on-the-api.md): an application reading what -- cgit v1.3.1