Biconomy Smart Account

A tutorial on integrating Biconomy Smart Account for an EOA with Aarc SDK ❇️

Setup Smart Account in two steps using Aarc SDK:

1. Fetch the Smart Account address for the EOA.

2. Deploy and transfer native funds to the Smart Account.

So, let's get started with this step-by-step guide 🚀

---

1. Create a new directory, initialize npm in it and install Aarc Migrator Package and ethers

mkdir aarc_bicoSW && cd aarc_bicoSW  && npm init -y && npm i @aarc-xyz/migrator ethers@5.7.2

2. Create a new file index.js in src folder.

3. Import the dependencies.

const { ethers, BigNumber } = require("ethers");
const {Migrator, WALLET_TYPE}= require("@aarc-xyz/migrator");

4. Get the Aarc API Key (you can learn how to get it from here), your EOA private key and the RPC URL.

5. Initialize the provider and Aarc SDK

let provider = new ethers.providers.JsonRpcProvider("YOUR_RPC_URL");
let signer = new ethers.Wallet("YOUR_PRIVATE_KEY", provider);
let eoaAddress = signer.address;

let aarcSDK = new Migrator({
    rpcUrl: "YOUR_RPC_URL",
    chainId: 80001,
    apiKey: "YOUR_AARC_API_KEY"
});

6. Fetch the Smart Account addresses of the EOA.

async function main() {
    try {
        const smartWalletAddresses = await aarcSDK.getSmartWalletAddresses(
            WALLET_TYPE.BICONOMY, // WALLET_TYPE imported from @aarc-xyz/migrator
            eoaAddress
        );
        console.log(' smartWalletAddresses ', smartWalletAddresses);
    } catch (error) {
        console.error(' error ', error);
    }
}

Here, we provide the WALLET_TYPE.BICONOMY to fetch the Smart Account addresses associated with the EOA.

In the response, we will see the addresses associated with the EOA for Biconomy's Smart Accounts. No Smart Account may be deployed so it will only generate and return the Smart Account address, mentioning its deployment status and the walletIndex.

Example response when no Smart Account is deployed!

 smartWalletAddresses  [
  {
    address: '0xcba2d1f7522757f4f1b2e1f7ce54612c61fbd366',
    isDeployed: false,
    walletIndex: 0
  }
]

7. Deploy the Smart Account.

To deploy the smart account, use aarcSDK.transferNativeAndDeploy this will take a few parameters, as shown below.

NOTE:

• deploymentWalletIndex and receiver can be fetched from the above response.

• amountshould be in hex string, which can be easily done by usingBigNumbers from ethers.

async function main() {
    // ... Previous Code ...
    try {
        const response = await aarcSDK.transferNativeAndDeploy({
            walletType: WALLET_TYPE.BICONOMY,
            owner: eoaAddress,
            receiver: "0xcba2d1f7522757f4f1b2e1f7ce54612c61fbd366",
            signer: signer,
            deploymentWalletIndex: 0,
            amount: BigNumber.from("10000")._hex
        });
        console.log("Transfer and Deploy Response: ", response);
    }catch(error){
        console.error(' error ', error);
    }
}

8. Run the script.

Complete script!

const { ethers, BigNumber } = require("ethers");
const {Migrator, WALLET_TYPE}= require("@aarc-xyz/migrator");

let provider = new ethers.providers.JsonRpcProvider("YOUR_RPC_URL");
let signer = new ethers.Wallet("YOUR_PRIVATE_KEY", provider);
let eoaAddress = signer.address;

let aarcSDK = new Migrator({
    rpcUrl: "YOUR_RPC_URL",
    chainId: 80001, // Mumbai Testnet
    apiKey: "YOUR_AARC_API_KEY"
});

async function main() {
    try {
        const smartWalletAddresses = await aarcSDK.getSmartWalletAddresses(
            WALLET_TYPE.BICONOMY,
            eoaAddress
        );
        console.log(' smartWalletAddresses ', smartWalletAddresses);
    } catch (error) {
        console.error(' error ', error);
    }

    try {
        const response = await aarcSDK.transferNativeAndDeploy({
            walletType: WALLET_TYPE.BICONOMY,
            owner: eoaAddress,
            receiver: "0xcba2d1f7522757f4f1b2e1f7ce54612c61fbd366", //Change the receiver address to the SA address
            signer: signer,
            deploymentWalletIndex: 0, // Change the index to the index of the SA
            amount: BigNumber.from("10000")._hex // Change the string to the amount you want to transfer
        });
        console.log("Transfer and Deploy Response: ", response);
    }catch(error){
        console.error(' error ', error);
    }
}

main();

node src/index.js

You will see the following response after deploying the Biconomy Smart Wallet.

Response after deploying the Smart Wallet

Transfer and Deploy Response:  [
  {
    tokenAddress: '',
    amount: '0x00',
    message: 'Deployment tx sent',
    txHash: '0x95906eed70f8cc7b19549091852a17325011fff67f71a0983c0cdcda55f51b2f'
  },
  {
    tokenAddress: '0x0000000000000000000000000000000000001010',
    amount: '0x2710',
    message: 'Token transfer tx sent',
    txHash: '0x681bd6444460661462cd9e9eedefe87ca17e5022d3a4b2f1e3d340c3c317715b'
  }
]

---

Voila! You have successfully deployed and funded your Biconomy's Smart Account in only two steps using Aarc SDK❇️

If you have any doubts, you can contact us on Telegram.