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.
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
/shops.json: trgovine, ki jih lahko uporabi kdorkoli./theme/docs/registro.csv: evidenca po letih./theme/docs/registro-mesi.csv: evidenca po mesecih./.well-known/nostr.json: identiteta NIP-05 skupnosti./sitemap.xml.
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.