Architecture

AingDB persists data to a single .adb file. The file starts with a small header containing magic, version, cipher, KDF, and salt, followed by a write-ahead log (WAL) of records. Periodically, AingDB writes a checkpoint to compact data and keep the file healthy.

• WAL & Checkpoint: fast appends, crash-safe, compacted via db.compact().
• Encryption (optional): AES‑256‑GCM / (X)ChaCha20‑Poly1305 with scrypt/argon2id KDF.
• Indexes: registry for secondary indexes, Full‑Text Search, HNSW vectors, and R‑Tree shapes.
• Observability: built‑in counters and optional Prometheus endpoint.
• Audit: append‑only audit log of mutating operations.

---

---