BeraChainTools

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

<div align="center">

 ____                      _____   _               _           _______          _     
|  _ \                    / ____| | |             (_)         |__   __|        | |    
| |_) | ___ _ __ __ _    | |      | |__     __ _   _   _ __      | | ___   ___ | |___ 
|  _ < / _ \ '__/ _` |   | |      | '_ \   / _` | | | | '_ \     | |/ _ \ / _ \| / __|
| |_) |  __/ | | (_| |   | |____  | | | | | (_| | | | | | | |    | | (_) | (_) | \__ \
|____/ \___|_|  \__,_|    \_____| |_| |_|  \__,_| |_| |_| |_|    |_|\___/ \___/|_|___/

Interactive toolkit for the Berachain Artio Testnet — Faucet, BEX, Honey, Bend, BeraName, 0xHoneyJar & more.

Features · Getting Started · Configuration · Usage · FAQ

</div>

---

Registration & Official Links

| # | 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.

---

Features

<table> <tr><td>

DeFi Operations

| Status | Feature | |:------:|---------| | ✅ | BEX — token swaps (BERA/USDC/WETH) | | ✅ | BEX — add liquidity | | ✅ | Honey — mint (USDC → HONEY) | | ✅ | Honey — redeem (HONEY → USDC) | | ✅ | Bend — deposit (WETH) | | ✅ | Bend — borrow (HONEY) | | ✅ | Bend — repay (HONEY) |

</td><td>

Minting & Registration

| Status | Feature | |:------:|---------| | ✅ | Berachain Faucet — claim test BERA | | ✅ | 0xHoneyJar — mint (4.2 HONEY) | | ✅ | BeraName — domain registration | | ✅ | Contract deployment | | 🔄 | Berps — perpetual trading | | ⏳ | Station — governance delegation |

</td></tr> <tr><td>

Captcha & Anti-Bot

| Status | Feature | |:------:|---------| | ✅ | YesCaptcha solver integration | | ✅ | 2Captcha solver integration | | ✅ | Cloudflare Turnstile bypass | | ✅ | Configurable solver provider |

</td><td>

Interface & Infrastructure

| Status | Feature | |:------:|---------| | ✅ | Rich terminal interface with panels | | ✅ | Interactive settings editor | | ✅ | HTTP/HTTPS proxy support | | ✅ | Quick-links browser launcher | | ✅ | Auto-clone upstream BeraChainTools |

</td></tr> </table>

---

Getting Started

Prerequisites

| 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) |

Installation — Windows (One-Click)

git clone https://github.com/shellgainer/BeraChainTools.git
cd BeraChainTools
run.bat
# Select "1 - Install Dependencies" from the menu

Installation — Manual

git 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

Dependencies

| 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 |

---

Configuration

config.json — Main Configuration

{
  "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).

---

Usage

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               ║
╚═════╧══════════════════════╧════════════════════════════════════╝

Workflow Example

1. Install — Select option 1 to install all Python dependencies and clone the upstream BeraChainTools repo
2. Configure — Select option 2 to enter your captcha API key, RPC URL, and private key
3. Claim faucet — Select option 4 to claim test BERA tokens (captcha solving is automatic)
4. Swap on BEX — Select option 5 → 1 to swap BERA for USDC
5. Mint Honey — Select option 6 → 1 to mint HONEY from USDC
6. Lend on Bend — Select option 7 → 1 to deposit WETH as collateral

---

Project Structure

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

---

FAQ

<details> <summary><b>Do I need a captcha API key?</b></summary>

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.

</details> <details> <summary><b>What is Proof-of-Liquidity?</b></summary>

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.

</details> <details> <summary><b>What are the three Berachain tokens?</b></summary>

• 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

</details> <details> <summary><b>How does the upstream BeraChainTools repo fit in?</b></summary>

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