diff options
| author | tv <tv@krebsco.de> | 2026-11-16 19:38:26 +0000 |
|---|---|---|
| committer | tv <tv@krebsco.de> | 2026-11-16 21:25:23 +0100 |
| commit | 3fccc4f6859cf0b4d93e7d166142e1ab9255723f (patch) | |
| tree | 7a76c8bfe5b186ec063feb8e454de583f0c87ff5 /src/document/events.rs | |
| parent | 69d2aace79eb61d800afa3a0779cfe3a9dfe1039 (diff) | |
access: what a change of a swarm holding a store writes
Every node judges a change of a swarm holding a store by what it writes, at its history
(`docs/store.md`, What a change writes), in place of rules by path: `access::holding`.
It writes events, each at `_continuum/events/<ID>` the bytes whose SHA-256 that is, no
larger than the fold allows (the federation's 256 KiB), at a key held nowhere at the
change's history; and its node's entry, with the member list's map where there is none.
Everything else is refused, as closed: values outside `_continuum`, the policy, the
swarm's ID, users, bans, the topology, remakes and their acks. Nothing deletes or
replaces an event. A change names its node; the genesis change's writer names none, so
no change under it is taken but the genesis change.
In a swarm not holding a store, a change writing a policy naming one is refused: a swarm
holds a store from its genesis change, or not at all.
The inspector tells a put of bytes apart (`Action::PutBytes`), with the bytes, for the
events' check. All of it behind the `federation` feature.
Diffstat (limited to 'src/document/events.rs')
| -rw-r--r-- | src/document/events.rs | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/src/document/events.rs b/src/document/events.rs index 7b0fe5e..2b3a7e0 100644 --- a/src/document/events.rs +++ b/src/document/events.rs @@ -117,6 +117,16 @@ pub(crate) fn is_genesis(change: &Change, fold: &str, id: &Id) -> bool { root.is_some_and(|root| genesis(fold, &root).hash() == change.hash()) } +/// Puts `bytes` at the event `id`, held there or not, as no change of a node puts an +/// event: for tests of what a change may write. +#[cfg(test)] +pub(crate) fn put_held(doc: &mut super::Transaction<'_>, id: &Id, bytes: &[u8]) { + use automerge::transaction::Transactable; + let events = events_map(doc).expect("the events' map"); + doc.put(&events, id.to_string(), ScalarValue::Bytes(bytes.to_vec())) + .expect("a put"); +} + #[cfg(test)] mod tests { use super::*; |
