Un wallet Bitcoin non deve necessariamente limitarsi alla regola “una chiave firma e i fondi si muovono”. È possibile definire condizioni più articolate: per esempio richiedere due firme su tre, consentire una firma di emergenza solo dopo un determinato numero di blocchi oppure combinare più percorsi di spesa alternativi.
Il problema è descrivere queste condizioni in modo preciso, verificabile e compatibile con gli strumenti di custodia. È qui che entra in gioco Miniscript, un linguaggio progettato per rappresentare politiche di spesa Bitcoin all’interno dei limiti dello script della rete.
Miniscript non è una nuova blockchain, non custodisce le chiavi e non modifica il funzionamento del consenso Bitcoin. È uno strumento per progettare e analizzare script, utile soprattutto quando la custodia diventa più complessa di un semplice wallet single-signature o di un multisig standard.
Che cos’è Miniscript e quale problema risolve
Bitcoin utilizza uno script per stabilire quali condizioni devono essere soddisfatte affinché un output possa essere speso. In termini semplificati, lo script può richiedere una firma valida, più firme, una preimmagine hash oppure il rispetto di un vincolo temporale.
Scrivere direttamente questi script è difficile. Una piccola modifica può cambiare completamente il significato della regola, aumentare i costi, rendere impossibile una certa spesa o creare problemi durante il recupero. Miniscript fornisce una struttura più leggibile e analizzabile per esprimere la politica desiderata.
Una politica può essere rappresentata come una combinazione di operatori logici. Per esempio:
- and: devono essere soddisfatte entrambe le condizioni;
- or: è sufficiente uno dei due percorsi;
- thresh: deve essere raggiunta una soglia di condizioni;
- older: deve trascorrere un determinato intervallo prima della spesa;
- pk o pkh: serve una firma associata a una chiave pubblica.
Il risultato non è una password più sicura né un nuovo tipo di chiave privata. È una descrizione formale delle condizioni alle quali un insieme di chiavi può spendere i bitcoin.
Miniscript, script e descriptor: tre concetti da non confondere
Questi termini sono collegati, ma svolgono funzioni diverse.
Bitcoin Script è il linguaggio eseguito dalla rete per verificare se una spesa rispetta le condizioni dell’output. È molto flessibile, ma non è stato concepito per essere facilmente leggibile dagli utenti.
Miniscript è un modo strutturato e limitato di descrivere una parte di questi script. La struttura permette di verificare proprietà come la correttezza logica, la soddisfacibilità dei percorsi e, in una certa misura, l’efficienza della spesa.
Un output descriptor è una descrizione più ampia del wallet: può includere la politica Miniscript, le chiavi pubbliche, i percorsi di derivazione e il tipo di indirizzo. In pratica, il descriptor serve a ricostruire quali indirizzi appartengono al wallet e quali condizioni sono necessarie per spenderli.
Questo punto è fondamentale per il recupero. Conservare soltanto le seed phrase può non essere sufficiente quando il wallet usa una configurazione complessa. Servono anche le informazioni che spiegano come quelle chiavi devono essere combinate.
Un esempio pratico: due percorsi di spesa
Immaginiamo una politica con due possibilità:
- spendere normalmente con due firme su tre;
- spendere con una sola chiave di emergenza dopo un periodo di attesa.
La prima strada può essere utile nell’operatività ordinaria. Le chiavi potrebbero essere distribuite tra più dispositivi o persone, riducendo il rischio che la perdita di un singolo hardware wallet renda inutilizzabili i fondi.
La seconda strada può funzionare come recupero, ma introduce un vincolo temporale. Una chiave di emergenza rubata non dovrebbe consentire una spesa immediata; l’attaccante dovrebbe attendere il periodo previsto dallo script. Il proprietario, tuttavia, deve conoscere questa regola e avere una procedura per monitorare la blockchain e intervenire se nota una transazione di recupero non autorizzata.
Questo esempio mostra anche il limite principale: una politica complessa non elimina i rischi, li distribuisce tra più componenti. Oltre alle chiavi occorre proteggere la configurazione, comprendere i timelock e assicurarsi che i software utilizzati interpretino la stessa politica.
Miniscript rispetto a un multisig tradizionale
Un multisig standard, come una configurazione due-su-tre, è relativamente semplice da spiegare: su tre chiavi disponibili, almeno due devono firmare la transazione. È spesso una scelta comprensibile per una custodia distribuita.
Miniscript può descrivere anche un multisig, ma il suo valore emerge quando sono necessari percorsi alternativi. Una politica può prevedere una regola per l’uso quotidiano, una procedura diversa in caso di perdita di una chiave e un percorso di emergenza soggetto a timelock.
La maggiore flessibilità comporta però più responsabilità:
- la configurazione deve essere documentata in modo completo;
- ogni firmatario deve sapere quale percorso sta autorizzando;
- il wallet deve riconoscere correttamente descriptor e script;
- il piano di recupero deve essere testato prima di depositare somme rilevanti;
- le transazioni devono essere controllate anche dal dispositivo di firma, quando la funzione è disponibile.
Un multisig semplice e ben compreso può essere preferibile a una politica avanzata usata senza una procedura di backup e verifica adeguata. La complessità tecnica non è automaticamente sinonimo di maggiore sicurezza.
Timelock: il componente più delicato
I timelock sono condizioni che ritardano una spesa. Possono essere collegati all’altezza della blockchain oppure al tempo trascorso da quando un output è stato creato o confermato, a seconda della modalità impiegata.
La differenza è importante. Un vincolo basato sull’altezza del blocco dipende dall’avanzamento della catena; uno basato sul tempo trascorso dipende anche dal comportamento dei miner e dall’interpretazione delle regole da parte del software. Non basta quindi scrivere “attendere una settimana”: bisogna capire quale tipo di timelock è stato scelto e come viene codificato.
Un errore nella progettazione può produrre effetti indesiderati. Il percorso di emergenza potrebbe diventare spendibile prima del previsto, richiedere un’attesa molto più lunga oppure non essere riconosciuto dal wallet usato per il recupero. Prima di utilizzare fondi reali è opportuno simulare la politica su un ambiente di prova e verificare la costruzione della transazione.
Backup: le seed phrase non sono l’intero wallet
In un wallet semplice, la seed phrase può consentire di ricostruire le chiavi derivate. In una configurazione basata su Miniscript, questo potrebbe non bastare a individuare gli indirizzi e a ricostruire esattamente le condizioni di spesa.
Il backup dovrebbe includere almeno:
- le seed phrase o le chiavi private dei partecipanti, conservate separatamente e secondo il modello di custodia scelto;
- il descriptor completo, con le chiavi pubbliche e i percorsi di derivazione;
- la politica Miniscript in una forma leggibile, non soltanto una stringa copiata senza spiegazioni;
- il tipo di indirizzo e le impostazioni necessarie al software di recupero;
- la descrizione dei timelock e delle procedure previste per ogni percorso;
- una procedura scritta per ricostruire il wallet e firmare una transazione.
Il descriptor non deve essere trattato come una seed phrase: in molti casi contiene informazioni pubbliche e può consentire di osservare i saldi e i movimenti. Non dovrebbe però includere chiavi private. La sua riservatezza è diversa da quella della seed, ma la sua integrità è essenziale: una configurazione alterata può indirizzare il recupero verso indirizzi sbagliati o rendere il wallet inutilizzabile.
Rischi ed errori da evitare
Confondere politica e autorizzazione. Miniscript descrive le condizioni, ma non decide chi debba custodire le chiavi. La sicurezza dipende anche dalla distribuzione dei dispositivi, dalle procedure e dalla protezione dei backup.
Usare strumenti non compatibili. Non tutti i wallet, coordinatori o hardware wallet supportano ogni forma di descriptor o ogni politica Miniscript. La compatibilità va verificata prima della ricezione dei fondi, non dopo.
Conservare soltanto le seed phrase. Senza descriptor, chiavi pubbliche e percorsi di derivazione, il recupero potrebbe non ricostruire gli indirizzi corretti.
Non controllare l’indirizzo sul dispositivo. Un computer compromesso può mostrare dati diversi da quelli realmente inviati al firmatario. Quando possibile, l’indirizzo di ricezione e i dettagli della transazione devono essere verificati sul dispositivo considerato affidabile.
Testare solo la ricezione. Un wallet può ricevere correttamente e tuttavia non essere in grado di spendere. Il test più importante è una piccola transazione di spesa, simulando anche i percorsi di recupero.
Rendere la politica troppo complessa. Ogni condizione aggiuntiva aumenta il numero di elementi da documentare e verificare. Una regola semplice, comprensibile da tutti i partecipanti, è spesso più robusta di una struttura sofisticata che nessuno sa ricostruire.
Una procedura prudente prima di depositare fondi
Il primo passaggio consiste nel definire la politica in linguaggio naturale: chi può spendere, quante firme servono, cosa succede se una chiave viene persa e quale procedura si applica in emergenza.
La politica va poi tradotta in Miniscript e in un descriptor usando strumenti compatibili e verificabili. È importante confrontare il risultato prodotto da più componenti indipendenti, quando possibile, e controllare che gli indirizzi generati coincidano.
Successivamente si può creare un wallet di prova, ricevere una quantità ridotta di bitcoin e testare ogni percorso: spesa ordinaria, recupero, firma con i diversi dispositivi e ripristino da backup. Il test deve includere la ricostruzione su un ambiente separato, senza esporre le seed phrase a computer connessi a Internet.
Solo dopo aver documentato l’esito e aver verificato la spesa si dovrebbe valutare l’uso della politica per somme più importanti. Anche in seguito è opportuno ripetere periodicamente il controllo dei backup e della compatibilità degli strumenti, soprattutto se cambiano software, dispositivi o persone coinvolte.
Miniscript è quindi un livello di progettazione della custodia Bitcoin: consente di esprimere regole più ricche e di analizzarle con maggiore precisione rispetto allo script scritto manualmente. Non sostituisce un hardware wallet, una procedura di backup o una corretta gestione delle chiavi. Il suo vantaggio emerge quando la politica è definita chiaramente, testata con transazioni reali di piccola entità e accompagnata da descriptor e documentazione sufficienti per il recupero.
