Documentation

Wordlists

A Wordlist is a set of 2048 words used to encode private keys (or other binary data) that is easier for humans to write down, transcribe and dictate.

The BIP-39 standard includes several checksum bits, depending on the size of the mnemonic phrase.

A mnemonic phrase may be 12, 15, 18, 21 or 24 words long. For most purposes 12 word mnemonics should be used, as including additional words increases the difficulty and potential for mistakes and does not offer any effective improvement on security.

There are a variety of BIP-39 Wordlists for different languages, but for maximal compatibility, the English Wordlist is recommended.

Constants
LangCz
LangEn
LangEs
LangFr
LangIt
LangJa
LangKo
LangPt
LangZh
Wordlist
WordlistOwl
WordlistOwlA

<src>wordlists⇒ Record< string, Wordlist >

The available Wordlists by their ISO 639-1 Language Code.

(i.e. cz, en, es, fr, ja, ko, it, pt, zh_cn, zh_tw)

The dist files (in the /dist folder) have had all languages except English stripped out, which reduces the library size by about 80kb. If required, they are available by importing the included wordlists-extra.min.js file.

<src>class LangCz

inherits fromWordlistOwl, Wordlist

The Czech wordlist for mnemonic phrases.

<src>LangCz.wordlist()⇒ LangCz

Returns a singleton instance of a LangCz, creating it if this is the first time being called.

<src>class LangEn

inherits fromWordlistOwl, Wordlist

The English wordlist for mnemonic phrases.

<src>LangEn.wordlist()⇒ LangEn

Returns a singleton instance of a LangEn, creating it if this is the first time being called.

<src>class LangEs

inherits fromWordlistOwlA, WordlistOwl, Wordlist

The Spanish wordlist for mnemonic phrases.

<src>LangEs.wordlist()⇒ LangEs

Returns a singleton instance of a LangEs, creating it if this is the first time being called.

<src>class LangFr

inherits fromWordlistOwlA, WordlistOwl, Wordlist

The French wordlist for mnemonic phrases.

<src>LangFr.wordlist()⇒ LangFr

Returns a singleton instance of a LangFr, creating it if this is the first time being called.

<src>class LangIt

inherits fromWordlistOwl, Wordlist

The Italian wordlist for mnemonic phrases.

<src>LangIt.wordlist()⇒ LangIt

Returns a singleton instance of a LangIt, creating it if this is the first time being called.

<src>class LangJa

inherits fromWordlist

The Japanese wordlist for mnemonic phrases.

<src>LangJa.wordlist()⇒ LangJa

Returns a singleton instance of a LangJa, creating it if this is the first time being called.

<src>class LangKo

inherits fromWordlist

The Korean wordlist for mnemonic phrases.

<src>LangKo.wordlist()⇒ LangKo

Returns a singleton instance of a LangKo, creating it if this is the first time being called.

<src>class LangPt

inherits fromWordlistOwl, Wordlist

The Portuguese wordlist for mnemonic phrases.

<src>LangPt.wordlist()⇒ LangPt

Returns a singleton instance of a LangPt, creating it if this is the first time being called.

<src>class LangZh

inherits fromWordlist

The Simplified Chinese wordlist and Tradional Chinese wordlist for mnemonic phrases.

<src>LangZh.wordlist(dialect: string)⇒ LangZh

Returns a singleton instance of a LangZh for dialect, creating it if this is the first time being called.

Use the dialect "cn" or "tw" for simplified or traditional, respectively.

<src>abstract class Wordlist

A Wordlist represents a collection of language-specific words used to encode and devoce BIP-39 encoded data by mapping words to 11-bit values and vice versa.

<src>wordlist.locale⇒ string

<src>new Wordlist(locale: string)

Creates a new Wordlist instance.

Sub-classes MUST call this if they provide their own constructor, passing in the locale string of the language.

Generally there is no need to create instances of a Wordlist, since each language-specific Wordlist creates an instance and there is no state kept internally, so they are safe to share.

<src>wordlist.getWord(index: number)⇒ stringabstract

Maps an 11-bit value into its coresponding word in the list.

Sub-classes MUST override this.

<src>wordlist.getWordIndex(word: string)⇒ numberabstract

Maps a word to its corresponding 11-bit value.

Sub-classes MUST override this.

<src>wordlist.join(words: Array< string >)⇒ string

Sub-classes may override this to provider a language-specific method for joining words into a phrase.

By default, words are joined by a single space.

<src>wordlist.split(phrase: string)⇒ Array< string >

Sub-classes may override this to provide a language-specific method for spliting phrase into individual words.

By default, phrase is split using any sequences of white-space as defined by regular expressions (i.e. /s+/).

<src>class WordlistOwl

inherits fromWordlist

An OWL format Wordlist is an encoding method that exploits the general locality of alphabetically sorted words to achieve a simple but effective means of compression.

This class is generally not useful to most developers as it is used mainly internally to keep Wordlists for languages based on ASCII-7 small.

If necessary, there are tools within the generation/ folder to create these necessary data.

<src>wordlistOwl._data⇒ stringread-only

<src>new WordlistOwl(locale: string, data: string, checksum: string)

Creates a new Wordlist for locale using the OWL data and validated against the checksum.

<src>wordlistOwl._decodeWords()⇒ Array< string >

<src>class WordlistOwlA

inherits fromWordlistOwl, Wordlist

An OWL-A format Wordlist extends the OWL format to add an overlay onto an OWL format Wordlist to support diacritic marks.

This class is generally not useful to most developers as it is used mainly internally to keep Wordlists for languages based on latin-1 small.

If necessary, there are tools within the generation/ folder to create these necessary data.

<src>wordlistOwlA._accent⇒ stringread-only

<src>new WordlistOwlA(locale: string, data: string, accent: string, checksum: string)