PLEBLINEsoftware libero per la custodia di bitcoin
Paper

PlebLine — l'idea e il programma

ottobre 2026 · di Ale-TheOrangeWay

PlebLine serve a chi custodisce da sé i propri bitcoin. Si inserisce fra due famiglie di strumenti, dove oggi manca uno strumento pensato per la custodia cold:

  • gli strumenti di custodia «complessi»: multisig, multivendor e simili;
  • gli strumenti di custodia «consumer»: con vulnerabilità concrete, che possono costare carissimo.

Il problema

Un cold storage che dipende da un multisig è molto più difficile da tramandare, e difficile da mantenere. Essendo multivendor, si dipende da almeno tre fornitori diversi (per esempio in un multisig 3 di 5):

  • tre hardware di marche diverse, ognuno soggetto alle proprie vulnerabilità, come si è visto negli ultimi mesi;
  • tre software house diverse, che possono esporti a vulnerabilità software: aggiornamenti del firmware, del computer e così via.

L'utente medio non ha competenze informatiche approfondite: per questo PlebLine è un flusso di azioni guidate.

La maggior parte degli utenti accumula bitcoin e li usa di rado. Per loro non c'è motivo di avere il cold storage sempre a portata di mano: sarebbe come portarsi dietro la cassaforte per uscire a fare l'aperitivo o comunque conservarla a casa propria. E più si usano hardware e software, più si è a rischio, per quanto buoni siano.

Chi invece spende spesso ha bisogno di rendere fluido il passaggio dal cold wallet all'hot wallet, perché di solito spende su Lightning.

Premessa: dove stanno le parole

PlebLine è pensato per un set up in cui le parole del seed, 12 o 24, restano per il 99% del tempo lontane da internet e al sicuro. Per esempio incise su un Cryptosteel o un supporto simile, chiuse in un tubetto d'acciaio che resiste a fuoco e acqua, e murate a casa della nonna, di parenti o di amici, o tenute in una cassetta di sicurezza in banca: dove preferisci.

L'importante è che non stiano a casa tua, e che non stiano in un dispositivo elettronico.

Come funziona PlebLine

Il programma non custodisce le chiavi e non sostituisce il tuo portafoglio. Fa i passi che faresti a mano, nello stesso ordine e ogni volta allo stesso modo, così il risultato non dipende da quanta attenzione hai quella sera. Sono pochi passi semplici, che organizzano il flusso fra cold e hot wallet per buona parte dell'anno successivo, senza riaprire il cold wallet quando non serve.

Su Tails

Si usa in una seduta, su Tails: un sistema che si avvia da una chiavetta, gira in memoria e allo spegnimento non ricorda niente. La rete esce solo attraverso Tor.

  1. Le parole. Le batti tu, ogni volta. Restano solo in memoria e non toccano mai il disco.
  2. Le monete. Il programma le legge dalla catena, attraverso Tor, e ti porta alla dashboard del tuo portafoglio: quanto hai, e in quali monete.
  3. Cosa fare. Da PlebLine scegli l'operazione. Ogni passo che non si può annullare chiede conferma, e la risposta già pronta è no.
  4. La firma, a rete staccata. Prima di firmare stacchi la rete. Il programma firma, e ricontrolla il risultato dai suoi byte prima di salvarlo.
  5. La chiusura. Le parole escono dalla memoria prima che la rete torni. I file firmati si cancellano solo se dici sì.

Quando poi mandi in rete una transazione firmata, il programma ti accompagna anche lì.

Le ricariche

Dalla dashboard, quando vuoi spendere, arrivi alle ricariche.

Una ricarica, in PlebLine, è una transazione prefirmata verso un hot wallet: il tuo, quello di tua madre, di un amico, di un parente. È letteralmente come una ricarica telefonica.

Fa parte dei passi previsti da PlebLine, ma è facoltativa e si può saltare. In quel passo il programma ti fa prefirmare il numero di transazioni che scegli, e ti mostra i QR code corrispondenti, uno per ogni PSBT o hex.

Quante farne lo decidi tu. Chi spende spesso deve rimpinguare il proprio hot wallet più di frequente: prefirmerà più transazioni e le trasmetterà poco alla volta durante l'anno. Chi spende poco ne prefirmerà poche, o nessuna.

