aboutsummaryrefslogtreecommitdiffstats
path: root/docs/peers.md
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-13 20:24:39 +0000
committertv <tv@krebsco.de>2026-11-13 20:24:39 +0000
commit5913c6cc383ade12a8edc01d0f47d9671fb53227 (patch)
treee78aef7551e544f3d73175a680e3990e97bda0bc /docs/peers.md
parente8a6110722b3d9cb6611631eeafedddd4f9b4cec (diff)
relay: a STATUS's heads wait at least 50 ms before they are pulled
A neighbour pulls heads a STATUS listed only if it still lacks them after a round trip to the sender, as they are usually on their way along a writer's tree. With no round trip known, or one measured long ago (busy pairs send no keepalives), it pulled at once; with a short one, a STATUS sent right after a change can overtake it by more than that round trip, delays varying per message. Either way the change came twice (`trees_hold_through_continuous_writes`: c pulled once while every write reached it along x's tree). The wait is the round trip, but 50 ms at least (and 1 s at most, as before).
Diffstat (limited to 'docs/peers.md')
-rw-r--r--docs/peers.md3
1 files changed, 2 insertions, 1 deletions
diff --git a/docs/peers.md b/docs/peers.md
index 4aa1334..f5b6ab6 100644
--- a/docs/peers.md
+++ b/docs/peers.md
@@ -330,7 +330,8 @@ own announcement or STATUS brought them, are this node's: announcements wait 200
the other skips it; nor one whose latest heads, as it said them in a STATUS or a sync
message, have all of this node's in their history: it is as far or further), and a neighbour that lacks those heads pulls them (it sets them as the peer's heads in its sync state, so Automerge asks
for what's missing), if it still lacks them after a round trip to the announcer (at
-most 1 s): while writes go on, the newest are usually on their way to it along a
+least 50 ms, at most 1 s: a STATUS can overtake a change sent just before it by more
+than a short round trip, and a round trip measured long ago says nothing): while writes go on, the newest are usually on their way to it along a
writer's tree, and would otherwise come twice. It pulls from one neighbour at a time
(until the answer is overdue, by the sync reply timeout, or 15 s); neighbours that
announce heads it lacks meanwhile wait their turn and are pulled from as soon as the