BoundDB

High-performance cell-based database with lock-free reads and dual-buffer architecture. Optimized for low-latency operations on fixed-size cells organized into regions.

Features

• Lock-free reads via dual-buffer epoch-based architecture
• Write-ahead logging (WAL) for durability
• TCP protocol for high-performance client access
• Periodic publishing of writes with configurable intervals

Installation

Docker

docker compose up -d

Usage

Configuration

Create a JSON configuration file (see configs/single.json for an example):

{
  "node_id": "local-0",
  "role": "leader",
  "data_dir": "/var/lib/bounddb",
  "publish_interval_ms": 1,
  "tcp_port": 9090,
  "enable_wal": true,
  "region": {
    "region_id": 1,
    "cell_size": 8,
    "num_cells": 1000000
  }
}

Running

./build/bounddbd --config /path/to/config.json

Client Access

• TCP Server: Port 9090 (see src/protocol.h for protocol details)

Operations

The database supports:

• WRITE_CELL - Write a cell at a specific index
• READ_CELL - Read a single cell
• READ_RANGE - Read a range of cells
• GET_LATEST_SEQ - Get the latest sequence number

See src/protocol.h for the complete protocol specification.