tadded some comments, made debug print to a file, added donation address - electrum-personal-server - Maximally lightweight electrum server for a single user
HTML git clone https://git.parazyd.org/electrum-personal-server
DIR Log
DIR Files
DIR Refs
DIR README
---
DIR commit 2c8cd9aa12ae7d5344e9ecf2c518a642f7a0da6d
DIR parent 3dcf7d7e186e9e568f2f0fb9fd686d09ebc50ae5
HTML Author: chris-belcher <chris-belcher@users.noreply.github.com>
Date: Tue, 27 Mar 2018 18:52:49 +0100
added some comments, made debug print to a file, added donation address
Diffstat:
M .gitignore | 1 +
M README.md | 23 ++++++++++++++++++++---
M server.py | 44 ++++++++++++++++++++++---------
M transactionmonitor.py | 95 ++++++++++++++++++-------------
4 files changed, 108 insertions(+), 55 deletions(-)
---
DIR diff --git a/.gitignore b/.gitignore
t@@ -1,4 +1,5 @@
*.pyc
*.swp
config.cfg
+debug.log
DIR diff --git a/README.md b/README.md
t@@ -28,6 +28,9 @@ Server would download the entire blockchain and scan it for the user's own
addresses, and therefore don't reveal to anyone else which bitcoin addresses
they are interested in.
+Before Electrum Personal Server, there was no easy way to connect a hardware
+wallet to a full node.
+
For a longer explaination of this project, see the
[mailing list email](https://lists.linuxfoundation.org/pipermail/bitcoin-dev/2018-February/015707.html)
and [bitcointalk thread](https://bitcointalk.org/index.php?topic=2664747.msg27179198). See also the Bitcoin Wiki [pages](https://en.bitcoin.it/wiki/Clearing_Up_Misconceptions_About_Full_Nodes) on [full nodes](https://en.bitcoin.it/wiki/Full_node).
t@@ -106,11 +109,25 @@ which will display the transaction as `Not Verified` in the wallet interface.
One day this may be improved on by writing new code for Bitcoin Core. See the
discussion [here](https://bitcointalk.org/index.php?topic=3167572.0).
+#### Further ideas for work
+
+* It would be cool to have a GUI front-end for this. So less technical users
+can set up a personal server helped by a GUI wizard for configuring that
+explains everything. With the rescan script built-in.
+
+* An option to broadcast transactions over tor, so that transaction broadcasting
+doesn't leak the user's IP address.
+
+* The above mentioned caveat about pruning could be improved by writing new code
+for Bitcoin Core.
+
## Contributing
-I welcome contributions. Please keep lines under 80 characters in length and
-ideally don't add any external dependencies to keep this as easy to install as
-possible.
+This is an open source project which happily accepts coding contributions from
+anyone. Please keep lines under 80 characters in length and ideally don't add
+any external dependencies to keep this as easy to install as possible.
+
+Donate to help make Electrum Personal Server even better: `bc1q5d8l0w33h65e2l5x7ty6wgnvkvlqcz0wfaslpz` or `12LMDTSTWxaUg6dGtuMCVLtr2EyEN6Jimg`.
I can be contacted on freenode IRC on the `#bitcoin` and `#electrum` channels,
or by email.
DIR diff --git a/server.py b/server.py
t@@ -1,8 +1,5 @@
#! /usr/bin/python3
-#the electrum protocol uses hash(scriptpubkey) as a key for lookups
-# as an alternative to address or scriptpubkey
-
import socket, time, json, datetime, struct, binascii, ssl, os.path, platform
import sys
from configparser import ConfigParser, NoSectionError
t@@ -14,9 +11,10 @@ ADDRESSES_LABEL = "electrum-watchonly-addresses"
VERSION_NUMBER = "0.1"
+DONATION_ADDR = "bc1q5d8l0w33h65e2l5x7ty6wgnvkvlqcz0wfaslpz"
+
BANNER = \
"""Welcome to Electrum Personal Server
-https://github.com/chris-belcher/electrum-personal-server
Monitoring {detwallets} deterministic wallets, in total {addr} addresses.
t@@ -25,23 +23,40 @@ Peers: {peers}
Uptime: {uptime}
Blocksonly: {blocksonly}
Pruning: {pruning}
+
+https://github.com/chris-belcher/electrum-personal-server
+
+Donate to help make Electrum Personal Server even better:
+{donationaddr}
+
"""
##python has demented rules for variable scope, so these
## global variables are actually mutable lists
subscribed_to_headers = [False]
bestblockhash = [None]
+debug_fd = None
#log for checking up/seeing your wallet, debug for when something has gone wrong
def debugorlog(line, ttype):
timestamp = datetime.datetime.now().strftime("%H:%M:%S,%f")
- print(timestamp + " [" + ttype + "] " + line)
+ return timestamp + " [" + ttype + "] " + line
def debug(line):
- debugorlog(line, "DEBUG")
+ global debug_fd
+ if debug_fd == None:
+ return
+ debug_fd.write(debugorlog(line, "DEBUG") + "\n")
+ debug_fd.flush()
def log(line):
- debugorlog(line, " LOG")
+ global debug_fd
+ line = debugorlog(line, " LOG")
+ print(line)
+ if debug_fd == None:
+ return
+ debug_fd.write(line + "\n")
+ debug_fd.flush()
def send_response(sock, query, result):
query["result"] = result
t@@ -62,7 +77,7 @@ def on_heartbeat_connected(sock, rpc, txmonitor):
debug("on heartbeat connected")
is_tip_updated, header = check_for_new_blockchain_tip(rpc)
if is_tip_updated:
- log("Blockchain tip updated")
+ debug("Blockchain tip updated")
if subscribed_to_headers[0]:
update = {"method": "blockchain.headers.subscribe",
"params": [header]}
t@@ -189,9 +204,10 @@ def handle_query(sock, line, rpc, txmonitor):
peers=networkinfo["connections"],
uptime=str(datetime.timedelta(seconds=uptime)),
blocksonly=not networkinfo["localrelay"],
- pruning=blockchaininfo["pruned"]))
+ pruning=blockchaininfo["pruned"],
+ donationaddr=DONATION_ADDR))
elif method == "server.donation_address":
- send_response(sock, query, "bc1q5d8l0w33h65e2l5x7ty6wgnvkvlqcz0wfaslpz")
+ send_response(sock, query, DONATION_ADDR)
elif method == "server.version":
send_response(sock, query, ["ElectrumPersonalServer "
+ VERSION_NUMBER, VERSION_NUMBER])
t@@ -230,7 +246,7 @@ def create_server_socket(hostport):
server_sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
server_sock.bind(hostport)
server_sock.listen(1)
- log("Listening on " + str(hostport))
+ log("Listening for Electrum Wallet on " + str(hostport))
return server_sock
def run_electrum_server(hostport, rpc, txmonitor, poll_interval_listening,
t@@ -371,6 +387,7 @@ def import_addresses(rpc, addrs):
for a in addr_i: #import the reminder of addresses
rpc.call("importaddress", [a, ADDRESSES_LABEL, False])
print("[100%]")
+ log("Importing done")
def obtain_rpc_username_password(datadir):
if len(datadir.strip()) == 0:
t@@ -394,6 +411,7 @@ def obtain_rpc_username_password(datadir):
return username, password
def main():
+ global debug_fd
try:
config = ConfigParser()
config.read(["config.cfg"])
t@@ -424,7 +442,7 @@ def main():
printed_error_msg = True
time.sleep(5)
- log("Starting Electrum Personal Server")
+ debug_fd = open("debug.log", "w")
import_needed, relevant_spks_addrs, deterministic_wallets = \
get_scriptpubkeys_to_monitor(rpc, config)
if import_needed:
t@@ -435,7 +453,7 @@ def main():
"rescan, just restart this script")
else:
txmonitor = transactionmonitor.TransactionMonitor(rpc,
- deterministic_wallets)
+ deterministic_wallets, debug, log)
if not txmonitor.build_address_history(relevant_spks_addrs):
return
hostport = (config.get("electrum-server", "host"),
DIR diff --git a/transactionmonitor.py b/transactionmonitor.py
t@@ -12,14 +12,29 @@ import hashes
#the electrum protocol uses sha256(scriptpubkey) as a key for lookups
# this code calls them scripthashes
+#code will generate the first address from each deterministic wallet
+# and check whether they have been imported into the bitcoin node
+# if no then initial_import_count addresses will be imported, then exit
+# if yes then initial_import_count addresses will be generated and extra
+# addresses will be generated one-by-one, each time checking whether they have
+# been imported into the bitcoin node
+# when an address has been reached that has not been imported, that means
+# we've reached the end, then rewind the deterministic wallet index by one
+
+#when a transaction happens paying to an address from a deterministic wallet
+# lookup the position of that address, if its less than gap_limit then
+# import more addresses
+
class TransactionMonitor(object):
"""
Class which monitors the bitcoind wallet for new transactions
and builds a history datastructure for sending to electrum
"""
- def __init__(self, rpc, deterministic_wallets):
+ def __init__(self, rpc, deterministic_wallets, debug, log):
self.rpc = rpc
self.deterministic_wallets = deterministic_wallets
+ self.debug = debug
+ self.log = log
self.last_known_wallet_txid = None
self.address_history = None
self.unconfirmed_txes = None
t@@ -46,7 +61,7 @@ class TransactionMonitor(object):
his["subscribed"] = False
def build_address_history(self, monitored_scriptpubkeys):
- s.log("Building history with " + str(len(monitored_scriptpubkeys)) +
+ self.log("Building history with " + str(len(monitored_scriptpubkeys)) +
" addresses")
st = time.time()
address_history = {}
t@@ -66,7 +81,7 @@ class TransactionMonitor(object):
obtained_txids = set()
while len(ret) == BATCH_SIZE:
ret = self.rpc.call("listtransactions", ["*", BATCH_SIZE, t, True])
- s.debug("listtransactions skip=" + str(t) + " len(ret)="
+ self.debug("listtransactions skip=" + str(t) + " len(ret)="
+ str(len(ret)))
t += len(ret)
for tx in ret:
t@@ -76,7 +91,7 @@ class TransactionMonitor(object):
continue
if tx["txid"] in obtained_txids:
continue
- s.debug("adding obtained tx=" + str(tx["txid"]))
+ self.debug("adding obtained tx=" + str(tx["txid"]))
obtained_txids.add(tx["txid"])
#obtain all the addresses this transaction is involved with
t@@ -97,8 +112,8 @@ class TransactionMonitor(object):
overrun_depths = wal.have_scriptpubkeys_overrun_gaplimit(
output_scriptpubkeys)
if overrun_depths != None:
- s.log("ERROR: Not enough addresses imported.")
- s.log("Delete wallet.dat and increase the value " +
+ self.log("ERROR: Not enough addresses imported.")
+ self.log("Delete wallet.dat and increase the value " +
"of `initial_import_count` in the file " +
"`config.cfg` then reimport and rescan")
#TODO make it so users dont have to delete wallet.dat
t@@ -119,18 +134,19 @@ class TransactionMonitor(object):
unconfirmed_txes[u["tx_hash"]].append(scrhash)
else:
unconfirmed_txes[u["tx_hash"]] = [scrhash]
- s.debug("unconfirmed_txes = " + str(unconfirmed_txes))
+ self.debug("unconfirmed_txes = " + str(unconfirmed_txes))
if len(ret) > 0:
#txid doesnt uniquely identify transactions from listtransactions
#but the tuple (txid, address) does
self.last_known_wallet_txid = (ret[-1]["txid"], ret[-1]["address"])
else:
self.last_known_wallet_txid = None
- s.debug("last_known_wallet_txid = " + str(self.last_known_wallet_txid))
+ self.debug("last_known_wallet_txid = " + str(
+ self.last_known_wallet_txid))
et = time.time()
- s.debug("address_history =\n" + pprint.pformat(address_history))
- s.log("Found " + str(count) + " txes. History built in " +
+ self.debug("address_history =\n" + pprint.pformat(address_history))
+ self.log("Found " + str(count) + " txes. History built in " +
str(et - st) + "sec")
self.address_history = address_history
self.unconfirmed_txes = unconfirmed_txes
t@@ -165,13 +181,13 @@ class TransactionMonitor(object):
utxo = self.rpc.call("gettxout", [inn["txid"], inn["vout"],
False])
if utxo is None:
- s.debug("utxo not found(!)")
+ self.debug("utxo not found(!)")
#TODO detect this and figure out how to tell
# electrum that we dont know the fee
total_input_value += int(Decimal(utxo["value"]) * Decimal(1e8))
unconfirmed_input = (unconfirmed_input or
utxo["confirmations"] == 0)
- s.debug("total_input_value = " + str(total_input_value))
+ self.debug("total_input_value = " + str(total_input_value))
fee = total_input_value - sum([int(Decimal(out["value"])
* Decimal(1e8)) for out in txd["vout"]])
t@@ -207,27 +223,25 @@ class TransactionMonitor(object):
his = self.address_history[ush]
self.sort_address_history_list(his)
if len(updated_scrhashes) > 0:
- s.debug("new tx address_history =\n"
+ self.debug("new tx address_history =\n"
+ pprint.pformat(self.address_history))
- s.debug("unconfirmed txes = " +
+ self.debug("unconfirmed txes = " +
pprint.pformat(self.unconfirmed_txes))
- s.debug("updated_scripthashes = " + str(updated_scrhashes))
- else:
- s.debug("no updated txes")
+ self.debug("updated_scripthashes = " + str(updated_scrhashes))
updated_scrhashes = filter(lambda sh:self.address_history[sh][
"subscribed"], updated_scrhashes)
return updated_scrhashes
def check_for_confirmations(self):
confirmed_txes_scrhashes = []
- s.debug("check4con unconfirmed_txes = "
+ self.debug("check4con unconfirmed_txes = "
+ pprint.pformat(self.unconfirmed_txes))
for uc_txid, scrhashes in self.unconfirmed_txes.items():
tx = self.rpc.call("gettransaction", [uc_txid])
- s.debug("uc_txid=" + uc_txid + " => " + str(tx))
+ self.debug("uc_txid=" + uc_txid + " => " + str(tx))
if tx["confirmations"] == 0:
continue #still unconfirmed
- s.log("A transaction confirmed: " + uc_txid)
+ self.log("A transaction confirmed: " + uc_txid)
confirmed_txes_scrhashes.append((uc_txid, scrhashes))
block = self.rpc.call("getblockheader", [tx["blockhash"]])
for scrhash in scrhashes:
t@@ -250,7 +264,7 @@ class TransactionMonitor(object):
tx_request_count = 2
max_attempts = int(math.log(MAX_TX_REQUEST_COUNT, 2))
for i in range(max_attempts):
- s.debug("listtransactions tx_request_count="
+ self.debug("listtransactions tx_request_count="
+ str(tx_request_count))
ret = self.rpc.call("listtransactions", ["*", tx_request_count, 0,
True])
t@@ -270,18 +284,17 @@ class TransactionMonitor(object):
#TODO low priority: handle a user getting more than 255 new
# transactions in 15 seconds
- s.debug("recent tx index = " + str(recent_tx_index) + " ret = " +
- str(ret))
- # str([(t["txid"], t["address"]) for t in ret]))
+ self.debug("recent tx index = " + str(recent_tx_index) + " ret = " +
+ str([(t["txid"], t["address"]) for t in ret]))
if len(ret) > 0:
self.last_known_wallet_txid = (ret[0]["txid"], ret[0]["address"])
- s.debug("last_known_wallet_txid = " + str(
+ self.debug("last_known_wallet_txid = " + str(
self.last_known_wallet_txid))
assert(recent_tx_index != -1)
if recent_tx_index == 0:
return set()
new_txes = ret[:recent_tx_index][::-1]
- s.debug("new txes = " + str(new_txes))
+ self.debug("new txes = " + str(new_txes))
obtained_txids = set()
updated_scripthashes = []
for tx in new_txes:
t@@ -313,13 +326,13 @@ class TransactionMonitor(object):
spk)] = {'history': [], 'subscribed': False}
new_addrs = [hashes.script_to_address(s, self.rpc)
for s in spks]
- s.debug("importing " + str(len(spks)) + " into change="
- + str(change))
+ self.debug("importing " + str(len(spks)) +
+ " into change=" + str(change))
s.import_addresses(self.rpc, new_addrs)
updated_scripthashes.extend(matching_scripthashes)
new_history_element = self.generate_new_history_element(tx, txd)
- s.log("Found new tx: " + str(new_history_element))
+ self.log("Found new tx: " + str(new_history_element))
for scrhash in matching_scripthashes:
self.address_history[scrhash]["history"].append(
new_history_element)
t@@ -405,6 +418,8 @@ def assert_address_history_tx(address_history, spk, height, txid, subscribed):
assert history_element["subscribed"] == subscribed
def test():
+ debugf = lambda x: x
+ logf = lambda x: x
#empty deterministic wallets
deterministic_wallets = [TestDeterministicWallet()]
test_spk1 = "deadbeefdeadbeefdeadbeefdeadbeef"
t@@ -435,7 +450,7 @@ def test():
###single confirmed tx in wallet belonging to us, address history built
rpc = TestJsonRpc([test_paying_in_tx1], [],
{test_containing_block1: 420000})
- txmonitor1 = TransactionMonitor(rpc, deterministic_wallets)
+ txmonitor1 = TransactionMonitor(rpc, deterministic_wallets, debugf, logf)
assert txmonitor1.build_address_history([test_spk1])
assert len(txmonitor1.address_history) == 1
assert_address_history_tx(txmonitor1.address_history, spk=test_spk1,
t@@ -445,7 +460,7 @@ def test():
rpc = TestJsonRpc([test_paying_in_tx1, test_paying_in_tx2], [],
{test_containing_block1: 1, test_containing_block2: 2})
deterministic_wallets = [TestDeterministicWallet()]
- txmonitor2 = TransactionMonitor(rpc, deterministic_wallets)
+ txmonitor2 = TransactionMonitor(rpc, deterministic_wallets, debugf, logf)
assert txmonitor2.build_address_history([test_spk1, test_spk2])
assert len(txmonitor2.address_history) == 2
assert_address_history_tx(txmonitor2.address_history, spk=test_spk1,
t@@ -471,7 +486,7 @@ def test():
}
rpc = TestJsonRpc([test_paying_in_tx3], [input_utxo3],
{test_containing_block3: 10})
- txmonitor3 = TransactionMonitor(rpc, deterministic_wallets)
+ txmonitor3 = TransactionMonitor(rpc, deterministic_wallets, debugf, logf)
assert txmonitor3.build_address_history([test_spk3])
assert len(txmonitor3.address_history) == 1
assert_address_history_tx(txmonitor3.address_history, spk=test_spk3,
t@@ -500,7 +515,7 @@ def test():
"hex": "placeholder-test-txhex4"
}
rpc = TestJsonRpc([], [input_utxo4], {test_containing_block4: 10})
- txmonitor4 = TransactionMonitor(rpc, deterministic_wallets)
+ txmonitor4 = TransactionMonitor(rpc, deterministic_wallets, debugf, logf)
assert txmonitor4.build_address_history([test_spk4])
assert len(txmonitor4.address_history) == 1
sh4 = hashes.script_to_scripthash(test_spk4)
t@@ -533,7 +548,7 @@ def test():
}
test_spk5_1 = "deadbeefdeadbeefcc"
rpc = TestJsonRpc([test_paying_in_tx5], [], {test_containing_block4: 10})
- txmonitor5 = TransactionMonitor(rpc, deterministic_wallets)
+ txmonitor5 = TransactionMonitor(rpc, deterministic_wallets, debugf, logf)
assert txmonitor5.build_address_history([test_spk5_1])
assert len(txmonitor5.address_history) == 1
assert len(txmonitor5.get_electrum_history(hashes.script_to_scripthash(
t@@ -563,7 +578,7 @@ def test():
"hex": "placeholder-test-txhex6"
}
rpc = TestJsonRpc([test_paying_in_tx6], [], {test_containing_block6: 10})
- txmonitor6 = TransactionMonitor(rpc, deterministic_wallets)
+ txmonitor6 = TransactionMonitor(rpc, deterministic_wallets, debugf, logf)
assert txmonitor6.build_address_history([test_spk6])
sh = hashes.script_to_scripthash(test_spk6)
assert len(txmonitor6.get_electrum_history(sh)) == 1
t@@ -598,7 +613,7 @@ def test():
}
rpc = TestJsonRpc([test_input_tx7, test_paying_from_tx7], [],
{test_containing_block7: 9, test_input_containing_block7: 8})
- txmonitor7 = TransactionMonitor(rpc, deterministic_wallets)
+ txmonitor7 = TransactionMonitor(rpc, deterministic_wallets, debugf, logf)
assert txmonitor7.build_address_history([test_spk7])
sh = hashes.script_to_scripthash(test_spk7)
assert len(txmonitor7.get_electrum_history(sh)) == 2
t@@ -630,7 +645,7 @@ def test():
}
rpc = TestJsonRpc([test_input_tx8, test_paying_from_tx8], [],
{test_containing_block8: 9, test_input_containing_block8: 8})
- txmonitor8 = TransactionMonitor(rpc, deterministic_wallets)
+ txmonitor8 = TransactionMonitor(rpc, deterministic_wallets, debugf, logf)
assert txmonitor8.build_address_history([test_spk8, test_spk8_1])
assert len(txmonitor8.get_electrum_history(hashes.script_to_scripthash(
test_spk8))) == 2
t@@ -662,7 +677,8 @@ def test():
return [test_spk9_imported]
rpc = TestJsonRpc([], [], {test_containing_block9: 10})
- txmonitor9 = TransactionMonitor(rpc, [TestImportDeterministicWallet()])
+ txmonitor9 = TransactionMonitor(rpc, [TestImportDeterministicWallet()],
+ debugf, logf)
assert txmonitor9.build_address_history([test_spk9])
assert len(txmonitor9.address_history) == 1
assert len(list(txmonitor9.check_for_updated_txes())) == 0
t@@ -675,7 +691,8 @@ def test():
assert len(txmonitor9.get_electrum_history(hashes.script_to_scripthash(
test_spk9_imported))) == 0
assert len(rpc.get_imported_addresses()) == 1
- assert rpc.get_imported_addresses()[0] == test_spk_to_address(test_spk9_imported)
+ assert rpc.get_imported_addresses()[0] == test_spk_to_address(
+ test_spk9_imported)
#other possible stuff to test:
#finding confirmed and unconfirmed tx, in that order, then both confirm