mirror of
https://github.com/trezor/trezor-firmware.git
synced 2024-11-25 17:09:44 +00:00
162 lines
4.7 KiB
Markdown
162 lines
4.7 KiB
Markdown
# trezorlib
|
|
|
|
[](https://repology.org/metapackage/python:trezor) [](https://gitter.im/trezor/community)
|
|
|
|
Python library and command-line client for communicating with Trezor
|
|
Hardware Wallet.
|
|
|
|
See <https://trezor.io> for more information.
|
|
|
|
## Install
|
|
|
|
Python Trezor tools require Python 3.8 or higher, and libusb 1.0. The easiest
|
|
way to install it is with `pip`. The rest of this guide assumes you have
|
|
a working `pip`; if not, you can refer to [this
|
|
guide](https://packaging.python.org/tutorials/installing-packages/).
|
|
|
|
On a typical system, you already have all you need. Install `trezor` with:
|
|
|
|
```sh
|
|
pip3 install trezor
|
|
```
|
|
|
|
On Windows, you also need to either install [Trezor Bridge](https://suite.trezor.io/web/bridge/), or
|
|
[libusb](https://github.com/libusb/libusb/wiki/Windows) and the appropriate
|
|
[drivers](https://zadig.akeo.ie/).
|
|
|
|
### Firmware version requirements
|
|
|
|
Current trezorlib version supports Trezor One version 1.8.0 and up, and Trezor T version
|
|
2.1.0 and up.
|
|
|
|
For firmware versions below 1.8.0 and 2.1.0 respectively, the only supported operation
|
|
is "upgrade firmware".
|
|
|
|
Trezor One with firmware _older than 1.7.0_ and bootloader _older than 1.6.0_
|
|
(including pre-2021 fresh-out-of-the-box units) will not be recognized, unless
|
|
you install HIDAPI support (see below).
|
|
|
|
### Installation options
|
|
|
|
* **Ethereum**: To support Ethereum signing from command line, additional packages are
|
|
needed. Install with:
|
|
|
|
```sh
|
|
pip3 install trezor[ethereum]
|
|
```
|
|
|
|
* **Stellar**: To support Stellar signing from command line, additional packages are
|
|
needed. Install with:
|
|
|
|
```sh
|
|
pip3 install trezor[stellar]
|
|
```
|
|
|
|
* **Extended device authentication**: For user-friendly device authentication for Trezor
|
|
Safe 3 and newer models (`trezorctl device authenticate` command), additional packages
|
|
are needed. Install with:
|
|
|
|
```sh
|
|
pip3 install trezor[authentication]
|
|
```
|
|
|
|
* **Firmware-less Trezor One**: If you are setting up a brand new Trezor One
|
|
manufactured before 2021 (with pre-installed bootloader older than 1.6.0), you will
|
|
need HIDAPI support. On Linux, you will need the following packages (or their
|
|
equivalents) as prerequisites: `python3-dev`, `cython3`, `libusb-1.0-0-dev`,
|
|
`libudev-dev`.
|
|
|
|
Install with:
|
|
|
|
```sh
|
|
pip3 install trezor[hidapi]
|
|
```
|
|
|
|
To install all four, use `pip3 install trezor[hidapi,ethereum,stellar,authentication]`.
|
|
|
|
### Distro packages
|
|
|
|
Check out [Repology](https://repology.org/metapackage/python:trezor) to see if your
|
|
operating system has an up-to-date python-trezor package.
|
|
|
|
### Installing latest version from GitHub
|
|
|
|
```sh
|
|
pip3 install "git+https://github.com/trezor/trezor-firmware#egg=trezor&subdirectory=python"
|
|
```
|
|
|
|
### Running from source
|
|
|
|
Install the [Poetry](https://python-poetry.org/) tool, checkout
|
|
`trezor-firmware` from git, and enter the poetry shell:
|
|
|
|
```sh
|
|
pip3 install poetry
|
|
git clone https://github.com/trezor/trezor-firmware
|
|
cd trezor-firmware
|
|
poetry install
|
|
poetry shell
|
|
```
|
|
|
|
In this environment, trezorlib and the `trezorctl` tool is running from the live
|
|
sources, so your changes are immediately effective.
|
|
|
|
## Command line client (trezorctl)
|
|
|
|
The included `trezorctl` python script can perform various tasks such as
|
|
changing setting in the Trezor, signing transactions, retrieving account
|
|
info and addresses. See the
|
|
[python/docs/](https://github.com/trezor/trezor-firmware/tree/master/python/docs)
|
|
sub folder for detailed examples and options.
|
|
|
|
NOTE: An older version of the `trezorctl` command is [available for
|
|
Debian Stretch](https://packages.debian.org/en/stretch/python-trezor)
|
|
(and comes pre-installed on [Tails OS](https://tails.boum.org/)).
|
|
|
|
## Python Library
|
|
|
|
You can use this python library to interact with a Trezor and use its capabilities in
|
|
your application. See examples here in the
|
|
[tools/](https://github.com/trezor/trezor-firmware/tree/master/python/docs/tools)
|
|
sub folder.
|
|
|
|
## PIN Entering
|
|
|
|
When you are asked for PIN, you have to enter scrambled PIN. Follow the
|
|
numbers shown on Trezor display and enter the their positions using the
|
|
numeric keyboard mapping:
|
|
|
|
| | | |
|
|
|---|---|---|
|
|
| 7 | 8 | 9 |
|
|
| 4 | 5 | 6 |
|
|
| 1 | 2 | 3 |
|
|
|
|
Example: your PIN is **1234** and Trezor is displaying the following:
|
|
|
|
| | | |
|
|
|---|---|---|
|
|
| 2 | 8 | 3 |
|
|
| 5 | 4 | 6 |
|
|
| 7 | 9 | 1 |
|
|
|
|
You have to enter: **3795**
|
|
|
|
## Contributing
|
|
|
|
If you want to change protobuf definitions, you will need to regenerate definitions in
|
|
the `python/` subdirectory.
|
|
|
|
First, make sure your submodules are up-to-date with:
|
|
|
|
```sh
|
|
git submodule update --init --recursive
|
|
```
|
|
|
|
Then, rebuild the protobuf messages by running, from the `trezor-firmware` top-level
|
|
directory:
|
|
|
|
```sh
|
|
make gen
|
|
```
|