Need help with panoramix?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

280 Stars 139 Forks MIT License 45 Commits 23 Opened issues


Decompiler at the heart of

Services available


Need anything else?

Contributors list


Palkeo is maintaining a more up to date for of Panoramix. Be sure to check it out:


git clone
pip3 install -r requirements.txt


You need python3.8 to run Panoramix. Yes, there was no way around it.

python3.8 address [func_name] [--verbose|--silent|--explain]


python3.8 0x06012c8cf97bead5deae237070f9587f8e7a266d


python3.8 kitties

Output goes to two places: -

directory - .pan, .json, .asm files

If you want to see how Panoramix works under the hood, try the

python3.8 kitties paused --explain
python3.8 kitties pause --explain
python3.8 kitties tokenMetadata --explain

Optional parameters:

func_name -- name of the function to decompile (note: storage names won't be discovered in this mode) --verbose -- prints out the assembly and stack as well as regular functions, a good way to try it out is by running 'python kitties pause --verbose' - it's a simple function

There are more parameters as well. You can find what they do in

Address shortcuts

Some contract addresses, which are good for testing, have shortcuts, e.g. you can run 'python kitties' instead of 'python3 0x06012c8cf97bead5deae237070f9587f8e7a266d'.

See for the list of shortcuts, feel free to add your own.

Directories & Files


  • core - modules for doing abstract/symbolic operations
  • pano - the proper decompiler
  • utils - various helper modules
  • tilde - the library for handling pattern matching in python3.8


  • cache_code - cached bytecodes
  • cache_pan - cached decompilation outputs
  • cache_pabi - cached auto-generated p-abi files
  • supplement.db - sqlite3 database of function definitions
  • supp2.db - a lightweight variant o the above

Cache directories are split into subdirectories, so the filesystem doesn't break down with large amounts of cached contracts (important when running bulk_decompile on all 2.2M contracts on the chain)

All of the above generated after the first run.

Utilities - batch-decompiles contracts, with multi-processing support - decompiles a set of test contracts, fetches the current decompiled from Eveem, and prepares two files, so you can diff them and see what changes were made

Why python3.8 and Tilde

Panoramix uses a ton of pattern matching operations, and python doesn't support those as a language.

There are some pattern-matching libraries for older python versions, but none of them seemed good enough. Because of that, I built Tilde, which is a language extension adding a new operator.

Tilde replaces '~' pattern matching operator with a series of ':=' operators underneath. Because of that, python3.8 is a must.

Believe me, I spent a lot of time looking for some other way to make pattern matching readable. Nothing was close to this good.

But if you manage to figure out a way to do it without Tilde (and maintain readability), I'll gladly accept a PR :)

How Panoramix works

See the source code comments, starting with Also, those slides[tbd].

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.