Awmdan1/evm-auto-transfer

Automate EVM transactions on testnets and mainnets with ease. Configure your network and handle multiple transfers effortlessly using this bot.

EVM Auto Transfer

Welcome to the evm-auto-transfer repository! This script allows you to automate transactions across multiple EVM-compatible networks. Whether you're interacting with testnets or mainnets, this tool simplifies the process, especially for tasks requiring multiple transfers.

Features

• 📡 Dynamic RPC URL, chain ID, and explorer integration from JSON files.
• 🔄 Automated transaction processing for multiple addresses.
• 🎯 Targeted transfers to specified addresses from addresses.json.
• 🚀 Easily configurable for various networks (testnets and mainnets).
• 🔒 Secure handling of private keys.

Getting Started

Prerequisites

Ensure you have the following installed:

• Node.js (v14 or higher)
• npm (Node Package Manager)

Installation

1. Clone the repository:

   git clone https://github.com/Awmdan1/evm-auto-transfer.git
   cd evm-auto-transfer

2. Install the necessary packages:

   npm install

Configuration

1. Define the Chains:

   • You'll need to specify the network details in JSON files located in the /chains directory. Create two JSON files: testnet.json and mainnet.json.

   • Each file should contain an array of objects with the following structure:

     [
         {
             "name": "Network Name",
             "rpcUrl": "https://rpc-url",
             "chainId": "1234",
             "symbol": "TOKEN",
             "explorer": "https://explorer-url"
         }
     ]

   • Example for testnet.json:

     [
         {
             "name": "Plume Testnet",
             "rpcUrl": "https://plume-testnet-rpc.example.com",
             "chainId": "8888",
             "symbol": "PLUME",
             "explorer": "https://plume-testnet-explorer.example.com"
         }
     ]

2. Define Private Keys:

   • Store your private keys securely inside a privateKeys.json file in the root directory. This file should contain an array of private keys as strings:

     [
         "0xYOUR_PRIVATE_KEY_1",
         "0xYOUR_PRIVATE_KEY_2"
     ]

     ⚠️ Important: Keep this file secure and avoid exposing your private keys!

3. Create Target Addresses File:

   • Create an addresses.json file in the root directory. This file should contain an array of target addresses you want to transfer funds to:

     [
         "0xTARGET_ADDRESS_1",
         "0xTARGET_ADDRESS_2"
     ]

Usage

1. Run the script for random address generation and transactions:

   npm start

2. To use the targeted address feature, run:

   npm run target

   • You will be prompted to select your network environment (Testnet/Mainnet) and choose the chain from the provided list using the arrow keys.
   • Define the number of transactions you want to process and let the script handle the rest!

Contribution

Contributions are welcome! Please fork the repository and submit a pull request with your improvements.

Donations

If you would like to support the development of this project, you can make a donation using the following addresses:

• Solana: GLQMG8j23ookY8Af1uLUg4CQzuQYhXcx56rkpZkyiJvP
• EVM: 0x960EDa0D16f4D70df60629117ad6e5F1E13B8F44
• BTC: bc1p9za9ctgwwvc7amdng8gvrjpwhnhnwaxzj3nfv07szqwrsrudfh6qvvxrj8

License

This project is licensed under the MIT License. See the LICENSE file for details.