diff options
| author | tv <tv@krebsco.de> | 2026-11-18 18:49:50 +0000 |
|---|---|---|
| committer | tv <tv@krebsco.de> | 2026-11-18 20:29:41 +0100 |
| commit | c64fcc05d8c53bee99ab039bd709039afb730cdd (patch) | |
| tree | 45baad78d7b92de42283be2954fc3f9b4dd6129d /docs/guides/federation/watching.md | |
| parent | 598366b03679eac9d04f32d9194f3ba4ba9c3da8 (diff) | |
federation: a node stops at a version it doesn't read
A version event writing a proposal passed on the version a node reads, which doesn't
read as a version there (of a later federation, using what a later continuum takes, or
none at all), the node can't judge: `Fold::stops`. The store stops at it: it takes
nothing and refuses nothing from then on, holding back whatever comes, that event first
(`Offered::Stopped`), and keeps none of it across a restart, where it stops there again.
One beside the version the node reads is refused of its own, as any other.
Its operator has it drop that event (`POST /admin/events/drop`), or one it builds on:
it is refused as dropped, or as built on what was, any version event writing that
version with it, kept in the store file; the node judges what it held back and goes on
under the version before. Allowed again, it stops there once more.
The node logs the stop and its end; `GET /events` names the event, why, and how many it
holds back (`stopped`); a put answers `stopped`, written into the document all the same;
a node voting by itself casts nothing while stopped. The test fold's eras tagged `new`
stop a store.
Row 39 is tested (`federation_attack_39`); of rows 9, 10 and 48, a node stops at the
version event.
Diffstat (limited to 'docs/guides/federation/watching.md')
| -rw-r--r-- | docs/guides/federation/watching.md | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/docs/guides/federation/watching.md b/docs/guides/federation/watching.md index f55005a..ec7ce6a 100644 --- a/docs/guides/federation/watching.md +++ b/docs/guides/federation/watching.md @@ -10,6 +10,11 @@ store, through its API and its log. * **A version the node refused** (`own` in `GET /events/refused` not empty): keys voted twice, and nodes may be apart. Act on it at once ([`when-things-go-wrong.md`](when-things-go-wrong.md)). +* **A stop** (`stopped` in `GET /events` not `null`): a version passed that the node's + continuum doesn't read, and it takes nothing until upgraded, or until its operator has + it drop that version event + ([`when-things-go-wrong.md`](when-things-go-wrong.md), + [A node stopped](when-things-go-wrong.md#a-node-stopped)). * **No store** (`404` from `GET /events` for longer than a start takes): the node can't read its store ([`when-things-go-wrong.md`](when-things-go-wrong.md), [A node doing less than it should](when-things-go-wrong.md#a-node-doing-less-than-it-should)). @@ -37,6 +42,9 @@ At warn or error: * `Refused an event its history takes, by what this node took before: kept so`: a version the node refused, as above; +* `The store stopped at an event this continuum can't judge: it takes none until it runs + one that does, or its operator has it drop that one`: a stop, as above; `The store + takes events again` once its operator had it drop that event; * `This node isn't a member of its store, as it reads now: its party doesn't list it, and members don't sync with it`; * `The pinned checkpoint isn't in the document (yet): holding no store until it is`; |
