Expand description
§Libro — Cryptographic Audit Chain
Libro (Italian/Spanish: book, record) provides tamper-proof event logging with hash-linked entries. Every event is chained to the previous via SHA-256, making any modification detectable.
§Feature Flags
| Flag | Description |
|---|---|
sqlite | SQLite-backed audit store with indexed queries |
signing | Ed25519 digital signatures per entry |
streaming | Real-time pub/sub via majra |
None are enabled by default.
§Modules
entry— Audit entries with hash linkingchain— The audit chain: append, verify, query, rotate, retain, paginatestore— Persistence backends (memory, file, custom)file_store— Append-only JSON Lines file backendquery— Composable query filtersexport— JSON Lines and CSV exportretention— Retention policiesreview— Structured chain review and summarymerkle— Merkle tree for efficient partial verificationverify— Chain integrity verification- [
signing] — Ed25519 per-entry signatures (feature:signing) - [
streaming] — Real-time pub/sub (feature:streaming) - [
sqlite_store] — SQLite persistence (feature:sqlite)
Re-exports§
pub use chain::AuditChain;pub use chain::ChainArchive;pub use entry::AuditEntry;pub use entry::EventSeverity;pub use export::to_csv;pub use export::to_jsonl;pub use file_store::FileStore;pub use merkle::MerkleProof;pub use merkle::MerkleTree;pub use query::QueryFilter;pub use retention::RetentionPolicy;pub use review::ChainReview;pub use verify::verify_chain;
Modules§
- chain
- The audit chain — append-only, hash-linked sequence of entries.
- entry
- Audit entries with hash linking.
- export
- Export audit entries to JSON Lines and CSV formats.
- file_
store - File-based audit store — append-only JSON Lines format.
- merkle
- Merkle tree for efficient partial verification of audit chains.
- query
- Query filters for audit entries.
- retention
- Retention policies for audit chains.
- review
- Chain review — structured summary and per-entry audit trail.
- store
- Persistence backends for the audit chain.
- verify
- Chain verification — validate integrity of an audit chain.