Rovereto, Dienstag, 17. November 2026 · Jahrgang XIII, Nr. 321 itende
Bitcoin Valley
InhaltSchließen

Chroniken aus dem Tal, in dem man mit Bitcoin bezahlt.

Für alle, die Dinge auseinandernehmen

Die Software

Diese Website läuft auf bitmentor, unter der Lizenz GNU AGPLv3 (andere Lizenzen, etwa MIT, auf Anfrage bei den Autoren): github.com/mammadori/bitmentor. Wenn Ihre Stadt dasselbe machen will: Der Code liegt dort, er ist unser Vermächtnis. Name, Farben, Geschichte und Seiten liegen in einem Ordner und lassen sich ändern, ohne den Code anzufassen.

Probieren Sie es jetzt mit Ihrer Stadt aus: Geben Sie den Namen ein, sehen Sie zu, wie sich die Website verändert, und laden Sie Ihren fertigen Ordner herunter.

Entwurfsentscheidungen

Der Server sieht die Wiederherstellungswörter nicht und kann nichts ausgeben. Nirgends im System gibt es Schlüssel, mit denen man Geld ausgeben kann.

Der Server sieht nicht einmal die Verkäufe. Die Kasse liegt auf dem Telefon oder Computer des Geschäfts: Sie holt die Rechnung direkt bei der Lightning-Adresse des Händlers, prüft die Zahlung mit seiner Wallet und speichert den Verlauf dort, mit den Kopien, die er selbst herunterlädt. On-chain ist eine experimentelle Funktion, ausgeschaltet, bis die Community sie einschaltet (das Valley hat sie eingeschaltet): Wer sie will, hinterlegt seinen öffentlichen Schlüssel in der Kasse, und die Adressen entstehen dort.

Ein Geschäft mit Lightning-Adresse kassiert auch dann, wenn der Server ausfällt: Die Adresse gehört zu seiner Wallet, und ein separat gedruckter QR-Code der Adresse funktioniert weiter. Das Schild der Website nicht: Sein QR-Code öffnet die Seite des Geschäfts, und die liegt auf dem Server.

Eine Sperrung nimmt ein Geschäft von der Karte und rührt seine Kasse nicht an. Wer die Website betreibt, hat keine Möglichkeit, die Einnahmen von irgendjemandem zu blockieren.

Was drinsteckt

Teil Technik
Website und Händlerbereich Django, Postgres, Caddy
Kasse Im Browser: Sie holt die Rechnung bei der Lightning-Adresse des Geschäfts (LNURL-pay) und prüft die Zahlung mit LUD-21 verify
Kassieren ohne Verwahrung Jede Lightning-Adresse, die von ihrer eigenen Domain aus und dem Browser auf LUD-21 verify antwortet; für ein kleines Geschäft eine Non-Custodial-Wallet auf Spark (welche wir ausprobiert haben)
On-chain Experimentell, standardmäßig aus: auf dem Telefon oder Computer der Kasse, erweiterter öffentlicher Schlüssel oder feste Adresse
Anmeldung LNURL-auth oder Link per E-Mail
Karte Leaflet, OpenStreetMap, kein Schlüssel
Offene Daten NIP-05, auf Nostr signierte Geschäfte und Veranstaltungen, /shops.json

Auf dem Server gibt es weder einen Bitcoin-Knoten noch einen Zahlungsserver: nichts zu synchronisieren, keine Kanäle, keine API-Schlüssel von Wallets. Die Verkäufe bleiben auf dem Telefon oder Computer der Kasse.

Installation

Was Sie brauchen Zum Ausprobieren Für eine echte Website
Software Python 3.14 Linux mit Docker
Maschine Ihr Computer Nur eine: 1 oder 2 CPUs, 2 GB RAM
Netz Nichts Ein Domainname, der dorthin zeigt, offene Ports 80 und 443

Zum Ausprobieren (5 Minuten)

Auf Ihrem Computer, mit einer Beispiel-Community und erfundenen Geschäften:

python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
export SECRET_KEY=prova DEBUG=1 && .venv/bin/python manage.py migrate && .venv/bin/python manage.py demo_data
.venv/bin/python manage.py runserver

Für eine echte Website (eine Maschine)

Eine einzige Maschine genügt, mit dem, was die Tabelle sagt: Caddy holt sich die Zertifikate selbst.

