Come configurare un nodo Bitcoin completo con Dojo in Linux

Bitcoin è uno strumento innovativo e liberatorio. Permette a un individuo di ottenere una risorsa indipendente che può utilizzare per scambiare facilmente con altre persone online, poiché, a differenza della moneta elettronica, Bitcoin genera scarsità limitando l’importo totale di monete che possono circolare nella sua rete.
Un modo per iniziare a utilizzare Bitcoin per le transazioni è usare un nodo completo con un portafoglio mobile. Uno dei migliori strumenti che puoi utilizzare è Dojo con Samourai Wallet.
Indice
- Come funziona Bitcoin?
- Perché usare un nodo Bitcoin completo?
- Cos’è Dojo?
- Preparazione per l’installazione di Dojo in Ubuntu Linux
- Installazione del nodo Bitcoin Dojo in Ubuntu
- Abbinamento del portafoglio Samourai con Dojo
- Domande frequenti
Leggi anche: Cos’è la Lightning Network di Bitcoin?
Come funziona Bitcoin?
Alla base, Bitcoin è un database distribuito che tiene traccia dei registri in modo immutabile. Crea un sistema che fa tre cose:
- Ogni nuova voce nel database dipende da quella precedente, creando una catena storica di eventi che collega tutte le voci tra loro.
- Aggiungere una nuova voce richiede di fare una certa quantità di lavoro per assicurarsi che chiunque tenti di falsificare una voce debba ripetere quel lavoro, così come qualsiasi lavoro svolto dopo di essa.
- Ogni nodo completo nella rete riceve una copia del database e segue un insieme di regole semplici che, a loro volta, consentono a ogni partecipante di concordare sulla versione corretta della storia.
Queste caratteristiche di Bitcoin garantiscono che ogni nuova voce nel sistema sia sicura quanto quella precedente. La sua natura decentralizzata consente anche di funzionare senza alcuna autorità centrale.
Ciò rende Bitcoin incredibilmente utile per gli individui che desiderano transare in privato senza alcun intermediario.
Leggi anche: Come guadagnare criptovaluta navigando sul web
Perché usare un nodo Bitcoin completo?
Un nodo completo Bitcoin è un software che ti consente di diventare un partecipante indipendente nella rete Bitcoin. Ti fornisce una copia esatta della cronologia delle transazioni della rete e ti consente di fare una serie di cose che non sono possibili da un normale portafoglio Bitcoin.
Ad esempio, avere l’intera cronologia delle transazioni consente a un nodo completo di verificare qualsiasi transazione in entrata da solo. Questo può essere particolarmente utile per gli utenti che accettano Bitcoin per la loro attività.
Eseguire un nodo completo ti consente anche di diventare un archivio per la rete Bitcoin. Altri utenti che desiderano avere il proprio nodo completo possono quindi utilizzare il tuo come punto di partenza.
Infine, utilizzare un nodo completo elimina anche la necessità di server esterni ogni volta che controlli e trasmetti nuove transazioni. Questo può essere utile per gli utenti che desiderano avere sicurezza e privacy mentre utilizzano Bitcoin.
Uno dei modi più semplici per utilizzare un nodo completo è installare Dojo.
Cos’è Dojo?
Dojo è una potente suite di software che ti consente di creare e distribuire facilmente un nodo Bitcoin sicuro. Mira anche a mantenere un alto grado di sicurezza attraverso l’uso di diversi componenti aggiuntivi per la privacy e Tor.

