diff options
| author | tv <tv@krebsco.de> | 2026-11-19 03:56:57 +0000 |
|---|---|---|
| committer | tv <tv@krebsco.de> | 2026-11-19 05:12:15 +0100 |
| commit | efaf79e7fd55db2b9704ccefedde33346f874a1d (patch) | |
| tree | 245bf0812b7cb95b000928a2739e0ff140352818 /docs/guides/federation/voting-by-itself.md | |
| parent | 5611555bd31e5b05bcee6c6e4450adeffd2e820b (diff) | |
vote: a node proposes a checkpoint at the heads it holds
A node proposed a checkpoint at the heads of what it held for a while: every event
written in that while, and every one built on an event beside those heads, as one party
writing now and then on something old makes them, was beside them, and refused once the
store moved. A voter whose while was shorter backed none, one whose while was longer
backed it and lost those.
It proposes at the heads its store holds, sorted: what was written before is in their
history, and only what is written while the vote takes its course may be beside them. It
proposes none where they are more than an event may name: under a revision with merge
events, it merges them first; otherwise, what is written after does. `--store-held-for`
keeps the voters' rule and how long a new proposal holds back a checkpoint.
`federation.md`, the guides and the options say so.
Diffstat (limited to 'docs/guides/federation/voting-by-itself.md')
| -rw-r--r-- | docs/guides/federation/voting-by-itself.md | 10 |
1 files changed, 6 insertions, 4 deletions
diff --git a/docs/guides/federation/voting-by-itself.md b/docs/guides/federation/voting-by-itself.md index 0390cfd..2209389 100644 --- a/docs/guides/federation/voting-by-itself.md +++ b/docs/guides/federation/voting-by-itself.md @@ -52,10 +52,12 @@ or `POST /admin/events/vote` with `{"proposal": "8d02…", "yes": true}`. COUNT`, `--store-propose-every DURATION`): once it holds so many events beyond its checkpoint, so many versions were written since it, 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 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 + heads it holds, no more than an event may name (64, which it merges first under a + revision with merge events), 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 + (`--store-held-for`, ten minutes unless set) whose proposer has none older on the + version. It backs what it proposes, so that the nodes following its party back it too. With `--store-propose-versions 1`, it proposes one after every version: after a close vote, one key voting twice can pass a rival version at a history from before it, any time |
