{"id":13746246,"url":"https://github.com/ethereum/eth-utils","last_synced_at":"2025-12-12T01:04:45.596Z","repository":{"id":17160083,"uuid":"81221757","full_name":"ethereum/eth-utils","owner":"ethereum","description":"Utility functions for working with ethereum related codebases.","archived":false,"fork":false,"pushed_at":"2025-04-14T19:39:16.000Z","size":980,"stargazers_count":328,"open_issues_count":11,"forks_count":170,"subscribers_count":19,"default_branch":"main","last_synced_at":"2025-04-15T05:32:08.538Z","etag":null,"topics":["ethereum","python","utility-library"],"latest_commit_sha":null,"homepage":"https://eth-utils.readthedocs.io/en/latest/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ethereum.png","metadata":{"files":{"readme":"README.md","changelog":"newsfragments/README.md","contributing":"docs/contributing.rst","funding":null,"license":"LICENSE","code_of_conduct":"docs/code_of_conduct.rst","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-02-07T15:15:18.000Z","updated_at":"2025-04-14T19:39:18.000Z","dependencies_parsed_at":"2024-05-06T18:27:32.601Z","dependency_job_id":"d1a04388-e8bf-46f6-8f60-977698ac688a","html_url":"https://github.com/ethereum/eth-utils","commit_stats":{"total_commits":626,"total_committers":44,"mean_commits":"14.227272727272727","dds":0.7284345047923323,"last_synced_commit":"c27072b6caf758f02d2eda8b1ee004d772e491dd"},"previous_names":[],"tags_count":80,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethereum%2Feth-utils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethereum%2Feth-utils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethereum%2Feth-utils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethereum%2Feth-utils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ethereum","download_url":"https://codeload.github.com/ethereum/eth-utils/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254346624,"owners_count":22055808,"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":["ethereum","python","utility-library"],"created_at":"2024-08-03T06:00:50.537Z","updated_at":"2025-12-12T01:04:45.551Z","avatar_url":"https://github.com/ethereum.png","language":"Python","funding_links":[],"categories":["Smart Contract Platforms"],"sub_categories":[],"readme":"# Ethereum Utilities\n\n[![Join the conversation on Discord](https://img.shields.io/discord/809793915578089484?color=blue\u0026label=chat\u0026logo=discord\u0026logoColor=white)](https://discord.gg/GHryRvPB84)\n[![Build Status](https://circleci.com/gh/ethereum/eth-utils.svg?style=shield)](https://circleci.com/gh/ethereum/eth-utils)\n[![PyPI version](https://badge.fury.io/py/eth-utils.svg)](https://badge.fury.io/py/eth-utils)\n[![Python versions](https://img.shields.io/pypi/pyversions/eth-utils.svg)](https://pypi.python.org/pypi/eth-utils)\n[![Docs build](https://readthedocs.org/projects/eth-utils/badge/?version=latest)](https://eth-utils.readthedocs.io/en/latest/?badge=latest)\n\nCommon utility functions for python code that interacts with Ethereum\n\nRead the [documentation](https://eth-utils.readthedocs.io/).\n\nView the [change log](https://eth-utils.readthedocs.io/en/latest/release_notes.html).\n\n## Installation\n\n```sh\npython -m pip install eth-utils\n```\n\n## Developer Setup\n\nIf you would like to hack on eth-utils, please check out the [Snake Charmers\nTactical Manual](https://github.com/ethereum/snake-charmers-tactical-manual)\nfor information on how we do:\n\n- Testing\n- Pull Requests\n- Documentation\n\nWe use [pre-commit](https://pre-commit.com/) to maintain consistent code style. Once\ninstalled, it will run automatically with every commit. You can also run it manually\nwith `make lint`. If you need to make a commit that skips the `pre-commit` checks, you\ncan do so with `git commit --no-verify`.\n\n### Development Environment Setup\n\nYou can set up your dev environment with:\n\n```sh\ngit clone git@github.com:ethereum/eth-utils.git\ncd eth-utils\nvirtualenv -p python3 venv\n. venv/bin/activate\npython -m pip install -e \".[dev]\"\npre-commit install\n```\n\n### Update Networks\n\nThe list of networks resides in the JSON file under eth_utils/\\_\\_json/eth_networks.json.\nThis file is used to initialize Networks, which can be used to obtain network\ninformation with a chain ID.\n\nRun the script to update the JSON file with the response from the remote list.\n\n```sh\npython update_networks.py\n```\n\nIf there are new networks they will appear in the JSON file. After checking the updates,\nopen a PR to make them available in a new release.\n\n### Release setup\n\nTo release a new version:\n\n```sh\nmake release bump=$$VERSION_PART_TO_BUMP$$\n```\n\n#### How to bumpversion\n\nThe version format for this repo is `{major}.{minor}.{patch}` for stable, and\n`{major}.{minor}.{patch}-{stage}.{devnum}` for unstable (`stage` can be alpha or beta).\n\nTo issue the next version in line, specify which part to bump,\nlike `make release bump=minor` or `make release bump=devnum`. This is typically done from the\nmain branch, except when releasing a beta (in which case the beta is released from main,\nand the previous stable branch is released from said branch).\n\nIf you are in a beta version, `make release bump=stage` will switch to a stable.\n\nTo issue an unstable version when the current version is stable, specify the\nnew version explicitly, like `make release bump=\"--new-version 4.0.0-alpha.1 devnum\"`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fethereum%2Feth-utils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fethereum%2Feth-utils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fethereum%2Feth-utils/lists"}