BTC-Subnet-Core

BTC-Subnet-Core / subnet-core

Public

subnet-core – Minimal TypeScript educational node modeling Bitcoin‑IPC: Proof‑of‑Stake subnets with BTC‑denominated stake, CometBFT‑style weighted quorum gates, cross‑subnet envelopes (SegWit / OP_RETURN batching), and a local two‑subnet harness with optional Bitcoin Core regtest integration. A living reference for researchers

bitcoin-ipc bitcoin-l2 btc-staking cometbft consensus
16
150
85% credibility
Found May 22, 2026 at 16 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

This is an educational TypeScript project that demonstrates how the Bitcoin-IPC architecture works — a system for scaling Bitcoin using proof-of-stake subnets anchored to Bitcoin's blockchain. It shows how validators can lock Bitcoin as collateral, reach consensus through weighted voting, and send cross-subnet transfers that get recorded on Bitcoin. The project includes a local testing harness with two simulated subnets, optional connection to a live Bitcoin node for real anchoring, and clear implementations of stake management, consensus rules, and envelope packaging.

How It Works

1
📚 You discover a Bitcoin scaling idea

You hear about a research paper that proposes anchoring proof-of-stake networks directly to Bitcoin for massive scaling.

2
🧪 You explore the working example

You download a small TypeScript project that shows exactly how this architecture works with clear, readable code.

3
🔐 You lock Bitcoin as stake

Validators lock their Bitcoin as collateral, which becomes their voting power in the network.

4
📦 You create two connected subnets

The system spins up two separate networks that can talk to each other through Bitcoin.

5
You send money between subnets
✅
Network agrees (quorum reached)

More than two-thirds of validators vote for the same transaction, and it commits.

↩️
Network disagrees (no quorum)

Not enough validators agree, so the burned coins are returned safely to the sender.

6
⛓️ The transfer gets anchored to Bitcoin

A tiny note is embedded in a Bitcoin transaction, proving the cross-subnet transfer happened.

🎉 Your transfer is complete

The recipient receives the Bitcoin on the destination subnet, secured by Bitcoin's blockchain.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 16 to 16 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is subnet-core?

subnet-core is a minimal TypeScript implementation that models the Bitcoin-IPC architecture from a recent whitepaper. It simulates Proof-of-Stake subnets anchored to Bitcoin L1, complete with BTC-denominated staking, CometBFT-style consensus gates, and cross-subnet messaging via OP_RETURN batching. The project includes a local harness for spinning up two subnets and optional integration with Bitcoin Core regtest for live testing.

Why is it gaining traction?

This stands out because it translates complex blockchain scaling research into runnable code without requiring Rust expertise. Researchers and developers can experiment with subnet mechanics, quorum thresholds, and cross-subnet transfers directly in TypeScript. The optional Docker setup for Bitcoin Core regtest lowers the barrier to hands-on exploration of the architecture.

Who should use this?

Cryptography researchers studying Bitcoin-IPC will find this invaluable for rapid prototyping of subnet designs. Protocol engineers evaluating the whitepaper can test consensus logic and envelope formats without production infrastructure. Educators teaching blockchain scaling concepts gain a self-contained reference implementation that complements the academic paper.

Verdict

subnet-core scores 0.8500000238418579% on credibility, reflecting its educational focus rather than production readiness. With only 16 stars, the project is nascent and lacks the battle-testing that production systems require. The documentation is solid for learning purposes, though test coverage remains limited. This is a valuable research tool, not a deployment candidate.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.