Skip to content

Commit 89db8c8

Browse files
Seed node repo: README, planning placeholder, .nojekyll
0 parents  commit 89db8c8

3 files changed

Lines changed: 51 additions & 0 deletions

File tree

‎.nojekyll‎

Whitespace-only changes.

‎README.md‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# bitcoin-kernel / node
2+
3+
A browser-native Bitcoin node. Validate Bitcoin's consensus rules in a tab,
4+
persist the chain to OPFS, and sync through a thin local bridge. Built on the
5+
[bitcoin-kernel](https://github.com/bitcoin-kernel/bitcoin-kernel.github.io) engine.
6+
7+
**Status: planning.** See the [roadmap](../../issues/1).
8+
9+
## The idea: usable first, trustless later
10+
11+
Three resource tiers. Opt into more to trust less.
12+
13+
| Tier | Does | Cost | Device |
14+
|---|---|---|---|
15+
| 0 Lite | headers + Neutrino wallet (BIP 157/158) | ~100 MB, minutes | phone |
16+
| 1 Validating | assumeutxo snapshot, validate new blocks live | a few GB | laptop |
17+
| 2 Full | backfill genesis to tip, fully trustless | ~650 GB, lots of RAM | desktop |
18+
19+
## Pillars
20+
21+
- **Storage:** OPFS (synchronous access handles in a Web Worker).
22+
- **Compute:** WASM-SIMD secp256k1 + Web Workers; the UTXO set lives in RAM, not a DB.
23+
- **Networking:** a small local WebSocket-to-TCP bridge (a browser cannot open raw TCP).
24+
25+
Every milestone is gated by a benchmark. Honest target: usable in minutes via
26+
assumeutxo, fully validated from genesis in an afternoon on commodity hardware.
27+
Not an archival node, not a Bitcoin Core replacement.
28+
29+
Independent community project, not affiliated with Bitcoin Core.

‎index.html‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
<!doctype html><html lang="en"><head><meta charset="utf-8">
2+
<meta name="viewport" content="width=device-width, initial-scale=1">
3+
<title>bitcoin-kernel / node — a Bitcoin node in your browser</title>
4+
<style>
5+
body{margin:0;background:#0d1117;color:#e6edf3;font:16px/1.6 system-ui,sans-serif;-webkit-font-smoothing:antialiased}
6+
.wrap{max-width:720px;margin:0 auto;padding:5rem 1.5rem}
7+
h1{font-size:2.4rem;letter-spacing:-1px;margin:0}h1 b{color:#e8830c}
8+
p{color:#adbac7}a{color:#e8830c}
9+
.tag{font:600 .75rem ui-monospace,monospace;letter-spacing:.14em;text-transform:uppercase;color:#e8830c}
10+
table{border-collapse:collapse;margin:1.4rem 0;font-size:.92rem;width:100%}
11+
td{padding:.5rem .7rem;border-top:1px solid #21262d}td:first-child{color:#fff;font-weight:600;white-space:nowrap}
12+
</style></head><body><div class="wrap">
13+
<div class="tag">bitcoin&#183;kernel / node &#183; planning</div>
14+
<h1>A Bitcoin node, <b>in your browser.</b></h1>
15+
<p>Validate Bitcoin's consensus rules in a tab, persist the chain to OPFS, sync through a thin local bridge. Usable as a wallet in minutes; fully validated in the background.</p>
16+
<table>
17+
<tr><td>Tier 0 &#183; Lite</td><td>headers + Neutrino wallet &#183; ~100 MB &#183; phone</td></tr>
18+
<tr><td>Tier 1 &#183; Validating</td><td>assumeutxo, validate new blocks live &#183; laptop</td></tr>
19+
<tr><td>Tier 2 &#183; Full</td><td>backfill genesis to tip, fully trustless &#183; desktop</td></tr>
20+
</table>
21+
<p>Built on <a href="https://bitcoin-kernel.github.io/">bitcoin-kernel</a>. Follow the <a href="https://github.com/bitcoin-kernel/node/issues/1">roadmap</a>.</p>
22+
</div></body></html>

0 commit comments

Comments
 (0)