Batched Transactions

Batched transactions allow you to perform multiple transactions in one single on-chain transaction

You can send an array of transactions and they will all get processed in 1 single transaction. Candide batched transactions are atomic; meaning that all transactions in the batch must succeed, otherwise, if any of the batched transactions fails then they are all canceled.

EIP-5792 allows us to standardize JSON-RPC methods for Dapps to communicate bundle calls to wallets using:

• wallet_sendFunctionCallBundle
• wallet_getBundleStatus
• wallet_showBundleStatus

You will need to download CANDIDE wallet to test your Dapp. Get access from the #dev channel in discord by pinging a core contributor.

Web3Modal

Try it in this sandbox

Send Bundle Calls

Example of how to send a transaction batch (2 ETH transfers) using Web3Modal

import Web3Modal from "web3modal";
import WalletConnect from "@walletconnect/web3-provider";

// define walletconnet provider
export const providerOptions = {
  walletconnect: {
    package: WalletConnect, // required
    options: {
      infuraId: "API_KEY" // required
    }
  }
};

//define web3Modal
const web3Modal = new Web3Modal({
  cacheProvider: true, // optional
  providerOptions // required
});

// get provider
const provider = await web3Modal.connect();
const library = new ethers.providers.Web3Provider(provider);


// define txs: send 0.001 ETH to two different addresses
const calls = [
  {
    chainId: 5,
    from: account,
    calls: [
      {
        to: "0xED0704E34278560a220A1EDFd9A2972b181081Fc",
        value: "0x5AF3107A4000",
        data: "0x",
        gas: "0x76c0"
      },
      {
        to: "0xf758D47a96685C1bb77223767F17D15497E610f3",
        value: "0x5AF3107A4000",
        data: "0x",
        gas: "0x76c0"
      }
    ]
  }
];

const txHash = await library.provider.request({
  method: "wallet_sendFunctionCallBundle",
  params: calls
});

console.log(txHash);
Get Bundle Status
const status = await library.provider.request({
  method: "wallet_getBundleStatus",
  params: [txHash]
});

if (status) {
  const response = JSON.parse(status).calls[0];
  console.log(response);
}

// example of status reponse 
{
  "calls": [
    {
      "status": "CONFIRMED",
      "receipt": {
        "logs": [
          {
            "address": "0xa922b54716264130634d6ff183747a8ead91a40b",
            "topics": [
              "0x5a2a90727cc9d000dd060b1132a5c977c9702bb3a52afe360c9c22f0e9451a68"
            ],
            "data": "0xabcd"
          }
        ],
        "success": true,
        "blockHash": "0xf19bbafd9fd0124ec110b848e8de4ab4f62bf60c189524e54213285e7f540d4a",
        "blockNumber": "0xabcd",
        "blockTimestamp": "0xabcdef",
        "gasUsed": "0xdef",
        "transactionHash": "0x9b7bb827c2e5e3c1a0a44dc53e573aa0b3af3bd1f9f5ed03071b100bb039eaff"
      }
    },
    {
      "status": "PENDING"
    }
  ]
}

Show Bundle Status

// delegate showing bundle status to the wallet

const status = await library.provider.request({
  method: "wallet_showBundleStatus",
  params: [txHash]
});

console.log(status);

{
  status: "CONFIRMED"
  receipt: {
    logs: [..]
    success: true
    blockHash: "0x84b9f48e922c6b500fa07a1e94144cb1452f2466199fc726e807d31bae6b4e52"
    blockNumber: "0x7dbc3c"
    gasUsed: "0x25c8e"
    transactionHash: "0xcb8c43372800586bffc7521e0ca09f8828a87d4f0003f36ea68f9cbcf3e229f9"
  }
}

WalletConnect Standalone

Send Bundle Calls

Example of how to send a transaction batch (2 ETH transfers) using walletconnect standalone client

import { ethers } from "ethers";
import WalletConnect from "@walletconnect/client";
import QRCodeModal from "@walletconnect/qrcode-modal";

// set provider
const provider = new ethers.providers.JsonRpcProvider("https://goerli.infura.io/v3/$API_KEY");

// connect with walletconnect
// define connector, create a new session and connect to the right chain ID
const connector = new WalletConnect({ bridge, qrcodeModal: QRCodeModal });
//.. 

// send 0.001 ETH to two different addresses
const calls = [
  {
    chainId: 5,
    from: account,
    calls: [
      {
        to: "0xED0704E34278560a220A1EDFd9A2972b181081Fc",
        value: "0x5AF3107A4000",
        data: "0x",
        gas: "0x76c0"
      },
      {
        to: "0xf758D47a96685C1bb77223767F17D15497E610f3",
        value: "0x5AF3107A4000",
        data: "0x",
        gas: "0x76c0"
      }
    ]
  }
];

// send transaction
const transactionHash = await connector.sendCustomRequest({
  id: 1671118055013479,
  jsonrpc: "2.0",
  method: "wallet_sendFunctionCallBundle",
  params: calls,
});
Get Bundle Status
// get the status of the bundle call 
const status = await connector.sendCustomRequest({
  id: 1671118055013479,
  jsonrpc: "2.0",
  method: "wallet_getBundleStatus",
  params: [transactionHash]
});

// example of status reponse
{
  "calls": [
    {
      "status": "CONFIRMED",
      "receipt": {
        "logs": [
          {
            "address": "0xa922b54716264130634d6ff183747a8ead91a40b",
            "topics": [
              "0x5a2a90727cc9d000dd060b1132a5c977c9702bb3a52afe360c9c22f0e9451a68"
            ],
            "data": "0xabcd"
          }
        ],
        "success": true,
        "blockHash": "0xf19bbafd9fd0124ec110b848e8de4ab4f62bf60c189524e54213285e7f540d4a",
        "blockNumber": "0xabcd",
        "blockTimestamp": "0xabcdef",
        "gasUsed": "0xdef",
        "transactionHash": "0x9b7bb827c2e5e3c1a0a44dc53e573aa0b3af3bd1f9f5ed03071b100bb039eaff"
      }
    },
    {
      "status": "PENDING"
    }
  ]
}

Show Bundle Status

// Delegate showing the bundle status to the wallet
const status = await connector.sendCustomRequest({
  id: 1671118055013479,
  jsonrpc: "2.0",
  method: "wallet_showBundleStatus",
  params: [txHash],
});

console.log(status);

{
  status: "CONFIRMED"
  receipt: {
    logs: [..]
    success: true
    blockHash: "0x84b9f48e922c6b500fa07a1e94144cb1452f2466199fc726e807d31bae6b4e52"
    blockNumber: "0x7dbc3c"
    gasUsed: "0x25c8e"
    transactionHash: "0xcb8c43372800586bffc7521e0ca09f8828a87d4f0003f36ea68f9cbcf3e229f9"
  }
}