Rust wrapper for the Bitcoin Hardware Wallet Interface library.
This library internally uses PyO3 to call HWI's functions. It is not a re-implementation of HWI in native Rust.
Python 3 is required. The libraries and udev rules for each device must also be installed. Some libraries will need to be installed
For Ubuntu/Debian:
sudo apt install libusb-1.0-0-dev libudev-dev python3-dev
For Centos:
sudo yum -y install python3-devel libusbx-devel systemd-devel
For macOS:
brew install libusb
Clone the repo
git clone https://github.com/bitcoindevkit/rust-hwi.git && cd rust-hwi
Create a virtualenv:
virtualenv -p python3 venv
source venv/bin/activate
pip install -r requirements.txt
```rust use bitcoin::util::bip32::DerivationPath; use hwi::error::Error; use hwi::{interface, types, HWIClient}; use std::str::FromStr;
fn main() -> Result<(), Error> { let devices = interface::HWIClient::enumerate()?; let device = devices.first().expect("No devices found"); let client = HWIClient::getclient( &device, true, types::HWIChain::Test, )?; let derivationpath = DerivationPath::fromstr("m/44'/1'/0'/0/0").unwrap(); let s = client.signmessage("I love BDK wallet", &derivation_path)?; println!("{:?}", s.signature); Ok(()) } ```
To run the tests, you need to have a hardware wallet plugged in. If you don't have a HW for testing, you can try: - Coldcard simulator - Trezor simulator - Ledger simulator
Don't use a device with funds for testing!
Either use a testing device with no funds, or use a simulator.
You can run the tests with cargo test.