From a9bd75d771df9c22eda1ffd72858031a613be145 Mon Sep 17 00:00:00 2001 From: tv Date: Sat, 14 Nov 2026 05:52:43 +0000 Subject: federation: catching up has a number of its own A node that comes back writes nothing before it caught up with the peers it keeps, or `witness` passed: one number meaning two things. A peer that delays what the node lacks for a minute had a root's node, back from a day off, write blind. `catchUp`, recommended 10 minutes, lets a swarm choose how long such a node waits. Past 32 heads, the STATUS names them by a digest, so the node goes by the sync that follows it. --- docs/federation.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/federation.md b/docs/federation.md index 25acc9e..6269203 100644 --- a/docs/federation.md +++ b/docs/federation.md @@ -236,6 +236,7 @@ value: | `remakeChanges` | 10000 | changes an epoch's history holds beyond its root change before a remake | | `remakeWriters` | 1000 | writers an epoch's changes start before a remake | | `witness` | 1 minute | how long a root's node lets a claim wait before it writes | +| `catchUp` | 10 minutes | how long a node that comes back waits to be caught up before it writes | | `limits.keys` | 64 | keys a user has at once | | `limits.nodes` | 64 | nodes carrying for a user at once | | `limits.users` | 16 | users a user created that stand; a root: no limit | @@ -726,10 +727,10 @@ What this gives: and whichever of two reaches one first when it is back holds. * **A node that comes back** (started, or cut off for a while) writes nothing before it caught up with the peers it keeps (its user's other nodes, its seeds): until it - holds the heads each of them had when it reached it, as the first STATUS says, - whatever they write after, or `witness` passed. A peer that keeps sending keeps it - silent no longer. So it is the harder to hand a node a rival before the claim it - would have seen first. + holds the heads each of them had when it reached it, as the first STATUS says (past + 32 heads, the sync that follows it), whatever they write after, or `catchUp` passed. + A peer that keeps sending keeps it silent no longer. So it is the harder to hand a + node a rival before the claim it would have seen first. * **Final.** A claim is **final** once it has been seen holding the name for `final` (Lengths of time). From then on no other claim of the name holds it or contests it, whatever a witness says and whatever is cut off: not a rival that a root says @@ -2204,7 +2205,7 @@ Claims: | 42 | Claims past its limit, in sight or out of sight of its other claims | Refuse in sight; out of sight, those past the limit don't count | 4, 6 | unit: `a_limit_in_sight`, `past_a_limit_out_of_sight` | | 43 | Claims `TV.r` beside `tv.r`, or `10.243.foo.bar`; claims one address in two spellings | Refuse what has characters the kind doesn't name. Else a name is compared as written: the application claims one spelling and reads no other | 4 | unit: `a_kinds_characters`; argued (Claims) | | 44 | A root says it saw a rival first, after the claim is settled | The name is contested; the registry names the changes and the root, and marks it if it showed both orders. Once the claim is final: nothing | not promised; 5 once final | unit: `a_root_contests`; sim: `both_orders_show` | -| 45 | Hands an honest node of a root or of the claimant, back from a day off, a rival before the claim | A node that comes back catches up with the peers it keeps before it writes. Where it wrote all the same: contested, until one releases or the voters say. Once the claim is final: nothing | not promised; 5 once final | sim: `a_node_handed_the_rival_first` | +| 45 | Hands an honest node of a root or of the claimant, back from a day off, a rival before the claim | A node that comes back catches up with the peers it keeps before it writes, for `catchUp` at most. Where it wrote all the same: contested, until one releases or the voters say. Once the claim is final: nothing | not promised; 5 once final | sim: `a_node_handed_the_rival_first` | | 46 | Two claims made at once reach two roots' nodes in two orders | Each is late against the other: contested, and one releases | 4 | unit: `roots_that_saw_two_orders` | | 47 | Keeps silent while no root's node is up, then claims saying it saw nothing | Before the claim is settled: contested, or whichever reaches a root's node first holds. After: late. Final: it gives way | 5 | unit: `silence_before_settling` | | 48 | Releases a claim with a stolen key, an accomplice claims | Once the key is cut off the release doesn't count: the accomplice's claim, made in sight of the first, gives way, unless it is final by then | 3, 4 | unit: `a_release_cut_off` | -- cgit v1.3.1