Skip to content

Internals

Technical deep dives into the HyperbyteDB implementation for engineers working on the codebase.

Contents

  1. Core Modules — Module-by-module walkthrough of every directory under src/. Covers domain types, port traits, adapter implementations, application services, the InfluxQL engine, and the clustering subsystem.

  2. Key Design Decisions — Deep dives into the write path, read path, flush pipeline, compaction engine, WAL design, Parquet storage layout, clustering model, Raft consensus, replication protocol, and self-repair.

  3. Replication design — Write-replication wire format (/internal/replicate), sync_quorum, hinted handoff (CFh1), flow control, and how this ties to self-repair.

  4. Extension Points — Step-by-step guides for adding new InfluxQL statements, storage backends, background services, and HTTP endpoints.