Skip to main content

starcoinGetPublicKey

Starcoin: get public key​

Retrieves BIP32 extended public derived by given BIP32 path. User is presented with a description of the requested key and asked to confirm the export.

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

Params​

Optional common params

Exporting single public key​

  • path — required string | Array<number> minimum length is 1. read more
  • showOnUKey — optional boolean determines if address will be displayed on device. Default is set to true

Exporting bundle of public keys​

  • bundle - Array of Objects with path, showOnUKey fields

Example​

Return public key of fifth starcoin account:

HardwareSDK.starcoinGetPublicKey(connectId, deviceId, {
  path: "m/101010'/0'/0'",
  showOnUKey: true,
});

Return a bundle of public keys for multiple starcoin accounts:

HardwareSDK.starcoinGetPublicKey(connectId, deviceId, {
  bundle: [
    { path: "m/101010'/0'/0'" }, // account 1
    { path: "m/101010'/0'/1'" }, // account 2
    { path: "m/101010'/0'/2'" }, // account 3
  ],
});

Result​

Result with only one public key

{
    success: true,
    payload: {
        path: string, // hardended path
        publicKey: string
    }
}

Read more about BIP32 serialization format

Result with bundle of public keys

{
    success: true,
    payload: [
        { path: serializedPath, publicKey }, // account 1
        { path: serializedPath, publicKey }, // account 2
        { path: serializedPath, publicKey }, // account 3
    ]
}

Error

{
    success: false,
    payload: {
        error: string, // error message
        code: number // error code
    }
}