# This file is part of the Trezor project. # # Copyright (C) 2012-2018 SatoshiLabs and contributors # # This library is free software: you can redistribute it and/or modify # it under the terms of the GNU Lesser General Public License version 3 # as published by the Free Software Foundation. # # 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 License along with this library. # If not, see . import os import time import warnings from . import messages as proto from .exceptions import Cancelled from .tools import expect, session from .transport import enumerate_devices, get_transport RECOVERY_BACK = "\x08" # backspace character, sent literally class TrezorDevice: """ This class is deprecated. (There is no reason for it to exist in the first place, it is nothing but a collection of two functions.) Instead, please use functions from the ``trezorlib.transport`` module. """ @classmethod def enumerate(cls): warnings.warn("TrezorDevice is deprecated.", DeprecationWarning) return enumerate_devices() @classmethod def find_by_path(cls, path): warnings.warn("TrezorDevice is deprecated.", DeprecationWarning) return get_transport(path, prefix_search=False) @expect(proto.Success, field="message") def apply_settings( client, label=None, language=None, use_passphrase=None, homescreen=None, passphrase_source=None, auto_lock_delay_ms=None, display_rotation=None, ): settings = proto.ApplySettings() if label is not None: settings.label = label if language: settings.language = language if use_passphrase is not None: settings.use_passphrase = use_passphrase if homescreen is not None: settings.homescreen = homescreen if passphrase_source is not None: settings.passphrase_source = passphrase_source if auto_lock_delay_ms is not None: settings.auto_lock_delay_ms = auto_lock_delay_ms if display_rotation is not None: settings.display_rotation = display_rotation out = client.call(settings) client.init_device() # Reload Features return out @expect(proto.Success, field="message") def apply_flags(client, flags): out = client.call(proto.ApplyFlags(flags=flags)) client.init_device() # Reload Features return out @expect(proto.Success, field="message") def change_pin(client, remove=False): ret = client.call(proto.ChangePin(remove=remove)) client.init_device() # Re-read features return ret @expect(proto.Success, field="message") def set_u2f_counter(client, u2f_counter): ret = client.call(proto.SetU2FCounter(u2f_counter=u2f_counter)) return ret @expect(proto.Success, field="message") def wipe(client): ret = client.call(proto.WipeDevice()) client.init_device() return ret @expect(proto.Success, field="message") def recover( client, word_count=24, passphrase_protection=False, pin_protection=True, label=None, language="english", input_callback=None, type=proto.RecoveryDeviceType.ScrambledWords, dry_run=False, u2f_counter=None, ): if client.features.model == "1" and input_callback is None: raise RuntimeError("Input callback required for Trezor One") if word_count not in (12, 18, 24): raise ValueError("Invalid word count. Use 12/18/24") if client.features.initialized and not dry_run: raise RuntimeError( "Device already initialized. Call device.wipe() and try again." ) if u2f_counter is None: u2f_counter = int(time.time()) res = client.call( proto.RecoveryDevice( word_count=word_count, passphrase_protection=bool(passphrase_protection), pin_protection=bool(pin_protection), label=label, language=language, enforce_wordlist=True, type=type, dry_run=dry_run, u2f_counter=u2f_counter, ) ) while isinstance(res, proto.WordRequest): try: inp = input_callback(res.type) res = client.call(proto.WordAck(word=inp)) except Cancelled: res = client.call(proto.Cancel()) client.init_device() return res @expect(proto.Success, field="message") @session def reset( client, display_random=False, strength=None, passphrase_protection=False, pin_protection=True, label=None, language="english", u2f_counter=0, skip_backup=False, no_backup=False, ): if client.features.initialized: raise RuntimeError( "Device is initialized already. Call wipe_device() and try again." ) if strength is None: if client.features.model == "1": strength = 256 else: strength = 128 # Begin with device reset workflow msg = proto.ResetDevice( display_random=bool(display_random), strength=strength, passphrase_protection=bool(passphrase_protection), pin_protection=bool(pin_protection), language=language, label=label, u2f_counter=u2f_counter, skip_backup=bool(skip_backup), no_backup=bool(no_backup), ) resp = client.call(msg) if not isinstance(resp, proto.EntropyRequest): raise RuntimeError("Invalid response, expected EntropyRequest") external_entropy = os.urandom(32) # LOG.debug("Computer generated entropy: " + external_entropy.hex()) ret = client.call(proto.EntropyAck(entropy=external_entropy)) client.init_device() return ret @expect(proto.Success, field="message") def backup(client): ret = client.call(proto.BackupDevice()) return ret