BunkerCoin

A low-bandwidth, shortwave radio-compatible blockchain protocol using Alpenglow consensus.

Contributions welcomed!

Quick Start

Run the simulated v0 prototype

This demo runs a multi-node Alpenglow consensus simulation over a simulated radio network, and exposes a (very basic) live block explorer API.

cargo run --bin node-api-radio-proto

• The explorer API will be available at http://localhost:3001
• See Explorer API Spec for endpoints

To run the same radio-proto message path through the PACTOR simulator instead of the raw simulated radio transport:

cargo run --bin node-api-radio-proto -- --pactor

Repo Overview

• bunker_coin_core: Shared types (hashes, blocks, transactions)
• bunker_coin_radio: Radio networking implementation
  • Simulated radio with realistic HF propagation
• bunker_coin_sim: Simulation scenarios and tools
• bunker_coin_rpc: API & RPC (wip)

Radio Networking

The radio layer right now simulates realistic HF (shortwave) conditions:

• Global Bandwidth >> 50-2400 bps (depending on conditions)
• Packet Loss >> 5-50% (ionospheric effects)
• Latency >> 100-1000ms (propagation) ++ jitter
• MTU >> 300 bytes (standard for packet radio) supported but inactive right now
• Erasure Coding (2:6 for now due to empty blocks, later 32:96)

API

• Explorer API Spec

Next Steps

1. Persistency, right now everything stored in-memory
2. Support for Transactions
3. Physical Radio devices instead of the simulated one
4. Remainders from the BunkerCoin spec (aggregation of bls, etc.)
   ... (many more)

Core contributors welcomed! If you'd like to help shape the protocol from the ground up, get in touch.

References

• Alpenglow (A true piece of art)
• BunkerCoin Whitepaper: bunker_coin.tex
• BunkerCoin Whitepaper (PDF)

Building

Ensure you have a recent stable Rust toolchain installed.

rustup update stable
cargo check

Nothing is stabilised yet, expect rapid iteration.