aboutsummaryrefslogtreecommitdiffstats
path: root/docs/guides
diff options
context:
space:
mode:
Diffstat (limited to 'docs/guides')
-rw-r--r--docs/guides/federation/common-changes.md14
-rw-r--r--docs/guides/federation/keys.md7
2 files changed, 15 insertions, 6 deletions
diff --git a/docs/guides/federation/common-changes.md b/docs/guides/federation/common-changes.md
index acbd98a..1f7f331 100644
--- a/docs/guides/federation/common-changes.md
+++ b/docs/guides/federation/common-changes.md
@@ -86,15 +86,21 @@ jq --arg key "$(cut -d' ' -f1,2 tv-new.key.pub)" '
## What a party does by itself
-* **Its node list**, signed with a key its version names, no vote:
+* **Its node list**, signed with a key its version names, no vote: the list whole, or the
+ list as it counts at the node with nodes added (`--add`) or taken off (`--remove`):
```sh
continuum-party --node http://tv:secret@localhost:3000 --key tv.key \
- --record tv.record nodes continuum:5be1… continuum:77d0…
+ --record tv.record nodes --add continuum:77d0…
+ # tv's node list: continuum:5be1… continuum:77d0…
+ # 9b2c… taken
```
- A version names a party's list anew only where it must: when the party is let in, or
- when it can't write its own.
+ The client checks first that the current version names the key it signs with for the
+ party, and says otherwise: then only a version naming the party's keys or its list
+ anew changes it, which a party proposes and the parties pass. A version names a
+ party's list anew only where it must: when the party is let in, or when it can't write
+ its own.
* **Its key set**, likewise ([`keys.md`](keys.md)).
* **Its writes**, wherever the rules give it places
([`writing-and-reading.md`](writing-and-reading.md)).
diff --git a/docs/guides/federation/keys.md b/docs/guides/federation/keys.md
index 3dd2834..6f9fc10 100644
--- a/docs/guides/federation/keys.md
+++ b/docs/guides/federation/keys.md
@@ -23,8 +23,11 @@ continuum-party --node http://tv:secret@localhost:3000 --key laptop.key \
--record tv.record write home/tv/motd '"from the laptop"'
```
-Each key goes as one argument, an `authorized_keys` line; its comment is left out. A
-set holds up to 16 keys. A node voting by itself keeps a key its version names on that
+Each key goes as one argument, an `authorized_keys` line; its comment is left out. With
+`--add` and `--remove` instead, the client writes the set as it counts at the node with
+those keys added or taken off (`keys --add "$(cat phone.pub)"`). A set holds up to 16
+keys, signed with a key the current version names for the party, which the client checks
+first. A node voting by itself keeps a key its version names on that
node (`--store-vote-key`), an Ed25519 key in a file: one stolen there votes for the
party.