#![warn(unreachable_pub, rustdoc::all)]
#![cfg_attr(not(test), warn(unused_crate_dependencies))]
#![deny(unused_must_use, rust_2018_idioms)]
#![cfg_attr(docsrs, feature(doc_cfg, doc_auto_cfg))]
mod messages;
pub mod client;
pub mod error;
pub mod protos;
pub mod transport;
#[cfg(feature = "bitcoin")]
pub mod utils;
mod flows {
#[cfg(feature = "bitcoin")]
pub(crate) mod sign_tx;
}
pub use client::{
ButtonRequest, ButtonRequestType, EntropyRequest, Features, PassphraseRequest,
PinMatrixRequest, PinMatrixRequestType, Trezor, TrezorResponse, WordCount,
};
pub use error::{Error, Result};
pub use messages::TrezorMessage;
#[cfg(feature = "bitcoin")]
pub use flows::sign_tx::SignTxProgress;
#[cfg(feature = "bitcoin")]
pub use protos::InputScriptType;
use std::fmt;
use tracing::{debug, warn};
use transport::{udp::UdpTransport, webusb::WebUsbTransport};
#[derive(PartialEq, Eq, Clone, Debug, Copy)]
pub enum Model {
TrezorLegacy,
Trezor,
TrezorBootloader,
TrezorEmulator,
}
impl fmt::Display for Model {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
f.write_str(self.as_str())
}
}
impl Model {
pub const fn as_str(&self) -> &'static str {
match self {
Model::TrezorLegacy => "Trezor (legacy)",
Model::Trezor => "Trezor",
Model::TrezorBootloader => "Trezor (bootloader)",
Model::TrezorEmulator => "Trezor Emulator",
}
}
}
#[derive(Debug)]
pub struct AvailableDevice {
pub model: Model,
pub debug: bool,
transport: transport::AvailableDeviceTransport,
}
impl fmt::Display for AvailableDevice {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
write!(f, "{} (transport: {}) (debug: {})", self.model, &self.transport, self.debug)
}
}
impl AvailableDevice {
pub fn connect(self) -> Result<Trezor> {
let transport = transport::connect(&self).map_err(Error::TransportConnect)?;
Ok(client::trezor_with_transport(self.model, transport))
}
}
pub fn find_devices(debug: bool) -> Vec<AvailableDevice> {
let mut devices = vec![];
match WebUsbTransport::find_devices(debug) {
Ok(usb) => devices.extend(usb),
Err(err) => {
warn!("{}", Error::TransportConnect(err))
}
};
match UdpTransport::find_devices(debug, None) {
Ok(udp) => devices.extend(udp),
Err(err) => {
warn!("{}", Error::TransportConnect(err))
}
};
devices
}
pub fn unique(debug: bool) -> Result<Trezor> {
let mut devices = find_devices(debug);
match devices.len() {
0 => Err(Error::NoDeviceFound),
1 => Ok(devices.remove(0).connect()?),
_ => {
debug!("Trezor devices found: {:?}", devices);
Err(Error::DeviceNotUnique)
}
}
}
#[cfg(test)]
mod tests {
use serial_test::serial;
use std::str::FromStr;
use crate::{client::handle_interaction, protos::IdentityType};
use bitcoin::{bip32::DerivationPath, hex::FromHex};
use super::*;
fn init_emulator() -> Trezor {
let mut emulator = find_devices(false)
.into_iter()
.find(|t| t.model == Model::TrezorEmulator)
.expect("No emulator found")
.connect()
.expect("Failed to connect to emulator");
emulator.init_device(None).expect("Failed to intialize device");
emulator
}
#[test]
#[serial]
fn test_emulator_find() {
let trezors = find_devices(false);
assert!(trezors.len() > 0);
assert!(trezors.iter().any(|t| t.model == Model::TrezorEmulator));
}
#[test]
#[serial]
fn test_emulator_features() {
let emulator = init_emulator();
let features = emulator.features().expect("Failed to get features");
assert_eq!(features.vendor(), "trezor.io");
assert_eq!(features.initialized(), true);
assert_eq!(features.firmware_present(), false);
assert_eq!(features.model(), "T");
assert_eq!(features.initialized(), true);
assert_eq!(features.pin_protection(), false);
assert_eq!(features.passphrase_protection(), false);
}
#[test]
#[serial]
fn test_bitcoin_address() {
let mut emulator = init_emulator();
assert_eq!(emulator.features().expect("Failed to get features").label(), "SLIP-0014");
let path = DerivationPath::from_str("m/44'/1'/0'/0/0").expect("Failed to parse path");
let address = emulator
.get_address(&path, InputScriptType::SPENDADDRESS, bitcoin::Network::Testnet, false)
.expect("Failed to get address");
assert_eq!(address.ok().unwrap().to_string(), "mvbu1Gdy8SUjTenqerxUaZyYjmveZvt33q");
}
#[ignore]
#[test]
#[serial]
fn test_ecdh_shared_secret() {
tracing_subscriber::fmt().with_max_level(tracing::Level::TRACE).init();
let mut emulator = init_emulator();
assert_eq!(emulator.features().expect("Failed to get features").label(), "SLIP-0014");
let mut ident = IdentityType::new();
ident.set_proto("gpg".to_owned());
ident.set_user("".to_owned());
ident.set_host("Satoshi Nakamoto <satoshi@bitcoin.org>".to_owned());
ident.set_port("".to_owned());
ident.set_path("".to_owned());
ident.set_index(0);
let peer_public_key = Vec::from_hex("0407f2c6e5becf3213c1d07df0cfbe8e39f70a8c643df7575e5c56859ec52c45ca950499c019719dae0fda04248d851e52cf9d66eeb211d89a77be40de22b6c89d").unwrap();
let curve_name = "secp256k1".to_owned();
let response = handle_interaction(
emulator
.get_ecdh_session_key(ident, peer_public_key, curve_name)
.expect("Failed to get ECDH shared secret"),
)
.unwrap();
let expected_session_key = Vec::from_hex("048125883b086746244b0d2c548860ecc723346e14c87e51dc7ba32791bc780d132dbd814fbee77134f318afac6ad6db3c5334efe6a8798628a1038195b96e82e2").unwrap();
assert_eq!(response.session_key(), &expected_session_key);
let expected_public_key =
Vec::from_hex("032726ba71aa066b47fc0f90b389f8c3e02fe20b94c858395d71f260e9944e3c65")
.unwrap();
assert_eq!(response.public_key(), &expected_public_key);
}
}