Skip to main content

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 ✅

Metadata

Release files for ethpwn 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ethpwn 1.0.0
File Size Uploaded Provenance Actions
ethpwn-1.0.0.tar.gz 27.6 MB Without provenance Details for ethpwn-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ethpwn 1.0.0
File Interpreter ABI Platform Actions
ethpwn-1.0.0-py3-none-any.whl Python 3 none any Details for ethpwn-1.0.0-py3-none-any.whl

Total release size: 27.7 MB

Release files / ethpwn-1.0.0.tar.gz

Download URL ethpwn-1.0.0.tar.gz
Size 27.6 MB
Tags Source
SHA-256 checksum
How to use checksums
295209b70bbef480418d1a2800d0e82e8c03bd3aea402670b71b679cf0df4dc5
BLAKE2b-256 checksum
How to use checksums
98c35105143b73360f6e77561a4aa6a1635481fa06a787ebec615c68d55a26d5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/4.0.2 CPython/3.11.7

Release files / ethpwn-1.0.0-py3-none-any.whl

Download URL ethpwn-1.0.0-py3-none-any.whl
Size 113.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8a95c60e211e11ece6da2190f253a2f34ece9f91e608041ca0b6321536fea185
BLAKE2b-256 checksum
How to use checksums
cf359f366b109a9be9d3553cb88beabcf0e8febbe0e60e331bb18898cf4ac4e0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/4.0.2 CPython/3.11.7

Security for ethpwn 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page