跳到主要内容

cosmosGetPublicKey

使用要求​

  • 固件版本要求
    • UKey Lite 24 / UKey Lite 25: 1.1.0
    • UKey Core 26: 1.1.0

Cosmos：获取公钥​

根据传入的 BIP32 路径导出扩展公钥；让用户在设备端确认导出。

const result = await HardwareSDK.cosmosGetPublicKey(
  connectId,
  deviceId,
  params,
);

参数​

可选通用参数

导出单个公钥​

  • path - 必需 string | Array<number>，字符串数组最小长度限制为 1。更多信息
  • curve - 可选 string，椭圆曲线算法；默认值为 secp256k1。
  • showOnUKey - 可选 boolean，决定是否在设备上显示地址；默认值为 true。

导出批量公钥​

  • bundle - Array 数组对象，包含 path、showOnUKey 和 curve 字段。

示例​

返回第二个 Cosmos 账户的公钥：

HardwareSDK.cosmosGetPublicKey(connectId, deviceId, {
  path: "m/44'/118'/1'/0/0",
  curve: "secp256k1",
  showOnUKey: true,
});

批量获取多个 Cosmos 账户的公钥：

HardwareSDK.cosmosGetPublicKey(connectId, deviceId, {
  bundle: [
    { path: "m/44'/118'/3'/0/0" }, // 第4个派生账户路径
    { path: "m/44'/118'/4'/0/0" }, // 第5个派生账户路径
    { path: "m/44'/118'/5'/0/0" }, // 第6个派生账户路径
  ],
});

返回结果​

只有一个公钥的结果

{
    success: true,
    payload: {
        path: string,      // 派生路径
        publicKey: string, // 返回的公钥
    }
}

了解更多关于 BIP32 序列化格式

批量公钥的结果

{
    success: true,
    payload: [
        { path: serializedPath, publicKey }, // 第4个派生账户路径
        { path: serializedPath, publicKey }, // 第5个派生账户路径
        { path: serializedPath, publicKey }, // 第6个派生账户路径
    ]
}

错误

{
    success: false,
    payload: {
        error: string, // 错误消息
        code: number // 错误码
    }
}