Complete C++ implementation of GroveDB v4.0.0 with full Rust parity. Features SPV proof generation/verification, Merk trees, transactions, batch operations, and replication.

cmake -S . -B build
cpu_count="$(nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || getconf _NPROCESSORS_ONLN 2>/dev/null || echo 1)"
jobs="$(( cpu_count > 1 ? cpu_count - 1 : 1 ))"
cmake --build build -j"${jobs}"

./autogen.sh
./configure
cpu_count="$(nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || getconf _NPROCESSORS_ONLN 2>/dev/null || echo 1)"
jobs="$(( cpu_count > 1 ? cpu_count - 1 : 1 ))"
make -j"${jobs}"
make check      # Run tests

Configure options:

• --with-rocksdb=PATH - Use RocksDB at PATH (default: auto-detect; RocksDB is required)
• --enable-debug - Enable debug build
• --disable-tests - Disable test building
• --disable-benchmarks - Disable benchmark building

CMake build:

./build/harness corpus/corpus.json

Autotools build:

./src/harness corpus/corpus.json

Test suite covers API contracts, Rust parity, and functional verification.

CMake:

cd build
ctest --output-on-failure

Autotools:

make check

Categories:

• API Contract Tests: Null/invalid input handling, lifecycle checks
• Parity Tests: Rust fixture comparison (storage, Merk, proofs, GroveDB facade)
• Functional Tests: Chunk operations, replication, version gating

See tests/README.md for details.

Release builds required for meaningful numbers (Rust cargo bench is optimized). Examples below use the CMake release build path (build-release/). For autotools builds, run the binaries from bench/ after ./configure && make.

Insertion (facade-level): CMake:

cmake -S . -B build-release -DCMAKE_BUILD_TYPE=Release
cpu_count="$(nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || getconf _NPROCESSORS_ONLN 2>/dev/null || echo 1)"
jobs="$(( cpu_count > 1 ? cpu_count - 1 : 1 ))"
cmake --build build-release -j"${jobs}"
./build-release/bench_insertion 10000 10 1 1

Autotools:

./configure --disable-tests
cpu_count="$(nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || getconf _NPROCESSORS_ONLN 2>/dev/null || echo 1)"
jobs="$(( cpu_count > 1 ? cpu_count - 1 : 1 ))"
make -j"${jobs}"
./bench/bench_insertion 10000 10 1 1

Insertion (storage microbenchmark): CMake:

./build-release/bench_insertion_storage 10000 10 1 1

Autotools:

./bench/bench_insertion_storage 10000 10 1 1

Corpus proof generation: CMake:

./build-release/bench_corpus corpus/corpus.json 1000

Autotools:

./bench/bench_corpus corpus/corpus.json 1000

Rust insertion benchmark (repo-local):

bash tools/run_rust_insertion_bench.sh 1 2 10

Rust corpus proof benchmark:

CARGO_TARGET_DIR=tools/corpus/target \
cargo bench --manifest-path tools/corpus/Cargo.toml \
  --bench corpus_proof_benchmark -- --warm-up-time 1 --measurement-time 2 --sample-size 10 --noplot

├── include/          # Public headers (element, merk, proof, query, etc.)
├── src/              # Implementation (~29.5k LOC)
├── tests/            # Contract + parity + functional tests
├── bench/            # Benchmarks (corpus, insertion, storage)
├── tools/            # Rust fixture generators, test runners
├── docs/             # Feature matrix, policies, performance baselines
├── corpus/           # Canonical test corpus
└── third_party/      # blake3

• rust-cpp-feature-matrix.md - Feature parity matrix
• grovedb-facade-spec.md - Facade API/behavior contract
• api-contract-matrix.md - API coverage
• compat-invariants.md - Cross-language invariants
• acceptance-criteria.md - Objective cutover gates
• accepted-divergences.md - Active divergences
• runbook-facade-parity.md - Parity/perf execution runbook
• perf/ - Performance baselines and thresholds

• tools/corpus/ - Rust corpus generator
• tools/insertion/ - Repo-local Rust insertion benchmark crate
• tools/rust-storage-tools/ - Rust binaries for parity fixture generation
• tools/run_parity_ctest.sh - Test runner (semantic/byte/contract gates)
• tools/run_rust_insertion_bench.sh - Rust insertion benchmark runner (writes docs/perf/raw/)
• tools/run_fixture_regen_check.sh - Canonical corpus determinism + drift check
• tools/check_*.sh - Policy enforcement (divergence expiry, perf thresholds, error strings)

• RocksDB - Storage backend (required by the current autotools build; auto-detected by default)
• blake3 - Hash function (bundled in third_party/)
• Rust toolchain - Required for parity tests (grovedb v4.0.0)