Expand description

Encoding and decoding of the Blech32 format

Blech32 is an encoding scheme that is easy to use for humans and efficient to encode in QR codes.

A Blech32 string consists of a human-readable part (HRP), a separator (the character '1'), and a data part. A checksum at the end of the string provides error detection to prevent mistakes when the string is written off or read out loud.

The original description in BIP-0173 has more details.

Examples

use blech32::{self, FromBase32, ToBase32};
let encoded = blech32::encode("blech32", vec![0x00, 0x01, 0x02].to_base32()).unwrap();
assert_eq!(encoded, "blech321qqqsyscrzwu4dl8y5".to_string());
let (hrp, data) = blech32::decode(&encoded).unwrap();
assert_eq!(hrp, "blech32");
assert_eq!(Vec::<u8>::from_base32(&data).unwrap(), vec![0x00, 0x01, 0x02]);

Structs

Allocationless Blech32 writer that accumulates the checksum data internally and writes them out in the end.

Integer in the range 0..32

Enums

Error types for Blech32 encoding / decoding

Traits

Interface to calculate the length of the base32 representation before actually serializing

A trait to convert between u8 arrays and u5 arrays without changing the content of the elements, but checking that they are in range.

Parse/convert base32 slice to Self. It is the reciprocal of ToBase32.

A trait for converting a value to a type T that represents a u5 slice.

Interface to write u5s into a sink

Functions

Convert between bit sizes

Decode a blech32 string into the raw HRP and the data bytes.

Encode a blech32 payload to string.

Encode a blech32 payload to an fmt::Write. This method is intended for implementing traits from std::fmt.