# kcode-kweb-db
A disk-first convergent store for complete signed Kweb node revisions, immutable
objects, WAL-atomic multi-node transactions, bounded startup recovery, and
durable transaction-only gossip.
Version 1.0 uses canonical hand-written binary encodings and SHA-256 integrity
checks throughout its committed disk state. Inbound transactions are committed
only after all transactions named by their heads are present. Source-aware
gossip transactions may wait in memory while their object payloads are staged
on disk; the submitting peer is asked for missing dependencies. Ordinary
admission rejects a missing head. Repeated submission of the same waiting or
committed transaction is a successful no-op.
Transactions can reserve node IDs before supplying complete node data, allowing
multiple newly created nodes to reference each other atomically. Every reserved
ID must be materialized before finalization.
See `Documentation.md` for the complete API and on-disk contract.