Il concetto di ricarica ha due conseguenze positive e una negativa:

  • Positiva: un QR perso non è un pericolo. Chi lo trova può al massimo trasmettere la transazione o cancellare il file: in nessuno dei due casi un bitcoin è a rischio.
  • Positiva: si può ricaricare chiunque. Non solo il tuo portafoglio: la nonna, un amico, i parenti.
  • Negativa: il tracciamento. Qualcuno potrebbe pensare, sbagliando, che ogni pagamento sia una ricarica, e collegare così mittente e destinatario: con il tracciamento dei bitcoin, può essere un male. Ma una ricarica può andare a chiunque, quindi non dice per forza chi c'è dall'altra parte.

Com'è fatta una cerimonia

Il cold storage si apre una volta; le ricariche partono nei mesi dopoUna seduta, su TailsNei mesi dopoLe paroleLe batti tu; restano solo in memoria, mai su discoLe moneteLette dalla catena attraverso TorGli indirizziArrivano dal telefono, e li controlli coi QRStacchi la reteDa qui in poi niente esce dal computerFirma e ricontrolloUna moneta per ricarica, verificate dai loro byteLe ricariche esconoUn QR per ricarica sul telefono, o una chiavetta;poi le parole escono dalla memoriaMandi una ricaricaquando serve, in qualsiasiordine, da qualunque computerTutte arrivate?Il programma lo dice e chiedese cancellare: il no è già prontoIl gruppo dopoUna nuova seduta, da capo
la cerimonia · una seduta, poi i mesi dopo

Le chiavi servono solo nella seduta, e si firma con la rete staccata. Tutto il resto, nei mesi dopo, si fa senza aprire il cold storage.

I principi

Ogni scelta del programma discende da poche idee. Sono scritte qui perché chi lo usa, o lo controlla, possa giudicarle.

  • Le chiavi restano tue. Il programma non custodisce niente e non genera le parole: chi non le ha ancora se le fa con un dado o con le carte, e il programma spiega come. Le parole non finiscono mai su disco e si chiedono ogni volta.
  • Non fidarti, controlla. Ogni ricarica firmata si ricontrolla dai suoi byte, senza chiavi e senza rete, su qualsiasi computer. Il pacchetto stesso si può ricostruire e confrontare byte per byte.
  • Una moneta, una ricarica. È l'errore più facile da fare a mano, quindi non è lasciato all'attenzione: lo impone il programma, con più barriere una dietro l'altra, anche fra cerimonie diverse.
  • Una macchina che dimentica. La cerimonia gira su Tails: si avvia da una chiavetta, non scrive sul computer e alla fine non ricorda niente. La rete esce solo attraverso Tor, e si firma con la rete staccata.
  • Il programma informa, la persona decide. Ogni passo che non si può annullare chiede conferma, e la risposta già pronta è no. I file firmati non si cancellano mai da soli: anche quando il server dice che tutto è arrivato, si chiede.
  • Fatto per i pleb. Il destinatario è chi custodisce da sé ma non scrive codice. Per lui c'è una strada sola, nel terminale o in una finestra, nella sua lingua, e ogni messaggio dice cosa fare dopo.
  • Aperto. Il codice è libero (licenza MIT) e scritto per essere letto da altri: le regole che non si devono rompere, e il perché delle scelte, sono documentati.

Cosa protegge e cosa no

Un programma di custodia vale quanto i suoi limiti dichiarati. Questi sono i suoi.

Da cosa ti difende

  • La stessa moneta in due ricariche della stessa seduta. È impedita in più punti, e gli impegni si leggono dai file firmati stessi: nessun registro a parte che possa andare fuori sincrono.
  • Una ricarica diversa da quella che vedi. La firma copre tutta la transazione, gli importi sono legati alle transazioni vere da cui vengono le monete, e la verifica rifà i conti dai byte.
  • Le parole che restano in giro. Non toccano mai il disco, si firma a rete staccata, e la macchina dimentica tutto allo spegnimento.
  • Il traffico in chiaro. La rete esce solo da Tor o verso un nodo tuo; un server pubblico raggiunto in chiaro è rifiutato prima che parta il primo pacchetto.
  • File rovinati o manomessi. Ogni file che la cerimonia rilegge è controllato, e un numero impossibile ferma tutto invece di passare per buono.
  • Un pacchetto falso. L'installatore controlla l'impronta di ogni file e la firma di chi l'ha fatto, e ti chiede di confrontarne l'impronta con una avuta per un'altra strada.

