Ledger Device App在模拟器及真机侧载时遇到的问题

Wed, 15 Apr 2026 10:54:59 +0800

ledger算是硬件钱包这个细分领域的No1了，但实际的使用中仍然遇到了很多问题，discord官方频道，推特，邮件，官方文档，具体交流等等。我踩了很多坑，这里总结下，给后续的开发者一些借鉴。

说明

我自己在实际使用中用到的机型Nano S Plus和Nano X，当然Nano X是不支持侧载的。
关于Ledger的完整介绍文章，可以查看Ledger Device App开发指南，这里不再赘述了。

真机侧载

侧载机型支持情况

Ledger Device App的真机侧载并非所有机型都支持，正如上面所提到的。具体支持机型如何查看呢。

查官网，有相关说明如下：

To load your app onto a Ledger device (also known as “sideloading”) and conduct real-world testing, select Load app on device. Bear in mind that sideloading is not possible on Nano X.
通过VSC下官方插件-Ledger Dev Tools，如果是选中了具体设备，侧载的按钮禁用还是启用其实就能看出来了.

侧载运行环境

官方VSC插件-Ledger Dev Tools
- ledger关键词插件很多，注意不要下载错误。
Docker，需要启动保持运行中
- Docker安装跟着官网指南即可，Mac下推荐走App安装方案。
点击插件，首次加载，会拉取ledger-app-dev-tools镜像并启动容易，该镜像大小大概为8.51GB

docker pull ghcr.io/ledgerhq/ledger-app-builder/ledger-app-dev-tools

中国大陆网络环境下如果拉取GitHub官方容器镜像比较慢，可以考虑使用国内的镜像源，比如ghcr.nju.edu.cn。如果本身电脑就是down不下来，可以考虑其它设备传输过去，不过目前看最终插件都会去下载最新版的也就是tag是latest的镜像。

侧载测试操作OS

Ubuntu等Linux发行版系统
MacOS
Windows,应该是最难的。

Ubuntu

Ubuntu下Docker不要使用snap安装的版本，直接从官网下载安装包安装即可，否则会遇到权限问题，导致侧载无法正常运行。

MacOS

如果仅仅只是为了检测联通性，执行如下脚本

pip install ledgerblue


from ledgerblue.comm import getDongle
from ledgerblue.commException import CommException

try:
 dongle = getDongle(debug=True)
 # GET VERSION APDU on the dashboard
 result = dongle.exchange(bytes.fromhex("e001000000"))
 print("Connected! Response:", result.hex())
 dongle.close()
except CommException as e:
 print(f"APDU error (SW=0x{e.sw:04X}): {e.message}")
except Exception as e:
 print(f"Unable to connect: {e}")

我自己实际去跑侧载，S Plus在Sequoia 15.5及以上版本的MacOS都不可以，都会出现不识别。结论

写在最后

总的来说，Ledger Device App的侧载虽然提供了一个很好的测试环境，但在实际使用中仍然存在一些问题和限制。希望通过这篇文章能够帮助开发者更好地理解和解决这些问题，提高开发效率和用户体验。

了解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。