git clone https://github.com/mammadori/bitmentor.git && cd bitmentor && cp -r examples/community ../la-mia-comunita
cp .env.example .env && for k in SECRET_KEY POSTGRES_PASSWORD WEB_DB_PASSWORD; do sed -i "s/^$k=.*/$k=$(openssl rand -hex 32)/" .env; done && chmod 600 .env

In der .env tragen Sie den Namen mit SITE_HOST ein, den Pfad Ihrer Community mit COMMUNITY_DIR und Ihre IP-Adresse in DEV_ALLOWED_IPS. Dann:

docker compose up -d
Man beginnt auf Signet, und wer die Website sehen kann

Man beginnt auf Signet, dem Testnetz, wo alles gleich funktioniert und die Münzen nichts wert sind; Mainnet ist der nächste Schritt.

Die Website startet im Modus development: Sehen können sie nur die Adressen, die in DEV_ALLOWED_IPS stehen. SITE_MODE=production öffnet sie für alle und funktioniert nur auf Mainnet. manage.py preflight sagt, was noch fehlt, von der E-Mail bis zum Mainnet. Zum Aktualisieren: git pull && docker compose up -d --build.

Ab dann kommen die Händler allein zurecht: Jeder trägt die Lightning-Adresse seiner Wallet ein. Wenn Sie von einem anderen System kommen, holt manage.py import_shops file.json die Liste der Geschäfte herein. Die optionalen Funktionen, von Telegram bis Nostr, werden in der .env oder in community.yml eingeschaltet; die beiden experimentellen, On-chain an der Kasse und das Senden an OpenStreetMap, bleiben aus, bis die Community sie einschaltet. Welche Wallets man den Geschäften vorschlagen kann, steht in docs/wallets.md. Die Liste der Funktionen steht in der README, mit der Schritt-für-Schritt-Anleitung und der Variante mit Images und CI für größere Gruppen.

Ihre Community

community.yml    Name, Kontakte, Sprachen, Route, Veranstaltungen
theme/           Schriften, Farben, Logo, Bilder
pages/<sprache>/ Seiten in Markdown, mit lebendigen Daten
templates/       Kopf- und Fußzeile, wenn Sie sie anders wollen
data/            Ihre Zahlen

Dieser Ordner ist das Einzige, was sich von einer Community zur anderen unterscheidet. Das Valley in Ihrer Stadt bereitet Ihnen einen vor, in Ihrem Browser.

Offene Daten

Blossom: die Dateien nach Fingerabdruck

Die Dateien der Website (Fotos, Dokumente, die Kopie der Website) lassen sich auch über ihren SHA-256-Fingerabdruck abrufen, wie bei einem Blossom-Server, nur lesend: https://bitcoinvalley.eu/blossom/<sha256>.

Jeder kann prüfen, ob die Bytes zum Fingerabdruck passen, und eine Kopie auf dem eigenen Blossom-Server behalten; wer alle kopieren will, beginnt bei /blossom/list, der Liste mit Fingerabdruck, Größe und Adresse jeder Datei. Man lädt nichts hoch und fragt niemanden um Erlaubnis.

Das ist das technische Stück der digitalen Unsterblichkeit: Eine Datei, die jemand kopiert hat, bleibt erreichbar, mit demselben Fingerabdruck, auch unter einer anderen Adresse. Sie hält, solange jemand sie aufbewahrt: Die Website stellt die Dateien bereit, die Kopien macht, wer will.

Nicht vertrauen, prüfen

Das PDF von Satoshis Text, das Sie hier finden, ist dasselbe, das in die Blockchain eingraviert ist. Mit einem eigenen Knoten:

seq 0 947 | (while read -r n; do bitcoin-cli gettxout 54e48e5f5c656b26c3bca14a8c95aa583d07ebe84dde3b7dd4a78f4e4186e713 $n | jq -r '.scriptPubKey.asm' | awk '{print $2 $3 $4}'; done) | tr -d '\n' | cut -c 17-368600 | xxd -r -p | sha256sum

Herauskommen muss b1674191a88ec5cdd733e4240a81803105dc412d6c6708d53ab94fc248f4f553, wie bei unserer Datei.

Die Zahlen des Hauptbuchs lassen sich so nachrechnen:

awk -F, 'NR>1{s+=$2} END{print s}' registro-mesi.csv

Das ergibt 5143.

Die Website selbst lässt sich mitnehmen: eine vollständige Kopie, mit Fingerabdrücken und Signatur, die sich überall wieder online stellen lässt.

Die offenen Daten auf einer Seite: das Hauptbuch In einem Geschäft verwenden