Expand description
One-writer deed store. Clients speak the Cap’n schema via Client.
just deedar / any client
|
Client::create|get|list|find|trail|evidence|delete|leave|timestamp|current|migrate
| Cap'n (schema/deedar.capnp)
v
FsStore -- write-once bytes + frozen deed + evidenceRe-exports§
pub use log::Entry as LogEntry;pub use log::Head as LogHead;pub use receipt::check_handover;pub use receipt::check_since;pub use receipt::kept_head;pub use receipt::sign_head;pub use receipt::Bridge;pub use receipt::Handover;pub use receipt::Receipt;pub use receipt::SignedHead;pub use vouch::Checked;pub use vouch::Vouch;
Modules§
- log
- An append-only Merkle log over the deeds a store has issued, hashed as
RFC 9162 (doi:10.17487/RFC9162): leaf
SHA-256(0x00 || entry), nodeSHA-256(0x01 || left || right). Inclusion proofs catch a dropped deed; consistency proofs catch a rewritten log. Signatures alone bind neither. Gossip lives outside this file. Two consistent logs shown to two readers both verify here. - receipt
- Checking a deed somebody else handed over.
- vouch
- Signing a file that somebody else will open.
Structs§
- Audit
- What an audit found in both directions: logged and gone is tampering; served and never logged is a store that wants backfilling. A deed file that does not read, and that the log does not name, is unreadable.
- Client
- Cap’n client. Same path the
deedarcommand uses. - Create
Request - Agent and grants the writer stamps onto the deed.
- Deed
- The work plus its identity. The next unit opens it by
id. - DeedId
- Accession:
deed-<kind>-<slug>. - Draft
- Constructor input.
from_draftis the shipped assemble. - Evidence
- Writer-issued evidence about a deed.
- Exporter
- One reading of the log, held for a handover of many deeds; see
FsStore::exporter. Every receipt is a lookup in a tree built once. - Filter
- Which rows of
Client::listto keep. - Form
Field - FsStore
- Directory of deeds, write-once bytes, and tombstones.
- Imported
- What an import checked, and what it added to this store.
- Mail
Message Id - RFC 5322 msg-id, stored as
<local@domain>. - Measure
- Missing
- A deed the log names that the store no longer serves as logged.
- Policy
- What
{store}/layoutsays about host attestation. - Produced
By - Who made the deed.
activity_idis an optional assignment id (a claimdagWorkIdwhen that graph is the caller). - Step
- Store
Url DEEDAR_URLcontract:file:///abs/pathis the store.
Enums§
- Body
- Kind-specific product. Adding a variant does not rewrite the envelope.
- Demand
- Whether a store demands an attestation before it will hand a deed over.
- Error
- Face
- How a viewer looks at a deed. Face follows media type and body.
- Grant
- Host or path the seat allowed this sitting.
- Kind
- Closed catalog. Each kind is a handler.
- Request
- Response
- Source
- Prior deed, a path, or a URL.
trailwalks deed sources. - Unsigned
Head - Whether an import appends under a head this store did not accept.
- Walk
- Where the walk from one accession ended.
Constants§
- EXIT_
UNTRUSTED_ SIGNER - Status of
deedar checkanddeedar vouch checkwhen the check finished and the signer was not one the reader accepts. - PREFIX_
CANDIDATES_ SHOWN - Accessions an ambiguous-prefix line prints.
Functions§
- decode_
request - decode_
response - deed_
digest - Content address of the canonical deed bytes.
- default_
store - Where a seat keeps its store when nobody says otherwise.
- encode_
request - encode_
response - ensure_
dir - explain_
accession - The sentence for an accession that did not resolve to one deed.
- imprint_
hash - SHA-256 of the on-disk
{id}.evidencefile bytes. - is_
write_ once_ addr - open
- prefix_
matches - Accessions whose id, deed digest, or product path starts with
raw. - resolve
- Slug accession, or
sha256:of deed bytes or a product path on a listed deed. - store_
dir - timestamp_
req - RFC 3161 TimeStampReq version 1. MessageImprint is SHA-256 of
hashed_message. - walk_
trail - Walk
sourcesthat name other deeds.