签名导读
本向导关注“应用如何把一笔待签名数据安全交给 UKey Wallet，并拿到可验证的签名结果”。不同链的交易结构差异很大，因此文档按链拆分，分别说明路径、参数、设备确认内容和签名校验方式。阅读前建议先了解 请求基础。
结构图
- 前置条件：固件版本、SDK 入口、传输方式和是否需要设备确认。
- 签名链路：连接设备 → 选择账户路径 → 构造请求 → 设备端审阅 → 返回签名 → 应用端验签。
- 最小参考片段：保留必要事件监听、核心请求参数和结果校验。
- 排障方向：路径错误、数据格式不匹配、设备拒签、请求超时、网络广播失败。
速查核对
| 核验项 | 说明 |
|---|---|
| 版本要求 | 固件和 SDK 版本要求保持一致，并按平台选择 WebUSB、BLE 或底层插件方案。 |
| 路径说明 | 每条链都有自己的 HD Path 规则，硬化和非硬化层级要单独留意。 |
| 会话 | 大多数链方法都需要 connectId + deviceId；设备重置后要重新读取 deviceId。 |
| 隐藏钱包 | 涉及 Passphrase 的流程需要携带或刷新 passphraseState。 |
| UI 处理 | 提前订阅 UI_EVENT，收到 PIN、Passphrase 或确认请求时再调用 uiResponse。 |
| 结果核验 | 先确认 success，再用链工具库核对地址、签名或序列化交易。 |
| 安全提示 | 如果设备显示和前端预期不一致，应让用户拒签，不要自动重放请求。 |
可用导读
- EVM Signer — EIP-1559 / Legacy 交易、消息签名、Typed Data 和广播前校验。
- BTC Signer — UTXO、脚本类型、前序交易、找零和手续费校验。
- Solana Signer — 全硬化路径、rawTx 准备、签名附加和结果验证。