È importante notare che l’installazione effettiva di Dojo può essere sia un processo intensivo di risorse che richiedente tempo, anche se i passaggi di installazione sono facili.
Questo è principalmente perché ottenere la cronologia delle transazioni di Bitcoin richiede che il tuo computer verifichi ogni voce che riceve. Ad esempio, la mia macchina Core 2 Duo del 2011 ha impiegato cinque giorni per sincronizzarsi completamente con la rete.
Inoltre, è anche una buona pratica assicurarsi che il tuo computer possa memorizzare tutti i dati. Per la maggior parte, un’unità da 1TB dovrebbe essere sufficiente per memorizzare l’intera cronologia e lasciare spazio per nuove.
Questo tutorial si concentra sull’installazione di Dojo su una macchina Ubuntu 22.04. Anche se la maggior parte dei comandi dovrebbe funzionare per qualsiasi distribuzione Linux, i nomi dei pacchetti e dei programmi possono variare.
Leggi anche: Cos’è Web3 e come cambierà la tua vita digitale
Preparazione per l’installazione di Dojo in Ubuntu Linux
Per iniziare, crea prima un nuovo account utente nel sistema:
sudo useradd -s/bin/bash -d/home/dojo -m -Gsudo dojo
sudo passwd dojo
Questo separa qualsiasi configurazione e programma che Dojo eseguirà dal tuo account utente. Un account separato ridurrà anche la possibilità che errori dell’utente influenzino Dojo.
Una volta fatto, puoi passare all’utente Dojo eseguendo: su dojo, poi inizia a installare alcune dipendenze specifiche per la distribuzione:
sudo apt update
sudo apt install gnupg-agent ca-certificates curl software-properties-common unzip tor torbrowser-launcher
Successivamente, includi il repository per Docker e Docker Compose.
Scarica e importa la chiave di firma principale per le versioni di Docker:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -Aggiungi il repository Docker:
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
Installa Docker:
sudo apt install docker-ce docker-ce-cli
sudo usermod -aG docker dojoInfine, installa docker-compose:
sudo curl -L "https://github.com/docker/compose/releases/download/1.25.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
Inizia a scaricare Dojo sulla tua macchina:
wget https://code.samourai.io/dojo/samourai-dojo/-/archive/master/samourai-dojo-master.zip
Estrai tutti i file di Dojo sulla tua macchina:
mkdir/home/$USER/dojo
unzip/home/$USER/samourai-dojo-master.zip -d/home/$USER/dojo
Configurazione delle chiavi segrete di Dojo
Apri il file “docker-bitcoind.conf.tpl” nella cartella dojo:
nano/home/$USER/dojo/docker/my-dojo/conf/docker-bitcoind.conf.tplLe variabili che devono essere modificate sono BITCOIN_RPC_USER= e BITCOIN_RPC_PASSWORD=. Dojo utilizza questi per connettersi ad altri portafogli remoti:
BITCOIN_RPC_USER=dojo
BITCOIN_RPC_PASSWORD=random_password
Modifica del database Dojo
Il prossimo file da modificare è “docker-mysql.conf.tpl.” Contiene tutte le informazioni che non sono direttamente collegate al tuo nodo completo:
nano/home/$USER/dojo/docker/my-dojo/conf/docker-mysql.conf.tplModifica tre variabili in questo file di configurazione: MYSQL_ROOT_PASSWORD=, MYSQL_USER= e MYSQL_PASSWORD=:
MYSQL_ROOT_PASSWORD=your_mysql_root_password
MYSQL_USER=dojo
MYSQL_PASSWORD=mysql_user_password
Modifica della configurazione NodeJS
Il prossimo file da modificare è “docker-node.conf.tpl.” Controlla l’istanza frontend di Dojo e funge da collante che combina il nodo completo, MySQL e tutte le funzionalità aggiuntive che utilizza Dojo:
nano/home/$USER/dojo/docker/my-dojo/conf/docker-node.conf.tplAll’interno di questo file, modifica le seguenti variabili: NODE_API_KEY=, NODE_ADMIN_KEY= e NODE_JWT_SECRET=.
- NODE_API_KEY funge da chiave segreta principale per l’API REST di Dojo. Questo valore consentirà ad altri servizi di comunicare facilmente con Dojo quando necessario.
- NODE_ADMIN_KEY è la password principale per la tua istanza Dojo. Dovrai digitare questo ogni volta che desideri accedere al pannello di configurazione di Dojo.
- NODE_JWT_SECRET funge da sale principale per il sistema Web Token di Dojo ed è il valore che garantisce una crittografia forte per ogni sessione di Dojo.
NODE_API_KEY=random_node_api_key
NODE_ADMIN_KEY=random_node_admin_key
NODE_JWT_SECRET=random_node_jwt_secret
Configurazione dell’esploratore di blocchi di Bitcoin
Infine, devi modificare il file “docker-explorer.conf.tpl.” Controlla l’esploratore di blocchi interno di Dojo:
nano/home/$USER/dojo/docker/my-dojo/conf/docker-explorer.conf.tplModifica due variabili in questo file di configurazione: EXPLORER_INSTALL= e EXPLORER_KEY=. Il primo dice a Dojo che desideri installare l’esploratore di blocchi, mentre il secondo funge da password per l’applicazione.
EXPLORER_INSTALL=on
EXPLORER_KEY=random_key
Leggi anche: Cos’è DeFi e come funziona
Installazione del nodo Bitcoin Dojo in Ubuntu
Successivamente, avvia lo script di installazione di Dojo eseguendo il seguente comando:
/home/$USER/dojo/docker/my-dojo/dojo.sh installLo script di installazione scaricherà tutti gli strumenti necessari per costruire il contenitore Docker di Dojo, quindi avvierà un processo di compilazione in cui costruirà gli strumenti e i programmi di cui ha bisogno.

