Bitcoin-Qt

Interfaccia Bitcoin-Qt.

Bitcoin-Qt fu il nome del client grafico Bitcoin dalla versione 0.5.0 fino alla rinomina del software in Bitcoin Core con la versione 0.9.0. Non è un portafoglio attuale separato: le versioni moderne di Bitcoin Core usano ancora bitcoin-qt come nome dell'applicazione grafica.

Storia del nome

Satoshi Nakamoto pubblicò il software Bitcoin originale nel 2009. L'interfaccia basata su Qt arrivò con la versione 0.5.0 nel novembre 2011 e sostituì la precedente interfaccia wxWidgets; in quel periodo il pacchetto era chiamato Bitcoin-Qt. La versione 0.9.0 adottò il nome Bitcoin Core per distinguere il progetto software dalla rete e dalla valuta. Il programma grafico mantiene il nome bitcoin-qt, mentre bitcoind è il demone senza interfaccia.

Le due tappe della denominazione hanno date di rilascio precise: Bitcoin-Qt 0.5.0 fu annunciato il 21 novembre 2011 e Bitcoin Core 0.9.0 il 19 marzo 2014. Quest’ultimo rilascio separò anche il client RPC in bitcoin-cli. Si trattò di modifiche al progetto software: il cambio di nome non creò una nuova valuta né richiese un nuovo saldo in bitcoin.

Funzione attuale

Bitcoin Core è software open source comprendente un nodo Bitcoin a validazione completa e un portafoglio opzionale. Il nodo verifica autonomamente blocchi e transazioni e può inoltrare i dati validi. La sincronizzazione iniziale richiede quindi spazio, banda e tempo considerevoli. Il pruning riduce i blocchi conservati, ma non trasforma Bitcoin Core in un client leggero.

Il nodo e il wallet svolgono funzioni diverse. Un nodo può verificare e inoltrare dati Bitcoin senza detenere chiavi private né spendere monete. Dalla versione 0.21, Bitcoin Core non crea più automaticamente un wallet predefinito; gli utenti possono creare o aprire wallet separatamente tramite l’interfaccia grafica.

Bitcoin Core non è un «client ufficiale» controllato dalla Bitcoin Foundation. Chiunque può proporre, esaminare o provare modifiche. I maintainer integrano le patch dopo revisione pubblica e ogni utente sceglie il software e le regole da eseguire.

Programmi e architettura

Bitcoin Core è distribuito come insieme di programmi collegati, non soltanto come portafoglio desktop. bitcoin-qt combina nodo, portafoglio e interfaccia grafica; bitcoind esegue nodo e portafoglio come demone; bitcoin-cli invia chiamate RPC a un'istanza attiva. La distribuzione comprende inoltre bitcoin-tx per manipolare transazioni, bitcoin-wallet per la manutenzione e altre utilità.

L'applicazione grafica non sostituisce il motore di validazione. Mostra stato del nodo, peer, sincronizzazione e cronologia e offre invio, ricezione, controllo delle commissioni e gestione dei portafogli. Chi non necessita di un desktop usa spesso bitcoind.

La versione 30.0 ha aggiunto un comando bitcoin che inoltra le richieste ai programmi esistenti: bitcoin gui richiama bitcoin-qt, bitcoin node richiama bitcoind e bitcoin rpc richiama bitcoin-cli con argomenti denominati. Le note di rilascio mantengono esplicitamente i comandi diretti. L’avvio dell’applicazione grafica attiva la sua funzionalità di nodo; un processo bitcoind separato non è necessario per il solo uso dell’interfaccia grafica.

Il toolkit Qt ha continuato a evolversi dopo il cambio di nome del progetto. Bitcoin Core 30.0 ha trasferito la propria interfaccia grafica da Qt 5 a Qt 6 e le note di rilascio della versione 31.0 documentano un aggiornamento a Qt 6.8. Il nome dell’eseguibile bitcoin-qt non significa quindi che il programma sia ancora il vecchio client del 2011.

Validazione, sincronizzazione e pruning

Un nuovo nodo scarica i blocchi e verifica autonomamente proof of work, struttura delle transazioni e regole di consenso applicabili. Il database chainstate registra gli output non spesi necessari per convalidare le transazioni successive. Questa verifica riduce la dipendenza da server terzi, ma richiede più tempo, banda e spazio.

Il pruning, introdotto in Bitcoin Core 0.11, consente a un nodo validatore di eliminare vecchi blocchi grezzi e dati di annullamento dopo aver costruito indice e insieme UTXO. Riduce lo spazio senza saltare la validazione. Può limitare operazioni che richiedono blocchi passati, come alcune riscansioni o interrogazioni storiche; versioni successive hanno consentito l'uso del portafoglio in modalità pruned.

Portafogli e transazioni

Il portafoglio segue chiavi o criteri di firma e gli output che può spendere. Il saldo visualizzato è la somma di uno o più output di transazione non spesi (UTXO), non un unico valore conservato in un indirizzo. Se gli UTXO scelti superano pagamento e commissione, la transazione crea normalmente un output di resto verso uno script controllato dal portafoglio. Il resto non è una seconda commissione né denaro perso a un indirizzo estraneo.

Anche i vecchi esempi di configurazione possono sopravvivere alle interfacce che descrivono. Bitcoin Core 31.0 ha rimosso l’opzione di avvio paytxfee e la chiamata RPC settxfee dopo che erano state deprecate nella versione 30.0. Le note di rilascio indicano agli utenti la stima delle commissioni o tassi di commissione specifici per transazione; un vecchio esempio Bitcoin-Qt di impostazione delle commissioni va quindi verificato rispetto alla versione in uso.

La generazione degli indirizzi e la gestione del resto rendono importanti backup e custodia delle chiavi. I portafogli moderni derivano molti script di ricezione e resto dai descrittori registrati. Copiare un database attivo come un normale file può essere rischioso; la documentazione raccomanda la funzione di backup del portafoglio, che coordina il database durante la copia.

I dati della blockchain e il wallet hanno scopi diversi. Scaricare nuovamente i blocchi non sostituisce le chiavi private perdute. La funzione documentata Backup Wallet o la chiamata RPC backupwallet produce un backup coordinato del database. La cifratura del wallet protegge le chiavi private, ma non nasconde la cronologia delle transazioni né i metadati delle chiavi pubbliche e non può recuperare una passphrase dimenticata. La documentazione sulla gestione dei wallet richiede un nuovo backup dopo la cifratura e dopo la migrazione; i backup devono essere protetti come materiale sensibile del wallet.

Portafogli legacy e migrazione

Bitcoin Core 0.15 introdusse il supporto multiwallet. I portafogli a descrittori arrivarono in forma sperimentale con 0.21, divennero predefiniti per i nuovi portafogli in 23.0 e sostituirono quelli Berkeley DB in 30.0. I descrittori specificano script e chiavi osservati e usano SQLite. Molte vecchie guide Bitcoin-Qt su backup, importazione e recupero sono quindi legate a una particolare versione.

Dalla versione 30.0 non è più possibile creare o caricare wallet legacy Berkeley DB per l’uso ordinario, anche se resta disponibile la migrazione ai wallet descriptor. La versione 26.0 ha introdotto un’opzione grafica di migrazione. La migrazione può produrre, oltre al wallet descriptor principale, wallet separati di sola osservazione o per script risolvibili. Il progetto descrive la conversione come effettuata secondo il principio del massimo impegno: configurazioni di script insolite possono richiedere ulteriore attenzione. La procedura conserva un backup del wallet legacy e richiede nuovi backup dei wallet risultanti. Il solo nome di un vecchio file wallet.dat non identifica il formato del database né la procedura di recupero necessaria.

Portafogli di sola osservazione e firma esterna

Un wallet che osserva chiavi pubbliche o script può monitorare i pagamenti pertinenti senza possedere le chiavi private necessarie per spenderli. La firma esterna separa la preparazione della transazione dalla firma: Bitcoin Core 22.0 ha aggiunto il supporto sperimentale nell’interfaccia grafica per firmatari esterni, inclusi gli hardware wallet, usando uno strumento installato separatamente come HWI. Il supporto dipende dallo strumento, dal dispositivo e dalla versione del software; non garantisce la compatibilità con tutti gli hardware wallet. Il progetto supporta anche le Partially Signed Bitcoin Transactions (PSBT), un formato che consente a più programmi di scambiarsi una transazione mentre raccolgono le informazioni e le firme necessarie per completarla.

Download e sicurezza

Il software attuale va scaricato dal progetto Bitcoin Core, non da siti o mirror che offrono «Bitcoin-Qt». La pagina ufficiale pubblica checksum SHA-256, firme e istruzioni di verifica. L'utente deve proteggere e salvare i dati del portafoglio e difendere il computer dai malware. Le vecchie guide Bitcoin-Qt possono contenere procedure obsolete.

Un avviso del progetto del gennaio 2026 ha identificato uno specifico errore di migrazione in Bitcoin Core 30.0 e 30.1: in rare condizioni di errore che coinvolgevano un wallet.dat legacy predefinito e senza nome, la migrazione tramite interfaccia grafica o RPC poteva eliminare file nella directory del wallet e causare la perdita di fondi. Secondo l’avviso, gli utenti che non tentavano la migrazione non erano interessati. I file binari interessati sono stati ritirati e le note di rilascio della versione 30.2 riportano la correzione. Le vecchie istruzioni per migrare con 30.0 o 30.1 sono quindi insicure; l’avvertimento riguarda queste procedure di migrazione, non ogni uso di Bitcoin Core né ogni migrazione successiva.