跳到主要内容

配对二维码

配对为你的钱包提供显示余额和构建交易所需的公钥。在 BitTool Signer 中,用户打开一个钱包并点击 Connect(连接),其中包含两个标签页。

钱包级币种级
二维码内容一个动态 ur:bytes 二维码每条链、每种账户类型各一个二维码
链Bitcoin(4 种地址类型)、EVM、TRON、Solana(3 个预设)用户选择的链
格式BitTool 自有的 bittool-signer-wallet v1标准 UR 类型:crypto-account、crypto-hdkey、crypto-multi-accounts,或纯地址
适用场景希望扫描一次即完成导入的多链钱包已支持二维码硬件签名器(Keystone 风格)的钱包
目前支持的钱包BitTool WalletSparrow、BlueWallet、MetaMask、Rabby、Solflare 等(参见兼容性)

两者都是对同一组公钥的只读导出;钱包级二维码只是一次性包含了全部公钥。两者都不需要钱包密码,也都不包含助记词、种子或任何私钥。

需要保存的数据​

对于导入的每个账户,请保存:

字段原因
主指纹(8 位十六进制数)每个签名请求都要携带,BitTool Signer 借此找到对应的钱包
账户路径,例如 m/84'/0'/0'请求中每个完整路径的前缀
账户 xpub(Bitcoin、EVM、TRON)用于派生收款地址和找零地址
脚本类型(Bitcoin)决定地址格式和 PSBT 字段
地址和完整路径(Solana,以及仅导出地址的 TRON 或 EVM)Solana 没有 xpub;每个预设对应一个密钥

请在本地根据 xpub 派生地址。永远不要向用户索要助记词,也不要尝试用一条链的 xpub 派生另一条链的密钥。

让用户核对​

BitTool Signer 会在二维码下方显示每个导出账户的第一个地址。导入完成后,请在你的 App 中显示相同的地址,并请用户完整比对,而不是只看开头和结尾的几个字符。由于二维码本身没有签名,这是防范配对数据被篡改或出错的唯一手段。

重复与重新配对​

  • 只有当公钥一致时,才把一次配对视为同一个钱包。仅凭指纹是不够的。
  • 如果新的配对使用已知的指纹但密钥不同,不要覆盖现有钱包(使用不同的 BIP39 passphrase 恰好会产生这种情况)。
  • 重装任一 App 后用相同的密钥重新配对,应恢复为同一个钱包,而不是新建第二个钱包。

网络​

所有导出均为主网:Bitcoin 主网、支持的八个 EVM 网络、TRON 主网以及 Solana mainnet-beta。不导出测试网密钥。