aboutsummaryrefslogtreecommitdiffstats
path: root/docs/configuration.md
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-19 20:55:59 +0000
committertv <tv@krebsco.de>2026-11-19 22:10:09 +0100
commit011560a72ca895d8b516983485cfc45c9984cd45 (patch)
tree50befd374201d3b7993b8e9b2872e4f6be05beec /docs/configuration.md
parentb827ecbfff930790af45b04b8e6f01e4f5514e75 (diff)
continuum-party --party: the party it reads as, without a record
A record is what votes go by, and what `again` signs anew from; for logging in as the party, and for `status`, it only named the party. So someone who only reads needed a record, begun with `init`, which should never vote beside the party's own. `--party NAME` (an option as node, key and record are, so party.toml holds it too) names the party where no record does (working_as): `init` the one it begins a record of, else the record's, else --party; --party naming another than these is an error. Commands that sign still take a record.
Diffstat (limited to 'docs/configuration.md')
-rw-r--r--docs/configuration.md12
1 files changed, 10 insertions, 2 deletions
diff --git a/docs/configuration.md b/docs/configuration.md
index ea401f5..0efdfc3 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -275,8 +275,16 @@ continuum-party vote 8d02 yes # krebs, the only one
Where `node` names no user and no `token` is given, the client logs in to the node as its
party, by `key`, where the federated node takes it: a party's session, which reads and
puts events and nothing else ([`guides/federation/running-a-node.md`](guides/federation/running-a-node.md),
-[Its API](guides/federation/running-a-node.md#its-api)). So `node = "https://node.example"`
-and a key whose party a version names are all a party's people need.
+[Its API](guides/federation/running-a-node.md#its-api)). The party is the one its record
+names, or, without a record, `party`: a record is what votes go by, and what `again`
+signs anew from, so one who only reads needs none. So a federation's directory with this
+`party.toml` is all one of a party's people needs to read (`status`, `values`):
+
+```toml
+node = "https://node.example"
+key = "/home/alice/.ssh/laptop.pub"
+party = "tv"
+```
`key` is an OpenSSH private key file, or a public key an ssh-agent holds: the key itself
(`key = "ecdsa-sha2-nistp256 AAAA…"`), or a file of such lines, whose first signs