硬件钱包 | 进击之路 - Alan的个人博客

了解Trezor硬件钱包

Tue, 28 Apr 2026 16:49:49 +0800

imkey不支持自定义刷固件，因此这里team内多了解了下另一个品牌，Trezor的硬件钱包。这里mark下一些资料，方便以后回顾。

固件

https://github.com/trezor/trezor-firmware

看来所有型号都是统一一个固件。

apps支持

https://github.com/trezor/trezor-firmware/tree/main/core/src/apps

模拟器

https://docs.trezor.io/trezor-firmware/core/build/emulator.html

自定义固件

https://trezor.io/trezor-suite?srsltid=AfmBOortBR02GKnAknyFOeS8YWKwWmQuYZeSHtu-ix4v0_7UJaBYd-5w

推特粉丝数

trezor 大概230k粉丝
ledger 大概670k粉丝数据来看，trezor的粉丝数是ledger的三分之一左右，说明在社区的影响力可能不如ledger。

固件开发/打包

$ git clone git@github.com:trezor/trezor-firmware.git

# 把子模块的资源都拉取下
$ git submodule update --init --recursive --force --progress

# install nix,支持Linux/MacOS，安装完成后需要重启shell。
$ curl -L https://nixos.org/nix/install | sh

$ nix-shell --arg devTools true

# 环境
$ uv sync

$ source .venv/bin/activate

# 测试环境是否搭建成功
$ python -c "import click; print('click ok')"

# 进入core目录，安装依赖
$ cd core

# 拉取第三方
$ make vendor


# 注意，如果代码没有变动，但是重复生成固件，直接会报错，提示文件已经存在了。正常打包会提示比如 cp build/firmware/firmware.bin build/firmware/firmware-T3T1-2.11.2-6daa3bd.bin (trezor-firmware) 
$ make build_firmware
# 比如如果是T3B1型号的设备，指定环境变量
$ TREZOR_MODEL=T3B1 make build_firmware

# TREZOR_MODEL=T3B1 make upload

# 设备列表，可以确认设备是否连接且被正确识别
$ trezorctl list

固件文件

构建打包后文件在core/build/firmware/firmware-T3B1-2.11.3-3a8d901.bin

注意：如果本身git文件没完全提交，那么构建的固件会有dirty标记。

查看机器真正型号

trezorctl get-features | grep -E "model|internal_model|vendor|major_version"

刷机

解锁 `如果提示不通过则增加解锁`

$ trezorctl device unlock-bootloader

根据提示进行解锁。

说明：trezorctl是官方python写的命令行工具。推荐走固件开发流程，去安装环境

$ git clone git@github.com:trezor/trezor-firmware.git

# 把子模块的资源都拉取下
$ git submodule update --init --recursive --force --progress

# install nix,支持Linux/MacOS，安装完成后需要重启shell。
$ curl -L https://nixos.org/nix/install | sh

$ nix-shell --arg devTools true

# 环境
$ uv sync

$ source .venv/bin/activate

# 到此，其实去执行trezorctl命令就会work，比如 trezorctl list 就可以看到设备列表了。

进入bootloader模式

硬件钱包两个按键同时按住，连接电脑，即可进入bootloader模式。
硬件钱包点击 Install FW，会提示waiting for host.

命令安装固件 `安装方法1`

# 这个会唤起真机进行固件刷机，也可以利用trezor suite进行刷机
$ make upload

trezor suite安装固件 `安装方法2`

安装的前提是进入bootloader模式，进入后会硬件会提示安装，点击安装，然后PC端左上角选择连接设备。

suite安装地址见官网

说明：固件大小的话，我看也就1-2MB，安装很快，需要硬件钱包侧确认。

注意：本地自定义签名固件后，启动钱包会提示warning，只有重新刷回官方签名固件，才会消除这个warning。

了解imKey硬件钱包

Tue, 21 Apr 2026 14:27:05 +0800