Da cosa non ti difende

  • Un server che mente. Monete e conferme arrivano da un server solo alla volta. Può nascondere monete o dire il falso sullo stato delle ricariche; le decisioni che non si annullano, però, restano a te.
  • Ricariche al portatore. Chi prende il telefono o la chiavetta con le ricariche può mandarle tutte insieme, verso i destinatari scelti alla firma.
  • Le ricariche delle sedute precedenti. Ogni apertura riparte da zero e non le guarda. Se una vecchia non è ancora partita e ne firmi una nuova sulla stessa moneta, vale quella mandata per prima e l'altra viene rifiutata per sempre. Il programma lo ricorda prima di firmare.
  • Il telefono come fonte degli indirizzi. Se il telefono è compromesso, può dare indirizzi sbagliati, e il confronto fatto sullo stesso telefono passa.
  • La fee congelata. Si decide alla firma; se dopo mesi non basta, alzarla vuol dire riaprire il cold storage.
  • Le parole battute su un computer. È il prezzo di non usare un dispositivo di firma separato; la difesa è la macchina che dimentica.

Sotto il cofano

Per chi vuole controllarlo: com'è costruito, e dove guardare nel codice. È scritto in Rust.

  • Quattro crate, tre programmi. plebline-core contiene i formati dei file, la scelta delle monete, la pianificazione, la firma, la verifica e la divisione: niente interfaccia, niente rete (lo controlla la CI) e#![forbid(unsafe_code)]. plebline ha i passi della cerimonia e il programma per esperti, plebline-guided il percorso guidato nel terminale,plebline-gui lo stesso percorso in una finestra, che chiama lo stesso codice. La rete, mainnet o signet, si sceglie alla compilazione, non con un'opzione.
  • Cosa si firma. Un portafoglio a firma singola BIP84 (P2WPKH), costruito con BDK e rust-bitcoin. Ogni firma è SIGHASH_ALL, nLockTime è sempre 0, e le transazioni segnalano RBF. L'importo di ogni moneta è legato alla transazione da cui viene, il cui txid si ricalcola: un server non può dichiarare un importo falso.
  • Una moneta per ricarica, in codice. DisjointCoinSelection è l'algoritmo di scelta delle monete passato a BDK, e non vede mai una moneta già impegnata. Le stesse monete vanno a unspendable; dopo la costruzione si registrano gli input veri; check_disjoint controlla l'intero gruppo. Gli impegni si leggono dai file firmati, filtrati per portafoglio (descriptor_checksum): nessun registro separato. Il percorso guidato riparte da zero a ogni apertura: sposta i file delle sedute precedenti in precedenti/ e non li legge più.
  • La verifica. verify rifà i conti dai byte delle transazioni, senza chiavi e senza rete: firme, fee, dimensione, input attesi, e che ogni uscita vada a un destinatario previsto o torni al portafoglio. Gira prima di salvare ogni gruppo firmato e, nel percorso guidato, prima di ogni invio. Limite noto: il destinatario si confronta con l'indirizzo scritto nel file, non con lo script nei byte.
  • La rete. Un client SOCKS5 dentro il programma, verso Tor con i nomi risolti dentro Tor (socks5h), oppure verso un nodo dell'utente. Un server pubblico raggiunto in chiaro è rifiutato prima del primo pacchetto, e una prova pretende che ogni chiamata di rete passi da quel controllo. Il codice di rete sta in un file solo,chain.rs.
  • Il pacchetto. Strumenti fissati (Rust 1.94.1, zig, cargo-zigbuild),--locked, e i percorsi della macchina riscritti: lo stesso commit, costruito sulla stessa macchina, dà gli stessi byte. L'installatore di Tails controlla l'impronta di ogni file e la firma GPG del pacchetto, e chiede di confrontare l'impronta della chiave con una avuta per un'altra strada.
  • Le prove. 430 prove automatiche, fra cui la cerimonia guidata intera con risposte simulate, i file ostili, una catena finta e i QR riletti da un decodificatore.

Nel repository, per chi revisiona: SECURITY.md (cosa protegge e cosa no),docs/ARCHITECTURE.md, docs/DECISIONS.md (le scelte e il loro perché) e docs/REVIEWING.md (da dove cominciare, e i difetti aperti).

Per chi è, e a che punto è

PlebLine è per chi tiene un cold storage a firma singola, da 12 a 24 parole BIP39 con o senza passphrase, e vuole aprirlo il meno possibile. Non gestisce multisig, dispositivi di firma, Lightning o descrittori complessi.

Oggi è alla versione 0.1, con 430 prove automatiche. La cerimonia intera è stata fatta su signet, anche su un Tails vero. Una revisione interna di sicurezza ha corretto i difetti più seri e ha elencato quelli aperti; una revisione di terzi non c'è ancora.