Skip to content

Voxion-Labs/VXR-Continuum

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

10 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Voxion Labs Logo

VXR-Continuum 🌌

Voxion eXperimental Research

TypeScript Vite CRDT P2P Edge Applied Research License

Deterministic, P2P Edge State Synchronization via Conflict-Free Replicated Data Cookies. πŸ§ͺ
A high-integrity, browser-native research prototype demonstrating zero-backend eventual consistency using join-semilattices, causal vector clocks, and cryptographic cookie boundaries.


🌐 Live Interactive Dashboard Β· πŸ“„ Read 10-Page Research Paper (PDF) Β· πŸ’» Source Code Repository


Executive Overview πŸ“‘

Modern decentralized applications operating at the edge are constrained by network latency, packet loss, and frequent disconnected periods. Traditional client-server models rely on heavy synchronization locks, causing UI blocking, high server overhead, and data residency hazards.

VXR-Continuum introduces a browser-native eventual consistency engine that treats browser tabs and localized edge nodes as independent peers. By mapping application states to State-based Conflict-Free Replicated Data Types (CvRDTs) and serializing delta updates into cryptographic HTTP Document Cookies, synchronization executes transparently during standard navigation. Real-time synchronizations between parallel active tabs are routed via the BroadcastChannel API in less than 50 milliseconds, bypassing database coordination entirely.


Core Architecture & Data Flow βš™οΈ

The VXR-Continuum architecture is built on origin isolation, local memory evaluation, and asynchronous edge-to-edge convergence:

  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
  β”‚                 Browser Tab A (Origin: Voxion Edge)                     β”‚
  β”‚  1. Mutation Event ──► Vector Clock++ ──► Local CvRDT State Mutation    β”‚
  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–²β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                           β”‚                       β”‚
                           β”‚ 2. Delta Serializer   β”‚ 5. Local Join Merge
                           β–Ό                       β”‚
  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
  β”‚ 3. Sign & Compress ──► gzip Deflate ──► Base64-URL Cookie Storage      β”‚
  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–²β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                           β”‚                       β”‚
                           β”‚ 4. Broadcast Channel  β”‚ 4. Cookie Marshalling
                           β–Ό                       β”‚
  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
  β”‚                 Browser Tab B (Origin: Voxion Edge)                     β”‚
  β”‚  5. HMAC Validation ──► Causal Vector Check ──► Converged State Supremumβ”‚
  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Mathematical Foundations of CvRDTs πŸ“

To guarantee conflict-free, deterministic convergence across distributed edge replicas without central lock coordination, VXR-Continuum models state transitions strictly as a bounded join-semilattice $(S, \sqcup, \le, \bot)$, where:

  • $S$ is the set of all possible state values.
  • $\sqcup$ (join) is the binary merge operator.
  • $\le$ is the partial order relation defining state progression.
  • $\bot$ is the initial bottom element representing the empty state.

Lattice Properties

Deterministic eventual consistency is mathematically guaranteed because the merge operator $\sqcup$ satisfies three mathematical properties:

$$\begin{aligned} \text{1. Idempotency:} \quad & x \sqcup x = x \\ \text{2. Commutativity:} \quad & x \sqcup y = y \sqcup x \\ \text{3. Associativity:} \quad & x \sqcup (y \sqcup z) = (x \sqcup y) \dots \end{aligned}$$

Monotonic Progression & Eventual Convergence

For every state mutation, replica state advances strictly monotonically:

$$x \le (x \sqcup y) \quad \text{and} \quad y \le (x \sqcup y)$$

Let $U = {u_1, u_2, \dots, u_m}$ be the finite set of all independent updates generated across the edge network. As replicas propagate and merge states, the system converges to the absolute supremum (least upper bound) of $U$:

$$\lim_{t \to \infty} x_i(t) = \bigsqcup U$$

This guarantees that all edge nodes reach identical state convergence regardless of network partitions, message dropouts, or out-of-order delivery.


Causal Ordering & Vector Clocks πŸ•’

While the join-semilattice guarantees convergence, resolving concurrent edits and preserving causal history requires logical Vector Clocks. Each replica node $i$ maintains a clock vector $V_i$ of size $N$ (active nodes):

$$V_i = [c_1, c_2, \dots, c_N]$$

where $c_j$ represents the sequence count of updates causally originating from node $j$ and observed by node $i$.

Vector Comparison Rules

A state update associated with clock $V_1$ causally precedes an update with clock $V_2$ ($V_1 \prec V_2$) if and only if:

$$\forall k \in [1, N]: V_1[k] \le V_2[k] \quad \land \quad \exists j \in [1, N]: V_1[j] < V_2[j]$$

If neither $V_1 \prec V_2$ nor $V_2 \prec V_1$ holds, the updates are concurrent ($V_1 \parallel V_2$):

$$V_1 \parallel V_2 \iff \neg (V_1 \prec V_2) \land \neg (V_2 \prec V_1)$$

When a conflict is detected ($V_1 \parallel V_2$), VXR-Continuum deploys a Last-Write-Wins (LWW) Register tied to Hybrid Logical Clocks (HLC) to break ties deterministically, protecting causal history against physical clock drifts exceeding a boundary threshold $\epsilon$ (e.g., $\epsilon = 60\text{ seconds}$).


