github
/
monero
mirror of https://github.com/monero-project/monero
1
Fork 0
Code Releases Activity
monero/src/device_trezor
History
tobtoht cdab0d489c
cmake: require libsodium 		2024-02-24 16:26:43 +01:00
..
trezor trezor: support v2.5.2+, add more trezor tests, fix chaingen and tests 2023-09-30 09:01:10 +02:00
CMakeLists.txt cmake: require libsodium 2024-02-24 16:26:43 +01:00
README.md trezor: support v2.5.2+, add more trezor tests, fix chaingen and tests 2023-09-30 09:01:10 +02:00
device_trezor.cpp trezor: support v2.5.2+, add more trezor tests, fix chaingen and tests 2023-09-30 09:01:10 +02:00
device_trezor.hpp trezor: support v2.5.2+, add more trezor tests, fix chaingen and tests 2023-09-30 09:01:10 +02:00
device_trezor_base.cpp trezor: support v2.5.2+, add more trezor tests, fix chaingen and tests 2023-09-30 09:01:10 +02:00
device_trezor_base.hpp device: boost -> std locks to fix c++17 compilation 2023-10-26 04:02:26 +02:00
trezor.hpp Copyright: Update to 2023 2023-01-16 13:00:18 +01:00

README.md

Trezor hardware wallet support

This module adds Trezor hardware support to Monero.

Basic information

Trezor integration is based on the following original proposal: https://github.com/ph4r05/monero-trezor-doc

A custom high-level transaction signing protocol uses Trezor in a similar way a cold wallet is used. Transaction is build incrementally on the device.

Trezor implements the signing protocol in trezor-firmware repository, in the monero application. Please, refer to monero readme for more information.

Dependencies

Trezor uses Protobuf library. As Monero is compiled with C++14, the newest Protobuf library version cannot be compiled because it requires C++17 (through its dependency Abseil library). This can result in a compilation failure.

Protobuf v21 is the latest compatible protobuf version.

If you want to compile Monero with Trezor support, please make sure the Protobuf v21 is installed.

More about this limitation: PR #8752, 1, 2

OSX

To build with installed, but not linked protobuf:

CMAKE_PREFIX_PATH=$(find /opt/homebrew/Cellar/protobuf@21 -maxdepth 1 -type d -name "21.*" -print -quit) \
make release

or to install and link as a default protobuf version:

# Either install all requirements as
brew update && brew bundle --file=contrib/brew/Brewfile

# or install protobufv21 specifically
brew install protobuf@21 && brew link protobuf@21

MSYS32

curl -O https://repo.msys2.org/mingw/mingw64/mingw-w64-x86_64-protobuf-c-1.4.1-1-any.pkg.tar.zst
curl -O https://repo.msys2.org/mingw/mingw64/mingw-w64-x86_64-protobuf-21.9-1-any.pkg.tar.zst
pacman --noconfirm -U mingw-w64-x86_64-protobuf-c-1.4.1-1-any.pkg.tar.zst mingw-w64-x86_64-protobuf-21.9-1-any.pkg.tar.zst

Other systems

  • install protobufv21
  • point CMAKE_PREFIX_PATH environment variable to Protobuf v21 installation.

Troubleshooting

To disable Trezor support, set USE_DEVICE_TREZOR=OFF, e.g.:

USE_DEVICE_TREZOR=OFF make release

Resources: