MnemonicGen creates BIP39-compliant seed phrases for Bitcoin/Bitcoin Cash wallets
Branch: development
Clone or download
Pull request Compare This branch is 1 commit ahead of joshmcintyre:development.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
res/data
src/core
.gitignore
LICENSE.md
Makefile
README.md

README.md

General


Author

  • Josh McIntyre

Website

  • jmcintyre.net

Overview

  • MnemonicGen creates BIP39-compliant seed phrases for Bitcoin/Bitcoin Cash wallets

Development


Git Workflow

  • master for releases (merge development)
  • development for bugfixes and new features

Building

  • make build Build the application
  • make clean Clean the build directory

Features

  • Generate a 12-word BIP39-compliant mnemonic seed phrase in English
  • Print this seed phrase on the command line for backup/wallet creation

Requirements

  • Requires Python with bitstring
  • Use pip install bitstring if it is not already available

Platforms

  • Linux
  • Windows
  • MacOSX

Usage


Command line usage

  • From the command line in the build directory, run ./mnemonicgen.py or python mnemonicgen.py
  • Write down the mnemonic phrase in order
  • Import the seed phrase into a modern HD (Hierarchical Deterministic) Bitcoin/Bitcoin Cash wallet. Examples include the Bitcoin.com wallet, Blockchain.info, or Electron Cash

Security Considerations

  • PLEASE NOTE - Every effort is made to learn and follow best practices in the development of this software. However, this code should be considered academic/experimental. Use at your own risk.
  • Always store your seed phrase in a secure location. Write it down and keep it somewhere safe, or use an encrypted password manager.
  • This tool does not require any network connectivity. Consider running offline to mitigate eavesdropping.
  • This tool uses Python's os.urandom to generate entropy for the seed. The underlying OS implementation determines the level of security. (/dev/urandom on Unix-based systems, CryptGenRandom() on Windows). It may be best to avoid using fresh machines or VM's as insufficient entropy may be used to generate a less-secure seed.