From 101080b8a62709cd2606dece086f959781bdf38f Mon Sep 17 00:00:00 2001 From: tv Date: Thu, 19 Nov 2026 01:48:57 +0000 Subject: vote: a follower copies no false, lapses nothing others back, waits after a move A node following a party (`--store-follow`) handed it more than the text said: * it copied the party's `false`: one party's nay freed bound followers, and its `true` shown to some and its `false` to the rest passed a checkpoint at one history and made it dead at another. It copies the `true` alone now, on any version too; * a checkpoint lapses every other proposal: the followed party ended any proposal it disliked by passing one. A node follows a checkpoint only where no proposal that changes more can still pass that someone but its proposer backs; * nothing bounded how often the store moved, so fresh events could be left out of every checkpoint; and a node just started held nothing for a while, so the voters' rule kept nothing. A node backs, and proposes, a checkpoint only once its store held its checkpoint, or ran, for a while (`--store-back-after`, ten minutes unless set), by itself or by hand. `federation.md` says what following hands over, and row 58 what a follower on any version copies; the guides and the example say the rest. --- docs/guides/federation/checkpoints.md | 7 +++++-- docs/guides/federation/voting-by-itself.md | 15 ++++++++++----- 2 files changed, 15 insertions(+), 7 deletions(-) (limited to 'docs/guides/federation') diff --git a/docs/guides/federation/checkpoints.md b/docs/guides/federation/checkpoints.md index 69debaf..345bc98 100644 --- a/docs/guides/federation/checkpoints.md +++ b/docs/guides/federation/checkpoints.md @@ -50,8 +50,11 @@ only so, and so does a vote by hand through it (`continuum-party vote … --thro party's client voting on its own (`continuum-party vote`) checks no heads: check them yourself, or vote through such a node. -* `--store-follow PARTY,…` has a node voting by itself follow those parties' votes, by - default on versions that only move to a checkpoint, and still by that rule. +* `--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. +* `--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 checkpoint, where it backs one that can still pass: of two checkpoints proposed at once, the other dies, and its backers are free. diff --git a/docs/guides/federation/voting-by-itself.md b/docs/guides/federation/voting-by-itself.md index b88947a..97f4eff 100644 --- a/docs/guides/federation/voting-by-itself.md +++ b/docs/guides/federation/voting-by-itself.md @@ -37,11 +37,16 @@ or `POST /admin/events/vote` with `{"proposal": "8d02…", "yes": true}`. ## Its rules * **Following** (`--store-follow PARTY,…`): it votes `true` on a proposal where a party - it follows voted `true`, and `false` where one voted `false`; by default only on a - version that only moves to a checkpoint. With `--store-follow-any`, on any version: - that hands those parties the node's vote, its `false` among it. A party followed so by - more than a third of the parties, with its key kept on a node, can end every proposal, - the one naming that key anew among them. + 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 + 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. +* **After a move** (`--store-back-after`, ten minutes unless set): it backs, and proposes, + no checkpoint until its store held its checkpoint, or ran, that long by its own clock, + by itself or by hand: the parties it follows move the store once that long at most, and + just started, it holds nothing for a while yet. * **Proposing checkpoints** (`--store-propose-events COUNT`, `--store-propose-every 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 -- cgit v1.3.1