Rovereto, četrtek, 19. november 2026 · Letnik XIII, št. 323
sl
Bitcoin Valley
KazaloZaprite

Kronika iz doline, kjer se plačuje z bitcoinom.

Za tiste, ki stvari razstavljajo

Programska oprema

To spletno mesto teče na bitmentorju, z licenco GNU AGPLv3 (druge licence, kot MIT, na zahtevo pri avtorjih): github.com/mammadori/bitmentor. Če želi vaše mesto narediti isto, je koda tam: to je naša zapuščina. Ime, barve, zgodba in strani so v eni mapi in se spreminjajo, ne da bi se dotaknili kode.

Preizkusite zdaj s svojim mestom: napišite ime, glejte, kako se spletno mesto spremeni, prenesite svojo pripravljeno mapo.

Odločitve pri zasnovi

Strežnik ne vidi obnovitvenih besed in ne more porabljati. Ključev, ki bi lahko porabljali, ni nikjer v sistemu.

Strežnik ne vidi niti prodaj. Blagajna je v telefonu ali računalniku trgovine: Lightning račun (invoice) zahteva neposredno od Lightning naslova trgovca, plačilo preveri z njegovo denarnico in zgodovino hrani tam, s kopijami, ki jih prenese on. On-chain je poskusna funkcija, izklopljena, dokler je skupnost ne vklopi (Valley jo ima vklopljeno): kdor jo želi, v blagajno vpiše svoj javni ključ, in naslovi nastanejo tam.

Trgovina z Lightning naslovom sprejema plačila, tudi če se strežnik ugasne: naslov pripada njeni denarnici, in posebej natisnjena QR koda naslova deluje naprej. Napis spletnega mesta pa ne: njegova QR koda odpre stran trgovine, ki je na strežniku.

Začasna izključitev trgovino odstrani z zemljevida, njene blagajne pa se ne dotakne. Kdor upravlja spletno mesto, nima nobene možnosti, da bi komu ustavil prilive.

Kaj je notri

Del Tehnologija
Spletno mesto in nadzorna plošča Django, Postgres, Caddy
Blagajna V brskalniku: račun zahteva od Lightning naslova trgovine (LNURL-pay) in plačilo preveri z LUD-21 verify
Prejemanje plačil brez skrbništva Katerikoli Lightning naslov, ki odgovarja na LUD-21 verify s svoje domene in brskalniku; za majhno trgovino denarnica brez skrbnika na Sparku (katere smo preizkusili)
On-chain Poskusno, privzeto izklopljeno: na telefonu ali računalniku blagajne, razširjeni javni ključ ali stalni naslov
Prijava LNURL-auth ali povezava po e-pošti
Zemljevid Leaflet, OpenStreetMap, brez ključa
Odprti podatki NIP-05, trgovine in dogodki, podpisani na Nostru, /shops.json

Na strežniku ni ne Bitcoin vozlišča ne plačilnega strežnika: nič za sinhronizacijo, nobenih kanalov, nobenih API ključev denarnic. Prodaje ostanejo na telefonu ali računalniku blagajne.

Kdor bi vdrl v strežnik, ne bi našel ne denarja ne prodaj: našel bi, zelo dobro nastavljeno, to, kar se že zdaj lahko prosto prenese, in poleg tega le kontaktne podatke, ki so nam jih trgovci sami pustili.

Namestitev

Kaj potrebujete Za preizkus Za pravo spletno mesto
Programska oprema Python 3.14 Linux z Dockerjem
Stroj Vaš računalnik En sam: 1 ali 2 CPU, 2 GB RAM-a
Omrežje Nič Ime domene, ki kaže tja, odprta vrata 80 in 443

Za preizkus (5 minut)

Na vašem računalniku, z vzorčno skupnostjo in izmišljenimi trgovinami:

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

Za pravo spletno mesto (en stroj)

Dovolj je en sam stroj, s tem, kar navaja preglednica: Caddy si certifikate pridobi sam.

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

V .env vpišite ime s SITE_HOST, pot do svoje skupnosti s COMMUNITY_DIR in svoj naslov IP v DEV_ALLOWED_IPS. Nato:

docker compose up -d
Začne se na signetu, in kdo lahko vidi spletno mesto

Začne se na signetu, testnem omrežju, kjer vse deluje enako, satoši pa nimajo vrednosti; glavno omrežje (mainnet) je naslednji korak.

Spletno mesto se zažene v načinu development: vidijo ga samo naslovi, vpisani v DEV_ALLOWED_IPS. SITE_MODE=production ga odpre za vse in deluje samo na glavnem omrežju. manage.py preflight pove, kaj še manjka, od e-pošte do glavnega omrežja. Za posodobitev: git pull && docker compose up -d --build.

Od tam naprej trgovci opravijo sami: vsak vpiše Lightning naslov svoje denarnice. Če prihajate iz drugega sistema, manage.py import_shops file.json uvozi seznam trgovin. Neobvezne funkcije, od Telegrama do Nostra, se vklopijo v .env ali community.yml; dve poskusni, on-chain na blagajni in pošiljanje na OpenStreetMap, ostaneta izklopljeni, dokler ju skupnost ne vklopi. Katere denarnice predlagati trgovinam, pove docs/wallets.md. Seznam funkcij je v README, z navodili korak za korakom in različico s slikami in CI za tiste, ki jih je veliko.

Vaša skupnost

community.yml    ime, kontakti, jeziki, pot, dogodki
theme/           pisave, barve, logotip, slike
pages/<lingua>/  strani v Markdownu, z živimi podatki
templates/       glava in noga strani, če ju želite drugačni
data/            vaše številke

Ta mapa je edina stvar, ki se med skupnostmi razlikuje. Valley v vašem mestu vam jo pripravi, v vašem brskalniku.

Odprti podatki

Blossom: datoteke po prstnem odtisu

Datoteke spletnega mesta (fotografije, dokumente, kopijo spletnega mesta) lahko zahtevate tudi po njihovem prstnem odtisu SHA-256, kot to počne strežnik Blossom samo za branje: https://blossom.bitcoinvalley.eu/<sha256>.

Kdorkoli lahko preveri, ali se bajti ujemajo s prstnim odtisom, in kopijo hrani na svojem strežniku Blossom; kdor jih želi kopirati vse, začne pri blossom.bitcoinvalley.eu/list, seznamu s prstnim odtisom, velikostjo in naslovom vsake datoteke. Nič se ne nalaga in za dovoljenje se ne sprašuje.

To je tehnični del digitalne nesmrtnosti: datoteka, ki jo je nekdo kopiral, ostane dosegljiva, z istim prstnim odtisom, tudi z drugega naslova. Traja, dokler jo nekdo hrani: spletno mesto datoteke da na voljo, kopije pa naredi, kdor želi.

Ne zaupajte, preverite

PDF Satoshijevega besedila, ki ga najdete tukaj, je enak tistemu, vklesanemu v verigo blokov. Z vašim vozliščem:

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

Izpisati se mora b1674191a88ec5cdd733e4240a81803105dc412d6c6708d53ab94fc248f4f553, kot za našo datoteko.

Izračune iz evidence preverite takole:

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

Izide se 5143.

Spletno mesto samo lahko odnesete: celotno kopijo, s prstnimi odtisi in podpisom, ki jo lahko postavite kjerkoli.

Odprti podatki na strani: evidenca Uporaba v trgovini