From 51d617e70f90a972185917ea0096c1ecef2bfa8b Mon Sep 17 00:00:00 2001
From: Bitflash-sh <btf01@proton.me>
Date: Fri, 24 Jul 2026 11:18:11 -0300
Subject: Bitflash: fair-launch release

Satoshi's bitcoin-0.1.0 reborn with RandomX CPU proof of work, anonymous .btf
addressing over Nostr with CGNAT rendezvous, automatic peer discovery, a
headless Linux node, and Windows GUI wallet. Fair launch, no premine, 21M cap.
---
 relay/README.md | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 relay/README.md

(limited to 'relay/README.md')

diff --git a/relay/README.md b/relay/README.md
new file mode 100644
index 0000000..abf0f8d
--- /dev/null
+++ b/relay/README.md
@@ -0,0 +1,57 @@
+# bitflashd — Bitflash rendezvous relay (the "meeting node")
+
+This is the small always-on server that lets Bitflash nodes behind CGNAT reach
+each other. Both sides connect **out** to this relay; it pairs them by their
+`.btf` pubkey and forwards ciphertext. It holds **no keys** and reads nothing —
+the two nodes are encrypted end-to-end (X25519 + ChaCha20-Poly1305) over it.
+
+Run it on any machine with a public IP (a cheap VPS). It has **no dependencies**
+beyond a C++ compiler.
+
+## Build (on the VPS, Linux)
+
+```
+sudo apt-get update && sudo apt-get install -y g++         # if needed
+bash build.sh
+```
+
+## Run
+
+```
+./bitflashd 8434
+```
+
+Open the port in the firewall (both the VPS provider's panel and the OS):
+
+```
+sudo ufw allow 8434/tcp        # if ufw is enabled
+```
+
+## Keep it running (systemd)
+
+Create `/etc/systemd/system/bitflashd.service`:
+
+```
+[Unit]
+Description=Bitflash rendezvous relay
+After=network.target
+
+[Service]
+ExecStart=/root/bitflash/relay/bitflashd 8434
+Restart=always
+User=root
+
+[Install]
+WantedBy=multi-user.target
+```
+
+Then:
+
+```
+sudo systemctl daemon-reload
+sudo systemctl enable --now bitflashd
+sudo systemctl status bitflashd
+```
+
+The relay's address for clients is then `YOUR_VPS_IP:8434` — that is what goes
+into a node's descriptor as its `meeting_node`.
-- 
cgit v1.2.3