STORAGE / PROFESSIONAL

Block Storage

The reference production engine: premium hashed storage in one efficient file.

01 / DESIGN

How Block Storage stores data.

Block Storage places accounts, files, lock slots, hash groups and record data inside one structured block file. File modulo directs an item hash to a group chain, free blocks are reused, and bounded caches retain group entries and listing snapshots.

AVAILABILITYReference Professional storage implementation.

01Item ID
02Hash + modulo
03Group block chain
04Record data blocks
05Single block file

02 / TRADE-OFFS

Choose the engine for the workload.

Storage engines balance memory, I/O, recovery, concurrency and operational complexity. These profiles show where each engine fits.

STRENGTHS

Predictable on-disk hashing
One-file operational footprint
Bounded structural caches
Integrated record locks and secondary indexes

WEAKNESSES

Block size and structural capacities are format decisions
Poor modulo choices deepen group chains
Single-file contention needs workload-aware tuning
Capacity and lock-slot limits should be planned before deployment

03 / ABILITIES

What it provides.

Block Storage is RightMV's reference implementation for production use. Its premium hashing backend stores the complete system in a single file and is designed to run efficiently across both small and large environments.

Reusable block allocation

Hashed group chains and adaptive hot-insert handling

Persistent lock slots with TTL recovery

Grouped commits and secondary-index maintenance

BEST FIT

Reference production deployments
Small and large environments
Single-file operations
Commercially supported systems

CORE CAPABILITIES

Premium hashed storage
Complete single-file persistence
Efficient operation across deployment sizes
ExecutionContext integration

CONFIGURATION

MVDB_BLOCK_DATA_ROOT
MVDB_BLOCK_FILE_NAME
MVDB_BLOCK_SIZE
MVDB_BLOCK_MAX_BYTES
MVDB_BLOCK_DEFAULT_MODULO
MVDB_BLOCK_MAX_LOCKS
MVDB_BLOCK_GROUP_ENTRY_CACHE_SIZE
MVDB_BLOCK_GROUP_COMMIT_RECORDS