0G Faucet Automation

An automated script designed to simplify claiming tokens from the 0G Faucet, solving hCaptcha using 2Captcha integration, and supporting proxies with authentication.

Features

• Automated hCaptcha solving via 2Captcha
• Proxy support including authenticated proxies (ip:port:user:pass)
• Automatic logging of successful claims with transaction URLs
• Flexible wallet address configuration (supports both .txt and .json wallet files)

Installation

Clone Repository

git clone https://github.com/Aero25x/0g-faucet.git
cd 0g-faucet

Install Dependencies

pip install requests colorama

Configuration

Before running, configure the following:

1. wallet.txt

Add wallet addresses, one per line:

0xYourWalletAddress1
0xYourWalletAddress2

2. proxy.txt

Proxies must be in the following formats:

• IP without authentication:

192.168.1.100:8080

• IP with authentication:

185.171.25.72:6125:username:password

3. Wallet JSON (Optional) - Exported from Kozel Software

To load wallets from a JSON file, create wallets.json:

[
    {"address": "0xYourWalletAddress3"},
    {"address": "0xYourWalletAddress4"}
]

Wallet addresses from wallets.json will be added to those from wallet.txt.

4. Update CAPTCHA_API_KEY and HCAPTCHA_SITE_KEY in main.py

Replace placeholders with your actual keys:

CAPTCHA_API_KEY = 'Your_2Captcha_API_Key'
HCAPTCHA_SITE_KEY = 'Target_Site_hCaptcha_Sitekey'

Running the Script

Execute:

python main.py

Example Run:

Processing wallet [1/2]: 0xYourWalletAddress1 | Proxy: 185.171.25.72:****:****:**** | Attempt: 1
Requesting captcha solution from 2Captcha...
Captcha ID obtained: 1234567890
Captcha solved successfully.
Submitting faucet claim for wallet 0xYourWalletAddress1...
Successfully claimed faucet! Transaction link: https://chainscan-newton.0g.ai/tx/transaction_hash_here

Logs

Successful claims are logged in log.txt:

0xYourWalletAddress1,185.171.25.72:****:****:****,transaction_hash_here,https://chainscan-newton.0g.ai/tx/transaction_hash_here

Contribution

Feel free to contribute by opening issues or pull requests.

Disclaimer

Use responsibly. The developer is not responsible for any misuse of this script.

0g Faucet Here