BeraChainTools — Interactive toolkit for Berachain Artio Testnet featuring BEX DEX swaps, Honey stablecoin mint/redeem, Bend lending, BeraName domain registration, faucet claims with YesCaptcha/2Captcha Cloudflare Turnstile bypass, and Proof-of-Liquidity interaction
____ _____ _ _ _______ _
| _ \ / ____| | | (_) |__ __| | |
| |_) | ___ _ __ __ _ | | | |__ __ _ _ _ __ | | ___ ___ | |___
| _ < / _ \ '__/ _` | | | | '_ \ / _` | | | | '_ \ | |/ _ \ / _ \| / __|
| |_) | __/ | | (_| | | |____ | | | | | (_| | | | | | | | | | (_) | (_) | \__ \
|____/ \___|_| \__,_| \_____| |_| |_| \__,_| |_| |_| |_| |_|\___/ \___/|_|___/
Interactive toolkit for the Berachain Artio Testnet — Faucet, BEX, Honey, Bend, BeraName, 0xHoneyJar & more.
Features · Getting Started · Configuration · Usage · FAQ
| # | Resource | URL |
|---|---|---|
| 1 | Berachain Official | https://www.berachain.com/ |
| 2 | Berachain Documentation | https://docs.berachain.com/ |
| 3 | Artio Testnet Faucet | https://artio.faucet.berachain.com/ |
| 4 | BEX (DEX) | https://artio.bex.berachain.com/swap |
| 5 | Honey (Stablecoin) | https://artio.honey.berachain.com |
| 6 | Bend (Lending) | https://artio.bend.berachain.com/ |
| 7 | BeraNames (Domains) | https://www.beranames.com |
| 8 | Berps (Perpetuals) | https://artio.berps.berachain.com/ |
| 9 | Station (Governance) | https://artio.station.berachain.com/ |
| 10 | YesCaptcha (Solver) | https://yescaptcha.com/i/0vVEgw |
| 11 | 2Captcha (Solver) | https://cn.2captcha.com/?from=9389597 |
| 12 | BeraChainTools (upstream) | https://github.com/ymmmmmmmm/BeraChainTools |
Berachain is a DeFi-centric EVM-compatible Layer 1 built on Cosmos, using a novel Proof-of-Liquidity (PoL) consensus mechanism. It features three native tokens: BERA (gas), BGT (governance/rewards), and HONEY (stablecoin). The Artio testnet provides full access to BEX (DEX), Honey mint/redeem, Bend (lending), Berps (perpetuals), and domain registration.
|
| ||||||||||||||||||||||||||||||
|
|
| Requirement | Version | Notes |
|---|---|---|
| Python | 3.9+ | CPython recommended |
| pip | latest | Ships with Python |
| Git | any | Required for cloning upstream BeraChainTools |
| Captcha API | — | YesCaptcha or 2Captcha account (for faucet claims) |
git clone https://github.com/shellgainer/BeraChainTools.git
cd BeraChainTools
run.bat
# Select "1 - Install Dependencies" from the menugit clone https://github.com/shellgainer/BeraChainTools.git
cd BeraChainTools
pip install -r requirements.txt
python main.py
# Select "1 - Install Dependencies" to also clone upstream repo| Package | Version | Purpose |
|---|---|---|
| rich | ≥13.0.0 | Terminal UI (panels, tables, menus) |
| loguru | ≥0.7.0 | Structured logging |
| requests | ≥2.31.0 | HTTP requests |
| Faker | ≥18.13.0 | User-agent generation for anti-detect |
| web3 | ≥6.5.0 | Blockchain RPC interaction |
| aiofiles | ≥23.2.1 | Async file I/O |
| aiohttp | ≥3.8.4 | Async HTTP client |
| py-solc-x | ≥2.0.2 | Solidity compiler (contract deployment) |
| eth-account | ≥0.10.0 | Wallet management & signing |
{
"rpc_url": "https://rpc.ankr.com/berachain_testnet",
"client_key": "YOUR_YESCAPTCHA_OR_2CAPTCHA_API_KEY",
"solver_provider": "yescaptcha",
"private_key": "0xa1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
"use_proxy": true,
"proxy_http": "http://user:pass@192.168.1.100:3128",
"proxy_https": "http://user:pass@192.168.1.100:3128"
}| Field | Description |
|---|---|
rpc_url |
Berachain Artio RPC endpoint |
client_key |
API key for YesCaptcha or 2Captcha |
solver_provider |
yescaptcha or 2captcha |
private_key |
Wallet private key (0x-prefixed hex) |
use_proxy |
Enable HTTP/HTTPS proxy |
proxy_http |
HTTP proxy URL |
proxy_https |
HTTPS proxy URL |
All settings can be edited interactively via the Settings menu option (option 2).
python main.py╔═════╤══════════════════════╤════════════════════════════════════╗
║ │ Main Menu │ ║
╠═════╪══════════════════════╪════════════════════════════════════╣
║ Key │ Action │ Description ║
╠═════╪══════════════════════╪════════════════════════════════════╣
║ 1 │ Install Dependencies │ Install Python packages + clone ║
║ 2 │ Settings │ Configure RPC, API keys, wallet ║
║ 3 │ About │ About BeraChainTools and links ║
║ 4 │ BeraChain Faucet │ Claim test BERA (captcha required) ║
║ 5 │ BEX │ DEX swaps and add liquidity ║
║ 6 │ Honey │ Mint and redeem HONEY stablecoin ║
║ 7 │ Bend │ Deposit, borrow, repay ║
║ 8 │ 0xHoneyJar │ Mint (costs 4.2 HONEY) ║
║ 9 │ BeraName │ Register .bera domain ║
║ L │ Links │ Open Berachain services in browser ║
║ 0 │ Exit │ Quit the application ║
╚═════╧══════════════════════╧════════════════════════════════════╝
- Install — Select option
1to install all Python dependencies and clone the upstream BeraChainTools repo - Configure — Select option
2to enter your captcha API key, RPC URL, and private key - Claim faucet — Select option
4to claim test BERA tokens (captcha solving is automatic) - Swap on BEX — Select option
5→1to swap BERA for USDC - Mint Honey — Select option
6→1to mint HONEY from USDC - Lend on Bend — Select option
7→1to deposit WETH as collateral
BeraChainTools/
├── main.py # Rich terminal interface — main entry point
├── config.json # Configuration (RPC, keys, captcha, proxy)
├── requirements.txt # Python dependencies
├── run.bat # Windows one-click launcher
├── tools/
│ ├── bera_utils.py # Shared utilities & Web3 helpers
│ ├── faucet.py # Faucet claim (Cloudflare Turnstile solver)
│ ├── bex_tools.py # BEX DEX — swap & liquidity
│ ├── honey_tools.py # Honey — mint & redeem
│ ├── bend_tools.py # Bend — deposit, borrow, repay
│ ├── honey_jar.py # 0xHoneyJar — mint NFT
│ └── bera_name.py # BeraName — domain registration
└── about/
└── hashtags.txt # Project hashtags
Do I need a captcha API key?
Yes, for faucet claims. The Berachain faucet is protected by Cloudflare Turnstile. You need an API key from either YesCaptcha or 2Captcha. Other operations (BEX, Honey, Bend) do not require captcha solving.
What is Proof-of-Liquidity?
Proof-of-Liquidity (PoL) is Berachain's novel consensus mechanism where validators stake BERA for security and direct BGT emissions to protocols. Liquidity providers earn BGT by supplying assets to whitelisted Reward Vaults, creating a flywheel between users, validators, and dApps.
What are the three Berachain tokens?
- BERA — Gas token used for transaction fees and validator staking
- BGT (Bera Governance Token) — Non-transferable governance and rewards token earned via PoL
- HONEY — Native stablecoin, mintable by depositing USDC
How does the upstream BeraChainTools repo fit in?
This project wraps ymmmmmmmm/BeraChainTools with a Rich terminal interface. The "Install Dependencies" step clones the upstream repo into bera_tools_repo/ and installs its requirements. The tools modules import from this upstream library.
Can I use a free RPC endpoint?
Yes. The default https://rpc.ankr.com/berachain_testnet is free. You can also use the official https://artio.rpc.berachain.com (chain ID: 80085). For high-volume operations, a private RPC node is recommended.
Is this safe for mainnet?
No. This toolkit is designed exclusively for the Berachain Artio Testnet. Never use mainnet wallets or real funds. Always use burner wallets with no real assets.
This software is provided for educational and testnet purposes only. It is designed to interact with the Berachain Artio Testnet and should never be used with mainnet wallets containing real assets. Use burner wallets exclusively. Never share your private keys or captcha API keys. The developers assume no liability for any loss or damage resulting from the use of this tool. Based on ymmmmmmmm/BeraChainTools. Always review the source code before running. By using this software you accept full responsibility for your actions.
If this project helped you, consider giving it a star!
MIT License