diff options
| author | tv <tv@krebsco.de> | 2026-11-19 19:01:55 +0000 |
|---|---|---|
| committer | tv <tv@krebsco.de> | 2026-11-19 20:13:48 +0100 |
| commit | 8a6474557ad9df0b29e7f6fe9f2c231fc9900588 (patch) | |
| tree | ec0efab9612b542dd6b1d5dfa401d012bfe8c411 /docs/guides/federation/getting-started.md | |
| parent | c66f0f8f7297484e095e02d259c84469b6c42367 (diff) | |
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).
Diffstat (limited to 'docs/guides/federation/getting-started.md')
| -rw-r--r-- | docs/guides/federation/getting-started.md | 12 |
1 files changed, 11 insertions, 1 deletions
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 |
