2 # Eloipool - Python Bitcoin pool server
3 # Copyright (C) 2011-2012 Luke Dashjr <luke-jr+eloipool@utopios.org>
5 # This program is free software: you can redistribute it and/or modify
6 # it under the terms of the GNU Affero General Public License as
7 # published by the Free Software Foundation, either version 3 of the
8 # License, or (at your option) any later version.
10 # This program is distributed in the hope that it will be useful,
11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 # GNU Affero General Public License for more details.
15 # You should have received a copy of the GNU Affero General Public License
16 # along with this program. If not, see <http://www.gnu.org/licenses/>.
20 if not hasattr(config, 'ServerName'):
21 config.ServerName = 'Unnamed Eloipool'
26 if len(logging.root.handlers) == 0:
28 format='%(asctime)s\t%(name)s\t%(levelname)s\t%(message)s',
31 for infoOnly in ('checkShare', 'JSONRPCHandler', 'merkleMaker', 'Waker for JSONRPCServer', 'JSONRPCServer'):
32 logging.getLogger(infoOnly).setLevel(logging.INFO)
34 def RaiseRedFlags(reason):
35 logging.getLogger('redflag').critical(reason)
39 from bitcoin.node import BitcoinLink, BitcoinNode
40 bcnode = BitcoinNode(config.UpstreamNetworkId)
41 bcnode.userAgent += b'Eloipool:0.1/'
44 UpstreamBitcoindJSONRPC = jsonrpc.ServiceProxy(config.UpstreamURI)
47 from bitcoin.script import BitcoinScript
48 from bitcoin.txn import Txn
49 from base58 import b58decode
50 from struct import pack
54 def makeCoinbaseTxn(coinbaseValue, useCoinbaser = True):
57 if useCoinbaser and hasattr(config, 'CoinbaserCmd') and config.CoinbaserCmd:
60 cmd = config.CoinbaserCmd
61 cmd = cmd.replace('%d', str(coinbaseValue))
62 p = subprocess.Popen(cmd, shell=True, stdout=subprocess.PIPE)
63 nout = int(p.stdout.readline())
65 amount = int(p.stdout.readline())
66 addr = p.stdout.readline().rstrip(b'\n').decode('utf8')
67 pkScript = BitcoinScript.toAddress(addr)
68 txn.addOutput(amount, pkScript)
71 coinbased = coinbaseValue + 1
72 if coinbased >= coinbaseValue:
73 logging.getLogger('makeCoinbaseTxn').error('Coinbaser failed!')
76 coinbaseValue -= coinbased
78 pkScript = BitcoinScript.toAddress(config.TrackerAddr)
79 txn.addOutput(coinbaseValue, pkScript)
82 # TODO: red flag on dupe coinbase
86 import jsonrpc_getwork
87 from util import Bits2Target
100 jsonrpc_getwork._CheckForDupesHACK = {}
101 global MM, networkTarget, server
102 networkTarget = Bits2Target(MM.currentBlock[1])
107 from merklemaker import merkleMaker
109 MM.__dict__.update(config.__dict__)
110 MM.clearCoinbaseTxn = makeCoinbaseTxn(5000000000, False) # FIXME
111 MM.clearCoinbaseTxn.assemble()
112 MM.makeCoinbaseTxn = makeCoinbaseTxn
113 MM.onBlockChange = blockChanged
114 MM.onBlockUpdate = updateBlocks
117 from binascii import b2a_hex
118 from copy import deepcopy
119 from struct import pack, unpack
121 from time import time
122 from util import RejectedShare, dblsha, hash2int, swap32
127 if hasattr(config, 'GotWorkURI'):
128 gotwork = jsonrpc.ServiceProxy(config.GotWorkURI)
130 def submitGotwork(info):
132 gotwork.gotwork(info)
134 checkShare.logger.warning('Failed to submit gotwork\n' + traceback.format_exc())
136 def getBlockHeader(username):
138 (merkleRoot, merkleTree, coinbase, prevBlock, bits, rollPrevBlk) = MRD
139 timestamp = pack('<L', int(time()))
140 hdr = b'\1\0\0\0' + prevBlock + merkleRoot + timestamp + bits + b'iolE'
141 workLog.setdefault(username, {})[merkleRoot] = (MRD, time())
142 return (hdr, workLog[username][merkleRoot])
144 def getBlockTemplate(username):
146 (dummy, merkleTree, coinbase, prevBlock, bits) = MC
148 wli = coinbase[1:wliLen+1]
149 workLog.setdefault(username, {})[wli] = (MC, time())
157 from bitcoin.varlen import varlenEncode, varlenDecode
159 def assembleBlock(blkhdr, txlist):
161 payload += varlenEncode(len(txlist))
166 def blockSubmissionThread(payload):
169 rv = UpstreamBitcoindJSONRPC.getmemorypool(b2a_hex(payload).decode('ascii'))
174 RaiseRedFlags('Upstream rejected block!')
176 def checkShare(share):
177 shareTime = share['time'] = time()
181 (prevBlock, bits) = MM.currentBlock
182 sharePrevBlock = data[4:36]
183 if sharePrevBlock != prevBlock:
184 if sharePrevBlock == MM.lastBlock[0]:
185 raise RejectedShare('stale-prevblk')
186 raise RejectedShare('bad-prevblk')
189 username = share['username']
190 if username not in workLog:
191 raise RejectedShare('unknown-user')
193 if data[72:76] != bits:
194 raise RejectedShare('bad-diffbits')
195 if data[:4] != b'\1\0\0\0':
196 raise RejectedShare('bad-version')
198 shareMerkleRoot = data[36:68]
199 if 'blkdata' in share:
200 pl = share['blkdata']
201 (txncount, pl) = varlenDecode(pl)
202 cbtxn = bitcoin.txn.Txn(pl)
203 cbtxn.disassemble(retExtra=True)
204 coinbase = cbtxn.getCoinbase()
206 wli = coinbase[1:wliLen+1]
210 wli = shareMerkleRoot
214 MWL = workLog[username]
216 raise RejectedShare('unknown-work')
217 (wld, issueT) = MWL[wli]
220 if data in DupeShareHACK:
221 raise RejectedShare('duplicate')
222 DupeShareHACK[data] = None
224 blkhash = dblsha(data)
225 if blkhash[28:] != b'\0\0\0\0':
226 raise RejectedShare('H-not-zero')
227 blkhashn = hash2int(blkhash)
230 logfunc = getattr(checkShare.logger, 'info' if blkhashn <= networkTarget else 'debug')
231 logfunc('BLKHASH: %64x' % (blkhashn,))
232 logfunc(' TARGET: %64x' % (networkTarget,))
234 workMerkleTree = wld[1]
235 workCoinbase = wld[2]
237 # NOTE: this isn't actually needed for MC mode, but we're abusing it for a trivial share check...
238 txlist = workMerkleTree.data
239 txlist = [deepcopy(txlist[0]),] + txlist[1:]
241 cbtxn.setCoinbase(workCoinbase)
244 if blkhashn <= networkTarget:
245 logfunc("Submitting upstream")
246 RBDs.append( deepcopy( (data, txlist, share.get('blkdata', None), workMerkleTree) ) )
248 payload = assembleBlock(data, txlist)
250 payload = share['data'] + share['blkdata']
251 logfunc('Real block payload: %s' % (payload,))
253 threading.Thread(target=blockSubmissionThread, args=(payload,)).start()
254 bcnode.submitBlock(payload)
255 share['upstreamResult'] = True
256 MM.updateBlock(blkhash)
259 if gotwork and blkhashn <= config.GotWorkTarget:
261 coinbaseMrkl = cbtxn.data
262 coinbaseMrkl += blkhash
263 steps = workMerkleTree._steps
264 coinbaseMrkl += pack('B', len(steps))
267 coinbaseMrkl += b"\0\0\0\0"
269 info['hash'] = b2a_hex(blkhash).decode('ascii')
270 info['header'] = b2a_hex(data).decode('ascii')
271 info['coinbaseMrkl'] = b2a_hex(coinbaseMrkl).decode('ascii')
272 thr = threading.Thread(target=submitGotwork, args=(info,))
276 checkShare.logger.warning('Failed to build gotwork request')
278 shareTimestamp = unpack('<L', data[68:72])[0]
279 if shareTime < issueT - 120:
280 raise RejectedShare('stale-work')
281 if shareTimestamp < shareTime - 300:
282 raise RejectedShare('time-too-old')
283 if shareTimestamp > shareTime + 7200:
284 raise RejectedShare('time-too-new')
287 cbpre = cbtxn.getCoinbase()
288 cbpreLen = len(cbpre)
289 if coinbase[:cbpreLen] != cbpre:
290 raise RejectedShare('bad-cb-prefix')
292 # Filter out known "I support" flags, to prevent exploits
293 for ff in (b'/P2SH/', b'NOP2SH', b'p2sh/CHV', b'p2sh/NOCHV'):
294 if coinbase.find(ff) > cbpreLen - len(ff):
295 raise RejectedShare('bad-cb-flag')
297 if len(coinbase) > 100:
298 raise RejectedShare('bad-cb-length')
300 cbtxn.setCoinbase(coinbase)
302 if shareMerkleRoot != workMerkleTree.withFirst(cbtxn):
303 raise RejectedShare('bad-txnmrklroot')
305 allowed = assembleBlock(data, txlist)
306 if allowed != share['data'] + share['blkdata']:
307 raise RejectedShare('bad-txns')
308 checkShare.logger = logging.getLogger('checkShare')
310 def receiveShare(share):
311 # TODO: username => userid
314 except RejectedShare as rej:
315 share['rejectReason'] = str(rej)
318 if '_origdata' in share:
319 share['solution'] = share['_origdata']
321 share['solution'] = b2a_hex(swap32(share['data'])).decode('utf8')
322 for i in loggersShare:
325 def newBlockNotification():
326 logging.getLogger('newBlockNotification').info('Received new block notification')
327 MM.updateMerkleTree()
328 # TODO: Force RESPOND TO LONGPOLLS?
331 def newBlockNotificationSIGNAL(signum, frame):
332 # Use a new thread, in case the signal handler is called with locks held
333 thr = threading.Thread(target=newBlockNotification, name='newBlockNotification via signal %s' % (signum,))
337 from signal import signal, SIGUSR1
338 signal(SIGUSR1, newBlockNotificationSIGNAL)
346 from time import sleep
349 SAVE_STATE_FILENAME = 'eloipool.worklog'
352 logger = logging.getLogger('stopServers')
354 if hasattr(stopServers, 'already'):
355 logger.debug('Already tried to stop servers before')
357 stopServers.already = True
359 logger.info('Stopping servers...')
360 global bcnode, server
361 servers = (bcnode, server)
368 logger.error('Failed to stop server %s\n%s' % (s, traceback.format_exc()))
374 sl.append(s.__class__.__name__)
379 logger.error('Servers taking too long to stop (%s), giving up' % (', '.join(sl)))
384 for fd in s._fd.keys():
387 def saveState(t = None):
388 logger = logging.getLogger('saveState')
390 # Then, save data needed to resume work
391 logger.info('Saving work state to \'%s\'...' % (SAVE_STATE_FILENAME,))
395 with open(SAVE_STATE_FILENAME, 'wb') as f:
397 pickle.dump(DupeShareHACK, f)
398 pickle.dump(workLog, f)
403 logger.error('Failed to save work\n' + traceback.format_exc())
405 os.unlink(SAVE_STATE_FILENAME)
407 logger.error(('Failed to unlink \'%s\'; resume may have trouble\n' % (SAVE_STATE_FILENAME,)) + traceback.format_exc())
413 logging.getLogger('exit').info('Goodbye...')
414 os.kill(os.getpid(), signal.SIGTERM)
421 logging.getLogger('restart').info('Restarting...')
423 os.execv(sys.argv[0], sys.argv)
425 logging.getLogger('restart').error('Failed to exec\n' + traceback.format_exc())
428 if not os.path.exists(SAVE_STATE_FILENAME):
431 global workLog, DupeShareHACK
433 logger = logging.getLogger('restoreState')
434 s = os.stat(SAVE_STATE_FILENAME)
435 logger.info('Restoring saved state from \'%s\' (%d bytes)' % (SAVE_STATE_FILENAME, s.st_size))
437 with open(SAVE_STATE_FILENAME, 'rb') as f:
441 # Future formats, not supported here
445 # Old format, from 2012-02-02 to 2012-02-03
450 if isinstance(t, dict):
451 # Old format, from 2012-02-03 to 2012-02-03
455 # Current format, from 2012-02-03 onward
456 DupeShareHACK = pickle.load(f)
458 if t + 120 >= time():
459 workLog = pickle.load(f)
461 logger.debug('Skipping restore of expired workLog')
463 logger.error('Failed to restore state\n' + traceback.format_exc())
465 logger.info('State restored successfully')
467 logger.info('Total downtime: %g seconds' % (time() - t,))
470 from jsonrpcserver import JSONRPCListener, JSONRPCServer
471 import interactivemode
472 from networkserver import NetworkListener
477 if __name__ == "__main__":
478 if not hasattr(config, 'ShareLogging'):
479 config.ShareLogging = ()
480 if hasattr(config, 'DbOptions'):
481 logging.getLogger('backwardCompatibility').warn('DbOptions configuration variable is deprecated; upgrade to ShareLogging var before 2013-03-05')
482 config.ShareLogging = list(config.ShareLogging)
483 config.ShareLogging.append( {
485 'engine': 'postgres',
486 'dbopts': config.DbOptions,
487 'statement': "insert into shares (rem_host, username, our_result, upstream_result, reason, solution) values ({Q(remoteHost)}, {username}, {YN(not(rejectReason))}, {YN(upstreamResult)}, {rejectReason}, decode({solution}, 'hex'))",
489 for i in config.ShareLogging:
490 if not hasattr(i, 'keys'):
492 logging.getLogger('backwardCompatibility').warn('Using short-term backward compatibility for ShareLogging[\'%s\']; be sure to update config before 2012-04-04' % (name,))
493 if name == 'postgres':
496 'engine': 'postgres',
497 'dbopts': parameters,
499 elif name == 'logfile':
501 i['thropts'] = parameters
502 if 'filename' in parameters:
503 i['filename'] = parameters['filename']
504 i['thropts'] = dict(i['thropts'])
505 del i['thropts']['filename']
513 fp, pathname, description = imp.find_module(name, sharelogging.__path__)
514 m = imp.load_module(name, fp, pathname, description)
515 lo = getattr(m, name)(**parameters)
516 loggersShare.append(lo.logShare)
518 logging.getLogger('sharelogging').error("Error setting up share logger %s: %s", name, sys.exc_info())
521 if not hasattr(config, 'BitcoinNodeAddresses'):
522 config.BitcoinNodeAddresses = ()
523 for a in config.BitcoinNodeAddresses:
524 LSbc.append(NetworkListener(bcnode, a))
526 if hasattr(config, 'UpstreamBitcoindNode') and config.UpstreamBitcoindNode:
527 BitcoinLink(bcnode, dest=config.UpstreamBitcoindNode)
529 import jsonrpc_getmemorypool
530 import jsonrpc_getwork
531 import jsonrpc_setworkaux
533 server = JSONRPCServer()
534 if hasattr(config, 'JSONRPCAddress'):
535 logging.getLogger('backwardCompatibility').warn('JSONRPCAddress configuration variable is deprecated; upgrade to JSONRPCAddresses list before 2013-03-05')
536 if not hasattr(config, 'JSONRPCAddresses'):
537 config.JSONRPCAddresses = []
538 config.JSONRPCAddresses.insert(0, config.JSONRPCAddress)
540 for a in config.JSONRPCAddresses:
541 LS.append(JSONRPCListener(server, a))
542 if hasattr(config, 'SecretUser'):
543 server.SecretUser = config.SecretUser
544 server.aux = MM.CoinbaseAux
545 server.getBlockHeader = getBlockHeader
546 server.getBlockTemplate = getBlockTemplate
547 server.receiveShare = receiveShare
548 server.RaiseRedFlags = RaiseRedFlags
550 if hasattr(config, 'TrustedForwarders'):
551 server.TrustedForwarders = config.TrustedForwarders
552 server.ServerName = config.ServerName
558 bcnode_thr = threading.Thread(target=bcnode.serve_forever)
559 bcnode_thr.daemon = True
562 server.serve_forever()