diff options
Diffstat (limited to 'bip-0039.mediawiki')
-rw-r--r-- | bip-0039.mediawiki | 39 |
1 files changed, 31 insertions, 8 deletions
diff --git a/bip-0039.mediawiki b/bip-0039.mediawiki index bd70558..4ac3c55 100644 --- a/bip-0039.mediawiki +++ b/bip-0039.mediawiki @@ -18,7 +18,7 @@ This BIP describes the implementation of a mnemonic code or mnemonic sentence -- a group of easy to remember words -- for the generation of deterministic wallets. -It consists of two parts: generating the mnemonic, and converting it into a +It consists of two parts: generating the mnemonic and converting it into a binary seed. This seed can be later used to generate deterministic wallets using BIP-0032 or similar methods. @@ -29,7 +29,7 @@ handling of raw binary or hexadecimal representations of a wallet seed. The sentence could be written on paper or spoken over the telephone. This guide is meant to be a way to transport computer-generated randomness with -a human readable transcription. It's not a way to process user-created +a human-readable transcription. It's not a way to process user-created sentences (also known as brainwallets) into a wallet seed. ==Generating the mnemonic== @@ -46,7 +46,7 @@ as an index into a wordlist. Finally, we convert these numbers into words and use the joined words as a mnemonic sentence. The following table describes the relation between the initial entropy -length (ENT), the checksum length (CS) and the length of the generated mnemonic +length (ENT), the checksum length (CS), and the length of the generated mnemonic sentence (MS) in words. <pre> @@ -67,12 +67,12 @@ MS = (ENT + CS) / 11 An ideal wordlist has the following characteristics: a) smart selection of words - - the wordlist is created in such way that it's enough to type the first four + - the wordlist is created in such a way that it's enough to type the first four letters to unambiguously identify the word b) similar words avoided - word pairs like "build" and "built", "woman" and "women", or "quick" and "quickly" - not only make remembering the sentence difficult, but are also more error + not only make remembering the sentence difficult but are also more error prone and more difficult to guess c) sorted wordlists @@ -97,7 +97,7 @@ This seed can be later used to generate deterministic wallets using BIP-0032 or similar methods. The conversion of the mnemonic sentence to a binary seed is completely independent -from generating the sentence. This results in rather simple code; there are no +from generating the sentence. This results in a rather simple code; there are no constraints on sentence structure and clients are free to implement their own wordlists or even whole sentence generators, allowing for flexibility in wordlists for typo detection or other purposes. @@ -113,7 +113,14 @@ will make the desired wallet available. ==Wordlists== -* [[bip-0039/bip-0039-wordlists.md|Moved to separate document]] +Since the vast majority of BIP39 wallets supports only the English wordlist, +it is '''strongly discouraged''' to use non-English wordlists for generating +the mnemonic sentences. + +If you still feel your application really needs to use a localized wordlist, +use one of the following instead of inventing your own. + +* [[bip-0039/bip-0039-wordlists.md|Wordlists]] ==Test vectors== @@ -137,6 +144,9 @@ http://github.com/trezor/python-mnemonic Go: * https://github.com/tyler-smith/go-bip39 +Python: +* https://github.com/meherett/python-hdwallet + Elixir: * https://github.com/aerosol/mnemo @@ -153,21 +163,34 @@ Haskell: * https://github.com/NicolasDorier/NBitcoin JavaScript: -* https://github.com/bitpay/bitcore-mnemonic +* https://github.com/bitpay/bitcore/tree/master/packages/bitcore-mnemonic * https://github.com/bitcoinjs/bip39 (used by [[https://github.com/blockchain/My-Wallet-V3/blob/v3.8.0/src/hd-wallet.js#L121-L146|blockchain.info]]) +Java: +* https://github.com/bitcoinj/bitcoinj/blob/master/core/src/main/java/org/bitcoinj/crypto/MnemonicCode.java + Ruby: * https://github.com/sreekanthgs/bip_mnemonic Rust: * https://github.com/maciejhirsz/tiny-bip39/ +* https://github.com/koushiro/bip0039-rs + +Smalltalk: +* https://github.com/eMaringolo/pharo-bip39mnemonic Swift: * https://github.com/CikeQiu/CKMnemonic * https://github.com/yuzushioh/WalletKit +* https://github.com/pengpengliu/BIP39 +* https://github.com/matter-labs/web3swift/blob/develop/Sources/web3swift/KeystoreManager/BIP39.swift +* https://github.com/zcash-hackworks/MnemonicSwift C++: * https://github.com/libbitcoin/libbitcoin-system/blob/master/include/bitcoin/system/wallet/mnemonic.hpp C (with Python/Java/Javascript bindings): * https://github.com/ElementsProject/libwally-core + +Python: +* https://github.com/scgbckbone/btc-hd-wallet |