Skip to content
δ-CRDT · Zero-GC · Post-Quantum

The database engine
engineered to the laws of physics.

A planetary-scale, off-heap δ-CRDT database with tri-temporal state, H3 spatial indexing, and a zero-allocation hot path — convergence proven by a chaos harness, not a marketing claim.

A product of Sovereign Systems

50.7M ops/s
CRDT core gate floor
Core microbench (HAMT.Set crucible — no crypto/net/TLS/disk). Gate-passing run 50,736,038 ops/s @32c Graviton; residency high 57.6M. NOT the ingest rate.
1.0–3.1M δ/sec
Production ingest
The rate a real operator sees — with Ed25519 verify, envelopes, network. ~17–57× below the core number, because the core number omits the ~60µs/batch verify.
0allocs/op
Hot path
HAMT.Set is allocation-free, gated by TestHotPathZeroAllocations. Every allocation is a future GC pause.
PQfrom day 1
Hybrid transport
X25519MLKEM768 negotiated by default + ML-DSA-65 signatures — a hedge against harvest-now-decrypt-later, proven by the transport-readiness gate, not bolted on later.
The five physical laws

Not workflow rules. Physics.

The engine is governed by five laws, each enforced by a named test gate and each tied to a measured failure mode that made it non-optional.

Memory law

0 allocs/op on the hot path. One make() on the write path at the core rate (50.7–57.6M ops/s) = stop-the-world ~every 4ms.

→ TestHotPathZeroAllocations

Cache law

128-byte stride for every contended atomic. Two atomics on one cache line at 32 cores = a HITM storm = 1.1M ops/s, 1.6% efficiency vs the 50.7–57.6M core range.

→ TestMemoryLayoutAnalysis

Lock law

No sync.Mutex on the write path. CAS + EBR only. A futex is a scheduler stall, and a stall at the core rate (50.7–57.6M ops/s) is a cliff.

→ pkg/sync · reclamation.go

WAL law

Replay starts at LamportHigh − len(Mutations), not LamportHigh. Replay re-runs the minting — change this and you get double-minting.

→ TestStage6WALRecoveryDeterminism

Honesty law

Report numbers, not adjectives — and report the layer. “50,736,038 ops/s @32c is the CRDT CORE microbench gate-passing floor (range 50.7–57.6M; the 57.6M is a residency high, not sustained; production ingest is 1.0–3.1M δ/sec)” is a fact. Quoting 57.6M alone as “sustained throughput” is a hero-number round-up the post-mortem forbids.

→ TestGate_GearHonesty
What makes it different

A moat built from mechanisms, not marketing.

Every differentiator is grounded in a real package, type, and test — and where a feature is preview, stub, or dormant, it is labeled as such.

01

Tri-temporal CRDT state

Keyed by system_time × valid_time × assertion_time, materialized as a 40-byte composite key + 9-field Arrow IPC rows. A query a mutable-row or log-only model cannot answer without an auxiliary history store.

CRDTEntry @hamt.go · internal/database
02

Off-heap, zero-GC hot path

State lives in a mmap’d segregated-slab HamtArena (17 size classes, 256-way sharded Treiber free-lists). NodePtr is a GC-invisible uintptr — the foundation of true zero-GC.

pkg/sync/hamt_arena.go
03

CAS + EBR, no futex on the write path

Join, InsertLocal, NextDot use compare-and-swap and epoch-based reclamation with hazard pointers. The only sync.Mutex guards disk fsync in a decoupled background worker.

pkg/sync/reclamation.go
04

H3 spatial CRDT

H3Index on every CRDTEntry, geocoding offloaded to an isolated C++ worker over a memfd-backed SPSC shared-memory ring — no syscalls or futexes on the hot path.

internal/spatial/h3_spsc_ring.go
05

Post-quantum from day one

ML-DSA-65 (FIPS 204) preview envelope plus X25519MLKEM768 intent, alongside a hedged (randomized-nonce) Ed25519 signer that stays compatible with the unchanged verifier.

pkg/identity/pq_mldsa.go
06

Honest-negative measurement culture

Every bench carries a gear tag. Honest negatives are recorded verbatim. FROZEN-file MD5 teeth pin the byte-identity of load-bearing source across forks.

TestGate_GearHonesty · TestGate_FrozenMD5
Layered architecture

One FROZEN core, wrapped by seams.

A layered system organized around a single frozen δ-CRDT core, wrapped by an ingress gate stack, a durable LSM tier, a replication mesh, and operator surfaces.

