You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+11-39Lines changed: 11 additions & 39 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,14 +1,14 @@
1
1
# HarborX — Blob Direct Write & High-Performance SQL
2
2
3
-
HarborX is a high-performance data engine for Web3. It ingests incremental **blob** data from L2/rollup ecosystems, writes directly into **columnar formats** (Arrow/Parquet), and exposes a **standard SQL** interface that runs either fully in the browser (DuckDB-WASM) or on your backend. The long-term goal is a verifiable pipeline with **ZK proofs** (ZKSQL) for trusted computation and cross-chain verification.
3
+
HarborX is a high-performance data engine for Web3. It ingests incremental **blob** data from L2/rollup ecosystems, writes directly into **columnar formats** (Arrow/Parquet), and exposes a **standard SQL** interface. The long-term goal is a verifiable pipeline with **ZK proofs** (ZKSQL) for trusted computation and cross-chain verification.
4
4
5
5
## Key Features
6
6
7
7
-**Blob → Columnar (Direct Write)**
8
8
9
9
Pull real blob payloads and write straight to Arrow/Parquet—no heavyweight node sync or custom ETL needed. Supports small, incremental updates for low latency.
10
10
11
-
-**SQL Anywhere (Frontend-Only or Backend)**
11
+
-**SQL Anywhere**
12
12
13
13
Query latest and historical data with SQL. The PoC ships a **pure-frontend** demo (DuckDB-WASM) that reads Arrow/Parquet over HTTP, no server code required.
14
14
@@ -34,7 +34,7 @@ pip install -e .[cli]
34
34
35
35
```
36
36
37
-
## Option A — Use Existing Static Data (most stable for PoC)
37
+
## Option A — Use Existing Static Data
38
38
39
39
Commit your prepared dataset under `apps/web/data/` (including `manifest.json`) and run:
The app resolves file paths **relative to the manifest**. If you ever see 404s like `/data/data/...`, it means both manifest & code added the `data/` prefix. Fix either the manifest (no `data/` prefix) **or** the app’s normalization (strip `data/`if present)—don’t do both.
114
+
The app resolves file paths **relative to the manifest**.
126
115
127
116
---
128
117
129
-
# Repository Layout (Recommended)
118
+
# Repository Layout
130
119
131
120
```base
132
121
harborx/ # unified CLI + data channel (blobscan, tools)
@@ -137,25 +126,8 @@ legacy/ # archived/older code and experiments
137
126
138
127
```
139
128
140
-
Generated artifacts (e.g., large datasets) are typically ignored by Git—except in PoC static mode, where you intentionally commit a tiny `apps/web/data/`for Pages.
0 commit comments