https://github.com/mesamirh/arbitrumethdistributionbot
This project is a Telegram bot that facilitates the distribution of Arbitrum Ethereum to users. Users can provide their Ethereum addresses to the bot, and they will automatically receive a small amount of ArbETH from the bot owner's wallet.
https://github.com/mesamirh/arbitrumethdistributionbot
crypto-bot telegram-bot
Last synced: about 2 months ago
JSON representation
This project is a Telegram bot that facilitates the distribution of Arbitrum Ethereum to users. Users can provide their Ethereum addresses to the bot, and they will automatically receive a small amount of ArbETH from the bot owner's wallet.
- Host: GitHub
- URL: https://github.com/mesamirh/arbitrumethdistributionbot
- Owner: mesamirh
- License: mit
- Created: 2024-06-06T09:59:48.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2024-07-30T06:38:01.000Z (10 months ago)
- Last Synced: 2025-02-09T02:19:05.790Z (4 months ago)
- Topics: crypto-bot, telegram-bot
- Language: JavaScript
- Homepage:
- Size: 54.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Arbitrum-eth-distribution-bot
## Features
- Distributes 0.000001 Arbitrum ETH to a user's Ethereum address.
- Ensures each address can only receive ETH once.
- Hash.
## Prerequisites
- Node.js (v16 or higher)
- npm (Node Package Manager)
- A Telegram bot token
- An Ethereum wallet private key with sufficient ETH for distribution
## Setup Instructions
### 1. Clone the Repository
```
git clone https://github.com/mesamirh/arbitrum-eth-distribution-bot.git
cd ArbitrumEthDistributionBot
```
### 2. Install Dependencies
```
npm install
```
### 3. Create `config.env` File
Create a file named `config.env` in the root directory of the project and add your environment variables:
```
BOT_TOKEN=your-telegram-bot-token
PRIVATE_KEY=your-ethereum-wallet-private-key
ARB_URL=rpc-here // like https://arb1.arbitrum.io/rpc
```
### 4. Run the Bot
```
node bot.js
```
### Files and Structure
- `bot.js`: The main script for the Telegram bot.
- `config.env`: Environment variables for bot token and private key.
- `addresses.json & received_addresses.json`: JSON file to keep track of addresses that have already received ETH.
- `package.json`: Project configuration and dependencies.
### Usage
1. Run the bot script using Node.js:
```
node bot.js
```
2. Interact with the Bot:
- Open Telegram and start a chat with your bot.
- Send your Ethereum address to the bot.
- The bot will check if the address has already received ETH. If not, it will send 0.000001 ETH to the address and log the transaction in `addresses.json`.
### Troubleshooting
- Error: `Cannot find module 'telegraf'`:
Ensure all dependencies are installed correctly by running `npm install`.
- Error: `404: Not Found`:
Verify your bot token in the `.env` file is correct.
- Transaction Errors:
Ensure your wallet has sufficient ETH for transactions and the gas limit is set appropriately.
### License
This project is licensed under the MIT License.
### Contributing
Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.