1258 lines
40 KiB
Python
1258 lines
40 KiB
Python
# (c) Copyright 2018 by Coinkite Inc. This file is covered by license found in COPYING-CC.
|
|
#
|
|
# seed.py - bip39 seeds and words
|
|
#
|
|
# references:
|
|
# - <https://github.com/bitcoin/bips/blob/master/bip-0039.mediawiki>
|
|
# - <https://iancoleman.io/bip39/#english>
|
|
# - zero values:
|
|
# - 'abandon' * 23 + 'art'
|
|
# - 'abandon' * 17 + 'agent'
|
|
# - 'abandon' * 11 + 'about'
|
|
#
|
|
import ngu, uctypes, bip39, random, stash, pyb
|
|
from menu import MenuItem, MenuSystem
|
|
from utils import xfp2str, parse_extended_key, swab32, pad_raw_secret, problem_file_line
|
|
from uhashlib import sha256
|
|
from ux import ux_show_story, the_ux, ux_dramatic_pause, ux_confirm
|
|
from ux import PressRelease, ux_input_numbers, ux_input_text, show_qr_code
|
|
from actions import goto_top_menu
|
|
from stash import SecretStash
|
|
from ubinascii import hexlify as b2a_hex
|
|
from pwsave import PassphraseSaver
|
|
from glob import settings, dis
|
|
from pincodes import pa
|
|
from nvstore import SettingsObject
|
|
from files import CardMissingError, needs_microsd, CardSlot
|
|
from charcodes import KEY_QR
|
|
|
|
|
|
# seed words lengths we support: 24=>256 bits, and recommended
|
|
VALID_LENGTHS = (24, 18, 12)
|
|
|
|
# bit flag that means "also include bare prefix as a valid word"
|
|
_PREFIX_MARKER = const(1<<26)
|
|
|
|
def letter_choices(sofar='', depth=0, thres=5):
|
|
# make a list of word completions based on indicated prefix
|
|
if not sofar:
|
|
# all letters:
|
|
# - except 'x' which isn't used in the wordlist.
|
|
# - and q- which is really qu-, because English.
|
|
return [('%s-' % chr(97+i)) if i != 16 else 'qu-' for i in range(26) if i != 23]
|
|
|
|
exact, nexts, matched = bip39.next_char(sofar)
|
|
#print("[%d] %s => x=%r n=%r m=%r" % (depth, sofar, exact, nexts, matched))
|
|
|
|
if not nexts:
|
|
# no more choices; done
|
|
return [matched]
|
|
|
|
rv = []
|
|
if exact:
|
|
# ie: "act" plus "action", "actor"
|
|
rv.append(sofar)
|
|
|
|
if len(nexts) == 1 and matched:
|
|
# aba => abandon (unambig first 3 chars)
|
|
# but not: age => age, agent (abig first 3)
|
|
rv.append(matched)
|
|
else:
|
|
for w in nexts:
|
|
rv.append(sofar + w + '-')
|
|
|
|
# replace bab- => baby and other cases where prefix is unique
|
|
# - doesn't grow menu length
|
|
if len(sofar) >= 2:
|
|
for n, w in enumerate(rv):
|
|
if w[-1] != '-': continue
|
|
exact, nexts, matched = bip39.next_char(w[:-1])
|
|
if matched:
|
|
rv[n] = matched
|
|
|
|
if len(rv) <= thres:
|
|
if depth == 0:
|
|
# examples:
|
|
# z => ze- and zo- ... better if all 4 z-words are shown
|
|
# y => 6 choices
|
|
# - above thres=5, we get menus w/60+ entries
|
|
# - recurse only one level also to keep size down
|
|
a = []
|
|
for i in rv:
|
|
if i[-1] != '-':
|
|
a.append(i)
|
|
else:
|
|
a.extend(letter_choices(i[:-1], depth+1))
|
|
return a
|
|
|
|
return rv
|
|
|
|
'''
|
|
# 100% working test code (keep)
|
|
|
|
thres=2 => min/max/avg = 2 / 20 / 4.221338 nodes=628
|
|
thres=3 => min/max/avg = 2 / 20 / 4.371667 nodes=600
|
|
thres=4 => min/max/avg = 2 / 31 / 4.593250 nodes=563
|
|
thres=5 => min/max/avg = 2 / 34 / 4.882917 nodes=521
|
|
thres=6 => min/max/avg = 2 / 58 / 5.397826 nodes=460
|
|
thres=7 => min/max/avg = 2 / 61 / 5.618721 nodes=438
|
|
thres=8 => min/max/avg = 2 / 61 / 5.793839 nodes=422
|
|
thres=9 => min/max/avg = 2 / 66 / 5.485588 nodes=451
|
|
|
|
def test_lc():
|
|
for thres in range(2, 10):
|
|
terms = set()
|
|
todo = set(letter_choices(''))
|
|
sizes = []
|
|
while todo:
|
|
w = todo.pop()
|
|
assert w not in terms
|
|
if w[-1] == '-':
|
|
h = letter_choices(w[:-1], thres=thres)
|
|
assert len(h) == len(set(h))
|
|
sizes.append(len(h))
|
|
todo.update(h)
|
|
else:
|
|
terms.add(w)
|
|
|
|
assert len(terms) == 2048
|
|
|
|
print("thres=%d => min/max/avg = %d / %d / %f nodes=%d" %
|
|
(thres, min(sizes), max(sizes), sum(sizes)/len(sizes), len(sizes)))
|
|
'''
|
|
|
|
|
|
class WordNestMenu(MenuSystem):
|
|
# singleton (cls level) vars
|
|
words = []
|
|
target_words = None
|
|
has_checksum = True
|
|
done_cb = None
|
|
|
|
def __init__(self, num_words=None, has_checksum=True, done_cb=None, items=None, is_commit=False):
|
|
|
|
if num_words is not None:
|
|
WordNestMenu.target_words = num_words
|
|
WordNestMenu.has_checksum = has_checksum
|
|
WordNestMenu.words = []
|
|
WordNestMenu.done_cb = done_cb or self.all_done
|
|
is_commit = True
|
|
|
|
if not items:
|
|
items = [MenuItem(i, menu=self.next_menu) for i in letter_choices()]
|
|
|
|
self.is_commit = is_commit
|
|
|
|
super(WordNestMenu, self).__init__(items)
|
|
|
|
@staticmethod
|
|
async def next_menu(self, idx, choice):
|
|
|
|
words = WordNestMenu.words
|
|
cls = self.__class__
|
|
|
|
if choice.label[-1] == '-':
|
|
ch = letter_choices(choice.label[0:-1])
|
|
|
|
return cls(items=[MenuItem(i, menu=self.next_menu) for i in ch])
|
|
|
|
# terminal choice, start next word
|
|
words.append(choice.label)
|
|
|
|
assert len(words) <= self.target_words
|
|
|
|
if len(words) == 23 and self.has_checksum:
|
|
# we can provide final 8 choices, but only for 24-word case
|
|
final_words = list(bip39.a2b_words_guess(words))
|
|
|
|
async def picks_chk_word(s, idx, choice):
|
|
# they picked final word, the word includes valid checksum bits
|
|
words.append(choice.label)
|
|
await cls.done_cb(words.copy())
|
|
|
|
items = [MenuItem(w, f=picks_chk_word) for w in final_words]
|
|
items.append(MenuItem('(none above)', f=self.explain_error))
|
|
return cls(is_commit=True, items=items)
|
|
|
|
# add a few top-items in certain cases
|
|
if len(words) == self.target_words:
|
|
if self.has_checksum:
|
|
try:
|
|
bip39.a2b_words(' '.join(words))
|
|
correct = True
|
|
except ValueError:
|
|
correct = False
|
|
else:
|
|
correct = True
|
|
|
|
# they have checksum right, so they are certainly done.
|
|
if correct:
|
|
# they are done, don't force them to do any more!
|
|
return await cls.done_cb(words.copy())
|
|
else:
|
|
# give them a chance to confirm and/or start over
|
|
return cls(is_commit=True, items = [
|
|
MenuItem('(INCORRECT)', f=self.explain_error),
|
|
MenuItem('(start over)', f=self.start_over)])
|
|
|
|
|
|
# pop stack to reset depth, and start again at a- .. z-
|
|
cls.pop_all()
|
|
|
|
return cls(items=None, is_commit=True)
|
|
|
|
@classmethod
|
|
def pop_all(cls):
|
|
while isinstance(the_ux.top_of_stack(), cls):
|
|
the_ux.pop()
|
|
|
|
def on_cancel(self):
|
|
# user pressed cancel on a menu (so he's going upwards)
|
|
# - if it's a step where we added to the word list, undo that.
|
|
# - but keep them in our system until:
|
|
# - when the word list is empty and they cancel, stop
|
|
words = WordNestMenu.words
|
|
if self.is_commit and words:
|
|
words.pop()
|
|
|
|
# replace the menu we are show w/ top-level (a-) menu
|
|
the_ux.pop()
|
|
nxt = WordNestMenu(is_commit=True)
|
|
the_ux.push(nxt)
|
|
else:
|
|
the_ux.pop()
|
|
|
|
@staticmethod
|
|
async def all_done(new_words):
|
|
# save the new seed value
|
|
set_seed_value(new_words)
|
|
|
|
# clear menu stack
|
|
goto_top_menu(first_time=True)
|
|
|
|
return None
|
|
|
|
async def explain_error(self, *a):
|
|
|
|
await ux_show_story('''\
|
|
You've got a mistake in your words. We know because the checksum does not \
|
|
verify. It's probably best to start over again, but you can back out \
|
|
individual words if you wish.''')
|
|
|
|
async def start_over(self, *a):
|
|
|
|
# pop everything we've done off the stack
|
|
self.pop_all()
|
|
|
|
# begin again, empty but same settings
|
|
self.words = []
|
|
the_ux.push(self.__class__(num_words=WordNestMenu.target_words))
|
|
|
|
def tr_label(self):
|
|
return 'Word'
|
|
|
|
def late_draw(self, dis):
|
|
# add an overlay with "word N" in small text, top right.
|
|
if dis.has_lcd: return # unreachable anyway?
|
|
|
|
from display import FontTiny
|
|
|
|
count = len(self.words)
|
|
if count >= self.target_words:
|
|
# on final DONE/incorrect screen
|
|
return
|
|
|
|
dis.progress_bar(count / self.target_words)
|
|
|
|
count += 1
|
|
invert = (self.cursor == self.ypos)
|
|
|
|
y = 6
|
|
dis.text(-8, y-4, "%d" % count, invert=invert)
|
|
dis.text(-18-(6 if count >= 10 else 0), y, self.tr_label(), FontTiny, invert=invert)
|
|
|
|
|
|
async def show_words(words, prompt=None, escape=None, extra='', ephemeral=False):
|
|
msg = (prompt or 'Record these %d secret words!\n') % len(words)
|
|
msg += '\n'.join('%2d: %s' % (i, w) for i, w in enumerate(words, start=1))
|
|
msg += '\n\nPlease check and double check your notes.'
|
|
if not ephemeral:
|
|
# user can skip quiz for ephemeral secrets
|
|
msg += " There will be a test!"
|
|
|
|
if not version.has_qwerty:
|
|
escape = (escape or '') + '1'
|
|
extra += 'Press (1) to view as QR Code. '
|
|
else:
|
|
escape = (escape or '') + KEY_QR
|
|
extra += 'Press QR button to view as QR Code. '
|
|
|
|
if extra:
|
|
msg += '\n\n'
|
|
msg += extra
|
|
|
|
while 1:
|
|
ch = await ux_show_story(msg, escape=escape, sensitive=True)
|
|
if ch == '1' or ch == KEY_QR:
|
|
await show_qr_code(' '.join(w[0:4] for w in words), True)
|
|
continue
|
|
break
|
|
|
|
return ch
|
|
|
|
|
|
async def add_dice_rolls(count, seed, judge_them, nwords=None, enforce=False):
|
|
from glob import dis
|
|
# XXX q1 support
|
|
from display import FontTiny, FontLarge
|
|
|
|
low_entropy_msg = "You only provided %d dice rolls, and each roll adds only 2.585 bits of entropy."
|
|
low_entropy_msg += " For %d-bit security"
|
|
if nwords is not None:
|
|
# do not add this if we generate private key in paper wallets
|
|
low_entropy_msg += ", which is considered the minimum for %d word seeds," % nwords
|
|
low_entropy_msg += " you need at least %d rolls."
|
|
|
|
# None is for papaer wallet private key - as it is 32 bytes of entropy we need 99 D6
|
|
if nwords in (24, None):
|
|
threshold = 99
|
|
sec_bit = 256
|
|
else:
|
|
threshold = 50
|
|
sec_bit = 128
|
|
|
|
counter = {}
|
|
md = sha256(seed)
|
|
pr = PressRelease()
|
|
|
|
# fixed parts of screen
|
|
dis.clear()
|
|
y = 38
|
|
dis.text(0, y, "Press 1-6 for each dice"); y += 13
|
|
dis.text(0, y, "roll to mix in.")
|
|
dis.save()
|
|
|
|
while 1:
|
|
# Note: cannot scroll this msg because 5=up arrow
|
|
dis.restore()
|
|
dis.text(None, 0, '%d rolls' % count, FontLarge)
|
|
|
|
hx = str(b2a_hex(md.digest()), 'ascii')
|
|
dis.text(0, 20, hx[0:32], FontTiny)
|
|
dis.text(0, 20+7, hx[32:], FontTiny)
|
|
|
|
dis.show()
|
|
|
|
ch = await pr.wait()
|
|
|
|
if ch in '123456':
|
|
count += 1
|
|
counter[ch] = counter.get(ch, 0) + 1 # mimics defaultdict
|
|
|
|
dis.restore()
|
|
dis.text(None, 0, '%d rolls' % count, FontLarge)
|
|
dis.show()
|
|
|
|
# this is slow enough to see
|
|
md.update(ch)
|
|
|
|
elif ch == 'x':
|
|
# Because the change (roll) has already been applied,
|
|
# only let them abort if it's early still
|
|
if count < 10 and judge_them:
|
|
return 0, seed
|
|
elif ch == 'y':
|
|
if count < threshold and judge_them:
|
|
if not count:
|
|
return 0, seed
|
|
|
|
story = low_entropy_msg % (count, sec_bit, threshold)
|
|
if enforce:
|
|
ch = await ux_show_story("Not enough dice rolls!!!\n\n" + story +
|
|
"\n\nPress OK to add more dice rolls. X to exit")
|
|
if ch == "y":
|
|
continue
|
|
else:
|
|
return 0, seed
|
|
else:
|
|
ok = await ux_confirm(story)
|
|
if not ok:
|
|
continue
|
|
|
|
if judge_them:
|
|
bad_dist = any((v / count) > 0.30 for _, v in counter.items())
|
|
if bad_dist:
|
|
bad_dist_msg = ("Distribution of dice rolls is not random. "
|
|
"Some numbers occurred more than 30% of the time.")
|
|
if enforce:
|
|
await ux_show_story(bad_dist_msg)
|
|
return 0, seed # exit
|
|
else:
|
|
ok = await ux_confirm(bad_dist_msg)
|
|
if not ok:
|
|
continue
|
|
break
|
|
|
|
if count:
|
|
seed = md.digest()
|
|
|
|
return count, seed
|
|
|
|
async def new_from_dice(nwords):
|
|
# Use lots of (D6) dice rolls to create seed entropy.
|
|
# Note: only 2.585 bits of entropy per roll, so need lots!
|
|
# 50 => 128bits, 99 => 256bits
|
|
|
|
seed = b''
|
|
count = 0
|
|
|
|
count, seed = await add_dice_rolls(count, seed, True, nwords, enforce=True)
|
|
if count == 0: return
|
|
|
|
words = await approve_word_list(seed, nwords)
|
|
if words:
|
|
set_seed_value(words)
|
|
# send them to home menu, now with a wallet enabled
|
|
goto_top_menu(first_time=True)
|
|
|
|
def in_seed_vault(encoded):
|
|
# Test if indicated xfp (or currently active XFP) is in the seed vault already.
|
|
seeds = settings.master_get("seeds", [])
|
|
if seeds:
|
|
ss = stash.SecretStash.storage_serialize(encoded)
|
|
if ss in [s[1] for s in seeds]:
|
|
return True
|
|
return False
|
|
|
|
async def add_seed_to_vault(encoded, meta=None):
|
|
|
|
if not settings.master_get("seedvault", False):
|
|
# seed vault disabled
|
|
return
|
|
if pa.is_secret_blank():
|
|
# do not save anything if no secrets yet
|
|
return
|
|
|
|
# do not offer to store secrets that are already in vault
|
|
if in_seed_vault(encoded):
|
|
return
|
|
|
|
main_xfp = settings.master_get("xfp", 0)
|
|
|
|
# parse encoded
|
|
_,_,node = SecretStash.decode(encoded)
|
|
new_xfp = swab32(node.my_fp())
|
|
new_xfp_str = xfp2str(new_xfp)
|
|
|
|
# do not offer to store main seed
|
|
if new_xfp == main_xfp:
|
|
return
|
|
|
|
seeds = settings.master_get("seeds", [])
|
|
|
|
xfp_ui = "[%s]" % new_xfp_str
|
|
story = ("Press (1) to "
|
|
"store temporary seed into Seed Vault. This way you can easily switch "
|
|
"to this secret and use it as temporary seed in future.\n\nPress OK "
|
|
"to continue without saving.")
|
|
|
|
ch = await ux_show_story(story, escape="1")
|
|
if ch != "1":
|
|
# didn't want to save
|
|
return
|
|
|
|
# Save it into master settings
|
|
seeds.append((new_xfp_str,
|
|
stash.SecretStash.storage_serialize(encoded),
|
|
xfp_ui,
|
|
meta))
|
|
|
|
settings.master_set("seeds", seeds)
|
|
|
|
await ux_show_story(xfp_ui + "\nSaved to Seed Vault")
|
|
|
|
return True
|
|
|
|
async def set_ephemeral_seed(encoded, chain=None, summarize_ux=True, bip39pw='',
|
|
is_restore=False, meta=None):
|
|
if not is_restore:
|
|
await add_seed_to_vault(encoded, meta=meta)
|
|
dis.fullscreen("Wait...")
|
|
|
|
applied = pa.tmp_secret(encoded, chain=chain, bip39pw=bip39pw)
|
|
dis.progress_bar_show(1)
|
|
xfp = settings.get("xfp", None)
|
|
if xfp:
|
|
xfp = "[" + xfp2str(xfp) + "]"
|
|
if not applied:
|
|
await ux_show_story(title=xfp, msg="Temporary master key already in use.")
|
|
return
|
|
|
|
if summarize_ux:
|
|
await ux_show_story(title=xfp, msg="New temporary master key is in effect now.")
|
|
|
|
return applied
|
|
|
|
async def set_ephemeral_seed_words(words, meta):
|
|
dis.progress_bar_show(0.1)
|
|
encoded = seed_words_to_encoded_secret(words)
|
|
dis.progress_bar_show(0.5)
|
|
await set_ephemeral_seed(encoded, meta=meta)
|
|
goto_top_menu()
|
|
|
|
async def ephemeral_seed_generate_from_dice(nwords):
|
|
# Use lots of (D6) dice rolls to create seed entropy.
|
|
# Note: only 2.585 bits of entropy per roll, so need lots!
|
|
# 50 => 128bits, 99 => 256bits
|
|
|
|
seed = b''
|
|
count = 0
|
|
|
|
count, seed = await add_dice_rolls(count, seed, True, nwords)
|
|
if count == 0: return
|
|
|
|
words = await approve_word_list(seed, nwords, ephemeral=True)
|
|
if words:
|
|
dis.fullscreen("Applying...")
|
|
await set_ephemeral_seed_words(words, meta='Dice')
|
|
|
|
def generate_seed():
|
|
seed = random.bytes(32)
|
|
assert len(set(seed)) > 4 # TRNG failure
|
|
# hash to mitigate possible bias in TRNG
|
|
seed = ngu.hash.sha256s(seed)
|
|
return seed
|
|
|
|
async def make_new_wallet(nwords):
|
|
# Pick a new random seed.
|
|
await ux_dramatic_pause('Generating...', 3)
|
|
seed = generate_seed()
|
|
words = await approve_word_list(seed, nwords)
|
|
if words:
|
|
set_seed_value(words)
|
|
# send them to home menu, now with a wallet enabled
|
|
goto_top_menu(first_time=True)
|
|
|
|
|
|
async def ephemeral_seed_import(nwords):
|
|
async def import_done_cb(words):
|
|
await set_ephemeral_seed_words(words, meta='Imported')
|
|
|
|
return WordNestMenu(nwords, done_cb=import_done_cb)
|
|
|
|
async def ephemeral_seed_generate(nwords):
|
|
await ux_dramatic_pause('Generating...', 3)
|
|
seed = generate_seed()
|
|
words = await approve_word_list(seed, nwords, ephemeral=True)
|
|
if words:
|
|
dis.fullscreen("Applying...")
|
|
await set_ephemeral_seed_words(words, meta="TRNG Words")
|
|
|
|
async def set_seed_extended_key(extended_key):
|
|
encoded, chain = xprv_to_encoded_secret(extended_key)
|
|
set_seed_value(encoded=encoded, chain=chain)
|
|
goto_top_menu()
|
|
|
|
async def set_ephemeral_seed_extended_key(extended_key, meta=None):
|
|
encoded, chain = xprv_to_encoded_secret(extended_key)
|
|
dis.fullscreen("Applying...")
|
|
await set_ephemeral_seed(encoded=encoded, chain=chain, meta=meta)
|
|
goto_top_menu()
|
|
|
|
async def approve_word_list(seed, nwords, ephemeral=False):
|
|
# Force the user to write the seeds words down, give a quiz, then save them.
|
|
|
|
# LESSON LEARNED: if the user is writting down the words, as we have
|
|
# vividly instructed, then it's a big deal to lose those words and have to start
|
|
# over. So confirm that action, and don't volunteer it.
|
|
|
|
if nwords == 12:
|
|
seed = seed[0:16]
|
|
|
|
words = bip39.b2a_words(seed).split(' ')
|
|
assert len(words) == nwords
|
|
extra_msg = 'Press (4) to add some dice rolls into the mix. '
|
|
if ephemeral:
|
|
# document quiz skipping if generating ephemeral seed
|
|
extra_msg += "Press (6) to skip word quiz. "
|
|
|
|
while 1:
|
|
# show the seed words
|
|
ch = await show_words(words, escape='46', extra=extra_msg, ephemeral=ephemeral)
|
|
if ch == 'x':
|
|
# user abort, but confirm it!
|
|
if await ux_confirm("Throw away those words and stop this process?"):
|
|
return
|
|
else:
|
|
continue
|
|
|
|
if ch == '4':
|
|
# dice roll mode
|
|
count, new_seed = await add_dice_rolls(0, seed, False)
|
|
if count:
|
|
seed = new_seed[0:16] if nwords == 12 else new_seed
|
|
words = bip39.b2a_words(seed).split(' ')
|
|
|
|
continue
|
|
|
|
if ch == '6':
|
|
# wants to skip the quiz (undocumented)
|
|
if await ux_confirm("Skipping the quiz means you might have "
|
|
"recorded the seed wrong and will be crying later."):
|
|
break
|
|
|
|
# Perform a test, to check they wrote them down
|
|
ch = await word_quiz(words)
|
|
if ch == 'x':
|
|
# user abort quiz
|
|
if await ux_confirm("Throw away those words and stop this process? Press X to see the word list again and restart the quiz."):
|
|
return
|
|
|
|
# show the words again, but don't change them
|
|
continue
|
|
|
|
# quiz passed
|
|
break
|
|
|
|
return words
|
|
|
|
def seed_words_to_encoded_secret(words):
|
|
# seed without checksum
|
|
seed = bip39.a2b_words(words) # checksum check
|
|
# encode it for our limited secret space
|
|
nv = SecretStash.encode(seed_phrase=seed)
|
|
return nv
|
|
|
|
def xprv_to_encoded_secret(xprv):
|
|
node, chain, _ = parse_extended_key(xprv, private=True)
|
|
if node is None:
|
|
raise ValueError("Failed to parse extended private key.")
|
|
nv = SecretStash.encode(xprv=node)
|
|
node.blank()
|
|
return nv, chain # need to know chain
|
|
|
|
|
|
def set_seed_value(words=None, encoded=None, chain=None):
|
|
# Save the seed words into secure element, and reboot. BIP-39 password
|
|
# is not set at this point (empty string)
|
|
if words:
|
|
nv = seed_words_to_encoded_secret(words)
|
|
else:
|
|
nv = encoded
|
|
|
|
from glob import dis
|
|
try:
|
|
dis.fullscreen('Applying...')
|
|
dis.busy_bar(True)
|
|
pa.change(new_secret=nv)
|
|
|
|
# re-read settings since key is now different
|
|
# - also captures xfp, xpub at this point
|
|
pa.new_main_secret(nv, chain=chain)
|
|
|
|
# check and reload secret
|
|
pa.reset()
|
|
pa.login()
|
|
finally:
|
|
dis.busy_bar(False)
|
|
|
|
|
|
async def calc_bip39_passphrase(pw, bypass_tmp=False):
|
|
from glob import dis, settings
|
|
from pincodes import pa
|
|
|
|
dis.fullscreen("Working...")
|
|
# get xfp of parent reliably - cannot go to settings for this if in ephemeral
|
|
if pa.tmp_value:
|
|
with stash.SensitiveValues(bypass_tmp=bypass_tmp) as sv:
|
|
assert sv.mode == 'words'
|
|
current_xfp = swab32(sv.node.my_fp())
|
|
else:
|
|
current_xfp = settings.get("xfp", 0)
|
|
|
|
with stash.SensitiveValues(bip39pw=pw, bypass_tmp=bypass_tmp) as sv:
|
|
# can't do it without original seed words (late, but caller has checked)
|
|
assert sv.mode == 'words'
|
|
nv = SecretStash.encode(xprv=sv.node)
|
|
xfp = swab32(sv.node.my_fp())
|
|
|
|
return nv, xfp, current_xfp
|
|
|
|
async def set_bip39_passphrase(pw, bypass_tmp=False, summarize_ux=True):
|
|
nv, _, parent_xfp = await calc_bip39_passphrase(pw, bypass_tmp=bypass_tmp)
|
|
ret = await set_ephemeral_seed(nv, summarize_ux=summarize_ux, bip39pw=pw,
|
|
meta="BIP-39 Passphrase on [%s]" % xfp2str(parent_xfp))
|
|
dis.draw_status(bip39=int(bool(pw)))
|
|
return ret
|
|
|
|
# Might need to bounce the USB connection, because our pubkey has changed,
|
|
# altho if they have already picked a shared session key, no need, and
|
|
# would only affect MitM test, which has already been done.
|
|
|
|
async def remember_ephemeral_seed():
|
|
# Compute current xprv and switch to using that as root secret.
|
|
import stash
|
|
from glob import dis
|
|
|
|
dis.fullscreen('Check...')
|
|
with stash.SensitiveValues() as sv:
|
|
nv = sv.encoded_secret()
|
|
|
|
dis.draw_status(bip39=0, tmp=0)
|
|
dis.fullscreen('Saving...')
|
|
pa.change(new_secret=nv)
|
|
|
|
# re-read settings since key is now different
|
|
# - also captures xfp, xpub at this point
|
|
pa.new_main_secret(nv)
|
|
|
|
# check and reload secret
|
|
pa.reset()
|
|
pa.login()
|
|
|
|
async def restore_to_main_secret(preserve_settings=False):
|
|
# go back to main se2 secret
|
|
pa.new_main_secret(raw_secret=None, blank=not preserve_settings)
|
|
|
|
def clear_seed():
|
|
from glob import dis
|
|
import utime, callgate
|
|
|
|
dis.fullscreen('Clearing...')
|
|
dis.busy_bar(True)
|
|
|
|
# clear settings associated with this key, since it will be no more
|
|
settings.blank()
|
|
|
|
callgate.fast_wipe(True)
|
|
# NOT REACHED
|
|
|
|
utime.sleep(1)
|
|
|
|
# security: need to reboot to really be sure to clear the secrets from main memory.
|
|
from machine import reset
|
|
reset()
|
|
|
|
async def word_quiz(words, limited=None, title='Word %d is?'):
|
|
# Perform a test, to check they wrote them down
|
|
# Return X if they cancel early.
|
|
# Can just pick a subset # of words, with limited arg.
|
|
|
|
wl = len(words) # 24 or 12, etc.
|
|
|
|
if limited is not None:
|
|
# truncate to some N randomly-selected words in the list
|
|
# and always the last word
|
|
order = list(range(wl-1))
|
|
random.shuffle(order)
|
|
|
|
order = order[0:limited-1]
|
|
order.append(wl-1)
|
|
else:
|
|
order = list(range(wl))
|
|
|
|
random.shuffle(order)
|
|
|
|
for o in order:
|
|
# always 3 choices: right answer, wrong from correct set, random word
|
|
right = words[o]
|
|
|
|
choices = [right]
|
|
while 1:
|
|
n = words[random.randbelow(wl)]
|
|
if n in choices: continue
|
|
choices.append(n)
|
|
break
|
|
|
|
while 1:
|
|
n = bip39.wordlist_en[random.randbelow(0x800)]
|
|
if n in choices: continue
|
|
choices.append(n)
|
|
break
|
|
|
|
while 1:
|
|
random.shuffle(choices)
|
|
|
|
msg = '\n'.join(' %d: %s' % (i+1, choices[i]) for i in range(3))
|
|
msg += '\n\nWhich word is right?\n\nX to give up, OK to see all the words again.'
|
|
|
|
ch = await ux_show_story(msg, title=title % (o+1), escape='123', sensitive=True)
|
|
if ch == 'x':
|
|
# user abort
|
|
return 'x'
|
|
elif ch == 'y':
|
|
await show_words(words)
|
|
continue
|
|
|
|
if ch in '123':
|
|
n = ord(ch) - ord('1')
|
|
|
|
if choices[n] == right:
|
|
break
|
|
|
|
await ux_dramatic_pause('Wrong!', 2)
|
|
|
|
return
|
|
|
|
async def make_seed_vault_menu(*a):
|
|
rv = SeedVaultMenu.construct()
|
|
return SeedVaultMenu(rv)
|
|
|
|
class SeedVaultMenu(MenuSystem):
|
|
|
|
@staticmethod
|
|
async def _set(menu, label, item):
|
|
from glob import dis
|
|
dis.fullscreen("Applying...")
|
|
|
|
xfp, encoded = item.arg
|
|
|
|
await set_ephemeral_seed(encoded, is_restore=True)
|
|
|
|
goto_top_menu()
|
|
|
|
@staticmethod
|
|
async def _remove(menu, label, item):
|
|
from glob import dis, settings
|
|
|
|
idx, xfp_str, encoded = item.arg
|
|
|
|
msg = ("Remove seed from seed vault and delete its "
|
|
"settings?\n\nPress OK to continue, press (1) to "
|
|
"only remove from seed vault and keep "
|
|
"encrypted settings for later use.\n\n"
|
|
"WARNING: Funds will be lost if wallet is"
|
|
" not backed-up elsewhere.")
|
|
|
|
ch = await ux_show_story(title="[" + xfp_str + "]", msg=msg, escape="1")
|
|
if ch == "x": return
|
|
|
|
dis.fullscreen("Saving...")
|
|
|
|
wipe_slot = (ch != "1")
|
|
tmp_val = False
|
|
|
|
if pa.tmp_value:
|
|
tmp_val = True
|
|
|
|
if wipe_slot:
|
|
# are we deleting current active ephemeral wallet
|
|
# and its settings ?
|
|
# slot wiping
|
|
if tmp_val:
|
|
# wipe current settings
|
|
settings.blank()
|
|
pa.tmp_value = False
|
|
settings.return_to_master_seed()
|
|
else:
|
|
# in main settings
|
|
xs = SettingsObject()
|
|
xs.set_key(encoded)
|
|
xs.load()
|
|
xs.blank()
|
|
del xs
|
|
|
|
# CAUTION: will get shadow copy if in tmp seed mode already
|
|
seeds = settings.master_get("seeds", [])
|
|
try:
|
|
del seeds[idx]
|
|
except IndexError:
|
|
pass
|
|
|
|
# need to load and work on master secrets, will be slow if on tmp seed
|
|
settings.master_set("seeds", seeds)
|
|
|
|
if tmp_val and wipe_slot:
|
|
goto_top_menu()
|
|
|
|
# pop menu stack
|
|
the_ux.pop()
|
|
m = the_ux.top_of_stack()
|
|
m.update_contents()
|
|
|
|
@staticmethod
|
|
async def _detail(menu, label, item):
|
|
xfp_str, encoded, name, meta = item.arg
|
|
|
|
# - first byte represents type of secret (internal encoding flag)
|
|
txt = SecretStash.summary(encoded[0])
|
|
|
|
detail = "Name:\n%s\n\nMaster XFP:\n%s\n\nOrigin:\n%s\n\nSecret Type:\n%s" \
|
|
% (name, xfp_str, meta, txt)
|
|
|
|
await ux_show_story(detail)
|
|
|
|
@staticmethod
|
|
async def _rename(menu, label, item):
|
|
# let them edit the name
|
|
from glob import dis
|
|
from ux import ux_input_text
|
|
|
|
idx, xfp_str = item.arg
|
|
|
|
seeds = settings.master_get("seeds", [])
|
|
chk_xfp, encoded, old_name, meta = seeds[idx]
|
|
assert chk_xfp == xfp_str
|
|
|
|
new_name = await ux_input_text(old_name, confirm_exit=False, max_len=40)
|
|
|
|
if not new_name:
|
|
return
|
|
|
|
dis.fullscreen("Saving...")
|
|
|
|
# save it
|
|
seeds[idx] = (chk_xfp, encoded, new_name, meta)
|
|
|
|
# need to load and work on master secrets, will be slow if on tmp seed
|
|
settings.master_set("seeds", seeds)
|
|
|
|
# update label in sub-menu
|
|
menu.items[0].label = new_name
|
|
menu.items[0].arg = menu.items[0].arg[0:2] + (new_name,) + menu.items[0].arg[3:]
|
|
|
|
# .. and name in parent menu too
|
|
parent = the_ux.parent_of(menu)
|
|
if parent:
|
|
parent.update_contents()
|
|
|
|
@staticmethod
|
|
async def _add_current_tmp(*a):
|
|
from pincodes import pa
|
|
|
|
assert pa.tmp_value
|
|
main_xfp = settings.master_get("xfp", 0)
|
|
|
|
new_xfp = settings.get("xfp", 0)
|
|
new_xfp_str = xfp2str(new_xfp)
|
|
|
|
# do not offer to store main seed
|
|
if new_xfp == main_xfp:
|
|
return
|
|
|
|
xfp_ui = "[%s]" % new_xfp_str
|
|
|
|
ch = await ux_show_story(title=xfp_ui, msg="Add to Seed Vault?")
|
|
if ch != "y":
|
|
return
|
|
|
|
seeds = settings.master_get("seeds", [])
|
|
|
|
# Save it into master settings
|
|
seeds.append((new_xfp_str,
|
|
stash.SecretStash.storage_serialize(pa.tmp_value),
|
|
xfp_ui,
|
|
"unknown origin"))
|
|
|
|
settings.master_set("seeds", seeds)
|
|
|
|
await ux_show_story(xfp_ui + "\nSaved to Seed Vault")
|
|
|
|
m = the_ux.top_of_stack()
|
|
m.update_contents()
|
|
|
|
@classmethod
|
|
def construct(cls):
|
|
# Dynamic menu with user-defined names of seeds shown
|
|
from glob import settings
|
|
from pincodes import pa
|
|
|
|
rv = []
|
|
add_current_tmp = MenuItem("Add current tmp", f=cls._add_current_tmp)
|
|
|
|
seeds = settings.master_get("seeds", [])
|
|
|
|
if not seeds:
|
|
rv.append(MenuItem('(none saved yet)'))
|
|
if pa.tmp_value:
|
|
rv.append(add_current_tmp)
|
|
rv.append(MenuItem("Temporary Seed", menu=make_ephemeral_seed_menu))
|
|
else:
|
|
tmp_in_sv = False
|
|
for i, (xfp_str, encoded, name, meta) in enumerate(seeds):
|
|
is_active = False
|
|
encoded = pad_raw_secret(encoded)
|
|
if encoded == pa.tmp_value:
|
|
is_active = tmp_in_sv = True
|
|
submenu = [
|
|
MenuItem(name, f=cls._detail, arg=(xfp_str, encoded, name, meta)),
|
|
MenuItem('Use This Seed', f=cls._set, arg=(xfp_str, encoded)),
|
|
MenuItem('Rename', f=cls._rename, arg=(i, xfp_str)),
|
|
MenuItem('Delete', f=cls._remove, arg=(i, xfp_str, encoded)),
|
|
]
|
|
if is_active:
|
|
submenu[1] = MenuItem("Seed In Use")
|
|
submenu[1].is_chosen = lambda: True
|
|
|
|
if pa.tmp_value and (not is_active):
|
|
# if different ephemeral wallet active
|
|
# DO NOT offer any modification api (rename/delete)
|
|
submenu = submenu[:2]
|
|
|
|
item = MenuItem('%d: %s' % (i+1, name), menu=MenuSystem(submenu))
|
|
if is_active:
|
|
item.is_chosen = lambda: True
|
|
|
|
rv.append(item)
|
|
|
|
if pa.tmp_value:
|
|
if seeds and (not tmp_in_sv):
|
|
# give em chance to store current active
|
|
rv.append(add_current_tmp)
|
|
|
|
from actions import restore_main_secret
|
|
rv.append(MenuItem("Restore Master", f=restore_main_secret))
|
|
|
|
return rv
|
|
|
|
def update_contents(self):
|
|
# Reconstruct the list of wallets on this dynamic menu, because
|
|
# we added or changed them and are showing that same menu again.
|
|
tmp = self.construct()
|
|
self.replace_items(tmp)
|
|
|
|
class EphemeralSeedMenu(MenuSystem):
|
|
|
|
@staticmethod
|
|
async def ephemeral_seed_import(menu, label, item):
|
|
return await ephemeral_seed_import(item.arg)
|
|
|
|
@staticmethod
|
|
async def ephemeral_seed_generate(menu, label, item):
|
|
return await ephemeral_seed_generate(item.arg)
|
|
|
|
@staticmethod
|
|
async def ephemeral_seed_generate_from_dice(menu, label, item):
|
|
return await ephemeral_seed_generate_from_dice(item.arg)
|
|
|
|
@classmethod
|
|
def construct(cls):
|
|
from glob import NFC
|
|
from actions import nfc_recv_ephemeral, import_tapsigner_backup_file, import_xprv, restore_temporary
|
|
|
|
import_ephemeral_menu = [
|
|
MenuItem("12 Words", f=cls.ephemeral_seed_import, arg=12),
|
|
MenuItem("18 Words", f=cls.ephemeral_seed_import, arg=18),
|
|
MenuItem("24 Words", f=cls.ephemeral_seed_import, arg=24),
|
|
MenuItem("Import via NFC", f=nfc_recv_ephemeral, predicate=lambda: NFC is not None),
|
|
]
|
|
gen_ephemeral_menu = [
|
|
MenuItem("12 Words", f=cls.ephemeral_seed_generate, arg=12),
|
|
MenuItem("24 Words", f=cls.ephemeral_seed_generate, arg=24),
|
|
MenuItem("12 Word Dice Roll", f=cls.ephemeral_seed_generate_from_dice, arg=12),
|
|
MenuItem("24 Word Dice Roll", f=cls.ephemeral_seed_generate_from_dice, arg=24),
|
|
]
|
|
|
|
rv = [
|
|
MenuItem("Generate Words", menu=gen_ephemeral_menu),
|
|
MenuItem("Import Words", menu=import_ephemeral_menu),
|
|
MenuItem("Import XPRV", f=import_xprv, arg=True), # ephemeral=True
|
|
MenuItem("Tapsigner Backup", f=import_tapsigner_backup_file, arg=True), # ephemeral=True
|
|
MenuItem("Coldcard Backup", f=restore_temporary),
|
|
]
|
|
|
|
return rv
|
|
|
|
|
|
async def make_ephemeral_seed_menu(*a):
|
|
if (not pa.tmp_value) and (not settings.master_get("seedvault", False)):
|
|
# force a warning on them, unless they are already doing it.
|
|
ch = await ux_show_story(
|
|
"Temporary seed is a secret completely separate "
|
|
"from the master seed, typically held in device RAM and "
|
|
"not persisted between reboots in the Secure Element. "
|
|
"Enable the Seed Vault feature to store these secrets longer-term."
|
|
"\n\nPress (4) to prove you read to the end"
|
|
" of this message and accept all consequences.",
|
|
title="WARNING",
|
|
escape="4"
|
|
)
|
|
if ch != "4":
|
|
return
|
|
|
|
rv = EphemeralSeedMenu.construct()
|
|
return EphemeralSeedMenu(rv)
|
|
|
|
|
|
pp_sofar = ''
|
|
|
|
class PassphraseMenu(MenuSystem):
|
|
# Collect up to 100 chars as a BIP-39 passphrase
|
|
|
|
# singleton (cls level) vars
|
|
done_cb = None
|
|
|
|
def __init__(self):
|
|
global pp_sofar
|
|
pp_sofar = ''
|
|
|
|
if version.has_qwerty:
|
|
items = [
|
|
MenuItem('Edit Phrase', f=self.view_edit_phrase),
|
|
MenuItem('Clear Phrase', f=self.empty_phrase),
|
|
MenuItem('APPLY', f=self.done_apply),
|
|
MenuItem('CANCEL', f=self.done_cancel),
|
|
]
|
|
else:
|
|
items = [
|
|
# xxxxxxxxxxxxxxxx
|
|
MenuItem('Edit Phrase', f=self.view_edit_phrase),
|
|
MenuItem('Add Word', menu=self.word_menu),
|
|
MenuItem('Add Numbers', f=self.add_numbers),
|
|
MenuItem('Clear All', f=self.empty_phrase),
|
|
MenuItem('APPLY', f=self.done_apply),
|
|
MenuItem('CANCEL', f=self.done_cancel),
|
|
]
|
|
# quick SD card check
|
|
# TODO this needs to handle 2 SD cards now ?
|
|
if pyb.SDCard().present():
|
|
try:
|
|
with CardSlot() as card:
|
|
# check if passphrases file exists on SD
|
|
# if yes add menu item
|
|
if card.exists(PassphraseSaver().filename(card)):
|
|
items.insert(0, MenuItem('Restore Saved', menu=self.restore_saved))
|
|
|
|
except: pass
|
|
|
|
super(PassphraseMenu, self).__init__(items)
|
|
|
|
@staticmethod
|
|
async def restore_saved(*a):
|
|
dis.fullscreen("Decrypting...")
|
|
try:
|
|
menu = PassphraseSaver().make_menu()
|
|
except CardMissingError:
|
|
await needs_microsd()
|
|
return
|
|
except Exception as e:
|
|
await ux_show_story(title="Failure", msg=str(e) + problem_file_line(e))
|
|
return
|
|
|
|
if not menu:
|
|
await ux_show_story("Nothing found")
|
|
return
|
|
|
|
return menu
|
|
|
|
def on_cancel(self):
|
|
# zip to cancel item when they fail to exit via X button
|
|
self.goto_idx(self.count - 1)
|
|
|
|
async def word_menu(self, *a):
|
|
return SingleWordMenu()
|
|
|
|
async def add_numbers(self, *a):
|
|
global pp_sofar
|
|
pw = await ux_input_numbers(pp_sofar, self.check_length)
|
|
if pw is not None:
|
|
pp_sofar = pw
|
|
self.check_length()
|
|
|
|
async def empty_phrase(self, *a):
|
|
global pp_sofar
|
|
|
|
if len(pp_sofar) >= 3:
|
|
if not await ux_confirm("Press OK to clear passphrase. X to cancel."):
|
|
return
|
|
|
|
pp_sofar = ''
|
|
await ux_dramatic_pause('Cleared...', 0.25)
|
|
|
|
async def backspace(self, *a):
|
|
global pp_sofar
|
|
if pp_sofar:
|
|
pp_sofar = pp_sofar[0:-1]
|
|
|
|
async def view_edit_phrase(self, *a):
|
|
# let them control each character
|
|
global pp_sofar
|
|
pw = await ux_input_text(pp_sofar)
|
|
if pw is not None:
|
|
pp_sofar = pw
|
|
self.check_length()
|
|
|
|
@classmethod
|
|
def check_length(cls):
|
|
# enforce a limit of 100 chars
|
|
global pp_sofar
|
|
pp_sofar = pp_sofar[0:100]
|
|
|
|
@staticmethod
|
|
async def add_text(_1, _2, item):
|
|
global pp_sofar
|
|
pp_sofar += item.label
|
|
PassphraseMenu.check_length()
|
|
|
|
while not isinstance(the_ux.top_of_stack(), PassphraseMenu):
|
|
the_ux.pop()
|
|
|
|
async def done_cancel(self, *a):
|
|
global pp_sofar
|
|
|
|
if len(pp_sofar) > 3:
|
|
if not await ux_confirm("What you have entered will be forgotten."):
|
|
return
|
|
|
|
goto_top_menu()
|
|
|
|
async def done_apply(self, *a):
|
|
# apply the passphrase.
|
|
# - important to work on empty string here too.
|
|
import stash
|
|
from glob import settings
|
|
from pincodes import pa
|
|
|
|
nv, xfp, parent_xfp = await calc_bip39_passphrase(pp_sofar, bypass_tmp=True)
|
|
|
|
msg = ('Above is the master key fingerprint of the new wallet. '
|
|
'Press X to abort and keep editing passphrase, '
|
|
'OK to use the new wallet, (1) to use and save to MicroSD')
|
|
|
|
msg1 = ""
|
|
if pa.tmp_value and settings.get("words", True):
|
|
# we have ephemeral seed but can add passphrase to it as it is word based
|
|
msg1 = (", or press (2) to add passphrase to the current "
|
|
"active temporary seed instead of the main seed.")
|
|
|
|
ch = await ux_show_story(msg + msg1, title="[%s]" % xfp2str(xfp), escape='12')
|
|
if ch == 'x':
|
|
return
|
|
|
|
if ch == "2":
|
|
stash.SensitiveValues.clear_cache()
|
|
nv, xfp, parent_xfp = await calc_bip39_passphrase(pp_sofar, bypass_tmp=False)
|
|
ch = await ux_show_story(msg, title="[%s]" % xfp2str(xfp), escape='1')
|
|
if ch == "x": return
|
|
|
|
await set_ephemeral_seed(nv, summarize_ux=False, bip39pw=pp_sofar,
|
|
meta="BIP-39 Passphrase on [%s]" % xfp2str(parent_xfp))
|
|
if ch == '1':
|
|
await PassphraseSaver().append(xfp, pp_sofar)
|
|
|
|
goto_top_menu()
|
|
|
|
class SingleWordMenu(WordNestMenu):
|
|
def __init__(self, items=None, **kws):
|
|
if items:
|
|
super(SingleWordMenu, self).__init__(items=items, **kws)
|
|
else:
|
|
super(SingleWordMenu, self).__init__(num_words=1, has_checksum=False, done_cb=None)
|
|
|
|
@staticmethod
|
|
async def all_done(new_words):
|
|
# create one more menu w/ the word and some variations on that word
|
|
word = new_words[0]
|
|
options = [word, word[0].upper() + word[1:], word.upper()]
|
|
for w in options[:]:
|
|
options.append(' ' + w)
|
|
|
|
# bugfix: in case they cancel from new menu
|
|
WordNestMenu.words = []
|
|
|
|
return MenuSystem([MenuItem(w, f=PassphraseMenu.add_text)
|
|
for n,w in enumerate(options)], space_indicators=True)
|
|
|
|
|
|
# EOF
|