This was a struggle for me. So my struggle bears fruit for you!
Eloipool is a Python3 based pool server with stratum support. You can read more about it
on Luke-Jr's post here:
https://bitcointalksearch.org/topic/ann-eloipool-fast-python3-pool-server-software-gbtstratumdyntargetproxy-61731I would like to thank Luke-Jr, jgarzik, and the folks at the
following threads for helping me get this sucker rolling.
https://bitcointalksearch.org/topic/ann-eloipool-fast-python3-pool-server-software-gbtstratumdyntargetproxy-61731;allhttps://bitcointalk.org/index.php?topic=158105.0;allThis is example is being installed on Ubuntu (Precise). You may have to adjust the downloading of packages to fit
your system.
1. Add the bitcoin repository to your sources and update (ubuntu)
add-apt-repository ppa:bitcoin/bitcoin
apt-get update
2. Install bitcoind
apt-get install bitcoind
3. Run bitcoind
bitcoind -daemon
You should receive an error that says something like this:
lsError: To use the "-daemon" option, you must set a rpcpassword in the configuration file:
/home/user/.bitcoin/bitcoin.conf
It is recommended you use the following random password:
rpcuser=bitcoinrpc
rpcpassword=*password redacted* <----This password is randomly generated by bitcoind
(you do not need to remember this password)
The username and password MUST NOT be the same.
If the file does not exist, create it with owner-readable-only file permissions.
It is also recommended to set alertnotify so you are notified of problems;
for example: alertnotify=echo %s | mail -s "Bitcoin Alert"
[email protected]4. Edit your bitcoin.conf file (at ~/.bitcoin/bitcoin.conf) to read
server=1
rpcuser=bitcoinrpc
rpcpassword=*the password in the error above*
rpcallowip=127.0.0.1
logtimestamps=1
5. Run bitcoind again
bitcoind -daemon
If you check the log file ~/.bitcoin/debug.log you should see it start the block download.
This syncs up with the network. This will take a long time so run this now and you can finish
set up. If you want a better visual representation and your system has a desktop installed,
install bitcoin-qt (apt-get intall bitcoin.qt). By leaving it up you can watch the progress
bar at the bottom.
6. Make eloipool directory
Pick a directory where you want to store eloipool.
I used "/bitcoin". This is in the root directory and different than "~/.bitcoin"
mkdir /bitcoin
7. Install python 3.2
apt-get install python3.2 python3.2-dev
8. Download python-bitcoinrpc
cd /bitcoin
git clone https://github.com/jgarzik/python-bitcoinrpc
Make sure you check out an older commit due to bugs with the current commit:
cd python-bitcoinrpc
git checkout -b 770881c8bd9b1f92427290270b37a28751cf9df0
Then go back to the main folder
cd ../../
9. Download python-base58
git clone git://gitorious.org/bitcoin/python-base58
10. Download and compile midstate
This is the only one you will have to compile yourself.
git clone http://gitorious.org/midstate/midstate
cd midstate
We have to edit midstate's Makefile to adhere to our system. Verify your python
flags are correct first by running these two commands:
python3.2-config --ldflags
python3.2-config --cflags
The output of these should match the last entry in the CFLAGS line and LDFLAGS line.
I edited mine from this:
CFLAGS = -march=native -Wall -funroll-all-loops -O3 -fstrict-aliasing -Wall -std=c99 -I/usr/include/python3.2
LDFLAGS = -Wl,-O1 -Wl,--as-needed -lpython3.2
to this:
CFLAGS = -march=native -Wall -funroll-all-loops -O3 -fstrict-aliasing -Wall -std=c99 -I/usr/include/python3.2mu
LDFLAGS = -Wl,-O1 -Wl,--as-needed -lpython3.2mu
Then make
sudo make
Then go back
cd ../
11. Download eloipool
sudo git clone git://gitorious.org/bitcoin/eloipool.git
cd eloipool
12. Edit config.py
Copy the file "config.py.example" to "config.py" and edit it.
cp config.py.example config.py
Change "TrackerAddr" to reflect the address of the local machine's bitcoin wallet.
MAKE SURE YOU CHANGE THIS TO YOUR ADDRESS!
TrackerAddr = '14tpWuy3pMf8A1zMxysg3rrEhD3bpveXGC'
If you are solo mining with a private pool, comment out the following line:
CoinbaserCmd = 'echo -e "1\\n$((%d / 100))\\n1579aXhdwvKZEMrAKoCZhzGuqMa8EonuXU"'
Update Template Sources primary and comment out the secondary entry:
Use the rpcuser and rpcpassword you listed in your ~/.bitcoin/bitcoin.conf file
TemplateSources = (
{
'name': 'primary',
'uri': 'http://rpcuser:rpcpass@localhost:8332'
'priority': 0,
'weight': 1,
}
)
Comment out or delete all entrties in TemplateChecks
TemplateChecks = (
)
Change UpstreamBitcoindNode to:
UpstreamBitcoindNode = ('127.0.0.1', 8333)
Change UpstreamNetworkId from testnet to main
UpstreamNetworkId = b'\xF9\xBE\xB4\xD9'
Disable (comment) transaction-related but workaround:
#POT = 2
Unless you want to use SQL for sharelogging, comment out all but the entry
with type 'logfile'. In order to use MySQL, you must install PyMySql.
ShareLogging = (
{
'type': 'logfile',
'filename': 'share-logfile',
'format': "{time} {Q(remoteHost)} {username} {YN(not(rejectReason))} {dash(YN(upstreamResult))} {dash(rejectReason)} {solution}\n",
},
)
For your LogFile setting, I recommend changing the backup count depending on your preferences. It backs up every midnight,
and the number reflects how many backups to keep (the oldest being deleted).
13. Create scripts
Go to your "/bitcoin" directory and create a file called "run-bitcoind.sh" and enter the following. NOTE: your paths may
be different depending on where you chose your directory. For this example I used my /bitcoin one.
#!/bin/sh
/usr/bin/bitcoind -daemon -blocknotify=/bitcoin/newblock.sh
Now create the file "newblock.sh" and enter this VERBATIM:
#!/bin/sh
killall -USR1 eloipool.py
Now change directory into your "eloipool" folder (for me it was /bitcoin/eloipool) and create this
script called run-eloipool.sh. Again, your directories may be different, but leave "./eloipool" as is:
#!/bin/bash
PYTHONPATH=/bitcoin/python-bitcoinrpc:/bitcoin/python-base58:/bitcoin/midstate \
nohup ./eloipool.py 2>&1 >/dev/null &
Make sure all the scripts are executable by issuing these commands:
chmod 0755 /bitcoin/run-bitcoind.sh
chmod 0755 /bitcoin/newblock.sh
chmod 0755 /bitcoin/eloipool/run-eloipool.sh
14. Run!
Bitcoind/bitcoin-qt MUST BE FULLY SYNC'd TO THE NETWORK.
Make sure you're firewalls and port forwarding allows port 3334 on TCP. For a better connection
to the bitcoin network, allow 8333 in as well (such as you notice only 8 connections max when synchronizing)
Make sure all related processes are not running.
I added the scripts and eloipool in case you tried a different setup first:
killall bitcoind
killall run-bitcoind.sh
killall eloipool.py
Run bitcoind from the script.
./run-bitcoind.sh
Wait a little bit for bitcoind to start up. Then run eloipool from the script.
./run-eloipool.sh
To verify that both processes are running, run the following commands. They should return
with a PID and the name of the process. Such as:
ps -e | grep bitcoin
should return something like:
26762 ? 03:27:37 bitcoind
ps -e | grep eloipool.py
should return something like:
26788 ? 03:30:00 eloipool.py
15. Check connection
Now test your connecton by pointing your miner at your server with the settings:
user: YourBitcoinAddress
pass: x (this doesnt matter, it is ignored with the allow all setting in config.py)
address: stratum+tcp://IpAddressOrDomainName:3334
An example for bfgminer:
bfgminer.exe --userpass 134dV6U7gQ6wCFbfHUz2CMh6Dth72oGpgH:snoogins --url stratum+tcp://192.168.0.22:3334
Port 3334 is the port used for the Stratum Protocol.
Known Errors:-----
If you have an error such as:
2013-05-12 23:08:19,014 merkleMaker CRITICAL Traceback (most recent call last):
File "/usr/local/lib/python3.2/json/decoder.py", line 361, in raw_decode
obj, end = self.scan_once(s, idx)
StopIteration
During handling of the above exception, another exception occurred:
Traceback (most recent call last):
File "/home/eloipool/merklemaker.py", line 692, in run
self.merkleMaker_I()
File "/home/eloipool/merklemaker.py", line 682, in merkleMaker_I
self.merkleMaker_II()
File "/home/eloipool/merklemaker.py", line 648, in merkleMaker_II
return self._updateMerkleTree()
File "/home/eloipool/merklemaker.py", line 548, in _updateMerkleTree
self._updateMerkleTree_I()
File "/home/eloipool/merklemaker.py", line 512, in _updateMerkleTree_I
r = self._updateMerkleTree_fromTS(TS)
File "/home/eloipool/merklemaker.py", line 477, in _updateMerkleTree_fromTS
MP = self._CallGBT(TS)
File "/home/eloipool/merklemaker.py", line 327, in _CallGBT
MP = access.getblocktemplate(self.GBTReq)
File "/usr/local/lib/python3.2/site-packages/bitcoinrpc/authproxy.py", line 102, in __call__
response = self._get_response()
File "/usr/local/lib/python3.2/site-packages/bitcoinrpc/authproxy.py", line 128, in _get_response
parse_float=decimal.Decimal)
File "/usr/local/lib/python3.2/json/__init__.py", line 320, in loads
return cls(**kw).decode(s)
File "/usr/local/lib/python3.2/json/decoder.py", line 345, in decode
obj, end = self.raw_decode(s, idx=_w(s, 0).end())
File "/usr/local/lib/python3.2/json/decoder.py", line 363, in raw_decode
raise ValueError("No JSON object could be decoded")
ValueError: No JSON object could be decoded
A known fix is to change the line in python-bitcoinrpc/bitcoinrpc/authproxy.py
somewhere around line 72
self.__auth_header = "Basic %s" % base64.b64encode(authpair)
to read:
self.__auth_header = "Basic %s" % base64.b64encode(authpair).decode()
----------
An error reading:
TypeError: _stratum_mining_subscribe() takes exactly 1 positional argument (
Can be resolved by editing eloipool/stratumserver.py around lines 106-107 from
if not hasattr(e, 'StratumQuiet'):
self.logger.debug(fexc)
to read:
if not hasattr(e, 'StratumQuiet'):
if fexc.find('takes exactly 1 positional argument') == -1:
self.logger.debug(fexc)
Using MySql to log from EloipoolThis one took me a little bit.
Change directory to this location:
cd /usr/local/lib/python3.2/dist-packages/PyMySQL3-0.5-py3.2.egg/pymysql/
Locate the lines that look like this: (they should be together)
def unpack_int24(n):
return struct.unpack('B',n[0])[0] + (struct.unpack('B', n[1])[0] << 8) +\
(struct.unpack('B',n[2])[0] << 16)
def unpack_int32(n):
return struct.unpack('B',n[0])[0] + (struct.unpack('B', n[1])[0] << 8) +\
(struct.unpack('B',n[2])[0] << 16) + (struct.unpack('B', n[3])[0] << 24)
def unpack_int64(n):
return struct.unpack('B',n[0])[0] + (struct.unpack('B', n[1])[0]<<8) +\
(struct.unpack('B',n[2])[0] << 16) + (struct.unpack('B',n[3])[0]<<24)+\
(struct.unpack('B',n[4])[0] << 32) + (struct.unpack('B',n[5])[0]<<40)+\
(struct.unpack('B',n[6])[0] << 48) + (struct.unpack('B',n[7])[0]<<56)
Delete them all and in their place put this:
def unpack_int24(n):
try:
return struct.unpack('B',n[0])[0] + (struct.unpack('B', n[1])[0] << 8) +\
(struct.unpack('B',n[2])[0] << 16)
except TypeError:
return n[0]+(n[1]<<8)+(n[2]<<16)
def unpack_int32(n):
try:
return struct.unpack('B',n[0])[0] + (struct.unpack('B', n[1])[0] << 8) +\
(struct.unpack('B',n[2])[0] << 16) + (struct.unpack('B', n[3])[0] << 24)
except TypeError:
return n[0]+(n[1]<<8)+(n[2]<<16)+(n[3]<<24)
def unpack_int64(n):
try:
return struct.unpack('B',n[0])[0] + (struct.unpack('B', n[1])[0]<<8) +\
(struct.unpack('B',n[2])[0] << 16) + (struct.unpack('B',n[3])[0]<<24)+\
(struct.unpack('B',n[4])[0] << 32) + (struct.unpack('B',n[5])[0]<<40)+\
(struct.unpack('B',n[6])[0] << 48) + (struct.unpack('B',n[7])[0]<<56)
except TypeError:
return n[0]+(n[1]<<8)+(n[2]<<16)+(n[3]<<24) \
+(n[4]<<32)+(n[5]<<40)+(n[6]<<48)+(n[7]<<56)
Save and quit.
Make sure your database configurations are correct in your correct in your config.py and now you are logging to MySQL.
----------------------------------------------------------------
If you have any questions please post them below. If I don't have the answer hopefully somebody will.
If you see any errors in my guide that I dont see please let me know and I will fix it.
If you liked this guide, feel free to tip/donate me for my time.
bitcoin:1Nnb5S3z8kPMiiej9fUnvRqHorwb5C5mzq