Vai al contenuto
buybitcoinsmart

Glossario / Riferimento per sviluppatori

Etichetta

Che cos'è l'etichetta?
L'etichetta in un URI Bitcoin indica la persona o l'azienda che riceve il pagamento e, in un wallet, è la nota privata che alleghi a un indirizzo o a una transazione.

Specificato nel BIP-21.

Le etichette sono l'unica parte di un pagamento in bitcoin che esiste puramente per le persone. Nulla di ciò che digiti in un'etichetta raggiunge la blockchain, e nulla della tua frase di recupero la riporta indietro: Bitcoin Core ha sostituito il suo vecchio sistema di conti con le etichette nella versione 0.17.0 a ottobre 2018, e queste vivono solo nel file del wallet. Perderle ti costa la tua stessa cronologia delle transazioni al momento della dichiarazione dei redditi.

Come funziona

La parola etichetta copre due cose diverse, e distinguerle evita molta confusione.

La prima è il parametro label definito da BIP21. Viaggia dentro un URI di pagamento come UTF-8 codificato in percentuale, così label=Coffee%20Shop appare come Coffee Shop nella schermata di conferma. È un testo indicativo fornito da chi ha costruito l'URI. Nessuna firma lo copre, nessun wallet lo verifica, e un attaccante che costruisce un link di phishing lo sceglie con la stessa libertà di un esercente onesto.

La seconda è la nota che scrivi tu stesso. Bitcoin Core la espone tramite setlabel, getaddressesbylabel e listlabels, l'API arrivata in 0.17.0 quando i conti sono stati deprecati e che ha finito di sostituirli quando le chiamate ai conti sono state rimosse in 0.18.0. Sparrow, Electrum e la maggior parte dei wallet mobili mantengono un campo equivalente.

Le etichette lato wallet sono metadati che stanno accanto alle tue chiavi, non dentro di esse. Ripristina una frase di recupero in un software nuovo e ogni bitcoin torna senza alcun ricordo della sua provenienza. BIP329 esiste per risolvere la metà di questo problema che riguarda la portabilità: definisce un'esportazione JSON Lines con un record per riga, ognuno con un tipo tra tx, addr, pubkey, input, output o xpub, un riferimento e il testo dell'etichetta. Diversi wallet desktop e mobili possono leggere e scrivere il formato, così le etichette possono spostarsi quando cambi software.

Dove la vedi

Le etichette si rivelano essenziali in tre situazioni che non hanno nulla a che fare con il fatto che i pagamenti appaiano ordinati.

Il coin control è la prima. Decidere quali output non spesi spendere, e quali tenere separati, funziona solo se riesci a distinguerli, e l'etichetta è ciò che registra che questo bitcoin è arrivato da un prelievo da un exchange verificato mentre quello è arrivato da uno scambio peer-to-peer. Uniscili in una sola transazione e avrai collegato le due storie in modo permanente. Nessuno pratica la merge avoidance a memoria.

I registri fiscali sono la seconda. Il tuo costo di acquisto per un dato bitcoin vive nelle tue note, perché un trasferimento in autocustodia non porta con sé un prezzo. Un wallet con depositi etichettati e l'importo in valuta fiat annotato è un foglio di calcolo che hai già; un wallet pieno di UTXO non etichettati è un pomeriggio di ricostruzione all'anno.

Il phishing è la terza, e va nella direzione opposta. L'etichetta di un URI è testo sotto il controllo dell'attaccante. Vedere il nome di un'azienda nota su una schermata di pagamento significa che qualcuno ha digitato quel nome in una stringa, nulla di più.

Abitudine pratica: etichetta al momento della transazione, quando sai ancora di cosa si trattava, ed esporta le etichette insieme al descriptor del wallet ogni volta che fai un backup. Una frase di recupero più un descriptor più un file di etichette è un ripristino completo. Una frase di recupero da sola recupera il denaro e perde la storia.

Etichetta vs memo PP

Un memo nel protocollo di pagamento BIP70 era testo dell'esercente che viaggiava dentro un messaggio firmato, così un wallet poteva almeno collegarlo a un titolare di certificato. Un'etichetta BIP21 viaggia in chiaro senza nulla che la garantisca. Questa differenza era l'intera motivazione del protocollo di pagamento, e non lo ha salvato: BIP70 è stato rimosso da Bitcoin Core nella versione 0.20.0 a giugno 2020, lasciando le etichette non firmate come il formato che tutti usano davvero.

Da non confondere con

Domande frequenti

La mia frase di recupero fa il backup delle mie etichette?

No. Una frase di recupero ripristina solo chiavi e bitcoin. Le etichette vivono nel file del wallet o nel database dell'app, quindi scompaiono in un ripristino da zero a meno che tu non le abbia esportate separatamente, cosa per cui è pensato il formato di etichette BIP329.

Posso fidarmi del nome mostrato su una schermata di pagamento?

Non da solo. L'etichetta in un URI BIP21 è testo semplice scelto da chi ha creato il link, senza alcuna firma dietro, quindi una pagina di phishing può mostrare qualsiasi nome di azienda voglia. Verifica invece l'indirizzo di destinazione.

Leggi anche

Termini correlati

Altro in Riferimento per sviluppatori

Leggi questa pagina in inglese