SYSTEM
COREINTEGRATION.

"Velocity is an accelerated low-latency binary store. This specification defines the integration layer for the Alpha storage engine."

Low-Level Architecture

VelocityDB bypasses standard high-level abstractions to interact directly with system memory and disk IO using **Rust's zero-cost abstractions**.

Zero-Copy Deserialization

Incoming VDB-Binary packets are mapped directly into application memory using **FlatBuffers**. No heap allocations occur during read cycles.

IO-Uring Integration

Linux kernel asynchronous IO submission queues are used to minimize syscall overhead for AOF write operations.

State Propagation

INGESTION

"Data enters the pipeline via the custom V-Proto binary stream."

MUTATION

"The atomic engine updates the Memtable and appends to the WAL simultaneously."

COMPACTION

"Background threads merge SSTables to maintain O(log N) read performance."

Integration Guide

Bootstrap Client

Select your architectural target and initialize the Velocity connection pool.

Velocity-Node SDK

import { VelocityPool } from '@velocity/core';

const vdb = new VelocityPool({
  node: 'alpha-cluster.vdb.io',
  auth: process.env.VDB_TOKEN
});

await vdb.connect();

Native Rust SDK

use velocity_sdk::Client;

let client = Client::builder()
  .endpoint("vdb://internal-v1")
  .pool_size(16)
  .build().await?;

Atomic KV Operations

Velocity provides linearizable KV operations with sub-microsecond latency benchmarks.

Protocol Operations

// Linearizable SET with TTL
await vdb.set('session:0xF1', { active: true }, { ttl: '2h' });

// Fast GET (Zero-Copy Path)
const data = await vdb.get('session:0xF1');

// Atomic Increment (Server-Side)
await vdb.incr('counters:req_total', 1);

V-Proto Binary Frames

Segment	Type	Bits	Spec
Magic	U32	32	"VELO" (0x56454C4F)
OpCode	U8	8	Operation Control Byte
Flags	U8	8	Consistency & Compression Flags
Len	U64	64	Payload Size (LE)
Body	Payload	Var	Binary Data Body
Check	CRC32	32	Hash Integrity Verification

SDK Security Advisory

DURING ALPHA STAGE, WE DO NOT RECOMMEND STORING RAW PASSWORDS OR PCI-SENSITIVE DATA IN THE CLOUD INSTANCES. ALL CONNECTIONS ARE TLS 1.3 ENCRYPTED BY DEFAULT.