Skip to content
OnionTip is a web app which parses Tor relay data to allow users to tip volunteers for running relay in a fair and open way.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Allows users to send tips with Bitcoin to volunteers who run Tor relays and provide Bitcoin addresses in their torrc file/router descriptor (contact and X-bitcoin fields). OnionTip uses router bandwidth measurements to allow users to donate to volunteers in a way that is proportional to the bandwidth that their routers contribute to the network.

This project is a rough implementation of the Flattor proposal made by George Kadianakis on the tor-talk mailing list.

tip for next commit


Bitcoin addresses are generated from a secret master seed. This secure random seed should be set in the 'BITCOIN_KEY_SEED' enviroment variable before running the application. Be sure to keep a copy of the key stored securely or funds may be lost.

$ export BITCOIN_KEY_SEED=`openssl rand 16 -hex`
$ python

The application retrieves updated lists of router bandwidth data and server descriptors from the onionoo service and the directory authorities respectively. The following is an example set of cron jobs to keep the router list and bitcoin payouts up to date.

0 * * * * /var/www/ --download
0,30 * * * * /var/www/ --check


This project was developed at the Dublin Bitcoin Hackathon, July 2014 and is beta software. It likely contains bugs and it may be risky sending non-negligible donations. All bitcoin addresses are generated from a master seed and transactions are forwarded as soon as possible to minimise threats of theft or loss.

If you find any bugs or experience problems with or your transactions please submit an issue on Github or email me at


Licensed under MIT License (c) 2014 Donncha O'Cearbhaill

This codebase is derived heavily from the Compass tool which allows the filtering and aggregation of data about Tor relays. (c) Sathyanarayanan Gunasekaran, The Tor Project

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.