Sending Bulk Transactions - peaq

Send many transactions from a single script with ethers.js. The examples target the peaq EVM and work on any EVM chain.

Prerequisites

A Node.js environment.
A private key for the sending wallet.
Access to a peaq RPC endpoint.
Basic familiarity with blockchain SDKs (e.g., ethers.js or web3.js).

Instructions

1. Install Required Dependencies

Install ethers.js to handle blockchain interactions programmatically, and dotenv to read your keys from a .env file.

npm install ethers dotenv

Create a .env file:

PEAQ_RPC_URL=https://quicknode1.peaq.xyz
ETH_PRIVATE=0xYOUR_PRIVATE_KEY

2. Define Bulk Transactions

Structure your transactions as an array of recipient addresses and amounts.

const { ethers } = require("ethers");

const createTransactions = () => [
    { to: "0xRecipientAddress1", value: ethers.parseEther("0.1") },
    { to: "0xRecipientAddress2", value: ethers.parseEther("0.2") },
    { to: "0xRecipientAddress3", value: ethers.parseEther("0.3") },
];

3. Putting it all together

Use the following script to send the batch.

const { ethers } = require("ethers");

require("dotenv").config(); // For environment variables

const RPC_URL = process.env.PEAQ_RPC_URL; // Replace with your preferred peaq RPC URL
const ETH_PRIVATE = process.env.ETH_PRIVATE;

const createTransactions = () => [
    { to: "0xRecipientAddress1", value: ethers.parseEther("0.1") },
    { to: "0xRecipientAddress2", value: ethers.parseEther("0.2") },
    { to: "0xRecipientAddress3", value: ethers.parseEther("0.3") },
];

const sendBulkTransactions = async (txs) => {
  // connect to provider
  const provider = new ethers.JsonRpcProvider(RPC_URL);
  const wallet = new ethers.Wallet(ETH_PRIVATE, provider);

  // send transactions
  for (const tx of txs) {
    try {
      const transaction = await wallet.sendTransaction(tx);
      console.log(`Transaction sent: ${transaction.hash}`);
      await transaction.wait(); // Wait for confirmation
      console.log(`Transaction confirmed: ${transaction.hash}`);
    } catch (error) {
      console.error(`Failed to send transaction: ${error.message}`);
    }
  }
};

const main = async () => {
  try {
    await sendBulkTransactions(createTransactions());
  } catch (error) {
    console.error("Error sending transactions:", error);
    process.exit(1);
  }
};

main();

Tips

Test with a small batch before sending large-scale transactions.
Monitor gas prices and set appropriate limits to avoid failed transactions.
Secure your private keys. Never expose them in code or logs.
Implement error handling to retry failed transactions where applicable.

⌘I