Rovereto, jueves 19 de noviembre de 2026 · Año XIII, n.º 323
es
Bitcoin Valley
SumarioCerrar

Crónicas del valle donde se paga en bitcoin.

Para quien desmonta las cosas

El software

Este sitio funciona con bitmentor, con licencia GNU AGPLv3 (otras licencias, como MIT, bajo petición a los autores): github.com/mammadori/bitmentor. Si tu ciudad quiere hacer lo mismo, el código está ahí: es nuestro legado. Nombre, colores, historia y páginas están en una carpeta, y se cambian sin tocar el código.

Prueba ahora con tu ciudad: escribe el nombre, mira cómo cambia el sitio, descarga tu carpeta lista.

Decisiones de diseño

El servidor no ve las palabras de recuperación y no puede gastar. No existen claves que gasten en ninguna parte del sistema.

El servidor ni siquiera ve las ventas. La caja está en el móvil o en el ordenador de la tienda: pide la factura directamente a la dirección Lightning del comerciante, comprueba el pago con su wallet y guarda el historial allí, con las copias que descarga él. El on-chain es una función experimental, apagada hasta que la comunidad la enciende (la Valley la tiene encendida): quien la quiere pone su clave pública en la caja, y las direcciones nacen allí.

Una tienda con dirección Lightning cobra aunque el servidor se apague: la dirección es de su wallet, y un QR de la dirección impreso aparte sigue funcionando. El cartel del sitio no: su QR abre la página de la tienda, que está en el servidor.

La suspensión quita una tienda del mapa y no le toca la caja. Quien gestiona el sitio no tiene manera de bloquear los cobros de nadie.

Qué hay dentro

Parte Tecnología
Sitio y panel Django, Postgres, Caddy
Caja En el navegador: pide la factura a la dirección Lightning de la tienda (LNURL-pay) y comprueba el pago con LUD-21 verify
Cobro sin custodia Cualquier dirección Lightning que responda a LUD-21 verify desde su dominio y al navegador; para una tienda pequeña, una wallet no custodial sobre Spark (cuáles hemos probado)
On-chain Experimental, apagado por defecto: en el móvil o en el ordenador de la caja, clave pública extendida o dirección fija
Inicio de sesión LNURL-auth, o enlace por correo
Mapa Leaflet, OpenStreetMap, ninguna clave
Datos abiertos NIP-05, tiendas y eventos firmados en Nostr, /shops.json

En el servidor no hay ni un nodo Bitcoin ni un servidor de pagos: nada que sincronizar, nada de canales, nada de claves API de las wallets. Las ventas se quedan en el móvil o en el ordenador de la caja.

Si alguien entrara en el servidor, no encontraría ni dinero ni ventas: encontraría, muy bien configurado, lo que ya se puede descargar libremente, y además solo los datos de contacto que los comerciantes han decidido dejarnos.

Instalación

Qué necesitas Para probarlo Para un sitio de verdad
Software Python 3.14 Linux con Docker
Máquina Tu ordenador Una sola: 1 o 2 CPU, 2 GB de RAM
Red Nada Un nombre de dominio que apunte ahí, puertos 80 y 443 abiertos

Para probarlo (5 minutos)

En tu ordenador, con una comunidad de ejemplo y tiendas inventadas:

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

Para un sitio de verdad (una máquina)

Basta con una sola máquina, con lo que dice la tabla: Caddy consigue él solo los certificados.

git clone https://github.com/mammadori/bitmentor.git && cd bitmentor && cp -r examples/community ../mi-comunidad
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

En el .env escribe el nombre con SITE_HOST, la ruta de tu comunidad con COMMUNITY_DIR y tu dirección IP en DEV_ALLOWED_IPS. Luego:

docker compose up -d
Se empieza en signet, y quién puede ver el sitio

Se empieza en signet, la red de pruebas, donde todo funciona igual y los satoshis no valen nada; la mainnet es un paso posterior.

El sitio arranca en modo development: solo lo ven las direcciones escritas en DEV_ALLOWED_IPS. SITE_MODE=production lo abre a todos y solo funciona en mainnet. manage.py preflight dice lo que todavía falta, del correo a la mainnet. Para actualizar: git pull && docker compose up -d --build.

A partir de ahí los comerciantes se apañan solos: cada uno escribe la dirección Lightning de su wallet. Si vienes de otro sistema, manage.py import_shops file.json mete dentro la lista de tiendas. Las funciones opcionales, de Telegram a Nostr, se encienden desde el .env o desde community.yml; las dos experimentales, el on-chain en la caja y el envío a OpenStreetMap, se quedan apagadas hasta que la comunidad las enciende. Qué wallets sugerir a las tiendas lo dice docs/wallets.md. La lista de funciones está en el README, con las instrucciones paso a paso y la versión con imágenes y CI para quien es mucha gente.

Tu comunidad

community.yml    nombre, contactos, idiomas, itinerario, eventos
theme/           fuentes, colores, logotipo, imágenes
pages/<lingua>/  páginas en Markdown, con los datos vivos
templates/       cabecera y pie de página, si los quieres distintos
data/            tus números

Esta carpeta es lo único que cambia entre una comunidad y otra. La Valley en tu ciudad te prepara una, en tu navegador.

Datos abiertos

Blossom: los archivos por su huella

Los archivos del sitio (fotos, documentos, la copia del sitio) se pueden pedir también por su huella SHA-256, como hace un servidor Blossom de solo lectura: https://blossom.bitcoinvalley.eu/<sha256>.

Cualquiera puede comprobar que los bytes cuadran con la huella y guardar una copia en su propio servidor Blossom; quien quiera copiarlos todos parte de blossom.bitcoinvalley.eu/list, la lista con huella, tamaño y dirección de cada archivo. No se sube nada y no se pide permiso.

Es la pieza técnica de la inmortalidad digital: un archivo que alguien ha copiado sigue siendo accesible, con la misma huella, también desde otra dirección. Dura mientras alguien lo guarde: el sitio pone a disposición los archivos, las copias las hace quien quiere.

No te fíes, comprueba

El PDF del texto de Satoshi que encuentras aquí es el mismo que está grabado en la blockchain. Con un nodo tuyo:

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

Tiene que salir b1674191a88ec5cdd733e4240a81803105dc412d6c6708d53ab94fc248f4f553, como con nuestro archivo.

Las cuentas del registro se rehacen así:

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

Da 5143.

El sitio mismo se puede llevar: una copia entera, con las huellas y la firma, para volver a montarla en cualquier parte.

Los datos abiertos en una página: el registro Usarlo en una tienda