Skip to main content

Crate deedar

Crate deedar 

Source
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 + evidence

Re-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), node SHA-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 deedar command uses.
CreateRequest
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_draft is 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::list to keep.
FormField
FsStore
Directory of deeds, write-once bytes, and tombstones.
Imported
What an import checked, and what it added to this store.
MailMessageId
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}/layout says about host attestation.
ProducedBy
Who made the deed. activity_id is an optional assignment id (a claimdag WorkId when that graph is the caller).
Step
StoreUrl
DEEDAR_URL contract: file:///abs/path is 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. trail walks deed sources.
UnsignedHead
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 check and deedar vouch check when 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}.evidence file 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 sources that name other deeds.

Type Aliases§

Result