https://github.com/dante4rt/evm-auto-transfer
Automate EVM transactions on testnets and mainnets with ease. Configure your network and handle multiple transfers effortlessly using this bot.
https://github.com/dante4rt/evm-auto-transfer
automation bot evm mainnet testnet transactions transfer
Last synced: 4 months ago
JSON representation
Automate EVM transactions on testnets and mainnets with ease. Configure your network and handle multiple transfers effortlessly using this bot.
- Host: GitHub
- URL: https://github.com/dante4rt/evm-auto-transfer
- Owner: dante4rt
- License: mit
- Created: 2024-08-30T07:37:30.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-17T05:36:13.000Z (5 months ago)
- Last Synced: 2025-05-17T06:27:05.706Z (5 months ago)
- Topics: automation, bot, evm, mainnet, testnet, transactions, transfer
- Language: JavaScript
- Homepage: https://t.me/HappyCuanAirdrop
- Size: 36.1 KB
- Stars: 138
- Watchers: 1
- Forks: 92
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://nodejs.org/) (v14 or higher)
- npm (Node Package Manager)
### Installation
1. Clone the repository:
```bash
git clone https://github.com/dante4rt/evm-auto-transfer.git
cd evm-auto-transfer
```
2. Install the necessary packages:
```bash
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:
```json
[
{
"name": "Network Name",
"rpcUrl": "https://rpc-url",
"chainId": "1234",
"symbol": "TOKEN",
"explorer": "https://explorer-url"
}
]
```
- Example for `testnet.json`:
```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:
```json
[
"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:
```json
[
"0xTARGET_ADDRESS_1",
"0xTARGET_ADDRESS_2"
]
```
### Usage
1. Run the script for random address generation and transactions:
```bash
npm start
```
2. To use the targeted address feature, run:
```bash
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.