Lo script avvierà l’eseguibile Dojo e si sincronizzerà immediatamente con la rete Bitcoin, indicando ciò con una differenza nel layout e nel colore del terminale. Premi Ctrl + C per spostare il processo in background.

Controllo sul progresso della sincronizzazione di Dojo
Come discusso sopra, la sincronizzazione con la rete Bitcoin può richiedere da alcune ore a pochi giorni. È importante tenere traccia dei progressi del nodo e cercare eventuali problemi durante la sincronizzazione.
Ci sono due modi per controllare i progressi di Dojo. In primo luogo, utilizza il file “dojo.sh” per generare un log in esecuzione del server. È particolarmente utile se desideri un modo rapido per visualizzare i progressi del server. Ad esempio, eseguire questo comando mostrerà tutti i log relativi al nodo completo Bitcoin:
/home/$USER/dojo/docker/my-dojo/dojo.sh logs bitcoind
È anche possibile controllare i progressi di Dojo attraverso il suo portale web dedicato. Tuttavia, è necessario assicurarsi che il computer abbia una copia del browser Tor per eseguire il seguente comando per stampare tutti gli indirizzi onion che Dojo utilizza:
/home/$USER/dojo/docker/my-dojo/dojo.sh onionSuccessivamente, devi copiare e caricare l’indirizzo per il “Dojo API and Maintenance Tool” tramite il browser Tor per caricare un piccolo prompt in cui puoi digitare la chiave admin che hai aggiunto in precedenza.

Dojo mostrerà un breve riepilogo del tuo nodo e dei vari stati dei suoi servizi, utile se desideri un’analisi più completa della tua istanza Dojo.

Leggi anche: Cosa devi sapere sui portafogli hardware per criptovaluta
Abbinamento del portafoglio Samourai con Dojo
Una volta che il tuo nodo Dojo è correttamente sincronizzato con la rete Bitcoin, puoi abbinarlo al tuo portafoglio mobile. Per impostazione predefinita, il nodo completo Dojo funziona bene con Samourai Wallet per Android.

- Scarica il portafoglio Samourai dal Play Store.
- Esegui Samourai Wallet e abilita “Connettiti al tuo server Dojo,” quindi fai clic su “Scansiona QR.”

- Sullo strumento di manutenzione Dojo, fai clic sull’opzione “Abbinamento” nel menu del sito a sinistra per generare un codice QR da scansionare.

- Torna al tuo portafoglio Samourai e scansiona il codice QR sul sito.
Congratulazioni! Hai configurato il tuo nodo Bitcoin completo tramite Dojo.
Domande frequenti
Posso utilizzare la stessa password per le chiavi segrete di Dojo?
Sì, ma non lo incoraggiamo. Il nodo completo Dojo si basa sulle chiavi che fornisci per alcune delle sue funzioni sensibili. Se un attaccante riesce a ottenere il controllo della tua singola chiave, è possibile che riesca a curiosare e modificare le tue transazioni.
Dojo è bloccato al 5% mentre si connette a Tor. Il mio nodo Bitcoin è rotto?
Questo sta probabilmente accadendo perché Docker non riesce a stabilire una connessione esterna adeguata. Ciò potrebbe accadere perché la tua macchina ha sia le versioni apt che snap di Docker.
Per risolvere questo problema, rimuovi ogni istanza di Docker e reinstallala con solo una versione.
Ho un errore “task: bitcoind bloccato per più di 120 secondi.” Cosa c’è di sbagliato nel mio Dojo?
Probabilmente, la tua macchina sta esaurendo le risorse durante la sincronizzazione, quindi il programma va in uno stato di “auto-blocco” in cui attende risorse sufficienti. In alcuni casi, ciò porta a un completo blocco del sistema.
È importante assicurarsi che il computer abbia risorse sufficienti per sincronizzarsi e gestire un nodo Bitcoin. La tua macchina dovrebbe avere almeno 1TB di spazio e 8GB di RAM per sincronizzarsi comodamente con la rete Bitcoin.