ledger的弊端开发起来跟官方的沟通很低效，因此这里我们调研了下另一个品牌imKey。

签名

对，硬件是唯一做签名的地方。

具体说：

私钥从出厂起就生成并存在 imKey 安全芯片里，永远不出设备
签名运算（secp256k1 的 ECDSA）也在芯片内部完成
@imkey/web3-provider从头到尾接触不到私钥，它只是： a. 把交易/消息编码成设备认识的 APDU 指令 b. 通过 WebUSB 把指令送进去 c. 把设备返回的签名字节 (r, s, v) 拼回标准格式交给 dApp

固件不开源？

目前看并不开源，如果牵扯到固件升级需求，比如不支持某链网络，某签名算法，那么需要联系官方，看是否可以升级固件进行支持。

了解OneKey硬件钱包

Wed, 25 Mar 2026 00:00:00 +0800

最近工作需要，研究硬件钱包，之前调研了下Ledger，另一个主流OneKey也需了解下，从而方便做出技术选型。

自定义区块链网络/新链的支持

对于一个自定义的区块链网络/新链，想要利用OneKey的安全存储和签名功能。

firmware下开发App，然后提交PR，审核通过后OneKey升级固件后就支持了。
利用官方SDK比如WEB SDK在对应的场景下连接钱包从而支持。

Ledger和OneKey的对比

Ledger需要安装App，OneKey不需要，但OneKey需要升级固件。一个可以看到App，一个可以看作OS。
Ledger App提交是发起上架商店请求，而OneKey是GitHub 开源项目下发起PR，审核通过后就支持了。
开发环境下，如果是非真机，两者都是走模拟器，真机的话，Ledger有硬件限制，必须是支持侧载的型号，而OneKey没有限制，但需要升级固件。

刷固件

固件构建打包，最终的产物是一个bin文件。
通过，https://firmware.onekey.so/ 进行固件升级。

了解Ledger硬件钱包

Fri, 20 Mar 2026 09:42:15 +0800

Ledger/'ledʒər/ 是硬件钱包品牌。最近项目需要验证一条新链上的硬件钱包签名方案，我拿到了 Ledger Nano X 设备进行验证。

本文记录整个工作过程和相关技术要点。

sequenceDiagram box 客户端 participant U as 用户 participant D as dApp participant M as MetaMask end box 外部签名设备 participant L as Ledger Device (Ethereum App) end box 区块链基础设施 participant R as RPC / Ethereum Network end U->>D: 发起转账 / Approve / Swap D->>M: 请求钱包发起交易 M->>R: 获取 nonce / gas / fee / chainId R-->>M: 返回链上参数 M->>U: 展示交易确认信息 U->>M: 在 MetaMask 点击确认 M->>L: 发送未签名交易数据 L->>U: 设备屏幕展示关键信息 U->>L: 按键确认/拒绝 alt 用户确认 L-->>M: 返回签名结果 M->>R: 广播已签名交易 R-->>M: 返回 tx hash / pending / confirmed M-->>U: 展示交易状态 else 用户拒绝 L-->>M: 拒绝签名 M-->>U: 交易取消/失败 end

自定义区块链网络/新链的支持

对于一个自定义的区块链网络/新链，想要利用ledger的安全存储和签名功能。

开发一个Ledger Device App，安装在设备上，提供特定区块链的交易签名功能。
开发一个连接Ledger Device App的插件，安装在MetaMask等钱包中，提供与新链交互的功能.
- 如果是使用web3js等库，就需要修改库，从而支持通过Ledger Device App进行交易签名。

调用链 / 数据流图

你的代码
 ↓
Ledger SDK（封装 APDU）
 ↓
WebHID（传输）
 ↓
Ledger 设备
 ↓
你的 ChainMaker App（解析 APDU）

说明：HID即 human interface device，APDU即 application protocol data unit。

Ledger Device App

Ledger Device App会安装在设备上，提供特定区块链的交易签名功能。

要求

