scure-bip39

Secure, audited & minimal implementation of BIP39 mnemonic phrases.

Compared to popular bip39 package, scure-bip39:

• Is 491KB all-bundled instead of 1.3MB
• Uses 2 dependencies instead of 15
• Wordlists are 157KB instead of 315KB
• Had an external security audit by Cure53 on Jan 5, 2022

Check out scure-bip32 if you need hierarchical deterministic wallets ("HD Wallets").

This library belongs to scure

scure — secure audited packages for every use case.

• Independent security audits
• All releases are signed with PGP keys
• Check out all libraries: base, bip32, bip39

Usage

npm install @scure/bip39

Or

yarn add @scure/bip39

1import * as bip39 from '@scure/bip39';
2import { wordlist } from '@scure/bip39/wordlists/english';
3
4// Generate x random words. Uses Cryptographically-Secure Random Number Generator.
5const mn = bip39.generateMnemonic(wordlist);
6console.log(mn);
7
8// Reversible: Converts mnemonic string to raw entropy in form of byte array.
9const ent = bip39.mnemonicToEntropy(mn, wordlist)
10
11// Reversible: Converts raw entropy in form of byte array to mnemonic string.
12bip39.entropyToMnemonic(ent, wordlist);
13
14// Validates mnemonic for being 12-24 words contained in `wordlist`.
15bip39.validateMnemonic(mn, wordlist);
16
17// Irreversible: Uses KDF to derive 64 bytes of key data from mnemonic + optional password.
18await bip39.mnemonicToSeed(mn, 'password');
19bip39.mnemonicToSeedSync(mn, 'password');

This submodule contains the word lists defined by BIP39 for Czech, English, French, Italian, Japanese, Korean, Simplified and Traditional Chinese, and Spanish. These are not imported by default, as that would increase bundle sizes too much. Instead, you should import and use them explicitly.

1function generateMnemonic(wordlist: string[], strength?: number): string;
2function mnemonicToEntropy(mnemonic: string, wordlist: string[]): Uint8Array;
3function entropyToMnemonic(entropy: Uint8Array, wordlist: string[]): string;
4function validateMnemonic(mnemonic: string, wordlist: string[]): boolean;
5function mnemonicToSeed(mnemonic: string, passphrase?: string): Promise<Uint8Array>;
6function mnemonicToSeedSync(mnemonic: string, passphrase?: string): Uint8Array;

All wordlists:

1import { wordlist } from '@scure/bip39/wordlists/czech';
2import { wordlist } from '@scure/bip39/wordlists/english';
3import { wordlist } from '@scure/bip39/wordlists/french';
4import { wordlist } from '@scure/bip39/wordlists/italian';
5import { wordlist } from '@scure/bip39/wordlists/japanese';
6import { wordlist } from '@scure/bip39/wordlists/korean';
7import { wordlist } from '@scure/bip39/wordlists/simplified-chinese';
8import { wordlist } from '@scure/bip39/wordlists/spanish';
9import { wordlist } from '@scure/bip39/wordlists/traditional-chinese';

Security

The library has been audited by Cure53 on Jan 5, 2022. Check out the audit PDF & URL. See changes since audit.

1. The library was initially developed for js-ethereum-cryptography
2. At commit ae00e6d7, it was extracted to a separate package called micro-bip39
3. After the audit we've decided to use NPM namespace for security. Since @micro namespace was taken, we've renamed the package to @scure/bip39

License

MIT License

Copyright (c) 2022 Patricio Palladino, Paul Miller (paulmillr.com)