Skip to content

Bitflash-sh/bitflash

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bitflash — Satoshi's Bitcoin reborn, mined with your CPU

Bitflash ⚡  BTF

Satoshi's Bitcoin, reborn — mine with your CPU, stay invisible, run anywhere.

A faithful revival of the original 2009 bitcoin-0.1.0, rebuilt for today: memory-hard CPU mining that shuts out ASICs and GPUs, anonymous addressing that hides your IP and punches through CGNAT, and a fair launch with no premine.


PoW Privacy Fair Launch

Windows Linux Language License Supply

⬇️ Download for Windows  ·  🐧 Build for Linux  ·  🧠 How it works


Bitflash wallet mining with RandomX

The Bitflash wallet — mining with RandomX, connected to the network, coins accruing. No pools, no ASICs, no gatekeepers.


💡 One CPU, one vote

Bitcoin promised money mined by anyone with a computer. Then ASIC farms and mining pools took over, and "anyone" became "whoever owns a warehouse." Bitflash gives that promise back.

  • 🧩 Memory-hard proof of work (RandomX). The same algorithm Monero uses to keep mining on ordinary CPUs. No ASICs. No GPU farms. Your laptop competes on equal footing.
  • 🕶️ Anonymous by default. Your node is reachable by a self-certifying .btf address instead of an IP — a Tor-style hidden service built into the coin, over Nostr. Peers never see your IP.
  • 🌐 Works behind any firewall. No public IP? Stuck behind CGNAT? No port forwarding? Doesn't matter. Nodes rendezvous through a lightweight relay and connect anyway.
  • ⚖️ Fair launch. No premine. No ICO. No founder's reward. The genesis block mints the same 50 coins everyone else mines for.
  • 🪙 Sound money. 50 BTF per block, halving on schedule, hard cap of 21,000,000 — exactly like the original.

🔥 Don't let the network die — run a node

A cryptocurrency is only as alive as the people running it. Every node that mines, relays, and stays online makes Bitflash faster, freer, and impossible to shut down. No companies. No servers to trust. No gatekeepers — just people, one CPU each.

Download it. Run it. Keep it alive.

⬇️ Windows  ·  🐧 Linux  ·  🛰️ Run a relay

The network needs you online. Close this tab and it's one node weaker.


✨ Features

🧠 RandomX PoW CPU-only, ASIC/GPU-resistant mining — one CPU, one vote
🔐 .btf hidden addresses Self-certifying, unforgeable node identity; your IP is never exposed
🛰️ Nostr peer discovery No central servers, no DNS seeds — nodes find each other over open relays
🚪 CGNAT traversal Rendezvous transport lets nodes behind carrier NAT reach each other
🔒 End-to-end encrypted P2P X25519 + XChaCha20-Poly1305 channel; the relay only ever sees ciphertext
💸 Instant transfers Send coins peer-to-peer in under a second
🖥️ Retro wallet The classic, no-nonsense Bitcoin 0.1.0 interface, one "Generate Coins" click away
🐧 Windows & Linux GUI wallet on Windows, headless daemon for Linux servers

🚀 Quick start

🪟 Windows (GUI wallet + miner)

  1. Download the latest release and unzip it anywhere.
  2. Double-click bitflash.exe.
  3. Wait ~1 minute — it finds peers on its own and starts syncing.
  4. Options → Generate Coins to start mining with your CPU. That's it. 🎉

No install, no config, no command line. It connects automatically, even behind CGNAT.

🐧 Linux (node + miner)

# grab the source, then:
bash build-linux.sh          # installs deps, builds secp256k1 + RandomX + the node
./src/bitflash-node -gen      # run + mine (auto-discovers peers, no config needed)

Run it 24/7 as a service — see docs/ and the systemd snippet below.


🧠 How it works

Bitflash keeps Satoshi's consensus intact and swaps two things: the proof of work and how nodes find and reach each other.

Anonymous rendezvous (the .btf network)

Every node has a .btf address derived from its public key — like a Tor .onion, but built into the coin. Nodes publish a signed descriptor over Nostr, and connect through a meeting relay so neither side ever learns the other's IP, and no port forwarding is ever needed.

flowchart LR
    A["🧑‍💻 Node A<br/>(behind CGNAT)"] -- "encrypted" --> R(("🛰️ Meeting<br/>relay"))
    B["🧑‍💻 Node B<br/>(behind CGNAT)"] -- "encrypted" --> R
    R -. "pairs by .btf key<br/>sees only ciphertext" .-> A
    R -. "pairs by .btf key<br/>sees only ciphertext" .-> B
    N["🛰️ Nostr relays"] -. "discover .btf peers" .-> A
    N -. "discover .btf peers" .-> B
