507 lines
16 KiB
Python
507 lines
16 KiB
Python
# (c) Copyright 2018 by Coinkite Inc. This file is covered by license found in COPYING-CC.
|
|
#
|
|
# export.py - Export and share various semi-public data
|
|
#
|
|
import stash, chains, version, ujson
|
|
from uio import StringIO
|
|
from ucollections import OrderedDict
|
|
from utils import xfp2str, swab32, export_prompt_builder
|
|
from ux import ux_show_story
|
|
from glob import settings
|
|
|
|
|
|
def generate_public_contents():
|
|
# Generate public details about wallet.
|
|
#
|
|
# simple text format:
|
|
# key = value
|
|
# or #comments
|
|
# but value is JSON
|
|
from public_constants import AF_CLASSIC
|
|
|
|
num_rx = 5
|
|
|
|
chain = chains.current_chain()
|
|
|
|
with stash.SensitiveValues() as sv:
|
|
|
|
xfp = xfp2str(swab32(sv.node.my_fp()))
|
|
|
|
yield ('''\
|
|
# Coldcard Wallet Summary File
|
|
## For wallet with master key fingerprint: {xfp}
|
|
|
|
Wallet operates on blockchain: {nb}
|
|
|
|
For BIP-44, this is coin_type '{ct}', and internally we use
|
|
symbol {sym} for this blockchain.
|
|
|
|
## IMPORTANT WARNING
|
|
|
|
**NEVER** deposit to any address in this file unless you have a working
|
|
wallet system that is ready to handle the funds at that address!
|
|
|
|
## Top-level, 'master' extended public key ('m/'):
|
|
|
|
{xpub}
|
|
|
|
What follows are derived public keys and payment addresses, as may
|
|
be needed for different systems.
|
|
|
|
|
|
'''.format(nb=chain.name, xpub=chain.serialize_public(sv.node),
|
|
sym=chain.ctype, ct=chain.b44_cointype, xfp=xfp))
|
|
|
|
for name, path, addr_fmt in chains.CommonDerivations:
|
|
|
|
if '{coin_type}' in path:
|
|
path = path.replace('{coin_type}', str(chain.b44_cointype))
|
|
|
|
if '{' in name:
|
|
name = name.format(core_name=chain.core_name)
|
|
|
|
show_slip132 = ('Core' not in name)
|
|
|
|
yield ('''## For {name}: {path}\n\n'''.format(name=name, path=path))
|
|
yield ('''First %d receive addresses (account=0, change=0):\n\n''' % num_rx)
|
|
|
|
submaster = None
|
|
for i in range(num_rx):
|
|
subpath = path.format(account=0, change=0, idx=i)
|
|
|
|
# find the prefix of the path that is hardneded
|
|
if "'" in subpath:
|
|
hard_sub = subpath.rsplit("'", 1)[0] + "'"
|
|
else:
|
|
hard_sub = 'm'
|
|
|
|
if hard_sub != submaster:
|
|
# dump the xpub needed
|
|
|
|
if submaster:
|
|
yield "\n"
|
|
|
|
node = sv.derive_path(hard_sub, register=False)
|
|
yield ("%s => %s\n" % (hard_sub, chain.serialize_public(node)))
|
|
if show_slip132 and addr_fmt != AF_CLASSIC and (addr_fmt in chain.slip132):
|
|
yield ("%s => %s ##SLIP-132##\n" % (
|
|
hard_sub, chain.serialize_public(node, addr_fmt)))
|
|
|
|
submaster = hard_sub
|
|
node.blank()
|
|
del node
|
|
|
|
# show the payment address
|
|
node = sv.derive_path(subpath, register=False)
|
|
yield ('%s => %s\n' % (subpath, chain.address(node, addr_fmt)))
|
|
|
|
node.blank()
|
|
del node
|
|
|
|
yield ('\n\n')
|
|
|
|
from multisig import MultisigWallet
|
|
if MultisigWallet.exists():
|
|
yield '\n# Your Multisig Wallets\n\n'
|
|
|
|
for ms in MultisigWallet.get_all():
|
|
fp = StringIO()
|
|
|
|
ms.render_export(fp)
|
|
print("\n---\n", file=fp)
|
|
|
|
yield fp.getvalue()
|
|
del fp
|
|
|
|
async def write_text_file(fname_pattern, body, title, total_parts=72):
|
|
# - total_parts does need not be precise
|
|
from glob import dis, VD, NFC
|
|
from files import CardSlot, CardMissingError, needs_microsd
|
|
|
|
force_vdisk = False
|
|
prompt, escape = export_prompt_builder("%s file" % title)
|
|
if prompt:
|
|
ch = await ux_show_story(prompt, escape=escape)
|
|
if ch == '3':
|
|
await NFC.share_text(body)
|
|
return
|
|
elif ch == "2":
|
|
force_vdisk = True
|
|
elif ch == '1':
|
|
force_vdisk = False
|
|
else:
|
|
return
|
|
|
|
# choose a filename
|
|
try:
|
|
dis.fullscreen("Saving...")
|
|
with CardSlot(force_vdisk=force_vdisk) as card:
|
|
fname, nice = card.pick_filename(fname_pattern)
|
|
|
|
# do actual write
|
|
with open(fname, 'wb') as fd:
|
|
body_len = len(body)
|
|
chunk = body_len // 10
|
|
for idx, i in enumerate(range(0, body_len, chunk)):
|
|
dis.progress_bar_show(idx / 10)
|
|
fd.write(body[i:i+chunk])
|
|
|
|
except CardMissingError:
|
|
await needs_microsd()
|
|
return
|
|
except Exception as e:
|
|
await ux_show_story('Failed to write!\n\n\n'+str(e))
|
|
return
|
|
|
|
msg = '''%s file written:\n\n%s''' % (title, nice)
|
|
await ux_show_story(msg)
|
|
|
|
async def make_summary_file(fname_pattern='public.txt'):
|
|
from glob import dis
|
|
|
|
# record **public** values and helpful data into a text file
|
|
dis.fullscreen('Generating...')
|
|
|
|
# generator function:
|
|
body = "".join(list(generate_public_contents()))
|
|
|
|
await write_text_file(fname_pattern, body, 'Summary')
|
|
|
|
async def make_bitcoin_core_wallet(account_num=0, fname_pattern='bitcoin-core.txt'):
|
|
from glob import dis
|
|
xfp = xfp2str(settings.get('xfp'))
|
|
|
|
dis.fullscreen('Generating...')
|
|
|
|
# make the data
|
|
examples = []
|
|
imp_multi, imp_desc = generate_bitcoin_core_wallet(account_num, examples)
|
|
|
|
imp_multi = ujson.dumps(imp_multi)
|
|
imp_desc = ujson.dumps(imp_desc)
|
|
|
|
body = '''\
|
|
# Bitcoin Core Wallet Import File
|
|
|
|
https://github.com/Coldcard/firmware/blob/master/docs/bitcoin-core-usage.md
|
|
|
|
## For wallet with master key fingerprint: {xfp}
|
|
|
|
Wallet operates on blockchain: {nb}
|
|
|
|
## Bitcoin Core RPC
|
|
|
|
The following command can be entered after opening Window -> Console
|
|
in Bitcoin Core, or using bitcoin-cli:
|
|
|
|
importdescriptors '{imp_desc}'
|
|
|
|
> **NOTE** If your UTXO was created before generating `importdescriptors` command, you should adjust the value of `timestamp` before executing command in bitcoin core.
|
|
By default it is set to `now` meaning do not rescan the blockchain. If approximate time of UTXO creation is known - adjust `timestamp` from `now` to UNIX epoch time.
|
|
0 can be specified to scan the entire blockchain. Alternatively `rescanblockchain` command can be used after executing importdescriptors command.
|
|
|
|
### Bitcoin Core before v0.21.0
|
|
|
|
This command can be used on older versions, but it is not as robust
|
|
and "importdescriptors" should be prefered if possible:
|
|
|
|
importmulti '{imp_multi}'
|
|
|
|
## Resulting Addresses (first 3)
|
|
|
|
'''.format(imp_multi=imp_multi, imp_desc=imp_desc, xfp=xfp, nb=chains.current_chain().name)
|
|
|
|
body += '\n'.join('%s => %s' % t for t in examples)
|
|
|
|
body += '\n'
|
|
|
|
await write_text_file(fname_pattern, body, 'Bitcoin Core')
|
|
|
|
def generate_bitcoin_core_wallet(account_num, example_addrs):
|
|
# Generate the data for an RPC command to import keys into Bitcoin Core
|
|
# - yields dicts for json purposes
|
|
from descriptor import Descriptor
|
|
|
|
from public_constants import AF_P2WPKH
|
|
|
|
chain = chains.current_chain()
|
|
|
|
derive = "84'/{coin_type}'/{account}'".format(account=account_num, coin_type=chain.b44_cointype)
|
|
|
|
with stash.SensitiveValues() as sv:
|
|
prefix = sv.derive_path(derive)
|
|
xpub = chain.serialize_public(prefix)
|
|
|
|
for i in range(3):
|
|
sp = '0/%d' % i
|
|
node = sv.derive_path(sp, master=prefix)
|
|
a = chain.address(node, AF_P2WPKH)
|
|
example_addrs.append( ('m/%s/%s' % (derive, sp), a) )
|
|
|
|
xfp = settings.get('xfp')
|
|
txt_xfp = xfp2str(xfp).lower()
|
|
_, vers, _ = version.get_mpy_version()
|
|
|
|
desc_obj = Descriptor(keys=[(xfp, derive, xpub)], addr_fmt=AF_P2WPKH)
|
|
# for importmulti
|
|
imm_list = [
|
|
{
|
|
'desc': desc_obj.serialize(internal=internal),
|
|
'range': [0, 1000],
|
|
'timestamp': 'now',
|
|
'internal': internal,
|
|
'keypool': True,
|
|
'watchonly': True
|
|
}
|
|
for internal in [False, True]
|
|
]
|
|
# for importdescriptors
|
|
imd_list = desc_obj.bitcoin_core_serialize(external_label="Coldcard %s" % txt_xfp)
|
|
return imm_list, imd_list
|
|
|
|
def generate_wasabi_wallet():
|
|
# Generate the data for a JSON file which Wasabi can open directly as a new wallet.
|
|
import version
|
|
|
|
# bitcoin (xpub) is used, even for testnet case (ie. no tpub)
|
|
# - altho, doesn't matter; the wallet operates based on it's own settings for test/mainnet
|
|
# regardless of the contents of the wallet file
|
|
btc = chains.BitcoinMain
|
|
|
|
with stash.SensitiveValues() as sv:
|
|
xpub = btc.serialize_public(sv.derive_path("84'/0'/0'"))
|
|
|
|
xfp = settings.get('xfp')
|
|
txt_xfp = xfp2str(xfp)
|
|
|
|
# chain = chains.current_chain()
|
|
# https://docs.wasabiwallet.io/using-wasabi/Testnet.html#activating-testnet-in-wasabi
|
|
# https://github.com/zkSNACKs/WalletWasabi/blob/master/WalletWasabi.Documentation/WasabiSetupRegtest.md
|
|
# as we do not shitcoin here - check is useless
|
|
# would yikes on XRT
|
|
# assert chain.ctype in {'BTC', 'XTN', 'XRT'}, "Only Bitcoin supported"
|
|
|
|
_,vers,_ = version.get_mpy_version()
|
|
|
|
return OrderedDict(ColdCardFirmwareVersion=vers,
|
|
MasterFingerprint=txt_xfp,
|
|
ExtPubKey=xpub)
|
|
|
|
def generate_unchained_export(acct_num=0):
|
|
# They used to rely on our airgapped export file, so this is same style
|
|
# - for multisig purposes
|
|
# - BIP-45 style paths for now
|
|
# - no account numbers (at this level)
|
|
from public_constants import AF_P2SH, AF_P2WSH_P2SH, AF_P2WSH
|
|
|
|
chain = chains.current_chain()
|
|
todo = [
|
|
( "m/48'/{coin}'/{acct_num}'/2'", 'p2wsh', AF_P2WSH ),
|
|
("m/48'/{coin}'/{acct_num}'/1'", 'p2sh_p2wsh', AF_P2WSH_P2SH),
|
|
("m/45'", 'p2sh', AF_P2SH), # iff acct_num == 0
|
|
]
|
|
|
|
xfp = xfp2str(settings.get('xfp', 0))
|
|
rv = OrderedDict(xfp=xfp, account=acct_num)
|
|
|
|
with stash.SensitiveValues() as sv:
|
|
for deriv, name, fmt in todo:
|
|
if fmt == AF_P2SH and acct_num:
|
|
continue
|
|
dd = deriv.format(coin=chain.b44_cointype, acct_num=acct_num)
|
|
node = sv.derive_path(dd)
|
|
xp = chain.serialize_public(node, fmt)
|
|
|
|
rv['%s_deriv' % name] = dd
|
|
rv[name] = xp
|
|
|
|
return rv
|
|
|
|
def generate_generic_export(account_num=0):
|
|
# Generate data that other programers will use to import Coldcard (single-signer)
|
|
from public_constants import AF_CLASSIC, AF_P2WPKH, AF_P2WPKH_P2SH, AF_P2WSH, AF_P2WSH_P2SH
|
|
from public_constants import AF_P2SH
|
|
from descriptor import Descriptor, multisig_descriptor_template
|
|
|
|
chain = chains.current_chain()
|
|
master_xfp = settings.get("xfp")
|
|
master_xfp_str = xfp2str(master_xfp)
|
|
|
|
rv = OrderedDict(chain=chain.ctype,
|
|
xfp=master_xfp_str,
|
|
account=account_num,
|
|
xpub=settings.get('xpub'))
|
|
|
|
with stash.SensitiveValues() as sv:
|
|
# each of these paths would have /{change}/{idx} in usage (not hardened)
|
|
for name, deriv, fmt, atype, is_ms in [
|
|
( 'bip44', "m/44'/{ct}'/{acc}'", AF_CLASSIC, 'p2pkh', False ),
|
|
( 'bip49', "m/49'/{ct}'/{acc}'", AF_P2WPKH_P2SH, 'p2sh-p2wpkh', False ), # was "p2wpkh-p2sh"
|
|
( 'bip84', "m/84'/{ct}'/{acc}'", AF_P2WPKH, 'p2wpkh', False ),
|
|
( 'bip48_1', "m/48'/{ct}'/{acc}'/1'", AF_P2WSH_P2SH, 'p2sh-p2wsh', True ),
|
|
( 'bip48_2', "m/48'/{ct}'/{acc}'/2'", AF_P2WSH, 'p2wsh', True ),
|
|
( 'bip45', "m/45'", AF_P2SH, 'p2sh', True ),
|
|
]:
|
|
if fmt == AF_P2SH and account_num:
|
|
continue
|
|
|
|
dd = deriv.format(ct=chain.b44_cointype, acc=account_num)
|
|
node = sv.derive_path(dd)
|
|
xfp = xfp2str(swab32(node.my_fp()))
|
|
xp = chain.serialize_public(node, AF_CLASSIC)
|
|
zp = chain.serialize_public(node, fmt) if fmt != AF_CLASSIC else None
|
|
if is_ms:
|
|
desc = multisig_descriptor_template(xp, dd, master_xfp_str, fmt)
|
|
else:
|
|
desc = Descriptor(keys=[(master_xfp, dd, xp)], addr_fmt=fmt).serialize(int_ext=True)
|
|
|
|
rv[name] = OrderedDict(name=atype,
|
|
xfp=xfp,
|
|
deriv=dd,
|
|
xpub=xp,
|
|
desc=desc)
|
|
|
|
if zp and zp != xp:
|
|
rv[name]['_pub'] = zp
|
|
|
|
if not is_ms:
|
|
# bonus/check: first non-change address: 0/0
|
|
node.derive(0, False).derive(0, False)
|
|
rv[name]['first'] = chain.address(node, fmt)
|
|
|
|
return rv
|
|
|
|
def generate_electrum_wallet(addr_type, account_num=0):
|
|
# Generate line-by-line JSON details about wallet.
|
|
#
|
|
# Much reverse enginerring of Electrum here. It's a complex
|
|
# legacy file format.
|
|
from public_constants import AF_CLASSIC, AF_P2WPKH, AF_P2WPKH_P2SH
|
|
|
|
chain = chains.current_chain()
|
|
|
|
xfp = settings.get('xfp')
|
|
|
|
# Must get the derivation path, and the SLIP32 version bytes right!
|
|
if addr_type == AF_CLASSIC:
|
|
mode = 44
|
|
elif addr_type == AF_P2WPKH:
|
|
mode = 84
|
|
elif addr_type == AF_P2WPKH_P2SH:
|
|
mode = 49
|
|
else:
|
|
raise ValueError(addr_type)
|
|
|
|
derive = "m/{mode}'/{coin_type}'/{account}'".format(mode=mode,
|
|
account=account_num, coin_type=chain.b44_cointype)
|
|
|
|
with stash.SensitiveValues() as sv:
|
|
top = chain.serialize_public(sv.derive_path(derive), addr_type)
|
|
|
|
# most values are nicely defaulted, and for max forward compat, don't want to set
|
|
# anything more than I need to
|
|
|
|
rv = OrderedDict(seed_version=17, use_encryption=False, wallet_type='standard')
|
|
|
|
lab = 'Coldcard Import %s' % xfp2str(xfp)
|
|
if account_num:
|
|
lab += ' Acct#%d' % account_num
|
|
|
|
# the important stuff.
|
|
rv['keystore'] = OrderedDict(type='hardware',
|
|
hw_type='coldcard',
|
|
label=lab,
|
|
ckcc_xfp=xfp,
|
|
ckcc_xpub=settings.get('xpub'),
|
|
derivation=derive,
|
|
xpub=top)
|
|
|
|
return rv
|
|
|
|
async def make_json_wallet(label, generator, fname_pattern='new-wallet.json'):
|
|
# Record **public** values and helpful data into a JSON file
|
|
|
|
from glob import dis, NFC, VD
|
|
from files import CardSlot, CardMissingError, needs_microsd
|
|
|
|
dis.fullscreen('Generating...')
|
|
|
|
body = generator()
|
|
|
|
force_vdisk = False
|
|
prompt, escape = export_prompt_builder("%s file" % label)
|
|
if prompt:
|
|
ch = await ux_show_story(prompt, escape=escape)
|
|
if ch == '3':
|
|
await NFC.share_json(ujson.dumps(body))
|
|
return
|
|
elif ch == "2":
|
|
force_vdisk = True
|
|
elif ch == '1':
|
|
force_vdisk = False
|
|
else:
|
|
return
|
|
|
|
# choose a filename and save
|
|
try:
|
|
with CardSlot(force_vdisk=force_vdisk) as card:
|
|
fname, nice = card.pick_filename(fname_pattern)
|
|
|
|
# do actual write
|
|
with open(fname, 'wt') as fd:
|
|
ujson.dump(body, fd)
|
|
|
|
except CardMissingError:
|
|
await needs_microsd()
|
|
return
|
|
except Exception as e:
|
|
await ux_show_story('Failed to write!\n\n\n'+str(e))
|
|
return
|
|
|
|
msg = '''%s file written:\n\n%s''' % (label, nice)
|
|
await ux_show_story(msg)
|
|
|
|
|
|
async def make_descriptor_wallet_export(addr_type, account_num=0, mode=None, int_ext=True):
|
|
from public_constants import AF_CLASSIC, AF_P2WPKH, AF_P2WPKH_P2SH
|
|
from descriptor import Descriptor
|
|
from glob import dis
|
|
|
|
dis.fullscreen('Generating...')
|
|
chain = chains.current_chain()
|
|
|
|
xfp = settings.get('xfp')
|
|
|
|
if mode is None:
|
|
if addr_type == AF_CLASSIC:
|
|
mode = 44
|
|
elif addr_type == AF_P2WPKH:
|
|
mode = 84
|
|
elif addr_type == AF_P2WPKH_P2SH:
|
|
mode = 49
|
|
else:
|
|
raise ValueError(addr_type)
|
|
|
|
derive = "m/{mode}'/{coin_type}'/{account}'".format(mode=mode,
|
|
account=account_num, coin_type=chain.b44_cointype)
|
|
|
|
with stash.SensitiveValues() as sv:
|
|
xpub = chain.serialize_public(sv.derive_path(derive))
|
|
|
|
desc = Descriptor(keys=[(xfp, derive, xpub)], addr_fmt=addr_type)
|
|
if int_ext:
|
|
# with <0;1> notation
|
|
body = desc.serialize(int_ext=True)
|
|
else:
|
|
# external descriptor
|
|
# internal descriptor
|
|
body = "%s\n%s" % (
|
|
desc.serialize(internal=False),
|
|
desc.serialize(internal=True),
|
|
)
|
|
|
|
await write_text_file(fname_pattern="descriptor.txt", body=body, title="Descriptor")
|
|
|
|
# EOF
|
|
|