From 5d8259ce576fce47b921c0bfbd6821f255be504a Mon Sep 17 00:00:00 2001 From: tv Date: Thu, 19 Nov 2026 14:25:53 +0000 Subject: docs: how large checkpoints grow, joining before the first, counting support What the docs left unsaid: * A checkpoint names every event that counts, 32 bytes each, and has no size limit, unlike an event; nothing bounds what a party writes where its rules let it, so every node, snapshot and fork's root holds as much as it writes. A party writing more than the others will hold is taken out by a version, or the others fork. Row 73 says so, and the rules guide. * Before the first checkpoint passed, a node joins from the root and nobody pins anything: a chain of old keys needs keys a version replaced, and a node voting by itself proposes a checkpoint after every version that changes more; until that passes, a joining node takes the first of two versions it judges, as row 63 has it. * A `true` binds; what binds nobody is said outside the votes. The voting guide shows how parties count their support first by plain writes, at a place a rule gives each (`intents/{party}/**`), read at `values` in GET /events/counts. --- docs/guides/federation/designing-rules.md | 6 ++++++ 1 file changed, 6 insertions(+) (limited to 'docs/guides/federation/designing-rules.md') diff --git a/docs/guides/federation/designing-rules.md b/docs/guides/federation/designing-rules.md index db61f62..bd577cd 100644 --- a/docs/guides/federation/designing-rules.md +++ b/docs/guides/federation/designing-rules.md @@ -69,6 +69,12 @@ parties' votes. A rule per shared name is a vote per name, and makes every versi much larger: give zones and blocks by rules where the spelling allows, and leave literal rules to what is shared. +Nor does a rule bound how many places below it a party writes, or how large a value is +but by an event's size (256 KiB): every node holds what counts, and every checkpoint +names it, 32 bytes an event. A party writing more than the others will hold is taken out +by a version, or the others fork ([`federation.md`](../../federation.md), +[Checkpoints](../../federation.md#checkpoints)). + ## An example: the krebs registry The krebs users who will vote are parties, each with its hosts in its namespace -- cgit v1.3.1