Mixer for RaiBlocks transactions
Switch branches/tags
Nothing to show
Clone or download
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.
img
raimixer
.gitignore
LICENSE
MAINTAINERS
README.md
requirements.txt
setup.cfg
setup.py

README.md

RaiMixer logo

RaiMixer: local transaction scrambler for Raiblocks

RaiMixer GUI

This video shows a simple session using RaiMixer to send a transaction to a destination account using a single round of mixing and 3 mixing accounts (18 transactions in total):

IMPORTANT

This is not finished. It needs more tests, documentation, and more anonymity features.

It could also could eat your funds alive and leave you poor and homeless. You've been warned.

What is this?

This is a fund mixer/shaker to improve anonymity on RaiBlocks transactions. It will create a (configurable) number of mixer accounts and send the amount between them and the original source account in a number of (configurable) mixing rounds until finally all the funds are sent to the destination account.

This takes advantage of the fast and feeless transactions of the awesome RaiBlocks cryptocurrency.

Is this safe?

Depends on your definition of safe. This probably won't protect you from a well done blockchain analysis by professionals. But since they can only get a certain % of certainly, that lowers as you increase the number of mixing rounds and accounts, it's very improbable that it could be used as solid evidence in a trial, for example.

In case you missed the warning in the first section, please note that this is currently a very early release and some things will improve and there could be bugs.

Won't the nodes know where the amounts are coming because of my IP?

No, nodes doesn't have a way to know of a block they're receiving is being originated in a peer or simply propagated.

Is this safer than an online mixer?

Not really. The advantage of an online mixer like RaiShaker is that it mixes amounts from different users. So even while nodes can't know if different accounts are from the same or different persons, a comprehensive analysis could see if all the funds from the first transactions before mixing came from knew exchanges accounts and thus can guess than the transactions following that one are to the mixers accounts. RaiShaker avoids that problem mixing the funds from its users together.

But this also have some advantages over an online mixer:

  • You don't have the trust the online mixer operator (that will know where the funds came from and where they'll go).

  • This is probably faster since the online mixers have to wait until they have a minimum amount of users to start the mixing process.

To be double safe you could use RaiMixer before sending to RaiShaker.

How much time does it take?

The bottleneck is the small POW done on every transaction and the fact that, at least on my tests, the node doesn't seem to parallelize RPC requests even if it's configured to use several threads or receive them on different connections. So it'll depend on the number of transactions, which in turn will depend on the number of mixing accounts and mixing rounds configured.

This number of transactions can't be exactly predicted because the program randomized some things, but a typical 4-accounts, 2 rounds mixing produces about 50 transactions, which on my machine take about 5 minutes to complete.

Installation

pip install raimixer
pip install pyqt5 # only if you want to use the GUI

How to use

Note: Python 3.6 required.

First, edit your ~/RaiBlocks/config.json and set to "true" the settings called enable_control and rpc_enable. The close and reopen your wallet or node and unlock it. It must remain running while this script runs. The program will remind you if either of these things is not done.

The program can be used in command line or GUI modes. For the GUI, just run:

raimixer --gui

The simplest example of the command line mode would be:

raimixer <destination_account> <ammount>

This will use the default wallet and accounts as specified in RaiBlock's config.json file. You can use the options --wallet and --source_acc to set specific ones if you want.

The amount must end with "mrai" for megarais or "krai" for kilorais. Smaller amounts are not supported at the moment (but you can use decimals).

Another interesting option that you could want to consider is --initial_amount. This will make the mixing send the specified bigger amount than the one actually needed to make analysis harder; excess amount will be returned to the source account at the end of the process.

Mixing accounts will be deleted at the end of the operation if everything worked.

If the RaiBlocks node or wallet crashes during the operation (which sometimes happens), you can use the --clean option to recover all amounts in all the accounts except the one you set as --source_acc. Please note that this can't make out mixing accounts from previous sessions from user-created accounts, so if you want to keep some amount in other accounts you'll have to move the fund manually (or run this and then restore the funds later, --clean won't delete any account.)

Other options

raimixer --help

usage: raimixer [-h] [-w WALLET] [-s SOURCE_ACC] [-c] [-d] [-i INITIAL_AMOUNT]
                [-m] [-l] [-n NUM_MIXERS] [-r NUM_ROUNDS] [-u RPC_ADDRESS]
                [-p RPC_PORT] [-g]
                [dest_acc] [amount]

 ____       _ __  __ _
|  _ \ __ _(_)  \/  (_)_  _____ _ __
| |_) / _` | | |\/| | \ \/ / _ \ '__|
|  _ < (_| | | |  | | |>  <  __/ |
|_| \_\__,_|_|_|  |_|_/_/\_\___|_|

Mix/scramble RaiBlocks transactions between random local accounts before
sending to the real destination.

Example usage:

raimixer xrb_3zq1yrhgij8ix35yf1khehzwfiz9ojjotndtqprpyymixxwxnkhn44qgqmy5 10xrb

If this software is useful to you, consider donating to the author's rai-funds!

xrb_3usnd3kirzfudprd3tceauh3sejxpfm754jgnjajbttrefx9obgdqe69wfcf

(Thank you!❤)

positional arguments:
  dest_acc              Destination account (mandatory except on --consolidate)
  amount                Amount. Use xrb/mrai or krai sufixes for mega/kilo rai (mandatory except for --consolidate)

optional arguments:
  -h, --help            show this help message and exit
  -w WALLET, --wallet WALLET
                        User wallet ID (default: from Rai config)
  -s SOURCE_ACC, --source_acc SOURCE_ACC
                        Source account (default: from Rai config)
  -c, --consolidate     Move everything to the source account. Useful after node crashes.
  -d, --delete_empty    Delete empty accounts
  -i INITIAL_AMOUNT, --initial_amount INITIAL_AMOUNT
                        Initial amount to mix. Helps masking transactions. Must be greater
                        than "amount". Rest will be returned to source account (default: equal to "amount")
  -m, --dest_from_multiple
                        Send to the final destination from various mixing account
  -l, --leave_remainder
                        Leave excess amount in the mixing accounts (don't return to main account at the end)
  -n NUM_MIXERS, --num_mixers NUM_MIXERS
                        Number of mixing accounts to create (default=4)
  -r NUM_ROUNDS, --num_rounds NUM_ROUNDS
                        Number of mixing rounds to do (default=2
  -u RPC_ADDRESS, --rpc_address RPC_ADDRESS
                        RPC address (default: from Rai config)
  -p RPC_PORT, --rpc_port RPC_PORT
                        RPC port (default: from Rai config)
  -g, --gui             Start the GUI (needs PyQt5 correctly installed)

Roadmap

  • Windows portable .exe file.
  • Testing framework emulating the node.
  • Better documentation.
  • Progress bars both in text and GUI mode.

If you want to contribute a PR for any of these points you're more than welcome!

I want to thank you!

xrb_3usnd3kirzfudprd3tceauh3sejxpfm754jgnjajbttrefx9obgdqe69wfcf