@secux/app-ada

SecuX Hardware Wallet ADA API

Usage

import { SecuxADA, AddressType } from "@secux/app-ada";

First, create instance of ITransport

• Web Usb
• Web Bluetooth
• React Native Bluetooth

Examples

1. Get shelley address

   • base address

   const path = "m/1852'/1815'/0'";
   const address = await device.getAddress(path, AddressType.BASE);
   
   /*
   
   // transfer data to hardware wallet by custom transport layer
   const data = SecuxADA.prepareAddress(path);
   const response = await device.Exchange(data);
   const address = SecuxADA.resolveAddress(response, AddressType.BASE);
   
   */

   • reward address

   const path = "m/1852'/1815'/0'";
   const address = await device.getAddress(path, AddressType.REWARD);

2. Sign transaction

   • transfer asset

   const inputs = [
       {
           path: "m/1852'/1815'/0'",
           txId: "75c7d745c5212a11a0bfc2719c35bcc2f57fda88d7afb2eb3c5f2b02c3e99ccb",
           index: 1,
           amount: 12663894,
           // for custom transport layer, each utxo needs xpublickey.
           // xpublickey: "c232950d7c27b78542795ce4cad053e8dfaab7679ba5477563be5c60c1a4d0613fc81fd9bb8f30822c1252c29cc6af147831da44fb86acad6c04fcc95700b92b"
       },
       {
           path: "m/1852'/1815'/0'",
           txId: "6552b8f8b8b282542b07d6187fe80daa5b7a60461c97231f45c06fd97f8a3385",
           index: 1,
           amount: 2330624,
           // for custom transport layer, each utxo needs xpublickey.
           // xpublickey: "c232950d7c27b78542795ce4cad053e8dfaab7679ba5477563be5c60c1a4d0613fc81fd9bb8f30822c1252c29cc6af147831da44fb86acad6c04fcc95700b92b"
       },
   ];
   
   const output = {
       // daedalus or shelley address is accepted.
       address: "DdzFFzCqrhsjZHKn8Y9Txr4B9PaEtYcYp8TGa4gQTfJfjvuNLqvB8hPG35WRgK4FjcSYhgK7b2H24jLMeqmPoS3YhJq6bjStsx4BZVnn",
       amount: 13000000
   };
   
   const { raw_tx } = await device.sign(inputs, output, {
       changeAddress: "addr1qyk54vyyc856ngxermdzqhxnlk376ykkupru8rxcyryvg4kxs4un3x4r4rq422kwrtvc8p2a20dzhyr5v0n9lhwy2u6sfjujuz",
   });
   
   /*
   
   // transfer data to hardware wallet by custom transport layer.
   const { commandData, serialized } = SecuxADA.prepareSign(inputs, output, {
       changeAddress: "addr1qyk54vyyc856ngxermdzqhxnlk376ykkupru8rxcyryvg4kxs4un3x4r4rq422kwrtvc8p2a20dzhyr5v0n9lhwy2u6sfjujuz",
   });
   const response = await device.Exchange(commandData);
   const raw_tx = SecuxADA.resloveTransaction(response, serialized);
   
   */

   • stake

   const input = {
       path: "m/1852'/1815'/0'",
       utxo: [
           {
               txId: "75c7d745c5212a11a0bfc2719c35bcc2f57fda88d7afb2eb3c5f2b02c3e99ccb",
               index: 1,
               amount: 12663894,
           }
       ],
       changeAddress: "addr1qyk54vyyc856ngxermdzqhxnlk376ykkupru8rxcyryvg4kxs4un3x4r4rq422kwrtvc8p2a20dzhyr5v0n9lhwy2u6sfjujuz",
       // for custom transport layer, each utxo needs xpublickey.
       // xpublickey: "c232950d7c27b78542795ce4cad053e8dfaab7679ba5477563be5c60c1a4d0613fc81fd9bb8f30822c1252c29cc6af147831da44fb86acad6c04fcc95700b92b"
   };
   
   // pool id (support bech32 encoded)
   const pool = "ea595c6f726db925b6832af51795fd8a46e700874c735d204f7c5841";
   
   const { raw_tx } = await device.sign(
       input,
       pool,
       {
           // An account needs to have a stake pool registration certificate 
           // before it can participate in stake delegation between stake pools.
           needRegistration: true
       }
   );
   
   /*
   
   // transfer data to hardware wallet by custom transport layer.
   const { commandData, serialized } = SecuxADA.prepareStake(
       input,
       pool,
       {
           needRegistration: true
       }
   );
   const response = await device.Exchange(commandData);
   const raw_tx = SecuxADA.resolveTransaction(response, serialized);
   
   */

   • withdrawal

   const withdrawAmount = 150000;
   const { raw_tx } = await device.sign(input, withdrawAmount);
   
   /*
   
   // transfer data to hardware wallet by custom transport layer.
   const { commandData, serialized } = SecuxADA.prepareStake(input, withdrawAmount);
   const response = await device.Exchange(commandData);
   const raw_tx = SecuxADA.resolveTransaction(response, serialized);
   
   */

   • unstake (de-register staking key)

   const { raw_tx } = await device.sign(
       input, 
       {
           // With de-registration operation, the balance of reward address must be 0.
           withdrawAmount
       }
   );
   
   /*
   
   // transfer data to hardware wallet by custom transport layer.
   const { commandData, serialized } = SecuxADA.prepareUnstake(input, { withdrawAmount });
   const response = await device.Exchange(commandData);
   const raw_tx = SecuxADA.resolveTransaction(response, serialized);
   
   */

