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
/shops.json: de winkels, door iedereen te hergebruiken./theme/docs/registro.csv: het register per jaar./theme/docs/registro-mesi.csv: het register per maand./.well-known/nostr.json: NIP-05-identiteiten van de community./sitemap.xml.
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