{"id":13673024,"url":"https://github.com/crytic/evm_cfg_builder","last_synced_at":"2025-04-28T08:33:45.998Z","repository":{"id":45165415,"uuid":"149234772","full_name":"crytic/evm_cfg_builder","owner":"crytic","description":"EVM CFG recovery","archived":false,"fork":false,"pushed_at":"2023-06-29T20:08:36.000Z","size":14436,"stargazers_count":118,"open_issues_count":14,"forks_count":29,"subscribers_count":14,"default_branch":"master","last_synced_at":"2024-10-14T11:14:31.717Z","etag":null,"topics":["cfg","ethereum","evm","reversing"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/crytic.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2018-09-18T05:42:10.000Z","updated_at":"2024-09-05T17:59:18.000Z","dependencies_parsed_at":"2024-01-17T04:41:13.002Z","dependency_job_id":"7fb4781b-a0e8-4a9e-8878-8b381387c2c3","html_url":"https://github.com/crytic/evm_cfg_builder","commit_stats":null,"previous_names":["trailofbits/evm_cfg_builder"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crytic%2Fevm_cfg_builder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crytic%2Fevm_cfg_builder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crytic%2Fevm_cfg_builder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crytic%2Fevm_cfg_builder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/crytic","download_url":"https://codeload.github.com/crytic/evm_cfg_builder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224103311,"owners_count":17256345,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cfg","ethereum","evm","reversing"],"created_at":"2024-08-02T10:00:21.884Z","updated_at":"2024-11-11T12:30:37.074Z","avatar_url":"https://github.com/crytic.png","language":"Python","funding_links":[],"categories":["Reverse engineering"],"sub_categories":["Tools"],"readme":"# EVM CFG BUILDER\n[![Build Status](https://travis-ci.org/crytic/evm_cfg_builder.svg?branch=master)](https://travis-ci.org/crytic/evm_cfg_builder)\n[![Slack Status](https://empireslacking.herokuapp.com/badge.svg)](https://empireslacking.herokuapp.com)\n[![PyPI version](https://badge.fury.io/py/evm-cfg-builder.svg)](https://badge.fury.io/py/evm-cfg-builder)\n\n`evm-cfg-builder` is used to extract a control flow graph (CFG) from EVM bytecode. It is used by Ethersplay, Manticore, and  other tools from Trail of Bits. It is a reliable foundation to build program analysis tools for EVM.\n\nWe encourage contributions that address any known [issues](https://github.com/trailofbits/evm_cfg_builder/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc) and will pay out bounties for accepted PRs. Join us on the [Empire Hacking Slack](https://empireslacking.herokuapp.com) to discuss using or extending `evm-cfg-builder`.\n\n## Features\n\n* Reliably recovers a Control Flow Graph (CFG) from EVM bytecode using a dedicated Value Set Analysis\n* Recovers functions names\n* Recovers attributes (e.g., payable, view, pure)\n* Outputs the CFG to a dot file\n* Library API\n\n## Usage\n\n### Command-line\n\nTo export basic dissassembly information, run:\n```bash\nevm-cfg-builder mycontract.evm \n```\n\nTo export the CFG of each function (dot format), run:\n```bash\nevm-cfg-builder mycontract.evm --export-dot my_dir \n```\n\ndot files can be read using xdot.\n\n### Library\nSee [examples/explore_cfg.py](examples/explore_cfg.py) and [examples/explore_functions.py](examples/explore_functions.py) for library examples.\n\n## How to install\n\n### Using Pip\n```bash\npip install evm-cfg-builder\n```\n\n### Using Git\n```bash\ngit clone https://github.com/trailofbits/evm_cfg_builder\npip install .\n```\n\n## Requirements\n\n* Python \u003e= 3.6\n* [pyevmasm](https://github.com/trailofbits/pyevmasm)\n\n## Getting Help\n\nFeel free to stop by our [Slack channel](https://empireslacking.herokuapp.com) (#ethereum) for help using or extending evm-cfg-builder.\n\n## License\n\n`evm-cfg-builder` is licensed and distributed under the AGPLv3. [Contact us](mailto:opensource@trailofbits.com) if you're looking for an exception to the terms.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrytic%2Fevm_cfg_builder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcrytic%2Fevm_cfg_builder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrytic%2Fevm_cfg_builder/lists"}