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.

  1. Aprire un account su Cloudflare

  2. Effettuare il login, vi troverete sulla Dashboard

  3. Ora cliccate sul pulsante blu Aggiungi un sito, in alto a destra

  4. Nella pagina successiva inserire il vostro dominio, poi sceglierei il piano free

  5. 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

  6. 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

    Untitled

  7. Ora passiamo alla configurazione del Tunnel. Dalla Dashboard, cliccate su Access, e poi su Avvia Zero Trust; selezionate il vostro account.

  8. Cliccate ancora su Access, Tunnels, Create a Tunnel e date un nome che vi permetta di riconoscere questo tunnel

  9. 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)

  10. Nel terminale dovrete installare tmux, con questo comando sudo apt install tmux

  11. Una volta installato, avviatelo scrivendo tmux

  12. 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

  13. 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

  14. 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

    Untitled

  15. 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

  16. Ora se provate ad accedere al link bolt.miodominio.com, vedrete la pagina della app Umbrel, inoltrata attraverso il tunnel appena creato

  17. 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

Screenshot_20230905_105511_Bolt Card Wallet.jpg

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

Screenshot_20230905_110058_Bolt Card Wallet.jpg

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.

Screenshot_20230905_111104_Bolt Card Wallet.jpg

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.