anduro-wallet-connector

Anduro Wallet Connector is a React library that will enable users to easily connect to the Anduro Wallet browser extension. This library includes the below options:

Connect
Disconnect
NetworkInfo (initialize)
Send transaction ( BTC & CBTC )
Asset transfer
Convert ( BTC to CBTC )
Convert ( CBTC to BTC)
Sign
Sign transaction
Send transaction
Sign and send transaction
Send Alys transaction

Examples

See our Examples for anduro wallet connector react library integration and implementations.

Before running example, please follow below things.

Install the Anduro Wallet Chrome extension from the Chrome web store. - https://chromewebstore.google.com/detail/anduro-wallet/khebhoaoppjeidmdkpdglmlhghnooijn

Installing example app

go to example folder and run below command
```
npm install
```

Usage

Initialize Anduro Wallet Connector:

import { UseConnectorProvider } from 'anduro-wallet-connector';
import React from 'react';

function App () {
  return (
    <UseConnectorProvider/>
  );
}

we will use the component to connect anduro wallet extension.

Anduro Wallet supported Chains list

Please refer below table for supported chain list

ID	Chain	Network Type
`1`	`Bitcoin`	`mainnet`
`2`	`Coordinate`	`mainnet`
`3`	`Alys`	`mainnet`
`4`	`Bitcoin`	`testnet`
`5`	`Coordinate`	`testnet`
`6`	`Alys`	`testnet`

1. Connect Anduro Wallet

Connect Anduro wallet using connect function.

Request

import React from 'react';
const { connect } = React.useContext<any>(useConnector);

const handleConnectResponse = async () => {
  const result = await connect({
   chainId: 4,
  })
}

Request data types

Parameter	Type	Description
`chainId`	`number`	Required. Please refer to the to the supported chain list table for chainID.

Response

{
  error: null,
  result: "wallet connected successfully.",
  status: true
}

Response data types

Parameter	Type	Description
`error`	`string OR null`	error for the connection request
`result`	`string OR null`	result for the connection request
`status`	`boolean`	status for the connection request

2. Disconnect Anduro Wallet

Disconnect Anduro wallet using disconnect function.

Request

import React from 'react';
const { disconnect } = React.useContext<any>(useConnector);

const handleDisConnectResponse = async () => {
  const result = await disconnect()
}

Response

{
  error: null,
  result: "The site has been removed.",
  status: true
}

Response data types

Parameter	Type	Description
`error`	`string OR null`	error for the disconnect request
`result`	`string OR null`	result for the disconnect request
`status`	`boolean`	status for the disconnect request

3. Get Network And Wallet Info

Get Anduro wallet network and wallet info using networkInfo function.

Request

import React from 'react';
const { networkInfo } = React.useContext<any>(useConnector);

const handleNetworkInfo = async () => {
  const result = await networkInfo()
}

Response

{
error: null,
result: {chainId: 4, networkType: 'bitcoin', accountPublicKey: '0389aadab03634bea18eea715f86aed1a9e7282fb700965898089fe0d8e1a1e2fb', xpubKey: 'tpubDEL7N3DKtxLx5ZNpD9EWJcPWFRQBdzL7u9Y34N1CgwCyCW…xhdz13womU7fPsy8Cq8rLN2hAzUQxa5V2pYNskFPzpgic3Sfh', address: 'tb1qg9064fqm9wx6grja2j2us6szhg046hdzud9va6'},
status: true
}

Response data types

Parameter	Type	Description
`error`	`string OR null`	error for the networkInfo request
`result`	`Object OR null`	result for the networkInfo request
`status`	`boolean`	status for the networkInfo request

4. Transfer Asset

Create Asset transfer in anduro wallet using transfer asset function

import { useConnector } from 'anduro-wallet-connector';
import React from 'react';

const { transferasset } = React.useContext<any>(useConnector);

const handleTransferFunction = async () => {
  const result = await transferasset({
    assetId: 1,
    receiverAddress: "ccrt1qy6302x6qm8084tfwuf2hagfe8ndvpevg3u5n2j",
    supply: 10,
  })
}

Request data types

Parameter	Type	Description
`assetId`	`number`	Required . The asset ID
`receiverAddress`	`string`	Required. Receiver Address
`supply`	`number`	Required. supply to transfer

Response

{
  error: null,
  result:
  {
    txid: "6857b38f0af87534d2ea03e871590cbdc7500ae1461ca416dc3ea7da56732797"
  },
  status: true
}

Response data types

Parameter	Type	Description
`error`	`string OR null`	error for the asset transfer request
`result`	`Object OR null`	result for the asset transfer request
`status`	`boolean`	status for the asset transfer request

5. Network and wallet informations

We provide network and wallet information

import { useConnector } from 'anduro-wallet-connector';
import React from 'react';

const { networkState, walletState } = React.useContext<any>(useConnector);
React.useEffect(() => {
    console.log("networkState", networkState)
    console.log("walletState", walletState)
  }, [networkState, walletState])

Response

networkState: {chainId: 5, networkType: "sidechain"}
walletState: {"accountPublicKey":"03fb98b76e6fc5225a9e00bd56d2c1bf3949dbf09eef6226ed7a118afea45a55ec","connectionState":"connected","address":"tc1qan2zcgz6yr8hjfta5g7j2pzqtwk46rvrhr6g3g","accountXpubKey":"tpubDFHMqRPLjGpVigSDuPBVws3uBLyVducsu1SJb4KVGkWJdGiYu4jJJQKVR6D8BvBhT1wuMcXJtNbQ841txiZSGQFhnYcnxKrNeukaEA1wkPt"}

Network State Response data types

Parameter	Type	Description
`chainId`	`number OR null`	connected chain ID
`networkType`	`string`	connected chain type

Wallet State Response data types

Parameter	Type	Description
`accountPublicKey`	`string`	connected chain account public key
`connectionState`	`string`	connected status
`address`	`string`	connected chain account address
`accountXpubKey`	`string`	connected chain xpub key address

6. Send / Convert ( BTC and CBTC )

import { useConnector } from 'anduro-wallet-connector';
import React from 'react';

const { send } = React.useContext<any>(useConnector);
const handleSendAction = async () => {
  const params = {
      transactionType: "normal",
      amount: 1,
      receiverAddress: "ccrt1qy6302x6qm8084tfwuf2hagfe8ndvpevg3u5n2j",
      feeRate: 1,
    }
    const result = await send(params);
}

Request data types

Parameter	Type	Description
`transactionType`	`string`	Required . normal(Send BTC / CBTC) OR pegin(Convert BTC to CBTC) OR pegout(Convert CBTC to BTC)
`amount`	`number`	Required. Amount to transfer in BTC
`receiverAddress`	`string`	Required. for normal transaction. Optional. for peg transaction
`feeRate`	`number`	Optional. Fee rate per virtual byte

Response

{
  error: null,
  result:
  {
    txid: "6e16b14f7803d6fcb11a555b6e7e161b7af3eb4e618ff324ff21b31f15e7f1ae"
  },
  status: true
}

Response data types

Parameter	Type	Description
`error`	`string OR null`	error for the transfer request
`result`	`Object OR null`	result for the transfer request
`status`	`boolean`	status for the transfer request

7. Sign Message

Sign Anduro wallet using sign function.

import React from 'react';
const { sign } = React.useContext<any>(useConnector);

const handleConnectResponse = async () => {
  const result = await sign({
   message: "sign message"
  })
}

Request data types

Parameter	Type	Description
`message`	`string`	Required . message to sign

Response

{
  error: null,
  result: "IK1OBlxobfS9pJiVVr88Kfg97uuJ1wnPDPHfLQfF7t4JBx7X5GDIO1Bhj+a2/+hyZyEWC9EKsj2KgnngF80VvdU=",
  status: true
}

Response data types

Parameter	Type	Description
`error`	`string OR null`	error for the sign request
`result`	`string OR null`	result for the sign request
`status`	`boolean`	status for the sign request

8. Sign Transactions

Sign the PSBT raw hex using the signTransaction function.

import React from 'react';
const { signTransaction } = React.useContext<any>(useConnector);
const [rawHex, setRawHex] = React.useState<string>("");

  const signTransactions = async () => {
    const signResult = await signTransaction({
      hex: rawHex,
    })
    console.log("===== SIGN RESULT EXAMPLE ======", signResult)
    if (signResult.status) {
      setSignedHex(signResult.result.signedHex)
    }
  }

Request data types

Parameter	Type	Description
`hex`	`string`	Required . serialized hex

