aboutsummaryrefslogtreecommitdiffstats
path: root/docs/trust.md
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-07 22:35:21 +0100
committertv <tv@krebsco.de>2026-11-07 22:35:21 +0100
commit5471e5285e94ce7576e6c86f260fea15ed9503d1 (patch)
tree310be18d26611d6aaf6d8b02a118ba2fb6ef4aa1 /docs/trust.md
parentc3fde0fdd410902125f006f0a7d77ca030cb9061 (diff)
signatures: verified changes
GET /admin/changes shows whether a signature by its node vouches for each change. Auth plan M5.
Diffstat (limited to 'docs/trust.md')
-rw-r--r--docs/trust.md8
1 files changed, 6 insertions, 2 deletions
diff --git a/docs/trust.md b/docs/trust.md
index 8b0f72a..70369e2 100644
--- a/docs/trust.md
+++ b/docs/trust.md
@@ -61,8 +61,12 @@ node acts on what the document says:
* **User data**: any member can write or delete any path.
* **Who wrote what** (`GET /admin/changes`): each change names its node and API user
- as the writing node says; nothing signs that, so a member can name another. The
- names of the users who write are in the document, and so on every node.
+ as the writing node says. Nodes sign their changes ([`api.md`](api.md), Signed
+ changes), so a change a signature vouches for shows `verified`: its node made it.
+ One that shows unverified may yet be vouched for by its node's next signature, or
+ may be another member's claiming that node; nothing is refused for it yet. The user a
+ change names is its node's claim, signed or not. The names of the users who write
+ are in the document, and so on every node.
* **The member registry**: each node writes its own entry, but nothing stops a member
from writing others'. The registry decides the topology and, through the alive
stamps, the electorate of a remake.