startcoinGetAddress

Starcoin：获取地址

返回指定的 BIP32 路径派生的地址。开启设备展示时，用户需要在 Ukey Wallet 上核对并确认导出该地址。

const response = await HardwareSDK.starcoinGetAddress(
  connectId,
  deviceId,
  params,
);

参数

可选通用参数

导出单个地址

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

导出批量地址

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

示例

在设备上展示第二个 Starcoin 账户地址：

HardwareSDK.starcoinGetAddress(connectId, deviceId, {
  path: "m/44'/101010'/1'/0/0",
});

批量获取多个 Starcoin 地址，并跳过设备展示：

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

返回结果

单个地址返回示例

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

批量地址返回示例（顺序与请求一致）

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

错误

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