Skip to content
View ethpwn's full-sized avatar
Block or Report

Block or report ethpwn

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Please don't include any personal information such as legal names or email addresses. Maximum 100 characters, markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
ethpwn/README.md

ethpwn

PyPI License Docs

ethpwn is a project inspired by the widely popular CTF exploitation framework pwntools, and the amazing enhanced GDB utility GEF. In other words, ethpwn is all you ever wanted for debugging and interacting with smart contracts on EVM-based blockchains.

More practically, this package includes a kick-ass command line debugger for simulating and re-playing Ethereum transactions (ethdbg), and a set of convenient wrappers for many web3 functionalities that are useful for interacting with smart contracts.

⚡️ Quick Setup

Release Installation

pip install ethpwn

Developer Installation

Make sure your pip version is >= 23.1.2, then:

git clone git@github.com:ethpwn/ethpwn.git && cd ./ethpwn && pip install -e .
❗️ Note
To start out, if you haven't created your global config before, you should run ethpwn config create to generate your initial configuration file. This command will interactively prompt you for the most important settings, including the Ethereum node URL to use and wallets you want to use.

⚡️ Jump Start for ethdbg

ethdbg --txid 0x82a11757c3f34c2882e209c6e5ae96aff3e4db7f7984d54f92b02e1fed87e834 --node-url https://mainnet.infura.io/v3/38eb4be006004da4a89315232040e222

📖 Documentation

Docs

⚙️ Currently Supported EVM-based Chains

Chain Name Chain Id Supported
mainnet 1
sepolia (testnet) 11155111

Pinned

  1. ethpwn ethpwn Public

    ethpwn - the Swiss Army Knife for Smart Contract Hacking

    Python 40 3