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.

• React Example
• Next.js Example

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 |