Practical overview
When it fits
Use it when building or adapting Python scripts for Berachain interactions and you can configure an RPC endpoint, account credentials and any required provider keys.
Who it is for
- Developers writing Python scripts for Berachain test-network interactions.
- Users who need code examples for token claims, swaps, liquidity operations, lending or contract deployment.
Documented uses
- Prepare a Python script to request Berachain test tokens with a CAPTCHA-solving provider.
- Script Bex swaps and liquidity additions, Honey minting and redemption, or Bend deposit, borrowing and repayment calls.
- Adapt an example for deploying a contract through the toolset.
Requirements & limits
The repository is public and lists GPL-3.0 as its license.
- The README documents both basic token claims and more involved contract workflows, including Bex, Honey, Bend and deployment examples.
- The claim example depends on a client key from a CAPTCHA-solving provider; the README names YesCaptcha and 2captcha and also demonstrates ez-captcha.
- The examples expose account private keys and specify RPC URLs, token addresses and contract operations, so users need to understand and review the configuration before running adapted code.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Prepare the Python dependencies
Install the repository's listed Python dependencies before adapting its examples.
Before you start
- A local Python environment
- The BeraChainTools repository
Steps
Obtain the repository.
Run the command below from the project directory.
pip install -r requirements.txt
Expected outcome
The dependencies listed in requirements.txt are requested for installation.
Configure the documented test-token claim example
Set up the README's Python example for requesting Berachain test tokens.
Before you start
- Installed project dependencies
- A private key for the account used by the script
- A client key from a CAPTCHA-solving provider shown in the README
- A Berachain RPC URL
Steps
Create or load an account with
eth_accountand initializeBeraChainToolswith its private key, the client key, a solver provider and an RPC URL.Call
bera.claim_bera(); the example also shows an optional proxy argument.Read the returned response text.
Expected outcome
The script is configured to make the documented test-token claim request and display its response.
Guide limitations
- The README example uses a testnet RPC endpoint and a placeholder client key.
- The guide describes the documented code path, not a confirmed successful claim.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 15 October 2026
- Original website title
- ymmmmmmmm/BeraChainTools · Official homepage title · retained in its source language

