summaryrefslogtreecommitdiffstats
path: root/docs/guides/federation/common-changes.md
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-18 12:31:09 +0000
committertv <tv@krebsco.de>2026-11-18 13:34:43 +0100
commit13d96ce6ecd386ddd39b803ecb52a8557476f8fa (patch)
tree3b1b946457dbb6073119a7be1b35d7d57934c804 /docs/guides/federation/common-changes.md
parent114739426a34654f1d296ed38040e369737775b2 (diff)
continuum-party keys, nodes: shown given no change, --set, --force
`keys` and `nodes` alone (`--list`) show the party's key set or node list as it counts at the node, one a line, without a key. `--set` writes it whole, none twice, in place of the arguments that did; `--add` and `--remove` change it as it counts. A set or list left empty, whichever way (`--set` with none, `--remove` of the last), is written with `--force` only: none of the party's writes count without keys, nor its nodes as members without a list.
Diffstat (limited to 'docs/guides/federation/common-changes.md')
-rw-r--r--docs/guides/federation/common-changes.md10
1 files changed, 6 insertions, 4 deletions
diff --git a/docs/guides/federation/common-changes.md b/docs/guides/federation/common-changes.md
index 1f7f331..1dd30c1 100644
--- a/docs/guides/federation/common-changes.md
+++ b/docs/guides/federation/common-changes.md
@@ -86,8 +86,9 @@ 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: the list whole, or the
- list as it counts at the node with nodes added (`--add`) or taken off (`--remove`):
+* **Its node list**, signed with a key its version names, no vote: the list as it counts
+ at the node with nodes added (`--add`) or taken off (`--remove`), or set whole
+ (`--set`); `nodes` alone shows it:
```sh
continuum-party --node http://tv:secret@localhost:3000 --key tv.key \
@@ -96,8 +97,9 @@ jq --arg key "$(cut -d' ' -f1,2 tv-new.key.pub)" '
# 9b2c… taken
```
- 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
+ A list left empty, taking all of the party's nodes out of the swarm, is written with
+ `--force` only. 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.