aboutsummaryrefslogtreecommitdiffstats
path: root/docs/example.toml
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-19 01:48:58 +0000
committertv <tv@krebsco.de>2026-11-19 03:19:39 +0100
commitdd720b2556fa64bd07dc1d087b502ac4ab0f7899 (patch)
tree1a56f3f9c556a3d44197732d66ba0a1af52f3d35 /docs/example.toml
parentb00371d1260f4379241a9226d576270dd3a68285 (diff)
vote: propose a checkpoint after so many versions
The votes cast before count at a history from before too: a proposal that died, or a rival, needs there only the votes it lacked, and after a close vote one key voting twice is enough, at any time until a checkpoint above the version that followed. Nodes that took that version refuse it; one lagging behind, or joining from the root, may take it. `federation.md` said it took the keys of two thirds of the parties. A node voting by itself proposes a checkpoint once so many versions were written since its store's (`--store-propose-versions`), as the design lists: with 1, after every version, so that what keys voting twice grow beside a version ends at a checkpoint above it. `federation.md` says how little a rival version takes, row 20 too, and the guides the option.
Diffstat (limited to 'docs/example.toml')
-rw-r--r--docs/example.toml6
1 files changed, 4 insertions, 2 deletions
diff --git a/docs/example.toml b/docs/example.toml
index 4bb5c98..4078017 100644
--- a/docs/example.toml
+++ b/docs/example.toml
@@ -154,8 +154,9 @@ htpasswd = "/etc/continuum/htpasswd"
# hand only through it (POST /admin/events/vote). It follows the `true` of the parties
# named (by default only on versions that only move to a checkpoint), votes `false` on a
# checkpoint proposed beside one it backs, if told, and proposes a checkpoint once it
-# holds so many events beyond its checkpoint, or so long after it moved there; it backs
-# and proposes none sooner than store-back-after after a move or its start.
+# holds so many events beyond its checkpoint, so many versions were written since, or so
+# long after it moved there; it backs and proposes none sooner than store-back-after
+# after a move or its start.
# store-vote-key = "/var/lib/continuum/party.key"
# store-vote-record = "/var/lib/continuum/party-record.json"
# store-follow = ["lass"]
@@ -163,6 +164,7 @@ htpasswd = "/etc/continuum/htpasswd"
# store-nay-beside = false
# store-propose-events = 10000
# store-propose-every = "7d"
+# store-propose-versions = 1
# store-held-for = "10m"
# store-back-after = "10m"