⚡ ETH Sweeper Bot

A utility bot that sweeps ETH from a source wallet to a safe wallet, intelligently estimating gas, retrying failed transactions, and supporting both fast and normal sweep modes.

---

✨ Features

• ✅ Fast mode for rapid sweeping
• ✅ Intelligent gas estimation
• ✅ Works with HTTPS & WebSocket RPC URLs
• ✅ Automatic retries with delay
• ✅ Flexible config via .env or direct object

---

📦 Installation

npm i eth-sweeper-bot

---

🚀 Usage

You can configure the bot in two different ways:

---

🔹 Option A – Programmatic Configuration

// bot.js or index.js
const ethSweeperBot = require("eth-sweeper-bot");

ethSweeperBot.start({
  ethRpcUrl: "https://mainnet.infura.io/v3/YOUR_INFURA_KEY",
  targetWalletPrivateKey: "your_private_key",
  safeWalletAddress: "your_safe_address",
  isFastMode: true
});

---

🔹 Option B – .env File Configuration

1. Create a .env file in your project root:

ETHEREUM_RPC_URL=https://mainnet.infura.io/v3/YOUR_INFURA_KEY
TARGET_WALLET_PRIVATE_KEY=your_target_wallet_private_key
SAFE_WALLET_ADDRESS=your_safe_wallet_address
IS_FAST_MODE=true

2. Use the following code:

// bot.js or index.js
const ethSweeperBot = require("eth-sweeper-bot");

// Use default .env
ethSweeperBot.start();

// Or specify a custom path
// ethSweeperBot.start(".env");
// ethSweeperBot.start("config/myenv.env");

---

▶️ Running the Bot

node bot.js

---

📁 Example File Structure

project/
├── bot.js
├── .env
└── node_modules/

---

⚠️ Important Notes

• DO NOT share your .env file or private key.
• Use a cold wallet as the safe destination for best security.
• Supports both HTTP and WebSocket RPC endpoints.

---

Tip: Use PM2 or a similar process manager to keep the bot running in the background

📃 License

MIT License © 2025

---

Happy sweeping! 🚀