Codificatore e decodificatore Bech32 / Bech32m
Dettagli tecnici
Come funziona lo strumento Bech32 / Bech32m
Cosa fa lo strumento Bech32
Bech32 e Bech32m sono codifiche con checksum che trasformano dati binari in una breve stringa di lettere minuscole e cifre. Sono usate negli indirizzi Bitcoin SegWit e Taproot, nelle chiavi Nostr (npub, nsec, note), negli account Cosmos, negli indirizzi Cardano e nelle fatture Lightning. Ogni stringa ha tre parti: la parte leggibile (HRP), come bc o npub, il separatore 1 e la parte dati, i cui ultimi sei caratteri sono il checksum. Lo strumento decodifica qualsiasi stringa Bech32 o Bech32m, rileva quale delle due varianti corrisponde al checksum e mostra HRP, dati in hex, Base64 e parole grezze a 5 bit, oltre a un’indicazione della rete per i prefissi noti. Puoi anche codificare un HRP e dati a tua scelta, e convalidare gli indirizzi SegWit in base a versione witness e lunghezza del programma. Tutto viene eseguito localmente nel browser.
Casi d’uso comuni
Gli sviluppatori decodificano indirizzi bc1 e tb1 per ispezionare la versione witness e il programma da 20 o 32 byte, verificano se un indirizzo è Taproot (versione 1, Bech32m) o SegWit nativo (versione 0, Bech32) e creano fixture di test per wallet e nodi. Gli sviluppatori Nostr convertono un npub nella chiave pubblica hex usata negli eventi, e viceversa. Chi integra Cosmos e Cardano controlla quale HRP porta un indirizzo e recupera i byte grezzi. Quando una stringa non supera la convalida, lo strumento ne indica il motivo e, per un singolo carattere sbagliato, la posizione probabile dell’errore, utile quando si copia un indirizzo a mano.
Varianti, input e limiti
Bech32 (BIP-173) usa la costante di checksum 1 ed è richiesto per SegWit versione 0 e per Nostr. Bech32m (BIP-350) usa la costante 0x2bc830a3, corregge una debolezza del checksum originale ed è richiesto per SegWit versione 1 e successive, incluso Taproot. Le stringhe sono limitate a 90 caratteri, a meno che tu non attivi l’opzione per stringhe lunghe usata dai dati in stile Lightning. L’input deve essere tutto minuscolo o tutto maiuscolo. In modalità codifica i dati possono essere forniti come hex, testo UTF-8 o Base64, e la modalità SegWit accetta versione witness e programma in hex. Tra gli HRP noti ci sono bc, tb e bcrt per Bitcoin, ltc, cosmos, osmo, npub, nsec, note, addr e lnbc.
Insidie e limiti
Un checksum valido dimostra solo che la stringa non è stata digitata male; non dimostra che l’indirizzo appartenga a qualcuno né che i fondi possano essere ricevuti in sicurezza, e lo strumento non comunica con nessuna rete. Usare la variante sbagliata, ad esempio Bech32 per un indirizzo Taproot, produce un indirizzo che i wallet rifiutano. Le maiuscole e minuscole miste non sono mai valide, e la cifra 1 può comparire nell’HRP, quindi il separatore è l’ultimo 1. Le stringhe nsec contengono chiavi private: la decodifica avviene solo nel browser, ma considera compromessa qualsiasi chiave segreta incollata in un sito web e usa valori fittizi per i test.