From 9784111bd3b95be5352669b74e174920c101f349 Mon Sep 17 00:00:00 2001 From: tv Date: Thu, 19 Nov 2026 16:18:16 +0000 Subject: continuum-party: a directory for each federation, the only one used unasked A party named its node, key and record on every command, or a file of them with --config; one voting in several federations kept files apart by hand. Without --config, the client now reads a federation's own directory, `continuum/federations/NAME` in $XDG_CONFIG_HOME or ~/.config: its `party.toml` of the client's options, its record (`record`) and, where there, its key (`key`); options on the command line, or `record` and `key` in `party.toml`, win. `--federation NAME` chooses one; where there is only one, it is used without being named; where there are several, the client says which there are and asks for one. `root`, `judge` and `twice`, using no options, read none. `init --federation NAME` begins a federation's directory, only its owner reading it, its `party.toml` holding the options given on the command line with it (`node`, `token`, `key`, the key's path made absolute; the node's default left out), and the record in it. --- docs/configuration.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) (limited to 'docs/configuration.md') diff --git a/docs/configuration.md b/docs/configuration.md index f48f288..1b7bd44 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -257,6 +257,21 @@ record = "/home/tv/.config/continuum/tv.record" continuum-party --config tv.toml write home/tv/motd '"hello"' ``` +Without `--config`, the client reads a federation's own directory, as one party may vote +in several federations: `~/.config/continuum/federations/NAME/` (in `$XDG_CONFIG_HOME` +where that is set), holding its `party.toml` of the options above, its record (`record`), +and, where given there, its key (`key`); `record` and `key` in `party.toml`, or on the +command line, win over those. `--federation NAME` chooses one; where there is only one, +the client uses it without being told, and where there are several, it asks which. +`init --federation NAME` begins one, its `party.toml` holding the options given with it +(`node`, `token`, `key`, the key's path made absolute), readable by its owner alone: + +```sh +continuum-party --federation krebs --node http://tv:secret@localhost:3000 \ + --key tv.key init tv --root root +continuum-party vote 8d02 yes # krebs, the only one +``` + `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 ([`guides/federation/keys.md`](guides/federation/keys.md), -- cgit v1.3.1