#Copyright (C) 2011,2012 Colin Rice
#This software is licensed under an included MIT license.
#See the file entitled LICENSE
#If you were not provided with a copy of the license please contact: 
# Colin Rice [email protected]


# Ubuntu installation
---------------------------------------------------------------------
Run the following in your terminal:

#Install dependencies
sudo apt-get install python2.7 git python2.7-dev python-setuptools python-pip libevent-dev git python-dev

#Download bitHopper
git clone git://github.com/c00w/bitHopper.git

#Move into the folder
cd bitHopper

#install python dependencies
sudo python setup.py install --upgrade
(If this doesn't work run sudo pip install --upgrade requests btcnet_info flask gevent mechanize setuptools)

#run bitHopper
python run.py

# Go to localhost:8339 and click on workers. Add some pool login information
# Make sure to add some backup pools such as eligius or mtred
# bitHopper will return no work if there are no safe pools to mine

# Point your miner at localhost:8337

Tested and working in Ubuntu 12.04.

# Mining deepbit
There is one other dependency, you need to install numpy
sudo apt-get install python-numpy

# Other Linux Installations
---------------------------------------------------------------------
Note: Use pip to install your libraries. We need fairly recent versions of everything.
The libraries bundled with debian are too old.

# Instructions for Windows users
-----------------------------------------------------------------
NOTE: IF YOU ARE RUNNING LOTS OF MINERS USE LINUX.
It's a lot more stable and takes less modifications.

Download and install
1. Python
http://python.org/ftp/python/2.7.2/python-2.7.2.msi
Make sure you are using the 32 bit version.

2. Greenlet
http://pypi.python.org/packages/2.7/g/greenlet/greenlet-0.3.4.win32-py2.7.exe

3. Gevent
http://gevent.googlecode.com/files/gevent-1.0b2.win32-py2.7.msi
It is recommended that you install the latest version because some users reported that earlier versions to 1.x cause problems with the latest versions of BitHopper (see c00w#671 (comment) )

4. SetupTools
http://pypi.python.org/packages/2.7/s/setuptools/setuptools-0.6c11.win32-py2.7.exe#md5=57e1e64f6b7c7f1d2eddfc9746bbaf20

7. BitHopper
github.com/c00w/bitHopper
Go to downloads and hit zip. Extract the zip to your desktop

8. Bundled Dependencies
Enter the bitHopper folder
Open a console and navigate to the directory where you unzipped BitHopper.
Run the command
> C:\Python27\python.exe setup.py install


Running bitHopper
Open a console and navigate to the directory where you unzipped BitHopper.
Run the command
> C:\Python27\python.exe run.py 

#Where to point you miners
Have your miner use http://localhost:8337/

# Configuring user settings
Worker Configuration page: http://localhost:8339/worker
BitHopper Stats page: http://localhost:8339/stats

# Large Scale Users
-------------------------
If you are mining with more than ~5GH/s you should make sure to do the following.
1) 
Make sure you have libevent installed if you are on linux
2) 
Put in a couple of workers for each pool you are mining at.
Lots of pools have a global rate limiter for how fast they will accept
work from a single worker
3) If you are running out of connection sockets on the client side send me
an email and I'll walk you through setting up bitHopper to run with uwsgi

# Running the test suite
mv custom_pools_test/test_pool custom_pools
python tests.py

# More help

Email the author at [email protected]

You can also ask for help in the oficial forum at https://bitcointalk.org/index.php?topic=26866. 
Join us on Freenode (http://webchat.freenode.net/) #bithopper channel.

# Donations

If you think this project is cool and you want features added and bugs hunted down then consider making a p2p donation, anything counts ;)
or have "Donation" pool enabled in your stats page (setup donation percent in your "pools.cfg" - default 1%)

 1HEmzeuVEKxBQkEenysV1yM8oAddQ4o2TX - c00w

 17wp2zfxZKeycWt6NKiueVYmYyrciiuq2t - ryouiki
 1CWjg4soWEAQjMD4dCchdPpJ6fWDBRUU5b - echiu64
 15iS8iDqVCM2MF5ndaS3exR7Kw4LxFf2ra - hawks5999
 1ParaWy6NELDpseL6b1xbKvyhy5eX8f3TW - paraipan
 13hP5QuFccLUZQDNxPwnfmn6q5RiV48TEn - macboy80
 1GgorPurRdDgsbPmoGEJm2WWGxKkJ8ktkf - sdogi

 All the people who contribute to this project - https://github.com/c00w/bitHopper/network/members

 flower1024, echiu64 (ed64), graphiclunarkid, elitak, Clipseza, littleant, bb-btc, gnaget, murfshake, Sukrim, gtrrkicw,
 swordv2, bitcoindaddy, rkozola, ryouiki, starlightbreaker, hawks5999, erasmo, pueytan, macboy80, sdogi, joulesbeef,
 Seoulboy1, paraipan, Swicher, lucita777, TenthReality, dfc (Douglas Calvert), dadittoz, cutnpaster, simonk83, xzion,
 HolodeckJizzmopper, Locky7, iongchun