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.
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
/shops.json: as lojas, reutilizáveis por qualquer pessoa./theme/docs/registro.csv: o registo por ano./theme/docs/registro-mesi.csv: o registo por mês./.well-known/nostr.json: identidade NIP-05 da comunidade./sitemap.xml.
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.