aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-12 22:56:02 +0000
committertv <tv@krebsco.de>2026-11-12 22:56:02 +0000
commit5b43b3ab2b0ac2a1849b6a5db5a16eba6975b9a8 (patch)
tree77d1027f287dc717a60773fee15cb77bf904c7da
parentff6a7acc6ef643ba9fb282369d41468eb8efd58d (diff)
federation: a thousand writers a user, and what the limit does
`limits.writers` is recommended at 1024. A user whose nodes started that many starts no more until a remake; how many they started shows.
-rw-r--r--docs/federation.md8
1 files changed, 6 insertions, 2 deletions
diff --git a/docs/federation.md b/docs/federation.md
index 9241e8e..bce0d0a 100644
--- a/docs/federation.md
+++ b/docs/federation.md
@@ -212,7 +212,7 @@ value:
| `limits.users` | 16 | users a user created that stand; a root: no limit |
| `limits.vouches`, `limits.bans` | 64 | vouches, and bans, of a user that stand |
| `limits.proposals` | 8 | proposals of a user that are open |
-| `limits.writers` | 256 | writers a user's nodes start in an epoch |
+| `limits.writers` | 1024 | writers a user's nodes start in an epoch |
| `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 |
@@ -295,7 +295,11 @@ grows. A statement is signed by one user and says one thing:
it starts, rejoins or drops *(docs)*. Every writer costs every node memory while
the epoch lasts, in proportion to the document's history: about 4 bytes per change
*(measured upstream)*. So a user's nodes start `limits.writers` in an epoch at
- most, and a federated node keeps its writer over a clean stop.
+ most, and a federated node keeps its writer over a clean stop. A writer is a run,
+ not a write: with a thousand, three nodes each crash or rejoin daily for most of
+ a year. A user whose nodes started that many starts no more until a remake, so a
+ node of its that crashes then writes nothing. How many a user's nodes started
+ shows (`GET /registry/users`), for a remake to come first.
* **Past a limit.** A user's statements of one kind are counted from the first: each
has, and states, the number after the highest of those it was signed in sight of,
and of two with one number the one with the lower digest comes first. A statement is