The pieces / weirdnet-storage

weirdnet-storage

SQLCipher databases opened with a caller-supplied raw key, migrations, savepoints, sync change log.

GitHub crates.io docs.rs weirdnet-storage = "0.1"

What it is

General storage for SQLite databases encrypted with SQLCipher. The crate knows no schema and no brand: callers bring their migrations, table registry and queries.

It never derives, wraps, stores, recovers or exports a key, and never sees a password. Opening with a key fails if SQLite was built without SQLCipher, so a key is never silently ignored.

What is in it

  • open, open_readonly, open_in_memory: open with a raw 32-byte key and verify it, in a private folder (0700) and file (0600).
  • rekey and encrypt_plaintext_in_place.
  • migrate: ordered migrations in one transaction, with a hook after each one.
  • savepoint, begin/release/rollback: all-or-nothing units that nest.
  • files (private files written through a side file), snapshot_to (online copies), and sync: a trigger-kept change log, row codec and hash, three-way merge decisions.

Where it fits

  • Used by Morph, weirdnet-relay.
  • Extracted from Muninn.
  • License: BSD-3-Clause.