Rovereto, Quinta-feira 19 de Novembro de 2026 · Ano XIII, n.º 323
pt
Bitcoin Valley
ÍndiceFechar

Crónicas do vale onde se paga em bitcoin.

Para quem desmonta as coisas

O software

Este site corre no bitmentor, com licença GNU AGPLv3 (outras licenças, como a MIT, a pedido dos autores): github.com/mammadori/bitmentor. Se a tua cidade quiser fazer a mesma coisa, o código está lá: é o nosso legado. Nome, cores, história e páginas estão numa pasta, e mudam-se sem tocar no código.

Experimenta agora com a tua cidade: escreve o nome, vê o site mudar, descarrega a tua pasta pronta.

Escolhas de projeto

O servidor não vê as palavras de recuperação e não pode gastar. Não existem chaves que gastem, em parte nenhuma do sistema.

O servidor também não vê as vendas. A caixa está no telemóvel ou no computador da loja: pede o pedido de pagamento (fatura Lightning) diretamente ao endereço Lightning do comerciante, verifica o pagamento com a carteira dele e guarda lá o histórico, com as cópias que ele descarrega. O on-chain é uma funcionalidade experimental, desligada até a comunidade a ligar (a Valley tem-na ligada): quem a quiser põe a sua chave pública na caixa, e os endereços nascem lá.

Uma loja com endereço Lightning recebe mesmo que o servidor se desligue: o endereço é da sua carteira, e um QR do endereço impresso à parte continua a funcionar. O cartaz do site não: o seu QR abre a página da loja, que está no servidor.

A suspensão tira uma loja do mapa e não lhe toca na caixa. Quem gere o site não tem maneira de bloquear os recebimentos de ninguém.

O que há lá dentro

Parte Tecnologia
Site e área do comerciante Django, Postgres, Caddy
Caixa No navegador: pede o pedido de pagamento ao endereço Lightning da loja (LNURL-pay) e verifica o pagamento com LUD-21 verify
Receber sem custódia Qualquer endereço Lightning que responda a LUD-21 verify a partir do seu domínio e ao navegador; para uma loja pequena, uma carteira não custodial na Spark (quais experimentámos)
On-chain Experimental, desligado por omissão: no telemóvel ou no computador da caixa, chave pública estendida ou endereço fixo
Login LNURL-auth, ou ligação por email
Mapa Leaflet, OpenStreetMap, nenhuma chave
Dados abertos NIP-05, lojas e eventos assinados no Nostr, /shops.json

No servidor não há um nó Bitcoin nem um servidor de pagamentos: nada para sincronizar, nada de canais, nada de chaves API das carteiras. As vendas ficam no telemóvel ou no computador da caixa.

Se alguém invadisse o servidor, não encontraria nem dinheiro nem vendas: encontraria, muito bem configurado, o que já se pode descarregar livremente, e além disso só os contactos que os comerciantes escolheram deixar-nos.

Instalação

O que precisas Para o experimentar Para um site a sério
Software Python 3.14 Linux com Docker
Máquina O teu computador Uma só: 1 ou 2 CPU, 2 GB de RAM
Rede Nada Um nome de domínio que aponte para lá, portas 80 e 443 abertas

Para o experimentar (5 minutos)

No teu computador, com uma comunidade de exemplo e lojas inventadas:

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

Para um site a sério (uma máquina)

Basta uma só máquina, com o que diz a tabela: o Caddy obtém sozinho os certificados.

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

No .env escreve o nome com SITE_HOST, o caminho da tua comunidade com COMMUNITY_DIR e o teu endereço IP em DEV_ALLOWED_IPS. Depois:

docker compose up -d
Começa-se na signet, e quem pode ver o site

Começa-se na signet, a rede de teste, onde tudo funciona igual e os satoshis não valem nada; a mainnet é um passo depois.

O site arranca em modo development: só o veem os endereços escritos em DEV_ALLOWED_IPS. SITE_MODE=production abre-o a todos e só funciona na mainnet. manage.py preflight diz o que ainda falta, do email à mainnet. Para atualizar: git pull && docker compose up -d --build.

A partir daí os comerciantes fazem tudo sozinhos: cada um escreve o endereço Lightning da sua carteira. Se vens de outro sistema, manage.py import_shops file.json importa a lista das lojas. As funcionalidades opcionais, do Telegram ao Nostr, ligam-se no .env ou no community.yml; as duas experimentais, o on-chain na caixa e o envio para o OpenStreetMap, ficam desligadas até a comunidade as ligar. Que carteiras sugerir às lojas diz-o docs/wallets.md. A lista das funcionalidades está no README, com as instruções passo a passo e a versão com imagens e CI para quem é muita gente.

A tua comunidade

community.yml    nome, contactos, línguas, itinerário, eventos
theme/           tipos de letra, cores, logótipo, imagens
pages/<língua>/  páginas em Markdown, com os dados vivos
templates/       cabeçalho e rodapé, se os quiseres diferentes
data/            os teus números

Esta pasta é a única coisa diferente entre uma comunidade e outra. A Valley na tua cidade prepara-te uma, no teu navegador.

Dados abertos

Blossom: os ficheiros pela impressão digital

Os ficheiros do site (fotografias, documentos, a cópia do site) também se podem pedir pela sua impressão digital SHA-256, como faz um servidor Blossom só de leitura: https://blossom.bitcoinvalley.eu/<sha256>.

Qualquer pessoa pode verificar que os bytes batem com a impressão digital e guardar uma cópia no seu próprio servidor Blossom; quem quiser copiá-los todos parte de blossom.bitcoinvalley.eu/list, a lista com impressão digital, tamanho e endereço de cada ficheiro. Não se carrega nada e não se pede autorização.

É a peça técnica da imortalidade digital: um ficheiro que alguém copiou continua acessível, com a mesma impressão digital, também a partir de outro endereço. Dura enquanto alguém o guardar: o site põe os ficheiros à disposição, as cópias faz quem quiser.

Não confies, verifica

O PDF do texto de Satoshi que encontras aqui é o mesmo que está gravado na blockchain. Com um nó teu:

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

Tem de sair b1674191a88ec5cdd733e4240a81803105dc412d6c6708d53ab94fc248f4f553, como para o nosso ficheiro.

As contas do registo refazem-se assim:

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

Dá 5143.

O próprio site leva-se para outro lado: uma cópia inteira, com as impressões digitais e a assinatura, para pôr a funcionar em qualquer lado.

Os dados abertos na página: o registo Usá-lo numa loja