russelldavies / satshunter

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

satshunter

Find the correct word order for a shuffled bitcoin seed phrase with a known address. Perhaps you're playing the Hunting Sats game.

Note that only native SegWit (P2WPKH) (BIP84) addresses are supported at the moment because they're the most popular. Others can be added quite easily.

While this program uses the Rayon library to get parallelization, the use of it could probably be improved upon to get more performance.

Installation

Embrace Nix and run cargo build --release. A binary will be written to target/release/satshunter.

Usage

satshunter --words 'hint cheese wife sugar cute boss win twin wall erode blush rival' \
  --address bc1qatpcs4tjj0c0mhfdpdypvxl7l66pcrqlcq02ce

Make sure you enclose the words in quotes so they can be parsed properly.

By default, the first 10 addresses are searched. If you want to change this pass the --depth argument.

If an ordering of the words matches the supplied address, the seed phrase will be printed. On success, the return code is 0, otherwise 1. You can integrate this into some reporting like so:

satshunter --words $WORDS --address $ADDRESS && notify 'success' || notify 'nothing found'

Replace notify with whatever notification system you want to use.

About


Languages

Language:Rust 55.6%Language:Nix 44.4%