3 # Electrum - lightweight Bitcoin client
4 # Copyright (C) 2011 thomasv@gitorious
6 # This program is free software: you can redistribute it and/or modify
7 # it under the terms of the GNU General Public License as published by
8 # the Free Software Foundation, either version 3 of the License, or
9 # (at your option) any later version.
11 # This program is distributed in the hope that it will be useful,
12 # but WITHOUT ANY WARRANTY; without even the implied warranty of
13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 # GNU General Public License for more details.
16 # You should have received a copy of the GNU General Public License
17 # along with this program. If not, see <http://www.gnu.org/licenses/>.
28 from util import print_msg, print_error
34 from transaction import Transaction
35 from plugins import run_hook
37 from synchronizer import WalletSynchronizer
39 COINBASE_MATURITY = 500
42 # internal ID for imported account
43 IMPORTED_ACCOUNT = '/x'
46 class WalletStorage(object):
48 def __init__(self, config):
49 self.lock = threading.RLock()
52 self.file_exists = False
53 self.path = self.init_path(config)
54 print_error( "wallet path", self.path )
58 def init_path(self, config):
59 """Set the path of the wallet."""
61 # command line -w option
62 path = config.get('wallet_path')
67 path = config.get('default_wallet_path')
72 dirpath = os.path.join(config.path, "wallets")
73 if not os.path.exists(dirpath):
76 new_path = os.path.join(config.path, "wallets", "default_wallet")
78 # default path in pre 1.9 versions
79 old_path = os.path.join(config.path, "electrum-nvc.dat")
80 if os.path.exists(old_path) and not os.path.exists(new_path):
81 os.rename(old_path, new_path)
86 """Read the contents of the wallet file."""
88 with open(self.path, "r") as f:
93 d = ast.literal_eval( data ) #parse raw data from reading wallet file
95 raise IOError("Cannot read wallet file.")
98 self.file_exists = True
100 def get(self, key, default=None):
103 v = self.data.get(key)
108 def put(self, key, value, save = True):
111 if value is not None:
112 self.data[key] = value
113 elif key in self.data:
120 f = open(self.path,"w")
123 if 'ANDROID_DATA' not in os.environ:
125 os.chmod(self.path,stat.S_IREAD | stat.S_IWRITE)
128 class Abstract_Wallet(object):
130 Wallet classes are created to handle various address generation methods.
131 Completion states (watching-only, single account, no seed, etc) are handled inside classes.
133 def __init__(self, storage):
134 self.storage = storage
135 self.electrum_version = ELECTRUM_VERSION
136 self.gap_limit_for_change = 3 # constant
138 self.seed_version = storage.get('seed_version', NEW_SEED_VERSION)
139 self.gap_limit = storage.get('gap_limit', 5)
140 self.use_change = storage.get('use_change',True)
141 self.use_encryption = storage.get('use_encryption', False)
142 self.seed = storage.get('seed', '') # encrypted
143 self.labels = storage.get('labels', {})
144 self.frozen_addresses = storage.get('frozen_addresses',[])
145 self.addressbook = storage.get('contacts', [])
147 self.history = storage.get('addr_history',{}) # address -> list(txid, height)
149 self.fee = int(storage.get('fee_per_kb', 1000))
151 self.next_addresses = storage.get('next_addresses',{})
153 # This attribute is set when wallet.start_threads is called.
154 self.synchronizer = None
156 # imported_keys is deprecated. The GUI should call convert_imported_keys
157 self.imported_keys = self.storage.get('imported_keys',{})
161 self.load_transactions()
164 self.prevout_values = {} # my own transaction outputs
165 self.spent_outputs = []
168 # there is a difference between wallet.up_to_date and interface.is_up_to_date()
169 # interface.is_up_to_date() returns true when all requests have been answered and processed
170 # wallet.up_to_date is true when the wallet is synchronized (stronger requirement)
171 self.up_to_date = False
172 self.lock = threading.Lock()
173 self.transaction_lock = threading.Lock()
174 self.tx_event = threading.Event()
175 for tx_hash, tx in self.transactions.items():
176 self.update_tx_outputs(tx_hash)
178 def load_transactions(self):
179 self.transactions = {}
180 tx_list = self.storage.get('transactions',{})
181 for k, raw in tx_list.items():
183 tx = Transaction.deserialize(raw)
185 print_msg("Warning: Cannot deserialize transactions. skipping")
187 self.add_pubkey_addresses(tx)
188 self.transactions[k] = tx
189 for h,tx in self.transactions.items():
190 if not self.check_new_tx(h, tx):
191 print_error("removing unreferenced tx", h)
192 self.transactions.pop(h)
194 def add_pubkey_addresses(self, tx):
195 # find the address corresponding to pay-to-pubkey inputs
199 tx.add_pubkey_addresses(self.transactions)
201 # outputs of tx: inputs of tx2
202 for type, x, v in tx.outputs:
204 for tx2 in self.transactions.values():
205 tx2.add_pubkey_addresses({h:tx})
207 def get_action(self):
210 def convert_imported_keys(self, password):
211 for k, v in self.imported_keys.items():
212 sec = pw_decode(v, password)
213 pubkey = public_key_from_private_key(sec)
214 address = public_key_to_bc_address(pubkey.decode('hex'))
216 self.import_key(sec, password)
217 self.imported_keys.pop(k)
218 self.storage.put('imported_keys', self.imported_keys)
220 def load_accounts(self):
223 d = self.storage.get('accounts', {})
224 for k, v in d.items():
226 v['mpk'] = self.storage.get('master_public_key')
227 self.accounts[k] = OldAccount(v)
228 elif v.get('imported'):
229 self.accounts[k] = ImportedAccount(v)
231 self.accounts[k] = BIP32_Account_2of3(v)
233 self.accounts[k] = BIP32_Account_2of2(v)
235 self.accounts[k] = BIP32_Account(v)
236 elif v.get('pending'):
237 self.accounts[k] = PendingAccount(v)
239 print_error("cannot load account", v)
241 def synchronize(self):
244 def can_create_accounts(self):
247 def set_up_to_date(self,b):
248 with self.lock: self.up_to_date = b
250 def is_up_to_date(self):
251 with self.lock: return self.up_to_date
254 self.up_to_date = False
255 while not self.is_up_to_date():
258 def is_imported(self, addr):
259 account = self.accounts.get(IMPORTED_ACCOUNT)
261 return addr in account.get_addresses(0)
265 def has_imported_keys(self):
266 account = self.accounts.get(IMPORTED_ACCOUNT)
267 return account is not None
269 def import_key(self, sec, password):
271 pubkey = public_key_from_private_key(sec)
272 address = public_key_to_bc_address(pubkey.decode('hex'))
274 raise Exception('Invalid private key')
276 if self.is_mine(address):
277 raise Exception('Address already in wallet')
279 if self.accounts.get(IMPORTED_ACCOUNT) is None:
280 self.accounts[IMPORTED_ACCOUNT] = ImportedAccount({'imported':{}})
281 self.accounts[IMPORTED_ACCOUNT].add(address, pubkey, sec, password)
284 if self.synchronizer:
285 self.synchronizer.subscribe_to_addresses([address])
288 def delete_imported_key(self, addr):
289 account = self.accounts[IMPORTED_ACCOUNT]
291 if not account.get_addresses(0):
292 self.accounts.pop(IMPORTED_ACCOUNT)
295 def set_label(self, name, text = None):
297 old_text = self.labels.get(name)
300 self.labels[name] = text
304 self.labels.pop(name)
308 self.storage.put('labels', self.labels, True)
310 run_hook('set_label', name, text, changed)
313 def addresses(self, include_change = True, _next=True):
315 for a in self.accounts.keys():
316 o += self.get_account_addresses(a, include_change)
319 for addr in self.next_addresses.values():
324 def is_mine(self, address):
325 return address in self.addresses(True)
327 def is_change(self, address):
328 if not self.is_mine(address): return False
329 acct, s = self.get_address_index(address)
330 if s is None: return False
333 def get_address_index(self, address):
334 for account in self.accounts.keys():
335 for for_change in [0,1]:
336 addresses = self.accounts[account].get_addresses(for_change)
337 for addr in addresses:
339 return account, (for_change, addresses.index(addr))
341 for k,v in self.next_addresses.items():
345 raise Exception("Address not found", address)
347 def get_private_key(self, address, password):
348 if self.is_watching_only():
350 account_id, sequence = self.get_address_index(address)
351 return self.accounts[account_id].get_private_key(sequence, self, password)
353 def get_public_keys(self, address):
354 account_id, sequence = self.get_address_index(address)
355 return self.accounts[account_id].get_pubkeys(*sequence)
357 def add_keypairs(self, tx, keypairs, password):
358 # first check the provided password. This will raise if invalid.
359 self.check_password(password)
361 addr_list, xpub_list = tx.inputs_to_sign()
362 for addr in addr_list:
363 if self.is_mine(addr):
364 private_keys = self.get_private_key(addr, password)
365 for sec in private_keys:
366 pubkey = public_key_from_private_key(sec)
367 keypairs[ pubkey ] = sec
369 for xpub, sequence in xpub_list:
370 # look for account that can sign
371 for k, account in self.accounts.items():
372 if xpub in account.get_master_pubkeys():
376 pk = account.get_private_key(sequence, self, password)
378 pubkey = public_key_from_private_key(sec)
379 keypairs[pubkey] = sec
381 def signrawtransaction(self, tx, private_keys, password):
382 # check that the password is correct. This will raise if it's not.
383 self.check_password(password)
384 # build a list of public/private keys
386 # add private keys from parameter
387 for sec in private_keys:
388 pubkey = public_key_from_private_key(sec)
389 keypairs[ pubkey ] = sec
391 self.add_keypairs(tx, keypairs, password)
392 # sign the transaction
393 self.sign_transaction(tx, keypairs, password)
395 def sign_message(self, address, message, password):
396 keys = self.get_private_key(address, password)
397 assert len(keys) == 1
399 key = regenerate_key(sec)
400 compressed = is_compressed(sec)
401 return key.sign_message(message, compressed, address)
403 def decrypt_message(self, pubkey, message, password):
404 address = public_key_to_bc_address(pubkey.decode('hex'))
405 keys = self.get_private_key(address, password)
407 ec = regenerate_key(secret)
408 decrypted = ec.decrypt_message(message)
412 return self.history.values() != [[]] * len(self.history)
414 def add_contact(self, address, label=None):
415 self.addressbook.append(address)
416 self.storage.put('contacts', self.addressbook, True)
418 self.set_label(address, label)
420 def delete_contact(self, addr):
421 if addr in self.addressbook:
422 self.addressbook.remove(addr)
423 self.storage.put('addressbook', self.addressbook, True)
425 def fill_addressbook(self):
426 for tx_hash, tx in self.transactions.items():
427 is_relevant, is_send, _, _ = self.get_tx_value(tx)
429 for addr in tx.get_output_addresses():
430 if not self.is_mine(addr) and addr not in self.addressbook:
431 self.addressbook.append(addr)
433 # self.update_tx_labels()
435 def get_num_tx(self, address):
437 for tx in self.transactions.values():
438 if address in tx.get_output_addresses(): n += 1
441 def get_tx_value(self, tx, account=None):
442 domain = self.get_account_addresses(account)
443 return tx.get_value(domain, self.prevout_values)
445 def update_tx_outputs(self, tx_hash):
446 tx = self.transactions.get(tx_hash)
448 for i, (type, addr, value) in enumerate(tx.get_outputs()):
449 key = tx_hash+ ':%d'%i
450 self.prevout_values[key] = value
452 for item in tx.inputs:
453 if self.is_mine(item.get('address')):
454 key = item['prevout_hash'] + ':%d'%item['prevout_n']
455 self.spent_outputs.append(key)
457 def get_addr_balance(self, address):
458 #assert self.is_mine(address)
459 h = self.history.get(address,[])
460 if h == ['*']: return 0,0
462 received_coins = [] # list of coins received at address
464 for tx_hash, tx_height in h:
465 tx = self.transactions.get(tx_hash)
468 for i, (type, addr, value) in enumerate(tx.get_outputs()):
470 key = tx_hash + ':%d'%i
471 received_coins.append(key)
473 for tx_hash, tx_height in h:
474 tx = self.transactions.get(tx_hash)
478 for item in tx.inputs:
479 addr = item.get('address')
481 key = item['prevout_hash'] + ':%d'%item['prevout_n']
482 value = self.prevout_values.get( key )
483 if key in received_coins:
486 for i, (type, addr, value) in enumerate(tx.get_outputs()):
487 key = tx_hash + ':%d'%i
497 def get_account_name(self, k):
498 return self.labels.get(k, self.accounts[k].get_name(k))
500 def get_account_names(self):
502 for k in self.accounts.keys():
503 account_names[k] = self.get_account_name(k)
506 def get_account_addresses(self, a, include_change=True):
508 o = self.addresses(include_change)
509 elif a in self.accounts:
510 ac = self.accounts[a]
511 o = ac.get_addresses(0)
512 if include_change: o += ac.get_addresses(1)
515 def get_account_balance(self, account):
516 return self.get_balance(self.get_account_addresses(account))
518 def get_frozen_balance(self):
519 return self.get_balance(self.frozen_addresses)
521 def get_balance(self, domain=None):
522 if domain is None: domain = self.addresses(True)
525 c, u = self.get_addr_balance(addr)
530 def get_unspent_coins(self, domain=None):
532 if domain is None: domain = self.addresses(True)
534 h = self.history.get(addr, [])
535 if h == ['*']: continue
536 for tx_hash, tx_height in h:
537 tx = self.transactions.get(tx_hash)
538 if tx is None: raise Exception("Wallet not synchronized")
539 outputs = tx.get_outputs()
541 is_coinbase = tx.inputs[0].get('prevout_hash') == '0'*64
542 is_coinstake = outputs[0][2] == 0
546 for i, (type, address, value) in enumerate(outputs):
547 output = {'address':address, 'value':value, 'prevout_n':i}
548 if address != addr: continue
549 key = tx_hash + ":%d"%i
550 if key in self.spent_outputs: continue
551 output['prevout_hash'] = tx_hash
552 output['height'] = tx_height
553 output['coinbase'] = is_coinbase
554 output['coinstake'] = is_coinstake
555 output["type"] = type
556 coins.append((tx_height, output))
560 coins = sorted(coins)
561 if coins[-1][0] != 0:
562 while coins[0][0] == 0:
563 coins = coins[1:] + [ coins[0] ]
564 return [x[1] for x in coins]
566 def choose_tx_inputs( self, amount, fixed_fee, num_outputs, domain = None, coins = None ):
567 """ todo: minimize tx size """
569 fee = self.fee if fixed_fee is None else fixed_fee
573 domain = self.addresses(True)
574 for i in self.frozen_addresses:
575 if i in domain: domain.remove(i)
576 coins = self.get_unspent_coins(domain)
581 if (item.get('coinbase') or item.get('coinstake')) and item.get('height') + COINBASE_MATURITY > self.network.get_local_height():
583 v = item.get('value')
586 fee = self.estimated_fee(inputs, num_outputs) if fixed_fee is None else fixed_fee
587 if total >= amount + fee: break
591 return inputs, total, fee
593 def set_fee(self, fee):
596 self.storage.put('fee_per_kb', self.fee, True)
598 def estimated_fee(self, inputs, num_outputs):
599 estimated_size = len(inputs) * 180 + num_outputs * 34 # this assumes non-compressed keys
600 fee = self.fee * int(math.ceil(estimated_size/1000.))
603 def add_tx_change( self, inputs, outputs, amount, fee, total, change_addr=None):
604 "add change to a transaction"
605 change_amount = total - ( amount + fee )
606 if change_amount > DUST_THRESHOLD:
609 # send change to one of the accounts involved in the tx
610 address = inputs[0].get('address')
611 account, _ = self.get_address_index(address)
613 if not self.use_change or account == IMPORTED_ACCOUNT:
614 change_addr = inputs[-1]['address']
616 change_addr = self.accounts[account].get_addresses(1)[-self.gap_limit_for_change]
618 # Insert the change output at a random position in the outputs
619 posn = random.randint(0, len(outputs))
620 outputs[posn:posn] = [( 'address', change_addr, change_amount)]
623 def get_history(self, address):
625 return self.history.get(address)
627 def get_status(self, h):
628 if not h: return None
629 if h == ['*']: return '*'
631 for tx_hash, height in h:
632 status += tx_hash + ':%d:' % height
633 return hashlib.sha256( status ).digest().encode('hex')
635 def receive_tx_callback(self, tx_hash, tx, tx_height):
637 with self.transaction_lock:
638 self.add_pubkey_addresses(tx)
639 if not self.check_new_tx(tx_hash, tx):
640 # may happen due to pruning
641 print_error("received transaction that is no longer referenced in history", tx_hash)
643 self.transactions[tx_hash] = tx
644 self.network.pending_transactions_for_notifications.append(tx)
645 self.save_transactions()
646 if self.verifier and tx_height>0:
647 self.verifier.add(tx_hash, tx_height)
648 self.update_tx_outputs(tx_hash)
650 def save_transactions(self):
652 for k,v in self.transactions.items():
654 self.storage.put('transactions', tx, True)
656 def receive_history_callback(self, addr, hist):
658 if not self.check_new_history(addr, hist):
659 raise Exception("error: received history for %s is not consistent with known transactions"%addr)
662 self.history[addr] = hist
663 self.storage.put('addr_history', self.history, True)
666 for tx_hash, tx_height in hist:
668 # add it in case it was previously unconfirmed
669 if self.verifier: self.verifier.add(tx_hash, tx_height)
671 def get_tx_history(self, account=None):
672 if not self.verifier:
675 with self.transaction_lock:
676 history = self.transactions.items()
677 history.sort(key = lambda x: self.verifier.get_txpos(x[0]))
681 for tx_hash, tx in history:
682 is_relevant, is_mine, v, fee = self.get_tx_value(tx, account)
683 if v is not None: balance += v
685 c, u = self.get_account_balance(account)
688 result.append( ('', 1000, 0, c+u-balance, None, c+u-balance, None ) )
690 balance = c + u - balance
691 for tx_hash, tx in history:
692 is_relevant, is_mine, value, fee = self.get_tx_value(tx, account)
695 if value is not None:
698 conf, timestamp = self.verifier.get_confirmations(tx_hash) if self.verifier else (None, None)
699 result.append( (tx_hash, conf, is_mine, value, fee, balance, timestamp) )
703 def get_label(self, tx_hash):
704 label = self.labels.get(tx_hash)
705 is_default = (label == '') or (label is None)
706 if is_default: label = self.get_default_label(tx_hash)
707 return label, is_default
709 def get_default_label(self, tx_hash):
710 tx = self.transactions.get(tx_hash)
713 is_relevant, is_mine, _, _ = self.get_tx_value(tx)
715 for o_addr in tx.get_output_addresses():
716 if not self.is_mine(o_addr):
718 default_label = self.labels[o_addr]
720 default_label = '>' + o_addr
723 default_label = '(internal)'
725 for o_addr in tx.get_output_addresses():
726 if self.is_mine(o_addr) and not self.is_change(o_addr):
729 for o_addr in tx.get_output_addresses():
730 if self.is_mine(o_addr):
737 default_label = self.labels[o_addr]
739 default_label = '<' + o_addr
743 def make_unsigned_transaction(self, outputs, fee=None, change_addr=None, domain=None, coins=None ):
744 for type, address, x in outputs:
745 if type == 'op_return':
747 if type == 'address':
748 assert is_address(address), "Address " + address + " is invalid!"
749 amount = sum( map(lambda x:x[2], outputs) )
750 inputs, total, fee = self.choose_tx_inputs( amount, fee, len(outputs), domain, coins )
752 raise ValueError("Not enough funds")
754 self.add_input_info(txin)
755 outputs = self.add_tx_change(inputs, outputs, amount, fee, total, change_addr)
756 return Transaction(int(time.time()), inputs, outputs)
758 def mktx(self, outputs, password, fee=None, change_addr=None, domain= None, coins = None ):
759 tx = self.make_unsigned_transaction(outputs, fee, change_addr, domain, coins)
761 self.add_keypairs(tx, keypairs, password)
763 self.sign_transaction(tx, keypairs, password)
766 def add_input_info(self, txin):
767 address = txin['address']
768 account_id, sequence = self.get_address_index(address)
769 account = self.accounts[account_id]
770 redeemScript = account.redeem_script(*sequence)
771 pubkeys = account.get_pubkeys(*sequence)
772 x_pubkeys = account.get_xpubkeys(*sequence)
773 # sort pubkeys and x_pubkeys, using the order of pubkeys
774 pubkeys, x_pubkeys = zip( *sorted(zip(pubkeys, x_pubkeys)))
775 txin['pubkeys'] = list(pubkeys)
776 txin['x_pubkeys'] = list(x_pubkeys)
777 txin['signatures'] = [None] * len(pubkeys)
780 txin['redeemScript'] = redeemScript
783 txin['redeemPubkey'] = account.get_pubkey(*sequence)
786 def sign_transaction(self, tx, keypairs, password):
788 run_hook('sign_transaction', tx, password)
790 def sendtx(self, tx):
794 return self.receive_tx(h, tx)
796 def send_tx(self, tx):
798 self.tx_event.clear()
799 self.network.send([('blockchain.transaction.broadcast', [str(tx)])], self.on_broadcast)
802 def on_broadcast(self, i, r):
803 self.tx_result = r.get('result')
806 def receive_tx(self, tx_hash, tx):
809 return False, "error: " + out
810 run_hook('receive_tx', tx, self)
813 def update_password(self, old_password, new_password):
814 if new_password == '':
818 decoded = self.get_seed(old_password)
819 self.seed = pw_encode( decoded, new_password)
820 self.storage.put('seed', self.seed, True)
822 imported_account = self.accounts.get(IMPORTED_ACCOUNT)
824 imported_account.update_password(old_password, new_password)
827 if hasattr(self, 'master_private_keys'):
828 for k, v in self.master_private_keys.items():
829 b = pw_decode(v, old_password)
830 c = pw_encode(b, new_password)
831 self.master_private_keys[k] = c
832 self.storage.put('master_private_keys', self.master_private_keys, True)
834 self.use_encryption = (new_password != None)
835 self.storage.put('use_encryption', self.use_encryption,True)
837 def freeze(self,addr):
838 if self.is_mine(addr) and addr not in self.frozen_addresses:
839 self.frozen_addresses.append(addr)
840 self.storage.put('frozen_addresses', self.frozen_addresses, True)
845 def unfreeze(self,addr):
846 if self.is_mine(addr) and addr in self.frozen_addresses:
847 self.frozen_addresses.remove(addr)
848 self.storage.put('frozen_addresses', self.frozen_addresses, True)
853 def set_verifier(self, verifier):
854 self.verifier = verifier
856 # review transactions that are in the history
857 for addr, hist in self.history.items():
858 if hist == ['*']: continue
859 for tx_hash, tx_height in hist:
861 # add it in case it was previously unconfirmed
862 self.verifier.add(tx_hash, tx_height)
864 # if we are on a pruning server, remove unverified transactions
865 vr = self.verifier.transactions.keys() + self.verifier.verified_tx.keys()
866 for tx_hash in self.transactions.keys():
867 if tx_hash not in vr:
868 self.transactions.pop(tx_hash)
870 def check_new_history(self, addr, hist):
871 # check that all tx in hist are relevant
873 for tx_hash, height in hist:
874 tx = self.transactions.get(tx_hash)
876 if not tx.has_address(addr):
879 # check that we are not "orphaning" a transaction
880 old_hist = self.history.get(addr,[])
881 if old_hist == ['*']: return True
883 for tx_hash, height in old_hist:
884 if tx_hash in map(lambda x:x[0], hist): continue
886 for _addr, _hist in self.history.items():
887 if _addr == addr: continue
888 if _hist == ['*']: continue
889 _tx_hist = map(lambda x:x[0], _hist)
890 if tx_hash in _tx_hist:
895 tx = self.transactions.get(tx_hash)
896 # tx might not be there
900 if self.verifier.get_height(tx_hash):
903 print_error("new history is orphaning transaction:", tx_hash)
904 # check that all outputs are not mine, request histories
906 for _addr in tx.get_output_addresses():
907 # assert not self.is_mine(_addr)
908 ext_requests.append( ('blockchain.address.get_history', [_addr]) )
910 ext_h = self.network.synchronous_get(ext_requests)
911 print_error("sync:", ext_requests, ext_h)
914 if h == ['*']: continue
916 if item.get('tx_hash') == tx_hash:
917 height = item.get('height')
919 print_error("found height for", tx_hash, height)
920 self.verifier.add(tx_hash, height)
922 print_error("removing orphaned tx from history", tx_hash)
923 self.transactions.pop(tx_hash)
927 def check_new_tx(self, tx_hash, tx):
928 # 1 check that tx is referenced in addr_history.
930 for addr, hist in self.history.items():
931 if hist == ['*']:continue
932 for txh, height in hist:
934 addresses.append(addr)
939 # 2 check that referencing addresses are in the tx
940 for addr in addresses:
941 if not tx.has_address(addr):
946 def start_threads(self, network):
947 from verifier import TxVerifier
948 self.network = network
949 if self.network is not None:
950 self.verifier = TxVerifier(self.network, self.storage)
951 self.verifier.start()
952 self.set_verifier(self.verifier)
953 self.synchronizer = WalletSynchronizer(self, network)
954 self.synchronizer.start()
957 self.synchronizer =None
959 def stop_threads(self):
962 self.synchronizer.stop()
964 def restore(self, cb):
967 def get_accounts(self):
970 def save_accounts(self):
972 for k, v in self.accounts.items():
974 self.storage.put('accounts', d, True)
976 def can_import(self):
977 return not self.is_watching_only()
979 def is_used(self, address):
980 h = self.history.get(address,[])
981 c, u = self.get_addr_balance(address)
982 return len(h), len(h) > 0 and c == -u
984 def address_is_old(self, address, age_limit=2):
986 h = self.history.get(address, [])
989 for tx_hash, tx_height in h:
993 tx_age = self.network.get_local_height() - tx_height + 1
996 return age > age_limit
999 class Imported_Wallet(Abstract_Wallet):
1001 def __init__(self, storage):
1002 Abstract_Wallet.__init__(self, storage)
1003 a = self.accounts.get(IMPORTED_ACCOUNT)
1005 self.accounts[IMPORTED_ACCOUNT] = ImportedAccount({'imported':{}})
1006 self.storage.put('wallet_type', 'imported', True)
1008 def is_watching_only(self):
1009 acc = self.accounts[IMPORTED_ACCOUNT]
1010 n = acc.keypairs.values()
1011 return n == [(None, None)] * len(n)
1016 def is_deterministic(self):
1019 def check_password(self, password):
1020 self.accounts[IMPORTED_ACCOUNT].get_private_key((0,0), self, password)
1022 def is_used(self, address):
1023 h = self.history.get(address,[])
1024 return len(h), False
1026 def get_master_public_keys(self):
1029 def is_beyond_limit(self, address, account, is_change):
1033 class Deterministic_Wallet(Abstract_Wallet):
1035 def __init__(self, storage):
1036 Abstract_Wallet.__init__(self, storage)
1039 return self.seed != ''
1041 def is_deterministic(self):
1044 def is_watching_only(self):
1045 return not self.has_seed()
1047 def add_seed(self, seed, password):
1049 raise Exception("a seed exists")
1051 self.seed_version, self.seed = self.prepare_seed(seed)
1053 self.seed = pw_encode( self.seed, password)
1054 self.use_encryption = True
1056 self.use_encryption = False
1058 self.storage.put('seed', self.seed, True)
1059 self.storage.put('seed_version', self.seed_version, True)
1060 self.storage.put('use_encryption', self.use_encryption,True)
1061 self.create_master_keys(password)
1063 def get_seed(self, password):
1064 return pw_decode(self.seed, password)
1066 def get_mnemonic(self, password):
1067 return self.get_seed(password)
1069 def change_gap_limit(self, value):
1070 if value >= self.gap_limit:
1071 self.gap_limit = value
1072 self.storage.put('gap_limit', self.gap_limit, True)
1073 #self.interface.poke('synchronizer')
1076 elif value >= self.min_acceptable_gap():
1077 for key, account in self.accounts.items():
1078 addresses = account[0]
1079 k = self.num_unused_trailing_addresses(addresses)
1080 n = len(addresses) - k + value
1081 addresses = addresses[0:n]
1082 self.accounts[key][0] = addresses
1084 self.gap_limit = value
1085 self.storage.put('gap_limit', self.gap_limit, True)
1086 self.save_accounts()
1091 def num_unused_trailing_addresses(self, addresses):
1093 for a in addresses[::-1]:
1094 if self.history.get(a):break
1098 def min_acceptable_gap(self):
1099 # fixme: this assumes wallet is synchronized
1103 for account in self.accounts.values():
1104 addresses = account.get_addresses(0)
1105 k = self.num_unused_trailing_addresses(addresses)
1106 for a in addresses[0:-k]:
1107 if self.history.get(a):
1111 if n > nmax: nmax = n
1114 def create_new_address(self, account=None, for_change=0):
1116 account = self.default_account()
1117 address = account.create_new_address(for_change)
1118 self.history[address] = []
1119 if self.synchronizer:
1120 self.synchronizer.add(address)
1121 self.save_accounts()
1124 def synchronize_sequence(self, account, for_change):
1125 limit = self.gap_limit_for_change if for_change else self.gap_limit
1127 addresses = account.get_addresses(for_change)
1128 if len(addresses) < limit:
1129 self.create_new_address(account, for_change)
1131 if map( lambda a: self.address_is_old(a), addresses[-limit:] ) == limit*[False]:
1134 self.create_new_address(account, for_change)
1136 def check_pending_accounts(self):
1137 for account_id, addr in self.next_addresses.items():
1138 if self.address_is_old(addr):
1139 print_error( "creating account", account_id )
1140 xpub = self.master_public_keys[account_id]
1141 account = BIP32_Account({'xpub':xpub})
1142 self.add_account(account_id, account)
1143 self.next_addresses.pop(account_id)
1145 def synchronize_account(self, account):
1146 self.synchronize_sequence(account, 0)
1147 self.synchronize_sequence(account, 1)
1149 def synchronize(self):
1150 self.check_pending_accounts()
1151 for account in self.accounts.values():
1152 if type(account) in [ImportedAccount, PendingAccount]:
1154 self.synchronize_account(account)
1156 def restore(self, callback):
1158 def wait_for_wallet():
1159 self.set_up_to_date(False)
1160 while not self.is_up_to_date():
1161 msg = "%s\n%s %d\n%s %.1f"%(
1162 _("Please wait..."),
1163 _("Addresses generated:"),
1164 len(self.addresses(True)),
1165 _("Kilobytes received:"),
1166 self.network.interface.bytes_received/1024.)
1168 apply(callback, (msg,))
1171 def wait_for_network():
1172 while not self.network.is_connected():
1173 msg = "%s \n" % (_("Connecting..."))
1174 apply(callback, (msg,))
1177 # wait until we are connected, because the user might have selected another server
1183 self.fill_addressbook()
1185 def create_account(self, name, password):
1186 i = self.num_accounts()
1187 account_id = self.account_id(i)
1188 account = self.make_account(account_id, password)
1189 self.add_account(account_id, account)
1191 self.set_label(account_id, name)
1193 # add address of the next account
1194 _, _ = self.next_account_address(password)
1197 def add_account(self, account_id, account):
1198 self.accounts[account_id] = account
1199 self.save_accounts()
1201 def account_is_pending(self, k):
1202 return type(self.accounts.get(k)) == PendingAccount
1204 def delete_pending_account(self, k):
1205 assert self.account_is_pending(k)
1206 self.accounts.pop(k)
1207 self.save_accounts()
1209 def create_pending_account(self, name, password):
1210 account_id, addr = self.next_account_address(password)
1211 self.set_label(account_id, name)
1212 self.accounts[account_id] = PendingAccount({'pending':addr})
1213 self.save_accounts()
1215 def is_beyond_limit(self, address, account, is_change):
1216 if type(account) == ImportedAccount:
1218 addr_list = account.get_addresses(is_change)
1219 i = addr_list.index(address)
1220 prev_addresses = addr_list[:max(0, i)]
1221 limit = self.gap_limit_for_change if is_change else self.gap_limit
1222 if len(prev_addresses) < limit:
1224 prev_addresses = prev_addresses[max(0, i - limit):]
1225 for addr in prev_addresses:
1226 if self.history.get(addr):
1230 def get_action(self):
1231 if not self.get_master_public_key():
1232 return 'create_seed'
1233 if not self.accounts:
1234 return 'create_accounts'
1237 class NewWallet(Deterministic_Wallet):
1239 def __init__(self, storage):
1240 Deterministic_Wallet.__init__(self, storage)
1241 self.master_public_keys = storage.get('master_public_keys', {})
1242 self.master_private_keys = storage.get('master_private_keys', {})
1244 def default_account(self):
1245 return self.accounts["m/0'"]
1247 def is_watching_only(self):
1248 return not bool(self.master_private_keys)
1250 def can_create_accounts(self):
1251 return 'm/' in self.master_private_keys.keys()
1253 def get_master_public_key(self):
1254 """xpub of the main account"""
1255 return self.master_public_keys.get("m/0'")
1257 def get_master_public_keys(self):
1259 for k, account in self.accounts.items():
1260 name = self.get_account_name(k)
1261 mpk_text = '\n\n'.join( account.get_master_pubkeys() )
1262 out[name] = mpk_text
1265 def get_master_private_key(self, account, password):
1266 k = self.master_private_keys.get(account)
1268 xpriv = pw_decode( k, password)
1271 def check_password(self, password):
1272 xpriv = self.get_master_private_key( "m/", password )
1273 xpub = self.master_public_keys["m/"]
1274 assert deserialize_xkey(xpriv)[3] == deserialize_xkey(xpub)[3]
1276 def create_xprv_wallet(self, xprv, password):
1277 xpub = bitcoin.xpub_from_xprv(xprv)
1278 account = BIP32_Account({'xpub':xpub})
1279 account_id = 'm/' + bitcoin.get_xkey_name(xpub)
1280 self.storage.put('seed_version', self.seed_version, True)
1281 self.add_master_private_key(account_id, xprv, password)
1282 self.add_master_public_key(account_id, xpub)
1283 self.add_account(account_id, account)
1285 def create_watching_only_wallet(self, xpub):
1286 account = BIP32_Account({'xpub':xpub})
1287 account_id = 'm/' + bitcoin.get_xkey_name(xpub)
1288 self.storage.put('seed_version', self.seed_version, True)
1289 self.add_master_public_key(account_id, xpub)
1290 self.add_account(account_id, account)
1292 def create_accounts(self, password):
1293 # First check the password is valid (this raises if it isn't).
1294 if not self.is_watching_only():
1295 self.check_password(password)
1296 self.create_account('Main account', password)
1298 def add_master_public_key(self, name, xpub):
1299 self.master_public_keys[name] = xpub
1300 self.storage.put('master_public_keys', self.master_public_keys, True)
1302 def add_master_private_key(self, name, xpriv, password):
1303 self.master_private_keys[name] = pw_encode(xpriv, password)
1304 self.storage.put('master_private_keys', self.master_private_keys, True)
1306 def add_master_keys(self, root, account_id, password):
1307 x = self.master_private_keys.get(root)
1309 master_xpriv = pw_decode(x, password )
1310 xpriv, xpub = bip32_private_derivation(master_xpriv, root, account_id)
1311 self.add_master_public_key(account_id, xpub)
1312 self.add_master_private_key(account_id, xpriv, password)
1314 master_xpub = self.master_public_keys[root]
1315 xpub = bip32_public_derivation(master_xpub, root, account_id)
1316 self.add_master_public_key(account_id, xpub)
1319 def create_master_keys(self, password):
1320 xpriv, xpub = bip32_root(mnemonic_to_seed(self.get_seed(password),'').encode('hex'))
1321 self.add_master_public_key("m/", xpub)
1322 self.add_master_private_key("m/", xpriv, password)
1324 def can_sign(self, tx):
1325 if self.is_watching_only():
1327 if tx.is_complete():
1329 addr_list, xpub_list = tx.inputs_to_sign()
1330 for addr in addr_list:
1331 if self.is_mine(addr):
1333 mpk = [ self.master_public_keys[k] for k in self.master_private_keys.keys() ]
1334 for xpub, sequence in xpub_list:
1339 def num_accounts(self):
1341 for k, v in self.accounts.items():
1342 if type(v) != BIP32_Account:
1348 account_id = self.account_id(i)
1349 if account_id not in keys: break
1353 def next_account_address(self, password):
1354 i = self.num_accounts()
1355 account_id = self.account_id(i)
1357 addr = self.next_addresses.get(account_id)
1359 account = self.make_account(account_id, password)
1360 addr = account.first_address()
1361 self.next_addresses[account_id] = addr
1362 self.storage.put('next_addresses', self.next_addresses)
1364 return account_id, addr
1366 def account_id(self, i):
1369 def make_account(self, account_id, password):
1370 """Creates and saves the master keys, but does not save the account"""
1371 xpub = self.add_master_keys("m/", account_id, password)
1372 account = BIP32_Account({'xpub':xpub})
1375 def make_seed(self):
1376 import mnemonic, ecdsa
1377 entropy = ecdsa.util.randrange( pow(2,160) )
1380 ss = "%040x"%(entropy+nonce)
1381 s = hashlib.sha256(ss.decode('hex')).digest().encode('hex')
1382 # we keep only 13 words, that's approximately 139 bits of entropy
1383 words = mnemonic.mn_encode(s)[0:13]
1384 seed = ' '.join(words)
1385 if is_new_seed(seed):
1386 break # this will remove 8 bits of entropy
1390 def prepare_seed(self, seed):
1392 return NEW_SEED_VERSION, unicodedata.normalize('NFC', unicode(seed.strip()))
1395 class Wallet_2of2(NewWallet):
1396 """ This class is used for multisignature addresses"""
1398 def __init__(self, storage):
1399 NewWallet.__init__(self, storage)
1400 self.storage.put('wallet_type', '2of2', True)
1402 def default_account(self):
1403 return self.accounts['m/']
1405 def can_create_accounts(self):
1408 def can_import(self):
1411 def create_account(self, name, password):
1412 xpub1 = self.master_public_keys.get("m/")
1413 xpub2 = self.master_public_keys.get("cold/")
1414 account = BIP32_Account_2of2({'xpub':xpub1, 'xpub2':xpub2})
1415 self.add_account('m/', account)
1417 def get_master_public_keys(self):
1418 xpub1 = self.master_public_keys.get("m/")
1419 xpub2 = self.master_public_keys.get("cold/")
1420 return {'hot':xpub1, 'cold':xpub2}
1422 def get_action(self):
1423 xpub1 = self.master_public_keys.get("m/")
1424 xpub2 = self.master_public_keys.get("cold/")
1426 return 'create_seed'
1428 return 'add_cosigner'
1429 if not self.accounts:
1430 return 'create_accounts'
1433 class Wallet_2of3(Wallet_2of2):
1434 """ This class is used for multisignature addresses"""
1436 def __init__(self, storage):
1437 Wallet_2of2.__init__(self, storage)
1438 self.storage.put('wallet_type', '2of3', True)
1440 def create_account(self, name, password):
1441 xpub1 = self.master_public_keys.get("m/")
1442 xpub2 = self.master_public_keys.get("cold/")
1443 xpub3 = self.master_public_keys.get("remote/")
1444 account = BIP32_Account_2of3({'xpub':xpub1, 'xpub2':xpub2, 'xpub3':xpub3})
1445 self.add_account('m/', account)
1447 def get_master_public_keys(self):
1448 xpub1 = self.master_public_keys.get("m/")
1449 xpub2 = self.master_public_keys.get("cold/")
1450 xpub3 = self.master_public_keys.get("remote/")
1451 return {'hot':xpub1, 'cold':xpub2, 'remote':xpub3}
1453 def get_action(self):
1454 xpub1 = self.master_public_keys.get("m/")
1455 xpub2 = self.master_public_keys.get("cold/")
1456 xpub3 = self.master_public_keys.get("remote/")
1458 return 'create_seed'
1459 if xpub2 is None or xpub3 is None:
1460 return 'add_two_cosigners'
1461 if not self.accounts:
1462 return 'create_accounts'
1465 class OldWallet(Deterministic_Wallet):
1467 def default_account(self):
1468 return self.accounts[0]
1470 def make_seed(self):
1472 seed = random_seed(128)
1473 return ' '.join(mnemonic.mn_encode(seed))
1475 def prepare_seed(self, seed):
1477 # see if seed was entered as hex
1482 return OLD_SEED_VERSION, str(seed)
1486 words = seed.split()
1487 seed = mnemonic.mn_decode(words)
1489 raise Exception("Invalid seed")
1491 return OLD_SEED_VERSION, seed
1493 def create_master_keys(self, password):
1494 seed = self.get_seed(password)
1495 mpk = OldAccount.mpk_from_seed(seed)
1496 self.storage.put('master_public_key', mpk, True)
1498 def get_master_public_key(self):
1499 return self.storage.get("master_public_key")
1501 def get_master_public_keys(self):
1502 return {'Main Account':self.get_master_public_key()}
1504 def create_accounts(self, password):
1505 mpk = self.storage.get("master_public_key")
1506 self.create_account(mpk)
1508 def create_account(self, mpk):
1509 self.accounts[0] = OldAccount({'mpk':mpk, 0:[], 1:[]})
1510 self.save_accounts()
1512 def create_watching_only_wallet(self, mpk):
1513 self.seed_version = OLD_SEED_VERSION
1514 self.storage.put('seed_version', self.seed_version, True)
1515 self.storage.put('master_public_key', mpk, True)
1516 self.create_account(mpk)
1518 def get_seed(self, password):
1519 seed = pw_decode(self.seed, password).encode('utf8')
1522 def check_password(self, password):
1523 seed = self.get_seed(password)
1524 self.accounts[0].check_seed(seed)
1526 def get_mnemonic(self, password):
1528 s = self.get_seed(password)
1529 return ' '.join(mnemonic.mn_encode(s))
1531 def check_pending_accounts(self):
1534 def can_sign(self, tx):
1535 if self.is_watching_only():
1537 if tx.is_complete():
1539 addr_list, xpub_list = tx.inputs_to_sign()
1540 for addr in addr_list:
1541 if self.is_mine(addr):
1543 for xpub, sequence in xpub_list:
1544 if xpub == self.master_public_key:
1548 # former WalletFactory
1549 class Wallet(object):
1550 """The main wallet "entry point".
1551 This class is actually a factory that will return a wallet of the correct
1552 type when passed a WalletStorage instance."""
1554 def __new__(self, storage):
1555 config = storage.config
1557 self.wallet_types = [
1558 ('standard', ("Standard wallet"), NewWallet if config.get('bip32') else OldWallet),
1559 ('imported', ("Imported wallet"), Imported_Wallet),
1560 ('2of2', ("Multisig wallet (2 of 2)"), Wallet_2of2),
1561 ('2of3', ("Multisig wallet (2 of 3)"), Wallet_2of3)
1563 run_hook('add_wallet_types', self.wallet_types)
1565 for t, l, WalletClass in self.wallet_types:
1566 if t == storage.get('wallet_type'):
1567 return WalletClass(storage)
1569 if not storage.file_exists:
1570 seed_version = NEW_SEED_VERSION if config.get('bip32') is True else OLD_SEED_VERSION
1572 seed_version = storage.get('seed_version')
1573 if not seed_version:
1574 seed_version = OLD_SEED_VERSION if len(storage.get('master_public_key')) == 128 else NEW_SEED_VERSION
1576 if seed_version == OLD_SEED_VERSION:
1577 return OldWallet(storage)
1578 elif seed_version == NEW_SEED_VERSION:
1579 return NewWallet(storage)
1581 msg = "This wallet seed is not supported."
1582 if seed_version in [5]:
1583 msg += "\nTo open this wallet, try 'git checkout seed_v%d'"%seed_version
1588 def is_seed(self, seed):
1591 elif is_old_seed(seed):
1593 elif is_new_seed(seed):
1599 def is_old_mpk(self, mpk):
1602 assert len(mpk) == 128
1608 def is_xpub(self, text):
1610 assert text[0:4] == 'xpub'
1611 deserialize_xkey(text)
1617 def is_xprv(self, text):
1619 assert text[0:4] == 'xprv'
1620 deserialize_xkey(text)
1626 def is_address(self, text):
1629 for x in text.split():
1630 if not bitcoin.is_address(x):
1635 def is_private_key(self, text):
1638 for x in text.split():
1639 if not bitcoin.is_private_key(x):
1644 def from_seed(self, seed, storage):
1645 if is_old_seed(seed):
1647 elif is_new_seed(seed):
1653 def from_address(self, text, storage):
1654 w = Imported_Wallet(storage)
1655 for x in text.split():
1656 w.accounts[IMPORTED_ACCOUNT].add(x, None, None, None)
1661 def from_private_key(self, text, storage):
1662 w = Imported_Wallet(storage)
1663 for x in text.split():
1664 w.import_key(x, None)
1668 def from_old_mpk(self, mpk, storage):
1669 w = OldWallet(storage)
1671 w.create_watching_only_wallet(mpk)
1675 def from_xpub(self, xpub, storage):
1676 w = NewWallet(storage)
1677 w.create_watching_only_wallet(xpub)
1681 def from_xprv(self, xprv, password, storage):
1682 w = NewWallet(storage)
1683 w.create_xprv_wallet(xprv, password)