Crate hyphae_storage

Expand description

Durable log, recovery, snapshot, and materialized-index implementation.

Structs§

BackupInfo: Verified metadata for one portable backup directory.
CommitReceipt: Durable identity of a committed transaction.
CompactionReport: Evidence for one successfully committed compaction generation.
DataDirectory: An exclusively owned Hyphae data directory.
DurableLog: Append-only transaction log with synchronous commit durability.
KvEntry: One binary KV entry in canonical key order.
KvPage: One bounded ordered KV scan page.
OpenedLog: A newly opened writer together with its recovery evidence.
OpenedStorage: A newly opened storage engine and its recovery evidence.
RecoveredTransaction: A committed transaction reconstructed from the verified log.
RecoveryReport: Evidence produced while opening and validating a segment.
RestoreInfo: Evidence that a backup was fully verified before destination activation.
SnapshotContents: Fully verified logical snapshot contents for offline operations.
SnapshotEntry: One verified logical KV entry loaded from a canonical snapshot.
SnapshotInfo: Verified metadata for one logical snapshot.
SnapshotReadLimits: Resource limits for loading a verified logical snapshot as an offline witness.
StorageEngine: Single-writer durable KV storage composed from the log and rebuildable redb index.
StorageRecoveryReport: Recovery evidence returned when the complete embedded storage layer opens.

AppendOutcome: Result of an idempotent append request.
BackupError: Failure while creating, verifying, or restoring a portable backup.
CompactionOutcome: Result of an online compaction request.
DataDirectoryError: Failure while opening or initializing a Hyphae data directory.
LogError: Failure while opening, validating, or appending to a durable log.
ManifestError: Failure while loading or atomically creating a storage manifest.
MaterializedIndexError: Failure while opening, verifying, or updating the rebuildable redb index.
Mutation: A deterministic mutation persisted inside one transaction operation frame.
MutationError: Failure while validating or decoding a persisted mutation.
SnapshotError: Failure while creating or verifying a logical snapshot.
StorageError: Failure while opening or operating the durable embedded storage engine.

MAX_KEY_BYTES: Maximum encoded key length accepted by the embedded KV layer.
MAX_SCAN_PAGE_ENTRIES: Maximum KV entries returned by one ordered storage scan page.

load_snapshot: Loads every logical KV entry from a verified snapshot under explicit resource limits.
restore_backup: Restores a verified backup to a new data directory.
verify_backup: Verifies a backup layout, bounded manifest, and complete snapshot.
verify_snapshot: Streams and verifies a snapshot without opening a Hyphae data directory.