Skip to Content
ハードウェア
このページの内容

btcGetAddress

Bitcoin: アドレスを取得

指定パスのアドレスを導出して返します。showOnOneKey が true の場合は、 ユーザーがデバイス上でアドレスを確認する必要があります。

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

パラメーター

任意の共通パラメーター

単一のアドレス

  • path - 必須 string | Array<number> SDK の最小長は 1. 詳細を読む
  • showOnOneKey - 任意 boolean アドレスをデバイスに表示するかどうか。デフォルトは true.
  • coin - 任意 string 次で指定されたネットワーク定義を決定します: coins.json  ファイル。コインの shortcut, name または label を使用できます。coin が設定されていない場合、API は path からネットワーク定義の取得を試みます。
  • multisig - 任意 MultisigRedeemScriptType、redeem script の情報 (マルチシグアドレスのみ)
  • scriptType - 任意 InputScriptType、アドレスのスクリプトタイプ

複数のアドレス

  • bundle - path, showOnOneKey, coin フィールドを持つオブジェクトの配列

異なる種類のアドレスを取得

BTC アドレスタイプごとに、異なる導出パスのパラメーターが必要です。

型パス例
レガシー BIP44m/44’/0’/x’/x/x「1」で始まり、26 ～ 35 文字で構成されます
ネスト型 SegWit BIP49m/49’/0’/x’/x/x「3」で始まり、26 ～ 35 文字で構成されます
ネイティブ SegWit BIP84m/84’/0’/x’/x/xメインネットは次で始まります: bc1q; テストネットは次で始まります: tb1q
Taproot BIP86m/86’/0’/x’/x/xメインネットは次で始まります: bc1p; テストネットは次で始まります: tb1p

例

最初の bitcoin アカウントの 3 番目のアドレスを表示します:

HardwareSDK.btcGetAddress(connectId, deviceId, {
    path: "m/49'/0'/0'/0/2",
    coin: "btc"
});

デバイスに表示せず、最初の bitcoin アカウントのアドレスをまとめて返します:

HardwareSDK.btcGetAddress(connectId, deviceId, {
    bundle: [
        { path: "m/49'/0'/0'/0/0", showOnOneKey: false }, // address 1
        { path: "m/49'/0'/0'/0/1", showOnOneKey: false }, // address 2
        { path: "m/49'/0'/0'/0/2", showOnOneKey: false }  // address 3
    ]
});

結果

単一アドレスのレスポンス

{
    success: true,
    payload: {
        address: string,     // displayed address
        path: string // serialized BIP32 path
    }
}

アドレスのバッチレスポンス

{
    success: true,
    payload: [
        { address: string, path: string }, // address 1
        { address: string, path: string }, // address 2
        { address: string, path: string }, // address 3
    ]
}

エラー

{
    success: false,
    payload: {
        error: string, // error message
        code?: string | number // error code
    }
}
最終更新日
はじめに