Il testamento dalla riga di comando

• Àncòra installato e attivo in Electrum 4.8.3 o successivo. La prima volta va attivato dalla finestra Strumenti → Plugin, come spiega la guida di installazione. Senza plugin attivo i comandi rispondono the bal plugin is not enabled in this daemon.
• Il comando electrum. Su Linux e macOS è electrum. Su Windows usa il file electrum-4.8.3-debug.exe nella cartella C:\Program Files\Electrum: è lo stesso Electrum, ma scrive le risposte nel terminale. Negli esempi scriviamo sempre electrum.
• Il demone. I comandi parlano con Electrum in esecuzione (il «demone»). Avvialo e carica il portafoglio:

electrum daemon -d

electrum load_wallet -w PERCORSO_DEL_PORTAFOGLIO

Ogni comando che riguarda il testamento vuole anche -w PERCORSO_DEL_PORTAFOGLIO: negli esempi lo omettiamo per brevità. Ogni comando spiega i suoi parametri con --help, per esempio electrum bal_heirs_add --help. Le risposte sono in formato JSON, leggibile anche da un programma.

Scarica l'elenco aggiornato dei will-executor:

electrum bal_willexecutors_download

{
    "downloaded": 2,
    "total": 2
}

Guarda l'elenco: per ognuno l'indirizzo, la commissione e se è scelto (selected):

electrum bal_willexecutors_list

{
    "https://we.bitcoin-after.life": {
        "base_fee": 1000,
        "info": "Will Executor Server",
        "selected": true,
        "url": "https://we.bitcoin-after.life",
        …
    },
    "https://we.safe21.io": {
        "base_fee": 1000,
        "info": "SAFE21.io Will-Executor",
        "selected": false,
        "url": "https://we.safe21.io",
        …
    }
}

Scegline un altro, poi controlla che i will-executor scelti rispondano:

electrum bal_willexecutors_select https://we.safe21.io --value true

{
    "https://we.safe21.io": true
}

electrum bal_willexecutors_ping

{
    "https://we.bitcoin-after.life": {
        "ok": true,
        "status": 200
    },
    "https://we.safe21.io": {
        "ok": true,
        "status": 200
    }
}

Ogni portafoglio ha la sua data di consegna e la sua commissione per i miner. Guarda quelle attuali:

electrum bal_delivery_show

{
    "baltx_fees": 20,
    "date": "2028-11-05",
    "form": "fixed",
    "will_in_force": null,
    …
}

Cambia la data (anno-mese-giorno, alle 00:00 UTC) e la commissione (in sat/vB):

electrum bal_delivery_set --date 2029-03-01 --fee 20

{
    "baltx_fees": 20,
    "date": "2029-03-01",
    "message": "Stored. Run bal_will_prepare to prepare the will with the new settings.",
    …
}

Aggiungi gli eredi: nome, indirizzo Bitcoin e quota (percentuale con %, oppure un importo fisso in satoshi):

electrum bal_heirs_add Anna tb1qdlvukeh0evy647cnlh8nuu5pu3eqjlk0eeuvae 60%

{
    "name": "Anna",
    "value": [
        "tb1qdlvukeh0evy647cnlh8nuu5pu3eqjlk0eeuvae",
        "60%",
        1867017600
    ]
}

electrum bal_heirs_add Luca tb1q0kxmulfdzc774990wmy0ww84mpmm4cd7jy7heq 40%

Controlla l'elenco:

electrum bal_heirs_list

{
    "Anna": [
        "tb1qdlvukeh0evy647cnlh8nuu5pu3eqjlk0eeuvae",
        "60%",
        1867017600
    ],
    "Luca": [
        "tb1q0kxmulfdzc774990wmy0ww84mpmm4cd7jy7heq",
        "40%",
        1867017600
    ]
}

Il numero 1867017600 è la data di consegna scritta come la legge Bitcoin (1 marzo 2029, 00:00 UTC). Per cambiare un erede usa bal_heirs_update, per toglierlo bal_heirs_delete.

