Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jon-becker/heimdall

Powerful Ethereum Smart-Contract Toolkit
https://github.com/jon-becker/heimdall

decompiler eth ethereum smart-contract smart-contracts toolkit

Last synced: 18 days ago
JSON representation

Powerful Ethereum Smart-Contract Toolkit

Awesome Lists containing this project

README 

        

# Heimdall [DEPRECATED]



![preview](https://github.com/Jon-Becker/heimdall/blob/main/preview.png?raw=true)



Heimdall is an advanced and modular smart-contract toolkit which aims to make dealing with smart contracts on EVM based chains easier.



## THIS REPOSITORY IS DEPRECATED AND WILL NOT BE UPDATED OR SUPPORTED AS OF JUN 24, 2022.

## YOU CAN FIND THE NEW VERSION HERE https://github.com/Jon-Becker/heimdall-rs/



## Installation & Usage

![version badge](https://badge.fury.io/py/eth-heimdall.svg) ![download badge](https://static.pepy.tech/personalized-badge/eth-heimdall?period=total&units=international_system&left_color=grey&right_color=brightgreen&left_text=Downloads) ![build badge](https://img.shields.io/badge/License-MIT-g.svg) [![Build](https://github.com/Jon-Becker/heimdall/actions/workflows/unit-tests.yml/badge.svg)](https://github.com/Jon-Becker/heimdall/actions/workflows/unit-tests.yml)

```

pip install eth-heimdall

```



Heimdall operates off the ``argparse`` library, with modules specifying which operation you with to perform.



```

heimdall MODULE [-v] [--default] [-arguments]

```



## Modules & Help



You may find the various modules supported by Heimdall by using the -h option, which opens the help menu by default.



```

Options:

  -h, --help                          Show the help message and exit

  -hh                                 Show advanced help message and exit

  --version                           Display version information and exit

  --update                            Updates heimdall to the latest release

  -v, --verbose                       Toggle verbose output



  Modules:

    Below is a list of modules currently supported on Heimdall



        #  |       Name  |                                           Description    

           |             |                                                      

        0  |     Config  |           Easily modify the configuration on Heimdall

        1  |      Debug  |              Easily access Heimdall debug information

        2  |  Decompile  |      Decompile and download the target smart contract



  Parameters:

    -m MODULE, --module MODULE        Operation module, either name or number from list

    -t TARGET, --target TARGET        Target of operation (file, transaction id,

                                        or address)

    -o PATH, --output PATH            Path to write output to

    -c ID, --chain ID                 Chain ID of target

    -p URL, --provider URL            URL of custom Ethereum provider



  Additional:

    --open, --edit                    Attempts to open nano / edit on the operation

    --redeploy ID                     Redeploys the contract from -n onto ID

    --beautify                        Attempts to beautify the downloaded contract using

                                        statistical renaming and spacing

    --default                         Always use defaults when prompted for input

    --flush, --ignore-cache           Flushes the cache and rewrites it

```



Please keep in mind as more modules are released, module numbers may change. It's recommended to use the module name instead.



### Module Documentation



Specific module documentation can be found in the ``/docs`` folder, or quickly navigate using the links beow.



| Module Name | Description                        | Documentation URL                                                                   |

| ----------- | ---------------------------------- | ----------------------------------------------------------------------------------- |

| Config      | Heimdall Configuration Module      | [Documentation](https://github.com/Jon-Becker/heimdall/blob/main/docs/config.md)    |

| Debug       | Heimdall Debug Module              | [Documentation](https://github.com/Jon-Becker/heimdall/blob/main/docs/debug.md)     |

| Decompile   | Decompiles EVM bytecode > Solidity | [Documentation](https://github.com/Jon-Becker/heimdall/blob/main/docs/decompile.md) |



## Configuration



You may save environment information, such as remote and local providers, to the configuration folder in ``env/conf.json``.



## Contributing



If you'd like to contribute to Heimdall or add a module, please open a pull-request with your changes, as well as detailed information on what is changed, added, or improved.



### Modules



To add a module, you must add a ``.py`` file within the ``/lib/modules`` folder. In order for your pull-request to be accepted, your module must begin with a ``meta`` object, which is used when displaying what it does to end-users.



Example meta object:

```

meta = {

  "title": "Decompile",

  "description": "Decompile and download the target smart contract",

  "author": "Jonathan Becker ",

  "version": "v1.0.0",

}

```



You will also need to add detailed documentation to this readme file in the ``Module Documentation`` section.



#### Troubleshooting



If you encounter an issue, please create one using the link below. You MUST follow the issue format, or it will be marked as invalid.



Issues that remain inactive for 72 hours will be marked inactive and closed. If your issue is accepted by a contributor, they will assign themselves to it and add corresponding tags.



## Credits

This project is coded in its entirety by [Jonathan Becker](https://jbecker.dev). Various contributors can be found in the sidebar.