aboutsummaryrefslogtreecommitdiffstats
path: root/docs/guides
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-19 19:01:55 +0000
committertv <tv@krebsco.de>2026-11-19 20:13:48 +0100
commit8a6474557ad9df0b29e7f6fe9f2c231fc9900588 (patch)
treeec0efab9612b542dd6b1d5dfa401d012bfe8c411 /docs/guides
parentc66f0f8f7297484e095e02d259c84469b6c42367 (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')
-rw-r--r--docs/guides/federation/getting-started.md12
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