Rovereto, donderdag 19 november 2026 · Jaargang XIII, nr. 323
nl
Bitcoin Valley
InhoudSluiten

Berichten uit het dal waar je met bitcoin betaalt.

Voor wie dingen uit elkaar haalt

De software

Deze site draait op bitmentor, met een GNU AGPLv3-licentie (andere licenties, zoals MIT, op aanvraag bij de auteurs): github.com/mammadori/bitmentor. Wil jouw stad hetzelfde doen, dan staat de code daar: het is onze nalatenschap. Naam, kleuren, geschiedenis en pagina's staan in één map, en je verandert ze zonder de code aan te raken.

Probeer het nu met jouw stad: typ de naam, zie de site veranderen, download je kant-en-klare map.

Keuzes in het ontwerp

De server ziet de herstelwoorden niet en kan niets uitgeven. Er bestaan nergens in het systeem sleutels die kunnen uitgeven.

De server ziet zelfs de verkopen niet. De kassa zit in de telefoon of de computer van de winkel: hij vraagt het betaalverzoek (Lightning-factuur) rechtstreeks op bij het Lightning-adres van de winkelier, controleert de betaling met diens wallet en bewaart de geschiedenis daar, met de kopieën die de winkelier zelf downloadt. On-chain is een experimentele functie, uitgeschakeld tot de community hem aanzet (de Valley heeft hem aan staan): wie hem wil, zet zijn publieke sleutel in de kassa, en de adressen ontstaan daar.

Een winkel met een Lightning-adres ontvangt betalingen ook als de server uitvalt: het adres hoort bij zijn wallet, en een los afgedrukte QR-code van het adres blijft werken. Het bordje van de site niet: die QR-code opent de pagina van de winkel, en die staat op de server.

Een schorsing haalt een winkel van de kaart en laat zijn kassa met rust. Wie de site beheert, kan niemands betalingen tegenhouden.

Wat erin zit

Onderdeel Technologie
Site en ondernemersomgeving Django, Postgres, Caddy
Kassa In de browser: vraagt het betaalverzoek op bij het Lightning-adres van de winkel (LNURL-pay) en controleert de betaling met LUD-21 verify
Betalingen ontvangen zonder bewaring Elk Lightning-adres dat vanaf zijn eigen domein en naar de browser antwoordt op LUD-21 verify; voor een kleine winkel een non-custodial wallet op Spark (welke we hebben geprobeerd)
On-chain Experimenteel, standaard uit: op de telefoon of de computer van de kassa, uitgebreide publieke sleutel of vast adres
Inloggen LNURL-auth, of een link per e-mail
Kaart Leaflet, OpenStreetMap, geen sleutel
Open data NIP-05, winkels en evenementen ondertekend op Nostr, /shops.json

Op de server staan geen Bitcoin-node en geen betaalserver: niets om te synchroniseren, geen kanalen, geen API-sleutels van wallets. De verkopen blijven op de telefoon of de computer van de kassa.

Installatie

Wat je nodig hebt Om het te proberen Voor een echte site
Software Python 3.14 Linux met Docker
Machine Je eigen computer Eén enkele: 1 of 2 CPU's, 2 GB RAM
Netwerk Niets Een domeinnaam die ernaar wijst, poorten 80 en 443 open

Om het te proberen (5 minuten)

Op je eigen computer, met een voorbeeldcommunity en verzonnen winkels:

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

Voor een echte site (één machine)

Eén machine is genoeg, met wat de tabel zegt: Caddy haalt zelf de certificaten op.

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

Schrijf in de .env de naam met SITE_HOST, het pad van je community met COMMUNITY_DIR en je IP-adres in DEV_ALLOWED_IPS. Daarna:

docker compose up -d
Je begint op signet, en wie de site kan zien

Je begint op signet, het testnetwerk, waar alles hetzelfde werkt en de satoshi's niets waard zijn; mainnet komt een stap later.

De site start in de modus development: alleen de adressen in DEV_ALLOWED_IPS kunnen hem zien. SITE_MODE=production opent hem voor iedereen en werkt alleen op mainnet. manage.py preflight vertelt wat er nog ontbreekt, van de e-mail tot mainnet. Bijwerken: git pull && docker compose up -d --build.

Vanaf dat moment doen de ondernemers het zelf: ieder vult het Lightning-adres van zijn eigen wallet in. Kom je van een ander systeem, dan haalt manage.py import_shops file.json de lijst met winkels binnen. De optionele functies, van Telegram tot Nostr, zet je aan in de .env of in community.yml; de twee experimentele, on-chain aan de kassa en het insturen naar OpenStreetMap, blijven uit tot de community ze aanzet. Welke wallets je de winkels kunt aanraden, staat in docs/wallets.md. De lijst met functies staat in de README, met stap-voor-stapinstructies en de versie met images en CI voor wie met velen is.

Je community

community.yml    naam, contact, talen, route, evenementen
theme/           lettertypen, kleuren, logo, afbeeldingen
pages/<taal>/    pagina's in Markdown, met de live gegevens
templates/       kop en voettekst, als je ze anders wilt
data/            je eigen cijfers

Deze map is het enige wat de ene community van de andere onderscheidt. De Valley in jouw stad maakt er een voor je klaar, in je browser.

Open data

Blossom: bestanden op vingerafdruk

De bestanden van de site (foto's, documenten, de kopie van de site) kun je ook opvragen met hun SHA-256-vingerafdruk, zoals een alleen-lezen Blossom-server dat doet: https://blossom.bitcoinvalley.eu/<sha256>.

Iedereen kan controleren of de bytes kloppen met de vingerafdruk en er een kopie van bewaren op zijn eigen Blossom-server; wie ze allemaal wil kopiëren, begint bij blossom.bitcoinvalley.eu/list, de lijst met vingerafdruk, grootte en adres van elk bestand. Je uploadt niets en je hoeft geen toestemming te vragen.

Het is het technische stuk van de digitale onsterfelijkheid: een bestand dat iemand heeft gekopieerd, blijft bereikbaar, met dezelfde vingerafdruk, ook via een ander adres. Het blijft bestaan zolang iemand het bewaart: de site stelt de bestanden beschikbaar, de kopieën maakt wie dat wil.

Vertrouw niet, controleer zelf

De pdf van Satoshi's tekst die je hier vindt, is dezelfde die in de blockchain gegraveerd staat. Met een eigen node:

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

Er moet b1674191a88ec5cdd733e4240a81803105dc412d6c6708d53ab94fc248f4f553 uitkomen, net als bij ons bestand.

De sommen van het register reken je zo na:

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

Dat geeft 5143.

De site zelf kun je meenemen: een volledige kopie, met de vingerafdrukken en de handtekening, om overal weer neer te zetten.

De open data op een pagina: het register Gebruiken in een winkel