From 8a6474557ad9df0b29e7f6fe9f2c231fc9900588 Mon Sep 17 00:00:00 2001 From: tv Date: Thu, 19 Nov 2026 19:01:55 +0000 Subject: continuum-party found: a federation's first version from its parties The founders wrote the first version as JSON by hand. `found PARTY=KEY|FILE...` writes it: each party with its keys, an authorized_keys line or a file of them, again for more, since 0; --nodes PARTY=NODE,... their node lists, empty where not given; --rule PATH=WRITER the rules in order, `nobody` for false, and without any, each party writing under home/{party}/; --revision FEATURE a later revision. It is checked as a first version (Version::read, changes_validly), and goes to standard output, for `root` to make the root of. The feature lookup is shared with `next` (adding). --- docs/guides/federation/getting-started.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) (limited to 'docs/guides/federation') diff --git a/docs/guides/federation/getting-started.md b/docs/guides/federation/getting-started.md index d148672..dc0eb25 100644 --- a/docs/guides/federation/getting-started.md +++ b/docs/guides/federation/getting-started.md @@ -44,7 +44,15 @@ printf '%s' 'secret' | argon2 "$(openssl rand -hex 16)" -id -e | sed 's/^/tv:/' ## The first version -The founders write the first version together, as a file: +The founders agree on the first version, as a file. `continuum-party found` writes it +from each party's keys (`PARTY=` an `authorized_keys` line, or a file of them), its node +list, and the rules in order (`--rule PATH=WRITER`), each party writing in its namespace +where no rule is given: + +```sh +continuum-party found tv=tv.key.pub lass=lass.key.pub \ + --nodes tv=continuum:5be1… --nodes lass=continuum:9c07… > first.json +``` ```json { "federation": 1, "number": 0, "changes": null, @@ -57,6 +65,8 @@ The founders write the first version together, as a file: Each party writes in its namespace (`home/tv/…`), and nowhere else: no other rule gives a place. Every change of the version takes two thirds of its parties: of two, both. +`--revision FEATURE` starts it on a later revision of the federation +([`upgrades.md`](upgrades.md)). ## The root -- cgit v1.3.1