aboutsummaryrefslogtreecommitdiffstats
path: root/docs/openapi.yaml
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-18 17:26:53 +0000
committertv <tv@krebsco.de>2026-11-18 18:31:11 +0100
commit598366b03679eac9d04f32d9194f3ba4ba9c3da8 (patch)
tree91620955243fa081fdd0365fb76c8aca0ba4288c /docs/openapi.yaml
parentf261a80b88c1fb640f4c892934809e15a7e05a95 (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.yaml17
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: