@getsafle/bsc-wallet-controller

bsc-wallet-controller

This repository contains BSCHdKeyring class to create Binance smart chain wallet from Safle Vault.

Usecase

We will be using BSCHdKeyring class to initialize the wallet and then utilize the provided functions to perform the required tasks.
The class initialization is done in the following way.

const bscWallet = new BSCHdKeyring(`mnemonic`)

mnemonic is the BIP-39 key phrase to generate the wallet.

Once we initialize the class, we can utilize the provided functions.

The wallet have the following functions:

generateWallet()

This function is used to generate the BSC wallet and set the 0th address as the default address.
parameters: -
returns: {address: string} // wallet address

exportPrivateKey()

This function is used to export the private key for the generated address.
parameters: -
returns: {privateKey: string} // address private key

signTransaction(transaction: TransactionObj , connectionUrl: string )

This function is used to sign a transaction off-chain and then send it to the network.
Transactions are of 4 types:

1. BSC transfer:
   Trasaction to transfer BSC from one wallet/address to another.
   The transaction object is of the following type:

TransactionObj: {
    data: {
        to, // destination address
        amount, // amount in wei
    },
    txnType: NATIVE_TRANSFER // type constant
}

2. Contract transactions:
   Transaction to call any smart contract function.
   The transaction object is of the following type:

TransactionObj: {
    data: {
        to, // destination smart contract address
        amount, // amount in wei
        data, // hex string of the encoded data
    },
    txnType: CONTRACT_TRANSACTION // type constant
}

parameters:

name: transaction,
type: TransactionObj, // refer to the above 2 trancationObj types.

name: connectionUrl, // BTC network {TESTNET | MAINNET}
type: string,
default: MAINNET (undefined)
optional

returns: {signedTransaction: string} signed raw transaction

signMessage(message: string )

This function is used to sign a message.
parameters:

name: message
type: string

returns: {signedMessage: string} // signed message hex string

getAccounts()

This function is used to get the wallet address.
parameters: -
returns: {address: string} // wallet address

sendTransaction(rawTransaction: string , connectionUrl: string)

This function is used send the signed transaction onto the chain.
parameters:

name: rawTransaction, // signed raw transaction (got from signedTransaction())
type: string

name: connectionUrl, // BTC network {TESTNET | MAINNET}
type: string,
default: MAINNET (undefined)
optional

returns: {transactionDetails : string} // transaction hash

getFee(transaction: TransactionObj , connectionUrl: string)

This function is returns the fees in wei which will be used for the passed transaction.

parameters:

name: transaction,
type: TransactionObj, // refer to the 2 trancationObj types provided in signTransaction.

name: connectionUrl, // BTC network {TESTNET | MAINNET}
type: string,
default: MAINNET (undefined)
optional

returns: {transactionFees: integer} // transaction fees

getBalance(connectionUrl: string)

This function is returns the account balance in wei.

parameters:

name: connectionUrl, // BTC network {TESTNET | MAINNET}
type: string,
default: MAINNET (undefined)
optional

returns: {balance: integer} // transaction fees