From b00371d1260f4379241a9226d576270dd3a68285 Mon Sep 17 00:00:00 2001 From: tv Date: Thu, 19 Nov 2026 01:48:58 +0000 Subject: vote: a proposal holds back checkpoints by a third, or new for a while A node voting by itself proposes no checkpoint beside a proposal that holds it back, as the checkpoint would lapse it, and a follower backs none so. A proposal held one back where someone but its proposer backed it: two parties, or one and a stolen key, kept a junk proposal alive, and no automatic checkpoint came while it lived, ending it taking nays from more than a third each round. And one new, its proposer alone backing it, was lapsed at once by a checkpoint its writes brought about. A proposal that can still pass holds back now where a third of the parties back it, someone but its proposer among them; or where it is new, held for less than a while (`--store-held-for`), and its proposer has none older on the version: so it is heard before a checkpoint lapses it, once a version for each proposer. Row 67 says so, and a test of nine parties checks it. --- docs/guides/federation/checkpoints.md | 9 ++++++--- docs/guides/federation/voting-by-itself.md | 12 +++++++----- 2 files changed, 13 insertions(+), 8 deletions(-) (limited to 'docs/guides') diff --git a/docs/guides/federation/checkpoints.md b/docs/guides/federation/checkpoints.md index 345bc98..f935421 100644 --- a/docs/guides/federation/checkpoints.md +++ b/docs/guides/federation/checkpoints.md @@ -37,8 +37,9 @@ nothing that can still pass is proposed on the current version. A node voting for its party by itself proposes checkpoints by its operator's rules: once it holds so many events beyond its checkpoint (`--store-propose-events`), or so long after its store moved there (`--store-propose-every`), at the heads of what it held for -a while (`--store-held-for`, ten minutes unless set), where nothing that can still pass -is proposed; and it backs what it proposes. +a while (`--store-held-for`, ten minutes unless set), where no proposal holds it back +([`voting-by-itself.md`](voting-by-itself.md), [Its rules](voting-by-itself.md#its-rules)); +and it backs what it proposes. ## Backing one @@ -52,7 +53,9 @@ yourself, or vote through such a node. * `--store-follow PARTY,…` has a node voting by itself follow those parties' `true`, by default on versions that only move to a checkpoint, and still by that rule, but not - where a proposal changing more can still pass that someone but its proposer backs. + where a proposal changing more holds it back, as a node proposing one keeps to + ([`voting-by-itself.md`](voting-by-itself.md), + [Its rules](voting-by-itself.md#its-rules)). * `--store-back-after` (ten minutes unless set) has it back none before its store held its checkpoint, or ran, that long. * `--store-nay-beside` has it vote `false` on every other version only moving to a diff --git a/docs/guides/federation/voting-by-itself.md b/docs/guides/federation/voting-by-itself.md index 97f4eff..cfcdcf3 100644 --- a/docs/guides/federation/voting-by-itself.md +++ b/docs/guides/federation/voting-by-itself.md @@ -38,8 +38,8 @@ or `POST /admin/events/vote` with `{"proposal": "8d02…", "yes": true}`. * **Following** (`--store-follow PARTY,…`): it votes `true` on a proposal where a party it follows voted `true`, never `false`; by default only on a version that only moves to - a checkpoint, and only where no proposal changing more can still pass that someone but - its proposer backs, as a checkpoint lapses it. Even so, the parties following one hand + a checkpoint, and only where no proposal changing more holds it back (below), as a + checkpoint lapses it. Even so, the parties following one hand it their votes on checkpoints. With `--store-follow-any`, on any version: that hands those parties the node's `true`. A party followed so by two thirds of the parties, with its key kept on a node, passes what it backs. @@ -51,9 +51,11 @@ or `POST /admin/events/vote` with `{"proposal": "8d02…", "yes": true}`. DURATION`): once it holds so many events beyond its checkpoint, or so long after its store moved there by its own clock, it proposes a version that only moves to a checkpoint, at the heads of what it held for a while (`--store-held-for`, ten minutes - unless set), where nothing that can still pass is proposed on the current version, - but a proposal it wouldn't back that nobody backs but its proposer. It backs what it - proposes, so that the nodes following its party back it too. + unless set), where no proposal on the current version holds it back: one it would back + that can still pass; one that can still pass that a third of the parties back, someone + but its proposer among them; or one held for less than a while whose proposer has none + older on the version. It backs what it proposes, so that the nodes following its party + back it too. * **`false` beside** (`--store-nay-beside`): where it backs a proposal that can still pass, it votes `false` on every other version only moving to a checkpoint, so that of two checkpoints proposed at once the other dies, and its backers are free. -- cgit v1.3.1