xmr-haystack 0.0.2

Manage your on-chain Monero privacy with xmr-haystack

xmr-haystack

Description

This program takes a Monero wallet file, scans the blockchain, and outputs transactions in which your one-time public outputs (stealth addresses) were used as decoys.

Installation

A Python 3 environment is required to run this application. Given that you have a working Python 3 environment, all you need to do to install this application is run the following command:

$ pip3 install xmr-haystack

If you are on Linux or MacOS and you would prefer to build from the source code, then the following commands will allow you to do so:

$ git clone https://github.com/jeffro256/xmr-haystack.git
$ cd xmr-haystack
$ pip3 install .

If you are Windows and would prefer to build from the source code, then follow these steps:

1. Download the unzip source code from Github.
2. Open 'cmd' from the Start Menu
3. Naviagte to newly unzipped directory in cmd
4. Type $ pip3 install .

Usage

python3 -m xmr-haystack [-h] [-a ADDR] [-p PORT] [-l LOGIN] [-s HEIGHT] [-i CACHE_IN]
[-o CACHE_OUT] [-n] [-c CLI_EXE_FILE] wallet file

America's favorite stealth address scanner™

positional arguments:
  wallet file           path to wallet file

optional arguments:
  -h, --help            show this help message and exit
  -a ADDR, --daemon-addr ADDR
                        daemon address (e.g. node.xmr.to)
  -p PORT, --daemon-port PORT
                        daemon port (e.g. 18081)
  -l LOGIN, --daemon-login LOGIN
                        monerod RPC login in the form of [username]:[password]
  -s HEIGHT, --scan-height HEIGHT
                        rescan blockchain from specified height. defaults to wallet restore height
  -i CACHE_IN, --cache-input CACHE_IN
                        path to input cache file
  -o CACHE_OUT, --cache-output CACHE_OUT
                        path to output cache file
  -n, --no-cache        do not read from cache file and do not save to cache file
  -c CLI_EXE_FILE, --wallet-cli-path CLI_EXE_FILE
                        path to monero-wallet-cli executable. Helpful if executable is not in PATH

Disclaimer

While this program works, it is still in very early dev stages. Use this program at your own risk; I take no responsibility for any lost funds or privacy, etc, etc. That said, I really hope you find this code useful and I would really appreciate any feedback. :)

Donate

89tQx7bUmQDMdkgUjk5ZSfVpV3yGKZ6udWe4XGbBNE27iyxoYoWif8nHCLnvqjodaLENVGgBpWSFE2XGyjNKLT1bB8efQh5