rust-hwi

注意：这是 https://github.com/bitcoindevkit/rust-hwi 的临时分支。计划从头开始全面重写，不依赖于也不与命令行 python hwi 工具一起工作，并直接从 rust 使用 libusb - 具有改进的数据类型和错误报告。

以下是原始 README 的副本

Rust 语言封装 HWI。

这个库内部使用 PyO3 来调用 HWI 的函数。它不是在本地 Rust 中重新实现 HWI。

MSRV

此项目的 MSRV 是 1.48.0。要使用 MSRV 构建，您需要固定一些依赖项

cargo update -p serde_json --precise 1.0.99
cargo update -p serde --precise 1.0.156
cargo update -p once_cell --precise 1.14.0
cargo update -p quote --precise 1.0.30
cargo update -p proc-macro2 --precise 1.0.65

先决条件

需要 Python 3。还必须安装每个设备的库和 udev 规则。某些库需要安装

对于 Ubuntu/Debian

sudo apt install libusb-1.0-0-dev libudev-dev python3-dev

对于 Centos

sudo yum -y install python3-devel libusbx-devel systemd-devel

对于 macOS

brew install libusb

安装

• 克隆仓库

git clone https://github.com/bitcoindevkit/rust-hwi.git && cd rust-hwi

• 创建虚拟环境

virtualenv -p python3 venv
source venv/bin/activate

• 使用 pip 安装所有依赖项

pip install -r requirements.txt

使用方法

use bitcoin::Network;
use bitcoin::bip32::DerivationPath;
use hwi::error::Error;
use hwi::HWIClient;
use std::str::FromStr;

fn main() -> Result<(), Error> {
    let mut devices = HWIClient::enumerate()?;
    if devices.is_empty() {
        panic!("No devices found!");
    }
    let first_device = devices.remove(0)?;
    let client = HWIClient::get_client(&first_device, true, Network::Bitcoin.into())?;
    let derivation_path = DerivationPath::from_str("m/44'/1'/0'/0/0").unwrap();
    let s = client.sign_message("I love BDK wallet", &derivation_path)?;
    println!("{:?}", s.signature);
    Ok(())
}

测试

要运行测试，您需要连接一个硬件钱包。如果您没有用于测试的硬件钱包，您可以尝试

• Coldcard 模拟器
• Trezor 模拟器
• Ledger 模拟器

请不要使用带有资金的设备进行测试！

可以使用没有资金的测试设备，或者使用模拟器。

可以使用以下命令运行测试：cargo test。