diff options
| author | tv <tv@krebsco.de> | 2026-11-18 17:26:53 +0000 |
|---|---|---|
| committer | tv <tv@krebsco.de> | 2026-11-18 18:31:11 +0100 |
| commit | 598366b03679eac9d04f32d9194f3ba4ba9c3da8 (patch) | |
| tree | 91620955243fa081fdd0365fb76c8aca0ba4288c /docs/openapi.yaml | |
| parent | f261a80b88c1fb640f4c892934809e15a7e05a95 (diff) | |
store: a drop refuses whatever writes what a dropped event writes
A fold may say what an event writes that others may write alike
(`Fold::writes`): of the federation, a version event's version. A node
whose operator has it drop such an event drops the taken events writing
the same with it, and refuses any writing it from then on, whoever wrote
it anew: of a version, it takes no other version event naming it and
writes none itself, though it holds the votes that passed it. The node
keeps what each dropped event writes in its store file, across restarts;
allowing one of them takes them all back.
Row 51 of the federation's attacks has its test, and waits no more.
Diffstat (limited to 'docs/openapi.yaml')
| -rw-r--r-- | docs/openapi.yaml | 17 |
1 files changed, 10 insertions, 7 deletions
diff --git a/docs/openapi.yaml b/docs/openapi.yaml index 2017f15..3dbcd62 100644 --- a/docs/openapi.yaml +++ b/docs/openapi.yaml @@ -1576,7 +1576,8 @@ paths: description: | The events the store refused: `own`, those its history takes but this node doesn't, by what it took before (a version changing another than the one it - reads), apart from the rest; `dropped`, those its operator had it drop; and + reads), apart from the rest; `dropped`, those its operator had it drop, and + version events naming a version among them; and `refused`, every other, with its kind (`none`: none of the federation's events; `judged`: refused at its history; `builtOn`: built on `on`, refused; `notAbove`: not above the checkpoint's heads, as a move refuses it) and why. @@ -1679,11 +1680,12 @@ paths: tags: [Events] summary: Drop events this node took description: | - Drops events the store took after its checkpoint, with everything built on - them: this node refuses them from then on, from whoever brings them, and keeps - so across restarts (`--store-file`), until it is told otherwise - (`/admin/events/allow`). Not what the checkpoint keeps or holds by ID. Answers - what it dropped, in the order taken. Needs `write` on `_continuum`. + Drops events the store took after its checkpoint, version events naming the + version one of them names, and everything built on them: this node refuses them + from then on, from whoever brings them, and any version event naming a version + among them, and keeps so across restarts (`--store-file`), until it is told + otherwise (`/admin/events/allow`). Not what the checkpoint keeps or holds by + ID. Answers what it dropped, in the order taken. Needs `write` on `_continuum`. requestBody: required: true content: @@ -1715,7 +1717,8 @@ paths: summary: Take back what this node refused of its own, or dropped description: | Takes back what this node refused of its own, or dropped, among the events - named, and what was refused for building on them: they are taken again where the + named, the version events dropped for naming the version one of them names, and + what was refused for building on them: they are taken again where the store takes them, as it reads its document again. Needs `write` on `_continuum`. requestBody: |
