Koder i dekoder Bech32 / Bech32m
Szczegóły techniczne
Jak działa narzędzie Bech32 / Bech32m
Co robi narzędzie Bech32
Bech32 i Bech32m to kodowania z sumą kontrolną, które zamieniają dane binarne w krótki ciąg małych liter i cyfr. Są używane w adresach Bitcoin SegWit i Taproot, kluczach Nostr (npub, nsec, note), kontach Cosmos, adresach Cardano i fakturach Lightning. Każdy ciąg ma trzy części: część czytelną dla człowieka (HRP), taką jak bc lub npub, separator 1 oraz część danych, której ostatnie sześć znaków to suma kontrolna. To narzędzie dekoduje dowolny ciąg Bech32 lub Bech32m, wykrywa, z którym z dwóch wariantów zgadza się suma kontrolna, i pokazuje HRP, dane jako hex, Base64 i surowe słowa 5-bitowe oraz podpowiedź o sieci dla dobrze znanych prefiksów. Może też kodować Twój własny HRP i dane, a adresy SegWit waliduje według wersji witness i długości programu. Wszystko działa lokalnie w Twojej przeglądarce.
Typowe zastosowania
Programiści dekodują adresy bc1 i tb1, aby sprawdzić wersję witness i 20- lub 32-bajtowy program, ustalić, czy adres jest Taproot (wersja 1, Bech32m), czy natywnym SegWit (wersja 0, Bech32), oraz budować dane testowe dla portfeli i węzłów. Programiści Nostr zamieniają npub na klucz publiczny w hex używany w zdarzeniach i z powrotem. Integratorzy Cosmos i Cardano sprawdzają, jaki HRP niesie adres, i odzyskują jego surowe bajty. Gdy ciąg nie przechodzi walidacji, narzędzie podaje przyczynę, a w przypadku jednego błędnie wpisanego znaku także prawdopodobną pozycję błędu, co pomaga przy ręcznym kopiowaniu adresu.
Warianty, dane wejściowe i limity
Bech32 (BIP-173) używa stałej sumy kontrolnej 1 i jest wymagany dla SegWit w wersji 0 oraz dla Nostr. Bech32m (BIP-350) używa stałej 0x2bc830a3, naprawia słabość pierwotnej sumy kontrolnej i jest wymagany dla SegWit w wersji 1 i wyższych, w tym Taproot. Ciągi są ograniczone do 90 znaków, chyba że włączysz opcję długich ciągów używaną przez dane w stylu Lightning. Dane wejściowe muszą składać się wyłącznie z małych albo wyłącznie z wielkich liter. W trybie kodowania dane można podać jako hex, tekst UTF-8 lub Base64, a tryb SegWit przyjmuje wersję witness i program w hex. Znane HRP to między innymi bc, tb i bcrt dla Bitcoin oraz ltc, cosmos, osmo, npub, nsec, note, addr i lnbc.
Pułapki i limity
Poprawna suma kontrolna dowodzi tylko, że ciąg nie został błędnie wpisany; nie dowodzi, że adres do kogoś należy ani że można bezpiecznie otrzymywać na niego środki, a to narzędzie nie łączy się z żadną siecią. Użycie złego wariantu, na przykład Bech32 dla adresu Taproot, daje adres odrzucany przez portfele. Mieszana wielkość liter jest zawsze niepoprawna, a cyfra 1 może występować w HRP, więc separatorem jest ostatnia 1. Ciągi takie jak nsec zawierają klucze prywatne: dekodowanie odbywa się tylko w Twojej przeglądarce, ale każdy klucz tajny wklejony na dowolną stronę traktuj jako skompromitowany i podczas testów używaj wartości fikcyjnych.