CRDT core pkg/sync
The δ-CRDT engine: sharded lock-free HAMT, Lamport dot minting, FROZEN merge-union Join, IBLT/strata set reconciliation, EBR + hazard-pointer reclamation, wire-integrity seam. The write/read hot path everything else builds on.
Storage & durability internal/database · pkg/durability
Off-heap jemalloc-backed SkipListArena MemTable, async L0 flush to per-entity Arrow IPC, L0→L1 compaction with tri-temporal dominance pruning, bitemporal Resolver (AsOf/Range) + read-your-writes LiveSource, WAL + bounded snapshot recovery.
Mesh & replication pkg/mesh · pkg/clock · pkg/admission
TLS 1.3 peer gossip, anti-entropy sweep (oversend / batched / stratified), JSON-over-mTLS control port. pkg/clock is the Byzantine HLC physical-bound cap (first ingress gate, sub-µs). pkg/admission is the per-peer Sybil-burst token bucket.
Receive & transport pkg/receive · pkg/transport
Length-prefix frame reassembly, gate-stack composition (the first production caller of Join), edge-triggered epoll ingress, eBPF SK_REUSEPORT steering, TLS 1.3 mTLS with SIGHUP rotation, zero-copy egress boundary.
Identity & crypto pkg/identity · pkg/crypto · internal/crypto · pkg/authorization
ZIP-215 Ed25519 verify gate, origin→pubkey Directory, hedged EdDSA signer, ML-DSA-65 preview, dev-mesh x509 CA, zero-GC PII masking, Cedar ABAC latency experiment.
Attribution & telemetry pkg/attribution · internal/telemetry · pkg/metrics
Relay-provenance envelopes + batch/digest dispatch, 19 zero-GC sharded LongAdder counters, Prometheus registry + TelemetryBridge (SSoT-grows-auto).
Network, spatial, capnp internal/network · internal/transport · internal/spatial · api/capnp
EPOLLET Cap’n Proto ingestion server, jittered-backoff HTTP client + bounded lock-free pool, SHA-256-prefix-sharded S3 uploader, memfd SPSC H3 ring + EpochBatcher, generated capnp wire bindings.
Chaos internal/chaos
Semantic Byzantine injector, in-memory VirtualNet partition fabric, engine-side WAL, supervisor/worker process-crash survival — the verification layer proving the hardest invariants.
Operator / developer / evidence cmd/sovereign-node · sdk/sovereign · examples · pkg/codec120 · pkg/durability120 · pkg/pqecobench
The production binary, the client SDK, examples, and the bench-only evidence tracks (codec byte-cost, durability CDFs, ML-DSA-65 PQ economics).
Honest readiness

What ships. What’s opt-in. What’s a stub.

The engine reports its own readiness — production-wired, opt-in, dormant, bench-only, or stub — with the test that proves each claim.

CapabilityReadinessEvidence
δ-CRDT core (Join, HAMT, IBLT, EBR)ProductionFROZEN; rapid property tests + chaos mesh convergence; 0 allocs/op hot path
Wire-integrity + skew boundProductionPhase 2c/2f/2g teeth; closes Byzantine A1/A4
TLS 1.3 mTLS mesh + control portProductionTestTLSHandshake_13_Only, /v1/* route teeth
Admission (rate + clock)ProductionTestPeerBucket_SybilIsolation; real EAGAIN-at-TCP is Track 2.1 (not yet shipped)
WAL + bounded snapshot recoveryOpt-in--wal-path; TestStage6WALRecoveryDeterminism
L0→L1 compaction + DominancePruneOpt-in--compaction-prune-enable default false; ADR-0019/0020/0025
T_gc auto-inferenceProductionDay-22 ADR-0027; inferrer floors operator knob; retreats refused + counted
L0 reaperOpt-in--compaction-reap-enable default false; never auto-runs
Read-your-writes LiveSourceProductionDay-27 ADR-0032; insert→IMMEDIATE query→200; engine.State().Get is O(total entries)
SkipListArena.SeekDormantProven correct (Day-23 ADR-0028) but not wired into scanWindowRecordBatch
eBPF SK_REUSEPORT steeringProduction//go:build ebpf_kernel (opt-out); silicon tests t.Skip cleanly on capability-absent box
EPOLLET Cap’n Proto ingestionPartialUnix-socket E2E proven; binds but no message in TestEpollServer_BasicMessage; IPv6 unsupported
H3 spatial CRDT (C++ worker)PartialSPSC ring proven structurally; C++ h3_worker operator-supplied; in-tree tests use mocks
Ed25519 verify + hedged signerProductionVerifyCRDTFrame + RejectSmallOrderKey; verifies under unchanged circl.Verify
ML-DSA-65 post-quantumPreviewpq_preview build tag; no production imports; 32c re-run pending
aws-lc hedged bridgeStubaws_lc_hedged_stub.go is a panic stub; real CGO bridge deferred
Dev-mesh x509 PKIDev onlyNot production PKI (no offline root/intermediates/HSM/OCSP/rotation)
Cedar ABACBench-onlypkg/authorization has no non-test .go source; no production authorizer type or call site
Zero-GC PII maskingProductioninternal/crypto/pii.go; memtable calls MaskPII per write
Telemetry → Prometheus bridgeProductionADR-0023; SSoT-grows-auto; 19 instruments; real scrape cumulative-not-delta
Chaos harnessBench-onlyinternal/chaos; SIGSEGV survival conditionally skipped pending CHAOS_WORKER_BIN
pkg/durability/wal.goAlias layerPure re-export of internal/chaos WAL with zero own logic
EpochCompactorDeadZero production importers; retained for scope hygiene; real GC is DominancePrune + L0 reaper
Start reading the docs

Documentation synthesized from the Sovereign Engine source — 231 .go files, 100% coverage.