API Reference

ADA package for SecuX device

Kind: global class

• SecuxADA
  • .addressConvert(xpublickey, type, [option]) ⇒ string
  • .prepareAddress(pathWith3Depth) ⇒ communicationData
  • .resolveAddress(response, type, [option]) ⇒ string
  • .prepareXPublickey(pathWith3Depth) ⇒ communicationData
  • .resolveXPublickey(response) ⇒ string
  • .prepareSign(inputs, output, [option]) ⇒ prepared
  • .resolveSignatureList(response) ⇒ Array.<string>
  • .resolveTransaction(response, serialized) ⇒ string
  • .prepareStake(input, pool, [option]) ⇒ prepared
  • .prepareUnstake(input, [option]) ⇒ prepared
  • .prepareWithdraw(input, amount, [option]) ⇒ prepared

SecuxADA.addressConvert(xpublickey, type, [option]) ⇒ string

Convert bip32-publickey to ADA address.

Returns: string - address

SecuxADA.prepareAddress(pathWith3Depth) ⇒ communicationData

Prepare data for address generation.

Returns: communicationData - data for sending to device

SecuxADA.resolveAddress(response, type, [option]) ⇒ string

Resolve address from response data.

Returns: string - address

SecuxADA.prepareXPublickey(pathWith3Depth) ⇒ communicationData

Prepare data for bip32-publickey.

Returns: communicationData - data for sending to device

SecuxADA.resolveXPublickey(response) ⇒ string

Resolve bip32-publickey from response data.

Returns: string - bip32-publickey (hex string)

SecuxADA.prepareSign(inputs, output, [option]) ⇒ prepared

Prepare data for signing.

SecuxADA.resolveSignatureList(response) ⇒ Array.<string>

Reslove signatures from response data.

Returns: Array.<string> - signature array of hex string

SecuxADA.resolveTransaction(response, serialized) ⇒ string

Resolve transaction for broadcasting.

Returns: string - signed transaction (base64 encoded)

SecuxADA.prepareStake(input, pool, [option]) ⇒ prepared

Prepare data for signing.

SecuxADA.prepareUnstake(input, [option]) ⇒ prepared

Prepare data for signing.

SecuxADA.prepareWithdraw(input, amount, [option]) ⇒ prepared

Prepare data for signing.

AddressType : enum

Properties

PointerOption : object

Properties

AddressOption : object

Properties

txInput : object

Properties

txOutput : object

Properties

signOption : object

Properties

stakeOption : object

Properties

withdrawOption : object

Properties

unstakeOption : object

Properties

utxo : object

Properties

stakeInput : object

Properties

prepared : object

Properties

© 2018-21 SecuX Technology Inc.

authors:
andersonwu@secuxtech.com