Architecting the Future of

We're not just building another blockchain; we're building the definitive, open-source launchpad for the next million Web3 developers. A transparent, end-to-end ecosystem designed for learning, not speculation.

A Complete, Integrated Ecosystem

BunkNet provides a full suite of tools out-of-the-box, giving you everything you need to build, test, and learn.

Why We're Building BunkNet

The promise of blockchain technology is immense, but its complexity remains a formidable barrier. Aspiring developers are often forced to choose between abstract theoretical articles and labyrinthine codebases of production-level chains. True understanding—the kind that sparks innovation—has been out of reach for too many.

BunkNet was born from a simple thesis: **the best way to learn is by doing, and the best way to do is with tools that are powerful yet simple.**

We meticulously engineered every component of the BunkNet ecosystem to be an educational instrument. The Python-based core is readable and intentionally simple. The Proof-of-Work algorithm is designed to be understood, not to consume megawatts of power. Our full suite of tools—the explorer, wallets, and faucet—are not afterthoughts; they are integral parts of a holistic curriculum. They allow a developer to see the entire lifecycle of a decentralized system, from minting a token to watching it move across the network in real-time.

This is not another financial network. This is a laboratory. A sandbox. A launchpad. BunkNet is our commitment to empowering the next generation of builders with the clarity and confidence they need to innovate in the decentralized world.

Power at Your Fingertips:
The BunkNet CLI Wallet

Our command-line wallet is the ultimate tool for developers. It offers complete, scriptable control over your BunkNet assets directly from the terminal. Follow this guide to get set up in minutes.

Note: If you accidentally delete the `wallet.dat` file, you can always recover your wallet and funds using the secret seed phrase provided during generation.

BunkNet CLI Wallet Commands

# 1. Generate a new wallet and seed phrase

python3 wallet.py generate

# 2. View your public wallet address

python3 wallet.py address

# 3. View your secret seed phrase (for backup)

python3 wallet.py backup

# 4. Check your wallet's balance

python3 wallet.py balance

# 5. View your transaction history

python3 wallet.py history

# 6. Import a wallet from a seed phrase

python3 wallet.py import

# 7. Send $BUNK to another address

python3 wallet.py send --to RECIPIENT_ADDRESS --amount 0.5

Anatomy of the BunkNet Protocol

Python Core

Built entirely in Python for maximum readability and accessibility. We chose Python to lower the barrier to entry, allowing developers to focus on blockchain concepts, not complex syntax.

Simplified PoW

Our unique Proof-of-Work algorithm is CPU-friendly and mathematically simple, designed to be understood rather than to be computationally obscure. It makes local mining and experimentation feasible for anyone.

ECDSA Accounts

We use the industry-standard Elliptic Curve Digital Signature Algorithm (SECP256k1) for account security, the same battle-tested cryptography that powers Bitcoin and Ethereum.

P2P Network

A straightforward peer-to-peer networking layer where nodes can register with each other. Consensus is achieved via the "longest chain rule," a fundamental blockchain principle.

MongoDB Storage

The blockchain and mempool data are stored in MongoDB, a flexible NoSQL database. Its document-based structure is a perfect match for the structure of blocks and transactions.

Fee & Reward Model

A simple and transparent model where miners receive a base block reward plus all transaction fees from the blocks they successfully mine, creating a clear incentive structure.

Your Journey Into Blockchain Starts Here.

BunkNet is more than code; it's a community of learners and builders. Fork the repository, raise an issue, or submit a pull request. The best way to learn is to build with us.

Become a Contributor