NAME

Bitcoin::Crypto::Bech32 - Bitcoin's Bech32 implementation in Perl

SYNOPSIS

        # none exported by default
        use Bitcoin::Crypto::Bech32 qw(
                encode_bech32
                decode_bech32
                split_bech32
                encode_segwit
                decode_segwit
        );

        # witness version - a number from 0 to 16, packed into a byte
        my $version = pack "C", 0;

        # human readable part of the address - a string
        my $network_hrp = Bitcoin::Crypto::Network->get->segwit_hrp;

        # handles Bitcoin SegWit adresses
        my $segwit_address = encode_segwit($network_hrp, $version . $pubkeyhash);
        my $data_with_version = decode_segwit($segwit_address);

        # handles custom Bech32 encoding
        my $bech32str = encode_bech32("hello", pack "A*", "world"); # should start with hello1
        my $bytestr = decode_bech32($bech32str);

DESCRIPTION

Implementation of Bech32 algorithm (BIP173 compatible)

The module has a couple of layers of encoding, namely:

• base32, which handles the alphabet and 5-to-8 transformation (not exported)

• bech32, which handles checksums and human-readable (HRP) parts

• segwit, which handles segwit program numbering and validation

For Bech32-encoded SegWit addresses, use encode_segwit and decode_segwit. For custom uses of Bech32 (not in context of Bitcoin SegWit addresses), use encode_bech32 and decode_bech32.

If in doubt, use segwit functions, not bech32 functions!

FUNCTIONS

This module is based on Exporter. None of the functions are exported by default. :all tag exists that exports all the functions at once.

encode_segwit

decode_segwit

Bech32 encoding / decoding valid for SegWit addresses. Does not validate the human readable part.

These functions also perform segwit program validation, see Bitcoin::Crypto::Segwit.

Encoding takes two arguments which are a human readable part and a byte string.

Decoding takes bech32-encoded string. Returns the entire encoded data along with the segwit program version byte.

encode_bech32

decode_bech32

Basic bech32 encoding / decoding.

Encoding takes two arguments which are a human readable part and a byte string.

Decoding takes bech32-encoded string.

These methods are not meant to work with Bitcoin SegWit addresses, use encode_segwit and decode_segwit for that instead

split_bech32

Splits a bech32-encoded string into human-readable part and data part. Returns a list containing the two.

Performs all validity checks on the input. Dies on every error.

EXCEPTIONS

This module throws an instance of Bitcoin::Crypto::Exception if it encounters an error. It can produce the following error types from the Bitcoin::Crypto::Exception namespace:

• Bech32InputFormat - input was not suitable for bech32 operations due to invalid format

• Bech32InputData - input was parsed with bech32 operations but contained invalid data

• Bech32InputChecksum - checksum validation has failed

SEE ALSO

Bitcoin::Crypto::Base58

Bitcoin::Crypto::Segwit

Bitcoin::Crypto::Key::Public

cpanm Bitcoin::Crypto

perl -MCPAN -e shell
install Bitcoin::Crypto