diff options
| author | tv <tv@krebsco.de> | 2026-11-16 13:12:01 +0000 |
|---|---|---|
| committer | tv <tv@krebsco.de> | 2026-11-16 15:05:53 +0100 |
| commit | 4bcb412f95a003d86a0bbad64576259a951e7c80 (patch) | |
| tree | e7fe68b768553e27c9300ae39c85b4e20f002d8d /README.md | |
| parent | 7ff0679c77be3e10348599d74941d7a28305311c (diff) | |
docs/store: a store of events, generic over its fold
A set of events that only grows, each named by the SHA-256 of its bytes and naming
those it builds on, judged at that history so that every node judges it alike, and read
together as one state. What the events are, how one is judged and what they read as is
a fold's, a trait the federation is the first to implement.
Its first home is a swarm's Automerge document: each event is bytes at
`_continuum/events/<ID>`, a change writes events and continuum's protocol data only,
and a node puts again every event it doesn't refuse of a change it refuses or drops, so
that which change carries an event changes nothing. A compaction's snapshot holds the
events at its base, and every event beyond it is put again: remakes, rejoins and a
writer's two changes of one number change no event a node holds, and the fold never sees
them.
It says what is promised, a node's own refusals and drops, forks carrying their root's
history, members by the fold, where Automerge sets limits, its attacks, and what its
tests check. Nothing of it is built; all of it is to be behind the `federation` feature.
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 2 |
1 files changed, 2 insertions, 0 deletions
@@ -93,6 +93,8 @@ curl -u alice:secret localhost:3000/peers # who is out there * [`docs/access.md`](docs/access.md): users, and what each may do. * [`docs/federation.md`](docs/federation.md): a design for a swarm kept by parties that don't trust each other. Not built. +* [`docs/store.md`](docs/store.md): a design for a store of events, each judged where it + was written, generic over what they read as; the federation rests on it. Not built. * [`docs/topology.md`](docs/topology.md): who syncs with whom, and how a change passes on: the choices, which combine well, and what they cost. * [`docs/measurements.md`](docs/measurements.md): `/admin/stats` and its Prometheus metrics. |
