1.0.1 • Published 7 years ago

hd-seed-phrase-guesser v1.0.1

Weekly downloads
4
License
ISC
Repository
github
Last release
7 years ago

HD Seed Phrase Guesser CircleCI

Live Web Interface Here

A tool for attempting to recover Ethereum addresses from incorrectly input seed phrases.

  • Attempts to compare an entered seed phrase against detected possible spelling errors.
  • Generates accounts for each valid seed phrase variation up to a defined depth.
  • Checks for accounts with any ethereum balance in that depth.
  • If an account with a balance is found, the valid mnemonic is returned.
  • The module is an event emitter for easy introspection into its attempt cycle.

Usage

const Guesser = require('hd-seed-phrase-guesser')
const Eth = require('ethjs')
const eth = new Eth(new Eth.HttpProvider('https://mainnet.infura.io'))

const input = ' travel funny  ocean erupt srader whale mandate timber scoter escout actress elbow'
const getBalance = eth.getBalance.bind(eth)

const guesser = new Guesser({
  phrase: input,
  getBalance: getBalance,
})

guesser.guess()
.then((mnemonic) => {
  // Successful recovery!
})
.catch((reason) => {
  // Failed to recover :()
})

// Track events!
guesser.on('trying', (mnemonic) => {
  // The guesser is checking balances on this mnemonic
})

Building the web interface

One detail: You'll have to remove the line of node_modules/spell/spell.js that references readFileSync, since that is not available in browser.

After you npm install, assuming you have browserify installed globally (npm install browserify -g) you should be able to build with npm run build.