aboutsummaryrefslogtreecommitdiffstats
path: root/docs/guides/federation/promises.md
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-19 01:48:58 +0000
committertv <tv@krebsco.de>2026-11-19 03:19:51 +0100
commite5f8df2a78f26d5928d1c96573dae5620dba5e25 (patch)
tree80e13aa7212b05c0a50be0c428d8377cf72b5fb0 /docs/guides/federation/promises.md
parent295ba74159e371bb9082fcbdada5eaf78de5d1dc (diff)
docs: quiet parties, proof of voting twice, the next change keeping the number
From the red-team review of the design: * a party that never votes holds those backing a proposal short by as many votes: they can neither pass it nor back another, a compromise all others would pass among them; `federation.md` draws that out, and the promises guide says so; * a client keeps its own votes and the nays that freed it, not another party's two: where keys voted twice, whoever saw it keeps the votes naming the party before a checkpoint leaves them out; * nothing but agreement keeps a party from using a change that keeps the federation's number before every node runs it: the next such change names itself in the version, so that two thirds decide when, and a node not running it stops at that version.
Diffstat (limited to 'docs/guides/federation/promises.md')
-rw-r--r--docs/guides/federation/promises.md5
1 files changed, 3 insertions, 2 deletions
diff --git a/docs/guides/federation/promises.md b/docs/guides/federation/promises.md
index 9059764..733c713 100644
--- a/docs/guides/federation/promises.md
+++ b/docs/guides/federation/promises.md
@@ -38,12 +38,13 @@ to whom. A party whose machine is taken over whole is the adversary from then on
* **Progress**: if the parties don't cooperate, nothing passes; those who do, fork.
* **Good votes**: a party may vote badly; a `true` binds it while its proposal can
- pass.
+ pass, and only other parties' nays free it: parties that never vote hold it there.
* **Delivery**: what a party's nodes withhold reaches nobody through them.
* **Speed and uptime**: a party that floods the store, or keeps remakes from committing,
makes nodes slow or runs them out of memory, never wrong. The others fork away from it.
* **One swarm where keys voted twice**: each node keeps the version it took, and nodes
- part, until their operators choose ([`when-things-go-wrong.md`](when-things-go-wrong.md)).
+ part, until their operators choose
+ ([`when-things-go-wrong.md`](when-things-go-wrong.md)).
* **Writes from before a move**: what isn't above a checkpoint's heads is refused once
nodes moved there; its party signs it again ([`checkpoints.md`](checkpoints.md)).
* **A joining node's view**: a node joining from the root of a federation that never