mirror of
https://github.com/trezor/trezor-firmware.git
synced 2024-12-04 05:28:17 +00:00
551 lines
20 KiB
Python
Executable File
551 lines
20 KiB
Python
Executable File
#!/usr/bin/env python
|
|
|
|
# This file is part of the TREZOR project.
|
|
#
|
|
# Copyright (C) 2012-2016 Marek Palatinus <slush@satoshilabs.com>
|
|
# Copyright (C) 2012-2016 Pavol Rusnak <stick@satoshilabs.com>
|
|
# Copyright (C) 2016 Jochen Hoenicke <hoenicke@gmail.com>
|
|
#
|
|
# This library is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU Lesser General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# This library is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU Lesser General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU Lesser General Public License
|
|
# along with this library. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
from __future__ import print_function
|
|
import sys
|
|
import os
|
|
import binascii
|
|
import argparse
|
|
import json
|
|
import base64
|
|
import tempfile
|
|
from trezorlib import types_pb2 as types
|
|
from io import BytesIO
|
|
|
|
from trezorlib.client import TrezorClient, TrezorClientDebug, CallException
|
|
import trezorlib.types_pb2 as types
|
|
|
|
ether_units = {
|
|
"wei": 1,
|
|
"kwei": 1000,
|
|
"babbage": 1000,
|
|
"femtoether": 1000,
|
|
"mwei": 1000000,
|
|
"lovelace": 1000000,
|
|
"picoether": 1000000,
|
|
"gwei": 1000000000,
|
|
"shannon": 1000000000,
|
|
"nanoether": 1000000000,
|
|
"nano": 1000000000,
|
|
"szabo": 1000000000000,
|
|
"microether": 1000000000000,
|
|
"micro": 1000000000000,
|
|
"finney": 1000000000000000,
|
|
"milliether": 1000000000000000,
|
|
"milli": 1000000000000000,
|
|
"ether": 1000000000000000000,
|
|
"eth": 1000000000000000000,
|
|
}
|
|
|
|
def init_parser(commands):
|
|
parser = argparse.ArgumentParser(description='Commandline tool for TREZOR devices.')
|
|
parser.add_argument('-v', '--verbose', dest='verbose', action='store_true', help='Prints communication to device')
|
|
parser.add_argument('-t', '--transport', dest='transport', choices=['usb', 'udp', 'pipe', 'bridge'], default='usb', help="Transport used for talking with the device")
|
|
parser.add_argument('-p', '--path', dest='path', default='', help="Path used by the transport")
|
|
parser.add_argument('-j', '--json', dest='json', action='store_true', help="Prints result as json object")
|
|
|
|
cmdparser = parser.add_subparsers(title='Available commands')
|
|
|
|
for cmd in commands._list_commands():
|
|
func = object.__getattribute__(commands, cmd)
|
|
|
|
try:
|
|
arguments = func.arguments
|
|
except AttributeError:
|
|
arguments = ((('params',), {'nargs': '*'}),)
|
|
|
|
item = cmdparser.add_parser(cmd, help=func.help)
|
|
for arg in arguments:
|
|
item.add_argument(*arg[0], **arg[1])
|
|
|
|
item.set_defaults(func=func)
|
|
item.set_defaults(cmd=cmd)
|
|
|
|
return parser
|
|
|
|
def get_transport(transport_string, path, **kwargs):
|
|
if transport_string == 'usb':
|
|
from trezorlib.transport_hid import HidTransport
|
|
|
|
for d in HidTransport.enumerate():
|
|
# Two-tuple of (normal_interface, debug_interface)
|
|
if path == '' or path in d:
|
|
return HidTransport(d, **kwargs)
|
|
|
|
raise CallException(types.Failure_Other, "Device not found")
|
|
|
|
if transport_string == 'udp':
|
|
from trezorlib.transport_udp import UdpTransport
|
|
return UdpTransport(path, **kwargs)
|
|
|
|
if transport_string == 'pipe':
|
|
from trezorlib.transport_pipe import PipeTransport
|
|
if path == '':
|
|
path = '/tmp/pipe.trezor'
|
|
return PipeTransport(path, is_device=False, **kwargs)
|
|
|
|
if transport_string == 'bridge':
|
|
from trezorlib.transport_bridge import BridgeTransport
|
|
|
|
devices = BridgeTransport.enumerate()
|
|
for d in devices:
|
|
if path == '' or d['path'] == binascii.hexlify(path):
|
|
return BridgeTransport(d, **kwargs)
|
|
|
|
raise CallException(types.Failure_Other, "Device not found")
|
|
|
|
raise NotImplementedError("Unknown transport")
|
|
|
|
class Commands(object):
|
|
def __init__(self, client):
|
|
self.client = client
|
|
|
|
@classmethod
|
|
def _list_commands(cls):
|
|
return [x for x in dir(cls) if not x.startswith('_')]
|
|
|
|
def list(self, args):
|
|
# Fake method for advertising 'list' command
|
|
pass
|
|
|
|
def get_address(self, args):
|
|
address_n = self.client.expand_path(args.n)
|
|
return self.client.get_address(args.coin, address_n, args.show_display)
|
|
|
|
def ethereum_get_address(self, args):
|
|
address_n = self.client.expand_path(args.n)
|
|
address = self.client.ethereum_get_address(address_n, args.show_display)
|
|
return "0x%s" % (binascii.hexlify(address),)
|
|
|
|
def ethereum_sign_tx(self, args):
|
|
from ethjsonrpc import EthJsonRpc
|
|
from ethjsonrpc.utils import hex_to_dec
|
|
import rlp
|
|
|
|
value = args.value
|
|
if ' ' in value:
|
|
value, unit = value.split(' ', 1)
|
|
if unit.lower() not in ether_units:
|
|
raise CallException(types.Failure_Other, "Unrecognized ether unit %r" % unit)
|
|
value = int(value) * ether_units[unit.lower()]
|
|
else:
|
|
value = int(value)
|
|
|
|
if args.to.startswith('0x') or args.to.startswith('0X'):
|
|
to_address = args.to[2:].decode('hex')
|
|
else:
|
|
to_address = args.to.decode('hex')
|
|
|
|
address_n = self.client.expand_path(args.n)
|
|
address = "0x%s" % (binascii.hexlify(self.client.ethereum_get_address(address_n)),)
|
|
|
|
host, port = args.host.split(':')
|
|
eth = EthJsonRpc(host, int(port))
|
|
|
|
gas_price = eth.eth_gasPrice()
|
|
gas_limit = args.gas
|
|
if args.data.startswith('0x'):
|
|
args.data = args.data[2:]
|
|
data = binascii.unhexlify(args.data)
|
|
if not gas_limit:
|
|
gas_limit = hex_to_dec(eth.eth_estimateGas(
|
|
to_address=args.to,
|
|
from_address=address,
|
|
value=value,
|
|
data="0x"+args.data))
|
|
nonce = eth.eth_getTransactionCount(address)
|
|
|
|
sig = self.client.ethereum_sign_tx(
|
|
n=address_n,
|
|
nonce=nonce,
|
|
gas_price=gas_price,
|
|
gas_limit=gas_limit,
|
|
to=to_address,
|
|
value=value,
|
|
data=data)
|
|
|
|
transaction = rlp.encode(
|
|
(nonce, gas_price, gas_limit, to_address, value, data) + sig)
|
|
tx_hex = '0x%s' % binascii.hexlify(transaction)
|
|
|
|
if args.publish:
|
|
tx_hash = eth.eth_sendRawTransaction(tx_hex)
|
|
return 'Transaction published with ID: %s' % tx_hash
|
|
else:
|
|
return 'Signed raw transaction: %s' % tx_hex
|
|
|
|
def get_entropy(self, args):
|
|
return binascii.hexlify(self.client.get_entropy(args.size))
|
|
|
|
def get_features(self, args):
|
|
return self.client.features
|
|
|
|
def list_coins(self, args):
|
|
return [coin.coin_name for coin in self.client.features.coins]
|
|
|
|
def ping(self, args):
|
|
return self.client.ping(args.msg, button_protection=args.button_protection, pin_protection=args.pin_protection, passphrase_protection=args.passphrase_protection)
|
|
|
|
def get_public_node(self, args):
|
|
address_n = self.client.expand_path(args.n)
|
|
return self.client.get_public_node(address_n, ecdsa_curve_name=args.curve, show_display=args.show_display)
|
|
|
|
def set_label(self, args):
|
|
return self.client.apply_settings(label=args.label)
|
|
|
|
def set_homescreen(self, args):
|
|
if args.filename:
|
|
from PIL import Image
|
|
im = Image.open(args.filename)
|
|
if im.size != (128, 64):
|
|
raise CallException(types.Failure_Other, 'Wrong size of the image')
|
|
im = im.convert('1')
|
|
pix = im.load()
|
|
img = ''
|
|
for j in range(64):
|
|
for i in range(128):
|
|
img += '1' if pix[i, j] else '0'
|
|
img = ''.join(chr(int(img[i:i + 8], 2)) for i in range(0, len(img), 8))
|
|
else:
|
|
img = '\x00'
|
|
return self.client.apply_settings(homescreen=img)
|
|
|
|
def clear_session(self, args):
|
|
return self.client.clear_session()
|
|
|
|
def change_pin(self, args):
|
|
return self.client.change_pin(args.remove)
|
|
|
|
def wipe_device(self, args):
|
|
return self.client.wipe_device()
|
|
|
|
def recovery_device(self, args):
|
|
typemap = { 'scrambled': types.RecoveryDeviceType_ScrambledWords,
|
|
'matrix': types.RecoveryDeviceType_Matrix }
|
|
return self.client.recovery_device(args.words, args.passphrase_protection,
|
|
args.pin_protection, args.label, 'english',
|
|
typemap[args.type])
|
|
|
|
def load_device(self, args):
|
|
if not args.mnemonic and not args.xprv:
|
|
raise CallException(types.Failure_Other, "Please provide mnemonic or xprv")
|
|
|
|
if args.mnemonic:
|
|
mnemonic = ' '.join(args.mnemonic)
|
|
return self.client.load_device_by_mnemonic(mnemonic, args.pin,
|
|
args.passphrase_protection,
|
|
args.label, 'english',
|
|
args.skip_checksum)
|
|
else:
|
|
return self.client.load_device_by_xprv(args.xprv, args.pin,
|
|
args.passphrase_protection,
|
|
args.label, 'english')
|
|
|
|
def reset_device(self, args):
|
|
return self.client.reset_device(True, args.strength, args.passphrase_protection,
|
|
args.pin_protection, args.label, 'english')
|
|
|
|
def sign_message(self, args):
|
|
address_n = self.client.expand_path(args.n)
|
|
ret = self.client.sign_message(args.coin, address_n, args.message)
|
|
output = {
|
|
'message': args.message,
|
|
'address': ret.address,
|
|
'signature': base64.b64encode(ret.signature)
|
|
}
|
|
return output
|
|
|
|
def verify_message(self, args):
|
|
signature = base64.b64decode(args.signature)
|
|
return self.client.verify_message(args.coin, args.address, signature, args.message)
|
|
|
|
def encrypt_message(self, args):
|
|
pubkey = binascii.unhexlify(args.pubkey)
|
|
address_n = self.client.expand_path(args.n)
|
|
ret = self.client.encrypt_message(pubkey, args.message, args.display_only, args.coin, address_n)
|
|
output = {
|
|
'nonce': binascii.hexlify(ret.nonce),
|
|
'message': binascii.hexlify(ret.message),
|
|
'hmac': binascii.hexlify(ret.hmac),
|
|
'payload': base64.b64encode(ret.nonce + ret.message + ret.hmac),
|
|
}
|
|
return output
|
|
|
|
def decrypt_message(self, args):
|
|
address_n = self.client.expand_path(args.n)
|
|
payload = base64.b64decode(args.payload)
|
|
nonce, message, msg_hmac = payload[:33], payload[33:-8], payload[-8:]
|
|
ret = self.client.decrypt_message(address_n, nonce, message, msg_hmac)
|
|
return ret
|
|
|
|
def encrypt_keyvalue(self, args):
|
|
address_n = self.client.expand_path(args.n)
|
|
ret = self.client.encrypt_keyvalue(address_n, args.key, args.value)
|
|
return binascii.hexlify(ret)
|
|
|
|
def decrypt_keyvalue(self, args):
|
|
address_n = self.client.expand_path(args.n)
|
|
ret = self.client.decrypt_keyvalue(address_n, args.key, args.value.decode("hex"))
|
|
return ret
|
|
|
|
def set_u2f_counter(self, args):
|
|
ret = self.client.set_u2f_counter(args.counter)
|
|
return ret
|
|
|
|
def firmware_update(self, args):
|
|
if args.file:
|
|
fp = open(args.file, 'rb').read()
|
|
elif args.url:
|
|
import requests
|
|
print("Downloading from", args.url)
|
|
r = requests.get(args.url)
|
|
fp = r.content
|
|
else:
|
|
import requests
|
|
r = requests.get('https://wallet.trezor.io/data/firmware/releases.json')
|
|
releases = r.json()
|
|
version = lambda r: r['version']
|
|
version_string = lambda r: ".".join(map(str, version(r)))
|
|
if args.version:
|
|
release = next((r for r in releases if version_string(r) == args.version))
|
|
else:
|
|
release = max(releases, key=version)
|
|
print("No file, url, or version given. Fetching latest version: %s" % version_string(release))
|
|
print("Firmware fingerprint: %s" % release['fingerprint'])
|
|
args.url = 'https://wallet.trezor.io/' + release['url']
|
|
return self.firmware_update(args)
|
|
|
|
if not args.skip_check:
|
|
if fp[:8] == b'54525a52':
|
|
fp = binascii.unhexlify(fp)
|
|
if fp[:4] != b'TRZR':
|
|
raise CallException(types.Failure_FirmwareError, "TREZOR firmware header expected")
|
|
|
|
print("Please confirm action on device...")
|
|
|
|
return self.client.firmware_update(fp=BytesIO(fp))
|
|
|
|
list.help = 'List connected TREZOR USB devices'
|
|
ping.help = 'Send ping message'
|
|
get_address.help = 'Get bitcoin address in base58 encoding'
|
|
ethereum_get_address.help = 'Get Ethereum address in hex encoding'
|
|
ethereum_sign_tx.help = 'Sign (and optionally publish) Ethereum transaction'
|
|
get_entropy.help = 'Get example entropy'
|
|
get_features.help = 'Retrieve device features and settings'
|
|
get_public_node.help = 'Get public node of given path'
|
|
set_label.help = 'Set new wallet label'
|
|
set_homescreen.help = 'Set new homescreen'
|
|
clear_session.help = 'Clear session (remove cached PIN, passphrase, etc.)'
|
|
change_pin.help = 'Change new PIN or remove existing'
|
|
list_coins.help = 'List all supported coin types by the device'
|
|
wipe_device.help = 'Reset device to factory defaults and remove all private data.'
|
|
recovery_device.help = 'Start safe recovery workflow'
|
|
load_device.help = 'Load custom configuration to the device'
|
|
reset_device.help = 'Perform device setup and generate new seed'
|
|
sign_message.help = 'Sign message using address of given path'
|
|
verify_message.help = 'Verify message'
|
|
encrypt_message.help = 'Encrypt message'
|
|
decrypt_message.help = 'Decrypt message'
|
|
encrypt_keyvalue.help = 'Encrypt value by given key and path'
|
|
decrypt_keyvalue.help = 'Decrypt value by given key and path'
|
|
set_u2f_counter.help = 'Set U2F counter'
|
|
firmware_update.help = 'Upload new firmware to device (must be in bootloader mode)'
|
|
|
|
clear_session.arguments= ()
|
|
|
|
get_address.arguments = (
|
|
(('-c', '--coin'), {'type': str, 'default': 'Bitcoin'}),
|
|
(('-n', '-address'), {'type': str}),
|
|
(('-d', '--show-display'), {'action': 'store_true', 'default': False}),
|
|
)
|
|
|
|
ethereum_get_address.arguments = (
|
|
(('-n', '-address'), {'type': str}),
|
|
(('-d', '--show-display'), {'action': 'store_true', 'default': False}),
|
|
)
|
|
|
|
ethereum_sign_tx.arguments = (
|
|
(('-a', '--host'), {'type': str, 'default': 'localhost:8545'}),
|
|
(('-n', '-address'), {'type': str}),
|
|
(('-v', '--value'), {'type': str, 'default': "0"}),
|
|
(('-g', '--gas'), {'type': int}),
|
|
(('-d', '--data'), {'type': str, 'default': ''}),
|
|
(('-p', '--publish'), {'action': 'store_true', 'default': False}),
|
|
(('to',), {'type': str}),
|
|
)
|
|
|
|
get_entropy.arguments = (
|
|
(('size',), {'type': int}),
|
|
)
|
|
|
|
get_features.arguments = ()
|
|
|
|
list_coins.arguments = ()
|
|
|
|
ping.arguments = (
|
|
(('msg',), {'type': str}),
|
|
(('-b', '--button-protection'), {'action': 'store_true', 'default': False}),
|
|
(('-p', '--pin-protection'), {'action': 'store_true', 'default': False}),
|
|
(('-r', '--passphrase-protection'), {'action': 'store_true', 'default': False}),
|
|
)
|
|
|
|
set_label.arguments = (
|
|
(('-l', '--label',), {'type': str, 'default': ''}),
|
|
# (('-c', '--clear'), {'action': 'store_true', 'default': False})
|
|
)
|
|
|
|
set_homescreen.arguments = (
|
|
(('-f', '--filename',), {'type': str, 'default': ''}),
|
|
)
|
|
change_pin.arguments = (
|
|
(('-r', '--remove'), {'action': 'store_true', 'default': False}),
|
|
)
|
|
|
|
wipe_device.arguments = ()
|
|
|
|
recovery_device.arguments = (
|
|
(('-w', '--words'), {'type': int, 'choices': [12, 18, 24], 'default': 24}),
|
|
(('-p', '--pin-protection'), {'action': 'store_true', 'default': False}),
|
|
(('-r', '--passphrase-protection'), {'action': 'store_true', 'default': False}),
|
|
(('-l', '--label'), {'type': str, 'default': ''}),
|
|
(('-t', '--type'), {'type': str, 'choices': ['scrambled', 'matrix'], 'default': 'matrix'}),
|
|
)
|
|
|
|
load_device.arguments = (
|
|
(('-m', '--mnemonic'), {'type': str, 'nargs': '+'}),
|
|
(('-x', '--xprv'), {'type': str}),
|
|
(('-p', '--pin'), {'type': str, 'default': ''}),
|
|
(('-r', '--passphrase-protection'), {'action': 'store_true', 'default': False}),
|
|
(('-l', '--label'), {'type': str, 'default': ''}),
|
|
(('-s', '--skip-checksum'), {'action': 'store_true', 'default': False}),
|
|
)
|
|
|
|
reset_device.arguments = (
|
|
(('-t', '--strength'), {'type': int, 'choices': [128, 192, 256], 'default': 256}),
|
|
(('-p', '--pin-protection'), {'action': 'store_true', 'default': False}),
|
|
(('-r', '--passphrase-protection'), {'action': 'store_true', 'default': False}),
|
|
(('-l', '--label'), {'type': str, 'default': ''}),
|
|
)
|
|
|
|
sign_message.arguments = (
|
|
(('-c', '--coin'), {'type': str, 'default': 'Bitcoin'}),
|
|
(('-n', '-address'), {'type': str}),
|
|
(('message',), {'type': str}),
|
|
)
|
|
|
|
encrypt_message.arguments = (
|
|
(('pubkey',), {'type': str}),
|
|
(('message',), {'type': str}),
|
|
(('-d', '--display-only'), {'action': 'store_true', 'default': False}),
|
|
(('-c', '--coin'), {'type': str, 'default': 'Bitcoin'}),
|
|
(('-n', '-address'), {'type': str}),
|
|
)
|
|
|
|
decrypt_message.arguments = (
|
|
(('-n', '-address'), {'type': str}),
|
|
(('payload',), {'type': str}),
|
|
)
|
|
|
|
verify_message.arguments = (
|
|
(('-c', '--coin'), {'type': str, 'default': 'Bitcoin'}),
|
|
(('address',), {'type': str}),
|
|
(('signature',), {'type': str}),
|
|
(('message',), {'type': str}),
|
|
)
|
|
|
|
encrypt_keyvalue.arguments = (
|
|
(('-n', '-address'), {'type': str}),
|
|
(('key',), {'type': str}),
|
|
(('value',), {'type': str}),
|
|
)
|
|
|
|
decrypt_keyvalue.arguments = (
|
|
(('-n', '-address'), {'type': str}),
|
|
(('key',), {'type': str}),
|
|
(('value',), {'type': str}),
|
|
)
|
|
|
|
get_public_node.arguments = (
|
|
(('-n', '-address'), {'type': str}),
|
|
(('-e', '--curve'), {'type': str}),
|
|
(('-d', '--show-display'), {'action': 'store_true', 'default': False}),
|
|
)
|
|
|
|
set_u2f_counter.arguments = (
|
|
(('counter',), {'type': int}),
|
|
)
|
|
|
|
firmware_update.arguments = (
|
|
(('-f', '--file'), {'type': str}),
|
|
(('-u', '--url'), {'type': str}),
|
|
(('-n', '--version'), {'type': str}),
|
|
(('-s', '--skip-check'), {'action': 'store_true', 'default': False}),
|
|
)
|
|
|
|
def list_usb():
|
|
from trezorlib.transport_hid import HidTransport
|
|
return HidTransport.enumerate()
|
|
|
|
def main():
|
|
parser = init_parser(Commands)
|
|
args = parser.parse_args()
|
|
|
|
if not hasattr(args, 'cmd'):
|
|
parser.print_help()
|
|
exit(0)
|
|
|
|
try:
|
|
|
|
if args.cmd == 'list':
|
|
devices = list_usb()
|
|
if args.json:
|
|
print(json.dumps(devices))
|
|
else:
|
|
for dev in devices:
|
|
if dev[1] != None:
|
|
print("%s - debuglink enabled" % dev[0])
|
|
else:
|
|
print(dev[0])
|
|
return
|
|
|
|
transport = get_transport(args.transport, args.path)
|
|
if args.verbose:
|
|
client = TrezorClientDebug(transport)
|
|
else:
|
|
client = TrezorClient(transport)
|
|
|
|
cmds = Commands(client)
|
|
|
|
res = args.func(cmds, args)
|
|
|
|
if args.json:
|
|
print(json.dumps(res, sort_keys=True, indent=4))
|
|
else:
|
|
print(res)
|
|
except CallException as e:
|
|
status, message = e.args
|
|
sys.stderr.write('failure: {message}\n'.format(message=message))
|
|
exit(status)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|