From c77f4a88dfd0f4ed423951da6535244aea4a0fa1 Mon Sep 17 00:00:00 2001 From: tv Date: Mon, 16 Nov 2026 22:25:31 +0000 Subject: node: votes it casts by itself, for its party A node may vote and propose for its party by itself, by its operator's rules (`docs/federation.md`, Votes a node casts by itself; `federation::vote`): * `--store-vote-key`: the party's key it signs with, an OpenSSH private key file, one the party's version names, kept on the node; * `--store-vote-record`: its party's one record of its votes, which it votes by, written before each vote is sent, begun where there is none on the version current then; * `--store-follow`, `--store-follow-any`: the parties it follows, by default only on a version that only moves to a checkpoint; * `--store-propose-events`, `--store-propose-every`: when it proposes a checkpoint, once it holds so many events beyond its checkpoint, or so long after its store moved there; * `--store-held-for` (10 minutes): how long it holds an event before it holds it for a while, for the heads it proposes and the voters' rule. Its store keeps when, by the node's own clock, it took each event, and when it moved to its checkpoint. Whenever the worker reads the store, the node decides what to sign (`Holding::act`), records it, writes the record, offers it to its store, and puts it into the document (`held::write`). A vote by hand through the node, by the record and the voters' rule, is `Holding::vote_by_hand`. --- docs/example.toml | 14 ++++++++++++++ 1 file changed, 14 insertions(+) (limited to 'docs/example.toml') diff --git a/docs/example.toml b/docs/example.toml index d101964..36a4ae2 100644 --- a/docs/example.toml +++ b/docs/example.toml @@ -148,6 +148,20 @@ htpasswd = "/etc/continuum/htpasswd" # party listing many nodes can't be all of them. # store-neighbour-parties = ["lass"] +# Behind the `federation` feature: this node votes and proposes for its party by itself +# (docs/federation.md, Votes a node casts by itself), with a key its party's version +# names, kept here, and its party's one record of its votes; its party then votes by +# hand only through it (POST /admin/events/vote). It follows the parties named (by +# default only on versions that only move to a checkpoint), and proposes a checkpoint +# once it holds so many events beyond its checkpoint, or so long after it moved there. +# store-vote-key = "/var/lib/continuum/party.key" +# store-vote-record = "/var/lib/continuum/party-record.json" +# store-follow = ["lass"] +# store-follow-any = false +# store-propose-events = 10000 +# store-propose-every = "7d" +# store-held-for = "10m" + # SSH keys, as authorized_keys lines (ssh-ed25519 [comment]), whose signature # on a strict remake's manifest this node takes: the values kept when the swarm turns # strict (docs/access.md). Without, it votes for no strict remake; a majority of the -- cgit v1.3.1