BIP39 Dictionary

BIP39 dictionary encoding/decoding

BIP39 dictionaries gives a set of 2048 order specific words for multiple languages.

Every words represent a 11 bits index, which combined together represent a binary encoding by adding some checksum bits (which serve as padding), this allow to encode any arbitary data stream.

This crate can be used to produced standard BIP39 data, but also give the ability to relax the standard with more capabilities.

The maximum length allowed for the checksum is 32 bytes (256 bits), and the checksum used is currently always SHA2-256. At later point this could be made customizable as well.

The following relation need to hold for having a valid decoding/encoding:

length_bytes(data) * 8 + checksum = number_of(words) * 11

The standard BIP39 encoding use the following value:

But by relaxing this BIP39 standard, we can make the checksum variable and all combinaison of words valid:

Thanks

This crate has been heavily inspired by the BIP39 implementation at rust-cardano bip39 and dictionary data and test vectors have been lifted from this source.