HTTP document cookies are constrained by browser sandboxes to a maximum payload size of 4096 bytes per domain. VXR-Continuum optimizes space utilization by executing delta-compaction (gzip) and Base64-URL serialization, packing states into structured protocol headers.

Binary Cookie Header Specification

Byte Offset Field Identifier Data Type Structural Constraint & Semantic Purpose
0x00 vxr_ver uint8_t Version matching; rejects incompatible client revisions
0x01 vxr_flags uint8_t Control bits (e.g., bit 0 represents delta compression status)
0x02 - 0x09 vxr_epoch uint64_t Hybrid Logical Clock (HLC) physical timestamp
0x0A - 0x0D vxr_counter uint32_t HLC logical sequence counter supporting exact concurrent tie-breakers
0x0E - 0x2D vxr_sig uint8_t[32] Cryptographic HMAC-SHA256 signature validating state integrity
0x2E - EOF vxr_payload string Base64-URL encoded gzip-compressed CvRDT state delta segment

Security & Tampering Boundaries πŸ›‘οΈ

Storing synchronization states inside document cookies exposes data to client-side manipulation. VXR-Continuum secures the transport boundary by enforcing a strict HMAC-SHA256 Signature Chain:

$$\text{Signature} = \text{HMAC-SHA256}\big(\text{vxr_ver} \mathbin{\Vert} \text{vxr_epoch} \mathbin{\Vert} \text{vxr_counter} \mathbin{\Vert} \text{vxr_payload}, , K_s\big)$$

where $K_s$ is a key isolated within the browser's origin-protected LocalStorage. Incoming cookie packets are validated:

// Active Cryptographic Verification Loop
const verifyCookiePayload = (cookie: RawCookiePacket, secretKey: string): boolean => {
  const computedSig = hmacSHA256(
    cookie.version + cookie.epoch + cookie.counter + cookie.payload, 
    secretKey
  );
  
  if (computedSig !== cookie.signature) {
    console.error("⚠️ [SECURITY] State tampering detected! Signature mismatch.");
    return false; // Reject transition
  }
  return true; // Apply merge
};

Empirical Telemetry Performance πŸ“ˆ

Under comprehensive benchmarking simulating $N=10,000$ operations across concurrent edge clients, local browser in-memory CRDT-cookie merging achieved sub-millisecond convergence, executing orders of magnitude faster than cloud round-trips.

VXR-Continuum Latency Benchmarks

Synchronization Phase Latency Telemetry

Performance Vector Central Cloud Database VXR-Continuum Cookie Net Advantage / Speedup
State Ingress / Read (P50) 45.80 ms 0.02 ms 2,290x (Avoids TCP handshake)
Conflict Resolution (P90) 12.40 ms 0.05 ms 248x (Idempotent in-memory join)
Serialization & Signing (P99) 8.20 ms 0.15 ms 54x (Client-side HMAC-SHA256)
Total Convergence (Average) 66.40 ms 0.22 ms 301x (Edge-local synchronization)

Run Locally πŸš€

Verify the edge synchronization visualizer in your local environment:

1. Clone & Install Dependencies

git clone https://github.com/Voxion-Labs/VXR-Continuum.git
cd VXR-Continuum
npm install

2. Run Local Development Server

npm run dev

Open your local browser to the displayed URL (typically http://localhost:5173/VXR-Continuum/). Open an incognito browser tab side-by-side to watch peer mutations synchronize across clients in real-time.

3. Compile Production Static Assets

npm run build

The production assets compile cleanly into the /dist/ folder for global static hosting.


Author πŸ‘₯

Rudranarayan Jena Rudranarayan Jena
Founder, Voxion Labs
Academic Profile: @liambrooks-lab
D.Y. Patil International University, Pune, India

Applied researcher in distributed systems security and edge computing. Currently directing the VXR-Continuum initiative to study high-integrity eventual convergence and conflict-free replicated data types in sandboxed client layers.


Academic Citation & Bibliography πŸ“„

If you reference this work or utilize the VXR-Continuum eventual consistency model in your research, please cite our whitepaper:

@techreport{jena2026vxrcontinuum,
  author      = {Jena, Rudranarayan},
  title       = {VXR-Continuum: Distributed State Synchronization via Conflict-Free Replicated Data Cookies},
  institution = {Voxion Labs Applied Systems Research Group},
  year        = {2026},
  number      = {VXR-2026-CT01},
  url         = {https://voxion-labs.github.io/VXR-Continuum/paper/VXR-Continuum_IEEE.pdf}
}

References

  • [1] M. Shapiro et al., "Conflict-free replicated data types," in Symposium on Self-Stabilizing Systems, Springer, 2011.
  • [2] L. Lamport, "Time, clocks, and the ordering of events in a distributed system," Commun. ACM, 21(7):558-565, 1978.
  • [3] I. Barth et al., "HTTP State Management Mechanism (RFC 6265)," IETF RFC Series, 2011.
  • [4] S. Kulkarni et al., "Logical physical clocks and hybrid time synchronization," IEEE Trans. Parallel Distrib. Syst., 2016.

License βš–οΈ

This repository is licensed under the MIT License.

Copyright (c) 2026 Voxion Labs

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

Voxion Labs Β· Applied Research Β· Zero-Backend Β· CRDT Edge Cookies Β· TypeScript Β· Vite

About

VXR-Continuum: A zero-backend, purely client-side engine demonstrating Distributed State Synchronization across edge networks using CRDT Cookies

Topics

Resources

License

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors