hd-seed-phrase-guesser

1.0.1 • Public • Published

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.

Package Sidebar

Install

npm i hd-seed-phrase-guesser

Weekly Downloads

0

Version

1.0.1

License

ISC

Last publish

Collaborators

  • danfinlay