Rovereto, jeudi 19 novembre 2026 · Année XIII, n° 323
fr
Bitcoin Valley
SommaireFermer

Chroniques de la vallée où l'on paie en bitcoin.

Pour ceux qui démontent les choses

Le logiciel

Ce site tourne sur bitmentor, sous licence GNU AGPLv3 (d'autres licences, comme MIT, sur demande aux auteurs) : github.com/mammadori/bitmentor. Si votre ville veut faire la même chose, le code est là : c'est notre héritage. Nom, couleurs, histoire et pages sont dans un dossier, et se changent sans toucher au code.

Essayez maintenant avec votre ville : écrivez le nom, regardez le site changer, téléchargez votre dossier prêt à l'emploi.

Choix de conception

Le serveur ne voit pas les mots de récupération et ne peut pas dépenser. Il n'existe aucune clé qui dépense, nulle part dans le système.

Le serveur ne voit même pas les ventes. La caisse est dans le téléphone ou l'ordinateur du commerce : elle obtient la demande de paiement (facture Lightning) directement de l'adresse Lightning du commerçant, vérifie le paiement auprès de son portefeuille et garde l'historique là, avec les copies qu'il télécharge. L'on-chain est une fonction expérimentale, éteinte tant que la communauté ne l'active pas (la Valley la garde activée) : celui qui la veut met sa clé publique dans la caisse, et les adresses naissent là.

Un commerce avec une adresse Lightning encaisse même si le serveur s'éteint : l'adresse est celle de son portefeuille, et un QR code de l'adresse imprimé à part continue de fonctionner. L'affichette du site, non : son QR code ouvre la page du commerce, qui est sur le serveur.

La suspension retire un commerce de la carte et ne touche pas à sa caisse. Ceux qui gèrent le site n'ont aucun moyen de bloquer les encaissements de qui que ce soit.

Ce qu'il y a dedans

Partie Technologie
Site et espace commerçant Django, Postgres, Caddy
Caisse Dans le navigateur : elle demande la facture Lightning à l'adresse Lightning du commerce (LNURL-pay) et vérifie le paiement avec LUD-21 verify
Encaissement sans garde des fonds N'importe quelle adresse Lightning qui répond à LUD-21 verify depuis son domaine et au navigateur ; pour un petit commerce, un portefeuille non custodial sur Spark (ceux que nous avons essayés)
On-chain Expérimental, éteint par défaut : sur le téléphone ou l'ordinateur de la caisse, clé publique étendue ou adresse fixe
Connexion LNURL-auth, ou lien par e-mail
Carte Leaflet, OpenStreetMap, aucune clé
Données ouvertes NIP-05, commerces et événements signés sur Nostr, /shops.json

Sur le serveur, il n'y a ni nœud Bitcoin ni serveur de paiement : rien à synchroniser, pas de canaux, pas de clés API des portefeuilles. Les ventes restent sur le téléphone ou l'ordinateur de la caisse.

Installation

Ce qu'il vous faut Pour l'essayer Pour un vrai site
Logiciel Python 3.14 Linux avec Docker
Machine Votre ordinateur Une seule : 1 ou 2 CPU, 2 Go de RAM
Réseau Rien Un nom de domaine qui pointe là, ports 80 et 443 ouverts

Pour l'essayer (5 minutes)

Sur votre ordinateur, avec une communauté d'exemple et des commerces inventés :

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

Pour un vrai site (une machine)

Une seule machine suffit, avec ce que dit le tableau : Caddy obtient tout seul les certificats.

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

Dans le .env, écrivez le nom avec SITE_HOST, le chemin de votre communauté avec COMMUNITY_DIR et votre adresse IP dans DEV_ALLOWED_IPS. Puis :

docker compose up -d
On commence sur signet, et qui peut voir le site

On commence sur signet, le réseau de test, où tout fonctionne pareil et où les satoshis ne valent rien ; le mainnet (réseau principal) est l'étape d'après.

Le site démarre en mode development : seules les adresses écrites dans DEV_ALLOWED_IPS le voient. SITE_MODE=production l'ouvre à tous et ne fonctionne que sur mainnet. manage.py preflight dit ce qui manque encore, de l'e-mail au mainnet. Pour mettre à jour : git pull && docker compose up -d --build.

À partir de là, les commerçants se débrouillent seuls : chacun écrit l'adresse Lightning de son portefeuille. Si vous venez d'un autre système, manage.py import_shops file.json importe la liste des commerces. Les fonctions facultatives, de Telegram à Nostr, s'activent depuis le .env ou community.yml ; les deux expérimentales, l'on-chain à la caisse et l'envoi vers OpenStreetMap, restent éteintes tant que la communauté ne les active pas. Quels portefeuilles suggérer aux commerces, c'est docs/wallets.md qui le dit. La liste des fonctions est dans le README, avec les instructions pas à pas et la version avec images et CI pour ceux qui sont nombreux.

Votre communauté

community.yml    nom, contacts, langues, itinéraire, événements
theme/           polices, couleurs, logo, images
pages/<langue>/  pages en Markdown, avec les données vivantes
templates/       en-tête et pied de page, si vous les voulez différents
data/            vos chiffres

Ce dossier est la seule chose qui diffère d'une communauté à l'autre. La Valley dans votre ville vous en prépare un, dans votre navigateur.

Données ouvertes

Blossom : les fichiers par empreinte

Les fichiers du site (photos, documents, la copie du site) peuvent aussi être demandés par leur empreinte SHA-256, comme le fait un serveur Blossom en lecture seule : https://blossom.bitcoinvalley.eu/<sha256>.

N'importe qui peut vérifier que les octets correspondent à l'empreinte et en garder une copie sur son propre serveur Blossom ; celui qui veut tous les copier part de blossom.bitcoinvalley.eu/list, la liste avec l'empreinte, la taille et l'adresse de chaque fichier. On ne téléverse rien et on ne demande pas la permission.

C'est la pièce technique de l'immortalité numérique : un fichier que quelqu'un a copié reste accessible, avec la même empreinte, même depuis une autre adresse. Il dure tant que quelqu'un le garde : le site met les fichiers à disposition, les copies, les fait qui veut.

Ne faites pas confiance, vérifiez

Le PDF du texte de Satoshi que vous trouvez ici est le même que celui gravé dans la blockchain. Avec votre propre nœud :

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

Il doit sortir b1674191a88ec5cdd733e4240a81803105dc412d6c6708d53ab94fc248f4f553, comme pour notre fichier.

Les comptes du registre se refont ainsi :

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

Cela fait 5143.

Le site lui-même s'emporte : une copie complète, avec les empreintes et la signature, à remettre en ligne n'importe où.

Les données ouvertes en page : le registre L'utiliser dans un commerce