@secux/app-btc

@secux/app-btc

SecuX Hardware Wallet BTC API

Usage

import { SecuxBTC, ScriptType } from "@secux/app-btc";

First, create instance of ITransport

• Web Usb
• Web Bluetooth
• React Native Bluetooth

Examples

1. Get address by purpose and script type

// native segwit address
const address = SecuxBTC.getAddress(
    device, 
    "m/84'/0'/0'/0/0", 
    ScriptType.P2WPKH, 
    { 
        coin: CoinType.BITCOIN // define cointype for checking path, optional
    }
);

// segwit address
const address = SecuxBTC.getAddress(
    device, 
    "m/49'/0'/0'/0/0", 
    ScriptType.P2SH_P2WPKH
);

// legacy address
const address = SecuxBTC.getAddress(
    device, 
    "m/44'/0'/0'/0/0", 
    ScriptType.P2PKH
);

1. For bitcoin ecosystem, you can use specific cointype by the coin

// native segwit address for dogecoin
const address = SecuxBTC.getAddress(
    device, 
    "m/84'/3'/0'/0/0", 
    ScriptType.P2WPKH
);

// segwit address for litecoin
const address = SecuxBTC.getAddress(
    device, 
    "m/49'/2'/0'/0/0", 
    ScriptType.P2SH_P2WPKH
);

// legacy address for bitcoincash
const address = SecuxBTC.getAddress(
    device, 
    "m/44'/145'/0'/0/0", 
    ScriptType.P2PKH
);

1. sign transaction

const inputs = [
    {
        hash: "0b062e71e165fba9634d9fb1b5ba703e774bf374815b1f5a617c8d1e7d43dc01",
        vout: 0,
        // for p2pkh, the raw transaction of utxo is needed
        txHex: "0100000001b103a004f672080ceae8277e83c296b5ac090ae78157979211da3e2d41399d1b010000006b483045022100f19d88e6a17789dc399ff2a93b4516bb44af32928d4986138f1a4f7f37ab277b022046fc14c958bc8aa97fea1d2fbf80982534cf51634d46c4d5178e5ca6698bca07012102f8667cfb5b80c3695e3f0c9078589cb04e8d15e71bdae89ebf24b82f9d663d5cffffffff02bc020000000000001976a9145c592f40134c6179a1ce5b06b28d5c2ae443113188ac00040000000000001976a9146d65ced4ef49e23cdbb4be9d510b38e5be28e10688ac00000000",
        script: ScriptType.P2PKH,
        satoshis: 700,
        path: "m/44'/0'/0'/0/0"
    },
    {
        hash: "07ad0a13e501d292bc8b9e16a3a8b62f99f77ab9e37ea8d3b8453984a2899984",
        vout: 0,
        script: ScriptType.P2SH_P2WPKH,
        satoshis: 6000,
        path: "m/49'/0'/0'/0/0"
    },
    {
        hash: "8686aee2b9dcf559798b9718ed26ca92e0c64bef11c433e576cae658678c497d",
        vout: 1,
        script: ScriptType.P2WPKH,
        satoshis: 1083,
        path: "m/84'/0'/0'/1/0"
    }
];

const out = {
    address: "bc1qs0k3ekx0z7a7yuq3lse7prw373s8cr8lhxvccd",
    satoshis: 1500

    // or send to another account
    // script: ScriptType.P2WPKH,
    // path: "m/84'/0'/1'/0/3",
    // satoshis: 6100
};

const utxo = {
    script: ScriptType.P2PKH,
    path: "m/44'/0'/0'/0/0",
    satoshis: 6100
};


const { raw_tx, signature } = await SecuxBTC.signTransaction(
    device, 
    inputs, 
    { 
        to: out, 
        utxo: utxo
    }
);

API doc

SecuxBTC

BTC package for SecuX device

Kind: global class

• SecuxBTC
  • SecuxBTC.getAddress(trans, path, script, [option]) ⇒ string
  • SecuxBTC.signTransaction(trans, inputs, outputs) ⇒ object

SecuxBTC.getAddress(trans, path, script, [option]) ⇒ string

Get address derived by given BIP32 path

Kind: static method of SecuxBTC
Returns: string - address

Param	Type	Description
trans	ITransport
path	string	BIP32
script	ScriptType	script type
[option]	AddressOption

SecuxBTC.signTransaction(trans, inputs, outputs) ⇒ object

Create transaction and Sign

Kind: static method of SecuxBTC
Returns:
object - signed
string - signed.raw_tx
Array<Buffer> - signed.signature

Param	Type
trans	ITransport
inputs	Array<txInput>
outputs	txOutput