Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/palkeo/panoramix
Ethereum decompiler
https://github.com/palkeo/panoramix
Last synced: 3 months ago
JSON representation
Ethereum decompiler
- Host: GitHub
- URL: https://github.com/palkeo/panoramix
- Owner: palkeo
- License: mit
- Fork: true (eveem-org/panoramix)
- Created: 2020-02-17T04:39:29.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-08-04T02:46:29.000Z (6 months ago)
- Last Synced: 2024-11-07T09:27:42.706Z (3 months ago)
- Language: Python
- Homepage:
- Size: 66 MB
- Stars: 812
- Watchers: 38
- Forks: 217
- Open Issues: 25
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-web3-security - Panoramix - This is an EVM decompiler. (<a name="tools"></a> Tools / <a name="forensics"> Forensics)
- awesome-web3-security - Panoramix - This is an EVM decompiler. (<a name="tools"></a> Tools / <a name="forensics"> Forensics)
README
Panoramix
=========
This is an EVM decompiler.
It's is a fork of the Panoramix original repo that's not maintained actively by its author anymore: https://github.com/eveem-org/panoramix.git
The goal of this fork is to maintain Panoramix in a decent shape, fix some crashes, implement missing opcodes...
I also got rid of the "tilde" syntax that was using a custom python encoding and use vanilla Python instead. And I made it a proper python package that can be imported.
There is also a better support of timeouts, as instead of stopping entirely we will fallback and print whatever we decompiled even if it's not complete.
The code quality is still not great and the software is complex, it's mostly reserved for advanced users.
## Installation
```console
$ pip install panoramix-decompiler
```
## Running
You can specify a web3 provider using the environment variable `WEB3_PROVIDER_URI`. In this case a local provider was set.
```console
$ WEB3_PROVIDER_URI=http://localhost:7545 panoramix 0x0d94D81FD712126E7f320b5B10537D01d6a01563
```
You can also provide the bytecode for decompilation.
```console
$ panoramix 6004600d60003960046000f30011223344
```
## Examples
I have decompiled all of mainnet, and make sure to decompile again on the latest Panoramix version from time to time.
You can access decompilations using Oko: https://oko.palkeo.com/
Here is an example for cryptokitties: https://oko.palkeo.com/0x06012c8cf97BEaD5deAe237070F9587f8E7A266d/code/
## Caveats
Windows is not supported currently.
## Changelog
### 0.5.0
* Added support for the BASEFEE opcode.
* Updated bytecode database / ABI definitions.
* Ability to decompile the Solidity-generated Panic reverts.
* Lots of simplification / code cleanup.
* Moved to Poetry as the dependency management tool.