Loading

The relay is dumb on purpose: it pairs peers by their .btf key and forwards bytes. The real connection is end-to-end encrypted (X25519 + XChaCha20-Poly1305) and authenticated to each peer's static key, so a malicious relay can't read or tamper — it can only refuse.

Bitflash node connecting by .btf through the rendezvous and mining RandomX

A node tunneling to a peer by its .btf address through the rendezvous, and finding a RandomX proof of work — automatic, no configuration, no IP exposed.

RandomX proof of work

Blocks are mined with RandomX, a memory-hard algorithm that runs efficiently on general-purpose CPUs and terribly on specialized hardware. This is what keeps mining decentralized: no ASIC advantage, no GPU farms — just CPUs, one vote each.


🛠️ Build from source

Linux

bash build-linux.sh

Installs build-essential cmake libssl-dev libdb5.3++-dev libsodium-dev nlohmann-json3-dev libboost-dev, builds libsecp256k1 (Schnorr) and RandomX from source, then the bitflash-node binary. Debian/Ubuntu.

Windows

Built with MSYS2 UCRT64 (g++ 16, wxWidgets 3.2, OpenSSL 3, Berkeley DB). See build.sh and src/makefile.mingw.

🛰️ Become a relay volunteer — automatically

Relays are the meeting points that let nodes behind CGNAT find each other. More relays, in more places, make the network faster and harder to knock offline. If you have a VPS with a public IP, you can add one — and the whole network discovers it automatically. No approval, no gatekeeper, no waiting.

1. Run the relay — one command:

sudo bash relay/install-bitflash-relay.sh 8434

Builds a tiny, dependency-free daemon, applies anti-flood firewall rules, and installs it as a systemd service (auto-restarts, survives reboot).

2. Open TCP port 8434 in your firewall / cloud panel.

3. Announce it by running a node that advertises your relay:

./bitflash-node -gen -announcerelay=YOUR_PUBLIC_IP:8434

That node publishes your relay over Nostr; every other node discovers it within a minute and adds it to its failover list. Done — you're part of the backbone.

🔒 A relay is trustless — it only forwards end-to-end-encrypted bytes and pairs peers by their .btf key. It cannot read, tamper with, or MITM your traffic; a malicious relay can at most refuse to forward, and nodes simply fail over. That's exactly why anyone can run one safely. A 1 GB VPS is plenty.

Run the Linux node 24/7 (systemd)
# /etc/systemd/system/bitflash-node.service
[Unit]
Description=Bitflash node/miner
After=network.target

[Service]
WorkingDirectory=/root/bitflash/src
ExecStart=/root/bitflash/src/bitflash-node -gen
Restart=always
User=root

[Install]
WantedBy=multi-user.target
systemctl daemon-reload && systemctl enable --now bitflash-node

📊 At a glance

Parameter Value
Ticker BTF
Proof of work RandomX (CPU, memory-hard)
Block reward 50 BTF, halving on schedule
Max supply 21,000,000 BTF
Target block time ~2 minutes
Address privacy .btf hidden-service addressing over Nostr
Premine / ICO None
Platforms Windows (GUI), Linux (headless)

🗺️ Roadmap

  • Faithful port of bitcoin-0.1.0 to a modern toolchain
  • RandomX CPU proof of work
  • Nostr peer discovery (replacing IRC)
  • .btf anonymous addressing + CGNAT rendezvous
  • Automatic peer discovery — zero config
  • Headless Linux node/miner
  • Fair-launch, stable-parameter relaunch
  • Redundant relays across regions with automatic failover
  • Automatic relay discovery over Nostr (self-announcing volunteer relays)

⚠️ Disclaimer

Bitflash is experimental software, released in the spirit of the original Bitcoin: "This is a design and prototype. Use at your own risk. It comes with no warranty of any kind." It has real cryptography and a live network, but it is young. Don't put in more than you're willing to lose, and don't rely on it for anything critical.


📜 License

MIT — see LICENSE. Built on Satoshi Nakamoto's original Bitcoin (2009), extended by the Bitflash developers (2026).


⚡ One CPU. One vote. Mining returns to the people. ⚡

About

Satoshi's Bitcoin (0.1.0) reborn — CPU-mined with RandomX, anonymous .btf addressing over Nostr, fair launch. Windows & Linux.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages