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.
Si quelqu'un pénétrait dans le serveur, il n'y trouverait ni argent ni ventes : il trouverait, très bien configuré, ce qu'on peut déjà télécharger librement, et en plus seulement les coordonnées que les commerçants ont choisi de nous laisser.
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
/shops.json: les commerces, réutilisables par n'importe qui./theme/docs/registro.csv: le registre par année./theme/docs/registro-mesi.csv: le registre par mois./.well-known/nostr.json: identité NIP-05 de la communauté./sitemap.xml.
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