aboutsummaryrefslogtreecommitdiffstats
path: root/CHANGELOG.md
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-19 21:24:09 +0000
committertv <tv@krebsco.de>2026-11-19 22:30:41 +0100
commit237c79efc5d25f438d024522fd89ea7fc600cbd1 (patch)
tree4f36801570db29d495b655f66da9901baa149abf /CHANGELOG.md
parent5e93c28c963224ce89901b813c06598bcc84f8c7 (diff)
continuum-party: a record held against the node's votes, a wait, restore
A party votes from one record; a second record voting beside it, or one begun anew after a loss, can make the party vote twice. The client votes by its record, never by what a node shows, and still should look. Before a vote (`consistent`, `unrecorded`), the party's votes on the current version that the node shows (each proposal's yes and no) are held against the record's (Record::votes_cast): one the node shows that the record lacks refuses the vote, naming it and `restore`; one the record holds that the node doesn't show is said, as on its way or held back. Where they agree, nothing is said. What may keep a vote from the node is said too (`cut_off`, from counts' `heard`): the party's own nodes the node hasn't heard from in five minutes, through which another vote of it may have gone; and the parties none of whose nodes it heard from lately, where they are a third of those with nodes or more: a part of the swarm cut off. Then it waits (--wait SECONDS, 5 unless given, on vote and propose) and asks the node again: a vote cast elsewhere just before arrives first. A version passing meanwhile ends it, as the proposal lapsed. `restore` takes the party's votes on the current version, as the node holds them, into its record, or a new one of --party (Record::restore, checking each vote's signature, its party and version, none twice); a record begun on the current version casts on it then. Best effort: a vote on its way from elsewhere isn't among them, and what `again` signs anew, and the nays that freed an earlier `true`, it doesn't learn.
Diffstat (limited to 'CHANGELOG.md')
-rw-r--r--CHANGELOG.md9
1 files changed, 9 insertions, 0 deletions
diff --git a/CHANGELOG.md b/CHANGELOG.md
index de8582e..5a9ba55 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,15 @@ it from the release before ([`docs/operations.md`](docs/operations.md),
## Unreleased
+* Before a vote, `continuum-party` holds the record against the party's votes the node
+ shows, refusing where another record voted, and says what may keep votes away: the
+ party's nodes, or a third of the parties, not heard from lately (`heard` in
+ `GET /events/counts`); it waits a few seconds and asks again before it casts
+ (`--wait`). `restore` takes the party's votes from the node into a record, best effort
+ ([`docs/guides/federation/proposing-and-voting.md`](docs/guides/federation/proposing-and-voting.md),
+ [Voting](docs/guides/federation/proposing-and-voting.md#voting);
+ [`src/federation/party.rs`](src/federation/party.rs)).
+
* `continuum-party get PATH` reads what counts as JSON: a place's value, or what lies
under a path as one object, within places' values too; `-r` a string as it is
([`docs/guides/federation/writing-and-reading.md`](docs/guides/federation/writing-and-reading.md),