aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-16 17:12:34 +0000
committertv <tv@krebsco.de>2026-11-16 18:28:32 +0100
commit6ec65f58e1b55d799a81884be651ef8407ab9809 (patch)
tree714128ac64b666e0673267e7a982e789a6f7db6d /docs
parent7d8fb07dc100a45a0bd6c0efc245e5efc63fb32c (diff)
federation: a vote on a checkpoint isn't judged against its heads
A vote on a version naming a checkpoint was taken only where it was above the heads. It follows from the version event's being above them: the version event is taken only there, and with it every vote it is written on, as everything in the history of an event above some heads that isn't in theirs is above them. Two rules are left: the proposal is a version only where it is above the heads, and a version event writing it is taken only where it is above them. A vote cast beside them binds its party as any yes does, until the move refuses it; an honest client builds only on what is above them.
Diffstat (limited to 'docs')
-rw-r--r--docs/federation.md11
1 files changed, 6 insertions, 5 deletions
diff --git a/docs/federation.md b/docs/federation.md
index 97f3285..5873013 100644
--- a/docs/federation.md
+++ b/docs/federation.md
@@ -408,10 +408,11 @@ above them: a move refuses what isn't above its heads, and heads a proposer made
built on little, would take back what was written since, a key set dropping a stolen key
among it. A node shows, for a proposed checkpoint, what it holds that its heads lack, as
for a fork (Forks). This is the voter's rule, by its own clock: nothing more is judged.
-It is a version only where its proposal is above those heads, and a vote on it, or a
-version event writing it, is taken only where it is above them too
-([`store.md`](store.md), Events): so moving to the checkpoint refuses nothing that
-decided it. A node that takes the version moves to the checkpoint: it builds it, forgets
+It is a version only where its proposal is above those heads, and a version event
+writing it is taken only where it is above them too, and so is every vote it is written
+on ([`store.md`](store.md), Events): so moving to the checkpoint refuses nothing that
+decided it. A vote beside them binds its party as any yes does, until the move refuses
+it. A node that takes the version moves to the checkpoint: it builds it, forgets
everything before those heads that it doesn't keep, and every event not above them, and
refuses such events from then on. Judging an event after them needs nothing it forgot:
the version, every party's keys and node list, and the proposals on the current version
@@ -653,7 +654,7 @@ crafted events. *Sim*: a simulation. *Bench*: measured, not judged.
| 50 | An honest party backs a second proposal once its first is dead; another party later signs `true` on the first too | It isn't named: its first proposal is dead by all the votes; the party with `true` and `false` on one is | unit |
| 51 | A node whose operator had it drop a version is sent it again, written anew by another node, or holds the votes that passed it | It refuses any event writing that version and writes it no more, until its operator says otherwise | unit |
| 52 | A party taken out and let in again | The list it wrote before counts no more: its list's `since` is the version that let it in | unit |
-| 53 | A version naming checkpoint heads its proposal isn't above, or a vote on it, or a version event writing it, that isn't | No version, or refused: moving to a checkpoint refuses nothing that decided it | unit |
+| 53 | A version naming checkpoint heads its proposal isn't above, or a version event writing it that isn't, written on a vote beside them, say | No version, or the version event refused: moving to a checkpoint refuses nothing that decided it | unit |
| 54 | An event not above a checkpoint's heads (written beside them, built on one that was, or naming one before them), after nodes moved to it | Refused; its party signs it again | unit |
| 55 | A checkpoint a node can't build, handed to it by peers, or a fork's root it can't check | Taken only where its operator pinned it, or named the fork | unit |
| 56 | Two versions changing one, naming different checkpoints | As 12: each node keeps the one it took, and moves to its checkpoint | unit |