Appunti per configurare una Bolt Card collegata ad un vostro nodo Umbrel casalingo
(guida in parte tradotta da https://boltcardwallet.com/umbrel-setup.php )
Cos’è Bolt Card?
E’ un card NFC che supporta lo standard di sicurezza NTAG 424, che permette di effettuare pagamenti lightning network NFC utilizzando un proprio nodo self custodial.
Che cosa ti serve
Questa guida è specifica per la configurazione Umbrel su raspberry, ma con piccolissimi cambiamenti può essere adattata ad altro hardware/software.
Attivare un tunnel Cloudflare
Per permettere al vostro servizio (LNDHub) di essere raggiungibile dall’esterno, è necessario attivare un tunnel tramite Cloudflare. Ci sono altre modalità, più o meno complesse, ma questa è forse la più semplice ed immediata, senza troppi passaggi da fare su terminale.
Aprire un account su Cloudflare
Effettuare il login, vi troverete sulla Dashboard
Ora cliccate sul pulsante blu Aggiungi un sito, in alto a destra
Nella pagina successiva inserire il vostro dominio, poi sceglierei il piano free
Ora il prossimo passaggio richiede l’accesso alla configurazione del vostro dominio, nella pagina che vedete ci sono due nameserver (xxxxx.cloudflare.com) da inserire negli appositi campi. Se non riuscite, trovare in giro moltissime guide che, per ogni fornitore di dominio, spiegano passo passo cosa fare
Una volta fatto il passaggio, cliccando sul pulsante Controlla nameserver, il sistema andrà a verificare che sia tutto apposto. In caso affermativo vedrete un messaggio di questo tipo
Ora passiamo alla configurazione del Tunnel. Dalla Dashboard, cliccate su Access, e poi su Avvia Zero Trust; selezionate il vostro account.
Cliccate ancora su Access, Tunnels, Create a Tunnel e date un nome che vi permetta di riconoscere questo tunnel
Nella schermata successiva cliccate su Docker. Per i prossimi passaggi è necessario accedere via SSH al vostro nodo (quindi usando un terminale ssh [email protected] oppure usando Putty)
Nel terminale dovrete installare tmux, con questo comando
sudo apt install tmux
Una volta installato, avviatelo scrivendo
tmux
Accederete così ad una schermata con la parte inferiore colorata di verde. Ora tornate nella pagina di cloudflare, e copiate il comando che inizia con docker run cloudflare/…. ed incollatelo nel terminare, dentro tmux. Premete invio, ed il programma dovrebbe installare cloudflared, e partire. Alla fine, vedrete i log di avvio, se tutto va bene non dovrebbero apparire righe con errori. Per uscire da tmux, premere CTRL + B, rilasciare i tasti e premere D immediatamente. Ora potete chiudere il terminale
In fondo alla pagina, sul sito cloudflare che avete aperto, apparirà una riga nella sezione Connectors. Se lo status è Connected, il tunnel funziona correttamente. Premete Next
Ora dovete impostare il public hostname per il tunnel. Potete utilizzare il dominio così com’è, ma forse la cosa migliore è impostare un Subdomain. Per esempio: bolt.miodominio.com . Il resto dei campi, compilatelo come da immagine qua sotto. Nel campo URL, inserite il link con cui accedete, in locale, alla pagina della app Umbrel Bolt Card Wallet Hub
Se tutto è stato fatto correttamente, dopo aver salvato il tunnel, vi apparirà la schermata con l’elenco dei tunnel, e nella riga di quello appena creato, avrete una scritta verde HEALTHY
Ora se provate ad accedere al link bolt.miodominio.com, vedrete la pagina della app Umbrel, inoltrata attraverso il tunnel appena creato
Ultimo passaggio, nella pagina che abbiamo aperto di Bolt Card Wallet App, cliccare sulla scritta settings, in basso a destra. Nella pagina che si apre, cliccate su edit, e configurate i 3 campi presenti: nel campo Host Domain, inserire bolt.miodominio.com, e gli altri 2 campi a vostra discrezione (minimo e massimo per le transazioni di pagamento tramite card)
Lavoro finito, ora passiamo alla app mobile.
Configurare app mobile e connettere la Bolt Card
Scaricate l’app da https://boltcardwallet.com/
Una volta aperta, create un wallet, cliccando su Aggiungi ora
Nella schermata successiva, cliccare sul simbolo QR e scansionare il QR code che vedete nell’app Umbrel, oppure inserite manualmente https://bolt.miodominio.com , e cliccate Crea
Viene creato il wallet, ed apparirà la classica schermata di Bluewallet per gestire i pagamenti. Potete selezionare ricevi per creare e pagarvi un’invoice, in modo da caricare qualche sat sul wallet stesso.
Fatto questo, potete collegare la card, cliccando su Connect Bolt Card.
Nella schermata successiva, semplicemente tenete appoggiata la card al sensore NFC del vostro smartphone, e la card sarà connessa. Da ultimo, cliccando su Bolt Card Details, potete impostare il limite per le transazioni, o attivare la funzione PIN (già disponibile sulla app Bolt Card POS, ma a breve anche su altri wallet.
Ora potete testare la vostra card con una delle app che supportano NFC, come Wallet of Satoshi, Blink, Breez e altri.
Questa guida è stata scritta con la maggior precisione possibile, se trovate errori o avete suggerimenti e modifiche, scrivetemi su telegram @MrBits o mail [email protected]
Se volete testare LN, nella homepage trovare un QR per prelevare 50 sats gratuitamente, e i dati per inviarmi un tip.