1 · Preparare

Prima della preparazione il controllo dice che non c'è ancora un testamento valido:

electrum bal_will_check

The will contains no valid transaction: a new will must be prepared.

Prepara il testamento: Àncòra costruisce una copia per ogni will-executor scelto.

electrum bal_will_prepare

{
    "message": "The will was rebuilt and needs to be signed and broadcast again",
    "result": "rebuilt",
    "will": {
        "count": 2,
        … le due copie, una per will-executor …
    }
}

2 · Firmare

electrum bal_will_sign --password :

{
    "7acde393e0b2a40149a0250828c24006909ba0b97fdcbc88884871c27402ed15": "02000000000101…",
    "7c329dc2c5a877220b04bab303a9ec879f078627de10c873bf6b4a9927e0a3cc": "02000000000101…"
}

3 · Inviare ai will-executor

electrum bal_will_broadcast

{
    "https://we.bitcoin-after.life": "Success",
    "https://we.safe21.io": "Success"
}

Se nessun will-executor riceve il testamento, il comando finisce con un errore; quelli che non l'hanno ricevuto sono elencati in _failed con il motivo.

4 · Verificare che ce l'abbiano davvero

electrum bal_will_check_executor

{
    "7acde393e0b2a40149a0250828c24006909ba0b97fdcbc88884871c27402ed15": {
        "check_fail": false,
        "checked": true,
        "pushed": true,
        "url": "https://we.safe21.io"
    },
    "7c329dc2c5a877220b04bab303a9ec879f078627de10c873bf6b4a9927e0a3cc": {
        "check_fail": false,
        "checked": true,
        "pushed": true,
        "url": "https://we.bitcoin-after.life"
    }
}

pushed vuol dire inviato, checked vuol dire che il will-executor ha confermato di averlo. Fatto: il testamento è in vigore.

Ogni tanto controlla che sia tutto a posto:

electrum bal_will_check

{
    "valid": true
}

electrum bal_will_prepare

{
    "message": "The will is coherent",
    "result": "coherent",
    …
}

bal_will_prepare è il controllo completo: se hai ricevuto o speso bitcoin, rifà il testamento (rebuilt); dopo, firma e invia di nuovo. Per lo stato di ogni copia usa bal_will_status: in fondo, status_counts dice quante copie sono valide, firmate, inviate e verificate.

electrum bal_will_status

{
    "count": 2,
    … le due copie …
    "status_counts": {
        "CHECKED": 2,
        "COMPLETE": 2,
        "PUSHED": 2,
        "VALID": 2,
        … gli altri stati, tutti a 0 …
    }
}

Le operazioni delicate vengono rifiutate finché non c'è una conferma esplicita. Per esempio anticipare la data di un testamento già inviato, che farebbe arrivare i bitcoin prima agli eredi:

electrum bal_delivery_set --date 2028-06-01

2028-06-01 is earlier than the will in force (2029-03-01): the heirs could receive the bitcoin earlier. If this is what you want, run the command again with --confirm_earlier true.

La data resta quella di prima (2029-03-01). Il messaggio spiega cosa succederebbe e come confermare: è pensato anche per un assistente di intelligenza artificiale, che così sa di dover chiedere prima a te.

• --confirm_earlier true — conferma che gli eredi possono ricevere prima.
• --confirm_invalidation true — conferma un'invalidazione sulla blockchain, che costa una commissione.
• Spostare la data più avanti di un testamento già inviato richiede di invalidarlo sulla blockchain: bal_will_prepare lo dice e prepara la transazione da firmare.

Salva una copia del testamento in un file JSON, per esempio prima di cambiare computer:

electrum bal_will_export testamento.json

{
    "exported": 2,
    "path": "testamento.json"
}

Con bal_will_import_merge lo riprendi. Allo stesso modo bal_heirs_export / bal_heirs_import salvano e riprendono solo gli eredi.

I 37 comandi di Àncòra 0.8.0. Per ognuno, --help dà i dettagli.