diff options
| author | tv <tv@krebsco.de> | 2026-11-19 14:44:31 +0000 |
|---|---|---|
| committer | tv <tv@krebsco.de> | 2026-11-19 15:53:25 +0100 |
| commit | c61ee56ad0dad9f3c7468616d89d944eda7f5edb (patch) | |
| tree | 275db3f4e6f2ed980871aa7fe301e195eb54048c /docs/guides | |
| parent | 33be6b959c9777c40ca2b16507e9f4f60d6d2d44 (diff) | |
docs: purges in rounds, a version's size, a thief asking, one spelling
What the docs left unsaid, each with a row of the attack table:
* two thirds are of the current version's parties, so taking parties
out in rounds leaves fewer to decide: of nine, four alone after two
rounds; those taken out fork (row 75);
* a version is one event, its parties and rules with it, within
256 KiB: a federation giving each name a rule of its own holds a few
thousand names (federation.md, the rules guide);
* a thief holding a key a version names can ask for the party's keys to
be named anew as well as the party, and the others tell them apart by
other means than the key (row 76, the keys guide);
* rules match spellings, so `7` and `07` are two places, which two
rules may give to two parties; the application takes one spelling of
each (row 77, the rules guide).
Diffstat (limited to 'docs/guides')
| -rw-r--r-- | docs/guides/federation/designing-rules.md | 7 | ||||
| -rw-r--r-- | docs/guides/federation/keys.md | 4 |
2 files changed, 10 insertions, 1 deletions
diff --git a/docs/guides/federation/designing-rules.md b/docs/guides/federation/designing-rules.md index bd577cd..d8654f9 100644 --- a/docs/guides/federation/designing-rules.md +++ b/docs/guides/federation/designing-rules.md @@ -62,6 +62,10 @@ Keep party names apart from the shared spellings: a party named `wiki` takes `wi where a `{party}` rule comes before the rule giving it to lass. Put the rules naming shared places first, and let no party be named like one of them. +Rules match spellings: an address written `ip4/10/243/7/3` and one written +`ip4/10/243/07/3` are two places, which two rules may give to two parties. Take one +spelling of each (no zeros in front, lower case), as no rule can tell them apart. + ## What rules cost A version holds all its rules, and every change of one is a version, which takes the @@ -69,6 +73,9 @@ 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. +A version is one event, all its rules with it, of at most 256 KiB: a rule per name holds +a few thousand names. + 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 diff --git a/docs/guides/federation/keys.md b/docs/guides/federation/keys.md index add7cb3..f21171f 100644 --- a/docs/guides/federation/keys.md +++ b/docs/guides/federation/keys.md @@ -110,7 +110,9 @@ set that party wrote count no more. to pass a version naming the party's keys anew, at once; then write the party's set and node list under it, as a list the thief wrote stays until the party writes one under the version that replaced the key. If the thief voted twice meanwhile, nodes may have - taken two versions: the parties answer that by forking. + taken two versions: the parties answer that by forking. The thief can ask as well, as + the party would, holding the same key: the other parties make sure who asks by other + means (in person, a key of the party's set the thief lacks) before passing it. ## The node key |
