weirdnet-storage 0.1.0

Weirdnet storage: SQLCipher databases opened with a caller-supplied raw key, rekey and plaintext conversion, an ordered migration runner, savepoints, private files, snapshots and an optional row change log for sync.
Documentation

weirdnet-storage

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

  • open, open_readonly, open_in_memory: open with a raw 32-byte key the caller hands in, verify it (wrong key is StorageError::WrongKey), private folder (0700) and file (0600).
  • rekey: re-encrypt in place; encrypt_plaintext_in_place: convert a plaintext file, verified before it replaces the original.
  • migrate: an ordered list of migrations in one transaction, with a hook after each one.
  • savepoint, begin/release/rollback: all-or-nothing units that nest.
  • files: private folders, 0600 files written through a side file and renamed into place.
  • snapshot_to: an online copy of an open database, keyed the same way.
  • sync (default feature): a change log kept by triggers on the tables you register, row read and write by primary key, a row codec and hash, and the three-way merge decision.

Keys

The crate never derives, wraps, stores, recovers or exports a key, and never sees a password. It applies the raw key it is given (PRAGMA key/rekey) and zeroizes the literals it builds. Key management belongs to the caller (for example weirdnet-keys). Opening with a key fails with StorageError::NoCipher if SQLite was built without SQLCipher, so a key is never silently ignored.

Features

  • sync (default): the change-log module; adds serde, serde_json, sha2 and base64.

SQLCipher is always bundled with vendored OpenSSL (rusqlite/bundled-sqlcipher-vendored-openssl).