Core trait defining the database interface. Provides operations for reading, writing, and verifying state. # Thread Safety All methods are thread-saf

Utility functions for manipulating active bits using u64 operations. Works with 4-element u64 slices (256 bits total).

Hasher for 20-byte address keys. Uses all 20 bytes: bytes 0..8 XOR 8..16 XOR (12..20 shifted) + wyhash64.

Core database engine handling state storage and verification. Manages the underlying storage, indexing, and proof generation. # Architecture AdsCore

High-level wrapper providing block-oriented database operations. Manages block lifecycle, caching, and task coordination. # Type Parameters `T`: Task

Buffer with 512-byte alignment for O_DIRECT operations. This buffer guarantees that: - The starting address is aligned to 512 bytes - Memory is conti

Manages a pool of direct I/O buffers. Provides: - Buffer allocation - Buffer recycling - Buffer access

A sharded cache for storing and retrieving byte slices. This cache provides concurrent access through multiple shards, each protected by a read-write

A shard of the bytes cache that manages a subset of the cached data. Each shard maintains its own buffer pool and position mapping to reduce contenti

Manages the compaction process for a database shard. The Compactor coordinates storage optimization by: - Monitoring entry counts and triggering comp

Consumer end of a ring buffer channel. The consumer can: - Receive items from the producer - Return items back to the producer

Iterator over deactivated serial numbers in an entry. This iterator yields (index, serial_number) pairs for each deactivated serial number stored in

Trait for indexer operations required by EntryMutator

Trait for inspecting entry mutations during database operations. This trait provides hooks for monitoring entry operations such as reading, appending

Handles mutations of key-value entries with efficient indexing

Builder for creating EntryMutator instances with different configurations. This builder allows for step-by-step configuration of an EntryMutator, sta

Trait for storage operations on entries

Lock-free file slots using a resizable ring buffer. This is a specialized wrapper around `ResizableSlots<File>` with additional file-specific feature

Watches a directory and streams newly appended file bytes via a crossbeam channel. Implementation notes: - Uses notify (debounced watcher) to receive

Shard-specific flusher component that manages local state and operations. The FlusherShard is responsible for: - Managing local buffer operations - U

Hasher for 32-byte hash keys (keccak, etc). Uses bytes 0..8 XOR 24..32. No wyhash64 needed (keccak is well-distributed).

Iterator for retrieving hash values for a list of positions in the tree

An incremental hasher that can accept any number of writes.

Result of generating a hover block, including bitmap update info

Hover block generator

Identity hasher for testing - returns the key as-is.

A complete block with its index and type

A small helper to measure QEVM instruction count / execution time / cycles. - **Linux ARM64**: Uses `perf_event` to count hardware instructions. - **

Represents a job to be processed by the prefetcher. Can be either: - A task job for processing multiple entries - A warmup job for prefetching specif

Manages prefetch jobs and I/O operations across shards. Handles: - Buffer management - I/O scheduling - Job coordination - Completion notification

Manages jobs for the universal prefetcher implementation. This implementation is used for platforms that don't support io_uring. It provides basic jo

Per-io_uring-worker tracking for a job. We keep exactly one `Arc<Job>` alive per job (per worker) to avoid per-I/O refcount contention on the `Arc` h

Hasher for level8nth u64 keys. Compresses sparse values (8-15, 24-31, ...) into contiguous indices.

We just copy some code from https://docs.rs/byteorder/latest/byteorder/ such that it can be used in no_std environment. LittleEndian is a module that

Metadata database managing persistent state information. This struct provides methods to read and write metadata to disk, optionally encrypting sensi