From ad39428c84a1fc36f7194cd0e0356276ff9a65fd Mon Sep 17 00:00:00 2001 From: tv Date: Sat, 14 Nov 2026 05:52:43 +0000 Subject: federation: `limits.writers` recommended at 64 Every writer costs every node 4 bytes for every change of the epoch, those before it started too. At a year of a hundred nodes' daily stamps, one user that starts 1 024 writers costs every node some 143 MB; 64 cost some 9 MB there, and 2.5 MB at the `remakeChanges` an epoch now reaches. 64 writers are a node restarting weekly for more than a year; a swarm whose epochs last longer than that (few nodes, writing little) sets it higher, as the text now says. --- docs/federation.md | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) (limited to 'docs/federation.md') diff --git a/docs/federation.md b/docs/federation.md index 8ceac00..1854ef6 100644 --- a/docs/federation.md +++ b/docs/federation.md @@ -241,7 +241,7 @@ value: | `limits.users` | 16 | users a user created that stand; a root: no limit | | `limits.vouches` | 64 | vouches of a user that stand | | `limits.proposals` | 8 | proposals of a user that are open | -| `limits.writers` | 1024 | writers a user's nodes start in an epoch before more are put off | +| `limits.writers` | 64 | writers a user's nodes start in an epoch before more are put off | | `limits.name` | 255 | bytes of a name | | `limits.entry` | 4096 | bytes of a node's member entry | | a kind's `limit` | none | names of the kind a user holds by a claim | @@ -365,11 +365,14 @@ grows. A statement is signed by one user and says one thing: stopped with count for nobody: a thief's node costs its victim nothing once cut off, and where the count falls back below the limit so, every node takes what it put off for that user, read again from the changes, nobody acting: late, with what was built - on it. A writer is a run, not a write: with a thousand, three nodes each crash or - rejoin daily for most of a year. A node whose writers count for a user past it is - put off as a whole, with what it carries for others and its records of proposals, - until a remake or its operator takes what is put off; how many a user's nodes - started shows (`GET /registry/users`), for a remake to come first. + on it. A writer is a run, not a write: 64 are a node restarting weekly for more than + a year. Each costs every node 4 bytes for every change of the epoch, those before it + started too *(measured upstream)*: 64 cost some 2.5 MB at `remakeChanges` changes. + Where epochs last long (few nodes, writing little), a user whose nodes restart often + reaches it first: such a swarm sets it higher. A node whose writers count for a user + past it is put off as a whole, with what it carries for others and its records of + proposals, until a remake or its operator takes what is put off; how many a user's + nodes started shows (`GET /registry/users`), for a remake to come first. * **A party's budget.** A node takes changes from a party's nodes no faster than a budget, its own setting: what is over waits, and nothing is refused for it. For a budget a party is a user with the users below it that no line reaches but through -- cgit v1.3.1