Response

{
  error: null,
  result: {signedHex:
"02000000000102aef1e7151fb321ff24f38f614eebf37a1b167e6e5b551ab1fcd603784fb1166e0000000000fdffffffaef1e7151fb321ff24f38f614eebf37a1b167e6e5b551ab1fcd603784fb1166e0100000000fdffffff028096980000000000160014937266dd00e16824d98e53d899c79728f50a6a240aad5300000000001600141d633457317f33abd1a8119e9f4af0d6b077c2f40247304402202362745b0cbe20680ea9b0d5dbf026cbdae2b7fe06784b184693745a8ff2db05022057f8a0944026be91e0de1366fdf3c7c55f406bf40ce1fdfee34b9efc83967a3a0121038f0767d3773829db262c59ac297f541f8cf047e12b6171286279de68f62745c702483045022100ece1794f2b89e62b4824bde0a4edf7c591f44d331f0e43777931cd38352472b802207e4b64d020ccd7509b06d8ea2d6bced2e47fd2eb48db4d14e4a63984b16817640121022b7ff89de365f25b8c29e3625c4c6f4c4e048d47e2d1ba41269272137e477bc100000000",
transactionSize: 209,
},
  status: true
}

Response data types

Parameter	Type	Description
`error`	`string OR null`	error for the sign request
`result`	`Object OR null`	result for the sign request
`status`	`boolean`	status for the sign request

9. Send Transactions

Send a signed PSBT hex to the connected chain using the sendTransaction function.

import React from 'react';
const { sendTransaction } = React.useContext<any>(useConnector);
const [signedHex, setSignedHex] = React.useState<string>("")

  const sendTransactions = async (type: string) => {
    const sendResult = await sendTransaction({
      hex: signedHex,
      transactionType: type,
    })
    console.log("===== SEND RESULT EXAMPLE ======", sendResult)
  }

Request data types

Parameter	Type	Description
`hex`	`string`	Required . PSBT signed hex
`type`	`string`	Required . type for the transaction (normal OR premium)

Response

{
  error: null,
  result: "96a4b76809164a4c30254dbac6a9e8135cc4ca331c04d0152d773230cc720d69",
  status: true
}

Response data types

Parameter	Type	Description
`error`	`string OR null`	error for the sign request
`result`	`string OR null`	transaction ID
`status`	`boolean`	status for the sign request

10. Sign And Send Transactions

Sign and send a transaction to the connected chain using the signAndSendTransaction function.

Parameter

hex: PSBT raw hex type: normal OR premium

import React from 'react';
const { signAndSendTransaction } = React.useContext<any>(useConnector);
const [rawHex, setRawHex] = React.useState<string>("");

  const signAndSendTransactions = async (type: string) => {
    const transactionResult = await signAndSendTransaction({
      hex: rawHex,
      transactionType: type,
    })
    console.log("===== SIGN AND SEND TRANSACTION RESULT EXAMPLE ======", transactionResult)
  }

Request data types

Parameter	Type	Description
`hex`	`string`	Required . PSBT signed hex
`type`	`string`	Required . type for the transaction (normal OR premium)

Response

{
  error: null,
  result: "96a4b76809164a4c30254dbac6a9e8135cc4ca331c04d0152d773230cc720d69",
  status: true
}

Response data types

Parameter	Type	Description
`error`	`string OR null`	error for the sign request
`result`	`string OR null`	transaction ID
`status`	`boolean`	status for the sign request

11. Send Alys transaction

Send Alys Transaction to be connected chain using the send Alys Transaction function .

import React from 'react';
const { sendAlys } = React.useContext<any>(useConnector);
const [unsignedHex, setUnsignedHex] = React.useState<string>("")
  const sendAlys = async () => {
    const hex = unsignedHex
    const transactionResult = await sendAlys({
      hex,
    })
  }

Request data types

Parameter	Type	Description
`hex`	`string`	Required . serialized hex

Response

{
  error: null,
  result:
  {
    txid: "0x811165a6cc8d80b5771359556dfd149f4cb19f03284a76b987c821ce01f3a80d"
  },
  status: true
}

Response data types

Parameter	Type	Description
`error`	`string OR null`	error for the transaction request
`result`	`Object OR null`	result for the transaction request
`status`	`boolean`	status for the transaction request