开发语言只能是C/Rust，因为设备资源有限，比如我手里的Nano X，内存只有MB级别。
- 官方提供了Rust脚手架模版
- 官方提供了C语言脚手架模版
- 推荐走官方脚手架，避免无法被插件正常识别。我个人目前选的走Rust，更好维护些。
安装官方的VSCode插件，提供了开发环境和调试工具。
构建打包device app的话，需要Docker环境，官方提供了Docker镜像，里面包含了构建和打包所需的工具链和依赖。
模拟器进行测试的话，本地还需安装Speculos模拟器，提供设备的模拟环境.

VSCode插件

如图，可以看到插件提供了完善的开发/构建/调试功能，极大提升了开发效率。

真机 vs 模拟器

对比项	真机 (WebHID)	模拟器 (Speculos)
连接方式	`TransportWebHID.create()` — 浏览器弹出 HID 设备选择器，用户手动选择 USB 设备	`SpeculosHttpTransport.open(url)` — 直接 HTTP 连到 `localhost:5001`
通信协议	USB HID 帧协议（浏览器 WebHID API → USB → 设备固件）	HTTP POST JSON `{ data: "hex..." }` → Speculos HTTP API → 模拟固件
用户确认	签名时需要在真机物理按键确认	Speculos 手动确认
LedgerSigner 创建	显式传 `signDigest` 和 `fetchPublicKey`（第 1043-1044 行）	用默认值（构造函数里默认就是 `rawApduSignDigest` / `rawApduFetchPublicKey`）
后续流程	`isReady()` → `fetchPublicKey()` → `signMessage()` → 上链	完全一样

发布上线流程

你需要提交的是：App 的源码仓库 + 一系列交付物（deliverables），Ledger 会 fork 你的 App 仓库，在他们自己的 Git flow 中管理部署代码。所以不是你自己打包一个二进制文件，而是提交源码让 Ledger 来构建和签名。

具体步骤：

先联系 Ledger 团队 — 填写表单介绍你的项目，达成合作意向（分为 Ledger

开发 或 自主开发两条路径），表单提交地址见[这里](https://developers.ledger.com/docs/device-app/submission-process/submission-form)

确保代码符合要求 — 满足安全、密码学和开发规范
准备交付物（Deliverables）：

- App 源码仓库（含 docs/apdu.md 文档，描述 APDU 命令和状态字）
- 用户文档（Google Doc 格式或已发布的文档 URL）
- App 兼容性信息（需支持 Nano S Plus、Nano X、Stax、Flex 所有设备）
- 法律实体信息、邮箱、地址等

填写提交表单 — 官方有专门的 device app 提交表单和 plugin 提交表单
安全审计 — Ledger 的合作审计方会对你的 App 进行安全审查，审计通过后Ledger 才会发布
- 要求走官方提供的合作审计方进行审计。
- 费用问题自负。

说明：提交审核需要很多信息，且审核包含安全审计因此上架的周期很长(几周到几个月，无确定时间周期)。

用户如何用

用户需要安装 Ledger Wallet 应用，连接并设置好 Ledger 设备。
用户需要在 Ledger Wallet 中安装目标App。
- 未上线App，需要走官方VSC插件进行侧载安装。

侧载测试

连接设备，VSC下打开ledger app，利用插件进行测试。
除了自己开发的app外，单纯想体验下侧载的话，可以走官方已上架app测试，比如eth app

其它问题

硬件钱包为什么那么多型号，那么贵？

硬件钱包，比如 Ledger ≠ 只是安全芯片
型号不同，安全级别 × 交互体验 × 使用场景的取舍不同，另外存储空间也不同，价格自然不同。

navigator.hid

navigator.hid（WebHID）是连接物理 USB HID 设备的，而 Speculos
是模拟器，它只暴露 TCP socket（端口 9999）和 HTTP API（端口 5000），不是真实 USB 设备，所以浏览器扫描不到任何 HID 设备。

联系官方

discord
邮件 hello@ledger.fr