跳到主要内容

nexaGetAddress

使用要求​

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

Nexa：获取地址​

获取指定的 BIP32 路径派生地址。用户需要在 Ukey Wallet 上核对并确认导出该地址。

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

参数​

可选通用参数

导出单个公钥​

  • path - 必需 string | Array<number>，字符串数组最小长度限制为 3。更多信息
  • showOnUKey - 可选 boolean，决定是否在设备上进行地址显示；默认值为 true。
  • prefix - 可选 string，用于指定地址前缀；默认值为 nexatest。
  • scheme - 可选 string，用于指定签名算法模式；默认值为 schnorr。

导出批量公钥​

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

示例​

获取第二个 Nexa 账户的公钥：

HardwareSDK.nexaGetAddress(connectId, deviceId, {
  path: "m/44'/29223'/1'/0/0",
  showOnUKey: true,
  prefix: "nexatest",
  scheme: "schnorr",
});

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

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

返回结果​

单个公钥返回示例

{
    success: true,
    payload: {
        path: Array<number>, // 派生路径
        address: string,     // 返回的地址
    }
}

批量公钥返回示例（顺序与请求一致）

{
    success: true,
    payload: [
        { path: Array<number>, address: string }, // 第4个派生账户路径
        { path: Array<number>, address: string }, // 第5个派生账户路径
        { path: Array<number>, address: string }, // 第6个派生账户路径
    ]
}

错误

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