Safe-eth-py (previously known as Gnosis-py)
###########################################
.. class:: no-web no-pdf
|ci| |coveralls| |python| |django| |pipy| |readthedocs| |black|
Safe-eth-py includes a set of libraries to work with Ethereum and relevant Ethereum projects:
- `EthereumClient`, a wrapper over Web3.py `Web3` client including utilities to deal with ERC20/721
tokens and tracing.
- `Gnosis Safe <https://github.com/safe-global/safe-contracts>`_ classes and utilities.
- Price oracles for `Uniswap`, `Kyber`...
- Django serializers, models and utils.
Quick start
-----------
Just run ``pip install safe-eth-py`` or add it to your **requirements.txt**
If you want django ethereum utils (models, serializers, filters...) you need to run
``pip install safe-eth-py[django]``
If you have issues building **coincurve** maybe
`you are missing some libraries <https://ofek.dev/coincurve/install/#source>`_
Contributing to safe-eth-py
---------------------------
Clone the repo, then to set it up:
.. code-block:: bash
python -m venv venv
source venv/bin/activate
pip install -r requirements-dev.txt
pre-commit install -f
Add new address for new chains
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you want to add Safe Smart Account support for a new chain you must `open a new issue <https://github.com/safe-global/safe-eth-py/issues/new?assignees=&labels=add-new-address&projects=&template=add_safe_address_new_chain.yml&title=%5BNew+chain%5D%3A+%7Bchain+name%7D>`_.
Once the issue is created or edited, an automatic validation will be executed and a **Pull Request** will be created if everything is ok. Finally, the Safe team will review and merge the automatic **Pull Request** generated from the issue.
Ethereum utils
--------------
gnosis.eth
~~~~~~~~~~~~~~~~~~~~
- ``class EthereumClient (ethereum_node_url: str)``: Class to connect and do operations
with an ethereum node. Uses web3 and raw rpc calls for things not supported in web3.
Only ``http/https`` urls are supported for the node url.
``EthereumClient`` has some utils that improve a lot performance using Ethereum nodes, like
the possibility of doing ``batch_calls`` (a single request making read-only calls to multiple contracts):
.. code-block:: python
from gnosis.eth import EthereumClient
from gnosis.eth.contracts import get_erc721_contract
ethereum_client = EthereumClient(ETHEREUM_NODE_URL)
erc721_contract = get_erc721_contract(self.w3, token_address)
name, symbol = ethereum_client.batch_call([
erc721_contract.functions.name(),
erc721_contract.functions.symbol(),
])
If you want to use the underlying `web3.py <https://github.com/ethereum/web3.py>`_ library:
.. code-block:: python
from gnosis.eth import EthereumClient
ethereum_client = EthereumClient(ETHEREUM_NODE_URL)
ethereum_client.w3.eth.get_block(57)
gnosis.eth.constants
~~~~~~~~~~~~~~~~~~~~
- ``NULL_ADDRESS (0x000...0)``: Solidity ``address(0)``.
- ``SENTINEL_ADDRESS (0x000...1)``: Used for Gnosis Safe's linked lists (modules, owners...).
- Maximum and minimum values for `R`, `S` and `V` in ethereum signatures.
gnosis.eth.oracles
~~~~~~~~~~~~~~~~~~
Price oracles for Uniswap, UniswapV2, Kyber, SushiSwap, Aave, Balancer, Curve, Mooniswap, Yearn...
Example:
.. code-block:: python
from gnosis.eth import EthereumClient
from gnosis.eth.oracles import UniswapV2Oracle
ethereum_client = EthereumClient(ETHEREUM_NODE_URL)
uniswap_oracle = UniswapV2Oracle(ethereum_client)
gno_token_mainnet_address = '0x6810e776880C02933D47DB1b9fc05908e5386b96'
weth_token_mainnet_address = '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2'
price = uniswap_oracle.get_price(gno_token_mainnet_address, uniswap_oracle.weth_address)
gnosis.eth.utils
~~~~~~~~~~~~~~~~
Contains utils for ethereum operations:
- ``mk_contract_address_2(from_: Union[str, bytes], salt: Union[str, bytes], init_code: [str, bytes]) -> str``:
Calculates the address of a new contract created using the new CREATE2 opcode.
Ethereum django (REST) utils
----------------------------
Django utils are available under ``gnosis.eth.django``.
You can find a set of helpers for working with Ethereum using Django and Django Rest framework.
It includes:
- **gnosis.eth.django.filters**: EthereumAddressFilter.
- **gnosis.eth.django.models**: Model fields (Ethereum address, Ethereum big integer field).
- **gnosis.eth.django.serializers**: Serializer fields (Ethereum address field, hexadecimal field).
- **gnosis.eth.django.validators**: Ethereum related validators.
- **gnosis.safe.serializers**: Serializers for Gnosis Safe (signature, transaction...).
- All the tests are written using Django Test suite.
Contributors
------------
`See contributors <https://github.com/safe-global/safe-eth-py/graphs/contributors>`_
.. |ci| image:: https://github.com/safe-global/safe-eth-py/actions/workflows/python.yml/badge.svg
:alt: Github Actions CI build
.. |coveralls| image:: https://coveralls.io/repos/github/safe-global/safe-eth-py/badge.svg
:target: https://coveralls.io/github/safe-global/safe-eth-py
.. |python| image:: https://img.shields.io/badge/Python-3.12-blue.svg
:alt: Python 3.12
.. |django| image:: https://img.shields.io/badge/Django-5-blue.svg
:alt: Django 5
.. |pipy| image:: https://badge.fury.io/py/safe-eth-py.svg
:target: https://badge.fury.io/py/safe-eth-py
:alt: Pypi package
.. |readthedocs| image:: https://readthedocs.org/projects/safe-eth-py/badge/?version=latest
:target: https://safe-eth-py.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
.. |black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
:target: https://github.com/psf/black
:alt: Black
Raw data
{
"_id": null,
"home_page": "https://github.com/0xEMMAI/safe-eth-py",
"name": "safe-emmai-py",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "ethereum, web3, django, safe, cowswap, gnosis",
"author": "emmai",
"author_email": "team@emmai.com",
"download_url": "https://files.pythonhosted.org/packages/bd/a6/69aead78f24afa5e0c2068d7e7b1e22b2011375f25a4c755851357fc1581/safe_emmai_py-1.0.0.tar.gz",
"platform": null,
"description": "Safe-eth-py (previously known as Gnosis-py)\n###########################################\n\n.. class:: no-web no-pdf\n\n|ci| |coveralls| |python| |django| |pipy| |readthedocs| |black|\n\nSafe-eth-py includes a set of libraries to work with Ethereum and relevant Ethereum projects:\n - `EthereumClient`, a wrapper over Web3.py `Web3` client including utilities to deal with ERC20/721\n tokens and tracing.\n - `Gnosis Safe <https://github.com/safe-global/safe-contracts>`_ classes and utilities.\n - Price oracles for `Uniswap`, `Kyber`...\n - Django serializers, models and utils.\n\nQuick start\n-----------\n\nJust run ``pip install safe-eth-py`` or add it to your **requirements.txt**\n\nIf you want django ethereum utils (models, serializers, filters...) you need to run\n``pip install safe-eth-py[django]``\n\nIf you have issues building **coincurve** maybe\n`you are missing some libraries <https://ofek.dev/coincurve/install/#source>`_\n\n\nContributing to safe-eth-py\n---------------------------\nClone the repo, then to set it up:\n\n.. code-block:: bash\n\n python -m venv venv\n source venv/bin/activate\n pip install -r requirements-dev.txt\n pre-commit install -f\n\nAdd new address for new chains\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\nIf you want to add Safe Smart Account support for a new chain you must `open a new issue <https://github.com/safe-global/safe-eth-py/issues/new?assignees=&labels=add-new-address&projects=&template=add_safe_address_new_chain.yml&title=%5BNew+chain%5D%3A+%7Bchain+name%7D>`_.\n\nOnce the issue is created or edited, an automatic validation will be executed and a **Pull Request** will be created if everything is ok. Finally, the Safe team will review and merge the automatic **Pull Request** generated from the issue.\n\nEthereum utils\n--------------\ngnosis.eth\n~~~~~~~~~~~~~~~~~~~~\n- ``class EthereumClient (ethereum_node_url: str)``: Class to connect and do operations\n with an ethereum node. Uses web3 and raw rpc calls for things not supported in web3.\n Only ``http/https`` urls are supported for the node url.\n\n``EthereumClient`` has some utils that improve a lot performance using Ethereum nodes, like\nthe possibility of doing ``batch_calls`` (a single request making read-only calls to multiple contracts):\n\n.. code-block:: python\n\n from gnosis.eth import EthereumClient\n from gnosis.eth.contracts import get_erc721_contract\n ethereum_client = EthereumClient(ETHEREUM_NODE_URL)\n erc721_contract = get_erc721_contract(self.w3, token_address)\n name, symbol = ethereum_client.batch_call([\n erc721_contract.functions.name(),\n erc721_contract.functions.symbol(),\n ])\n\nIf you want to use the underlying `web3.py <https://github.com/ethereum/web3.py>`_ library:\n\n.. code-block:: python\n\n from gnosis.eth import EthereumClient\n ethereum_client = EthereumClient(ETHEREUM_NODE_URL)\n ethereum_client.w3.eth.get_block(57)\n\n\ngnosis.eth.constants\n~~~~~~~~~~~~~~~~~~~~\n- ``NULL_ADDRESS (0x000...0)``: Solidity ``address(0)``.\n- ``SENTINEL_ADDRESS (0x000...1)``: Used for Gnosis Safe's linked lists (modules, owners...).\n- Maximum and minimum values for `R`, `S` and `V` in ethereum signatures.\n\ngnosis.eth.oracles\n~~~~~~~~~~~~~~~~~~\n\nPrice oracles for Uniswap, UniswapV2, Kyber, SushiSwap, Aave, Balancer, Curve, Mooniswap, Yearn...\nExample:\n\n.. code-block:: python\n\n from gnosis.eth import EthereumClient\n from gnosis.eth.oracles import UniswapV2Oracle\n ethereum_client = EthereumClient(ETHEREUM_NODE_URL)\n uniswap_oracle = UniswapV2Oracle(ethereum_client)\n gno_token_mainnet_address = '0x6810e776880C02933D47DB1b9fc05908e5386b96'\n weth_token_mainnet_address = '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2'\n price = uniswap_oracle.get_price(gno_token_mainnet_address, uniswap_oracle.weth_address)\n\n\n\ngnosis.eth.utils\n~~~~~~~~~~~~~~~~\n\nContains utils for ethereum operations:\n\n- ``mk_contract_address_2(from_: Union[str, bytes], salt: Union[str, bytes], init_code: [str, bytes]) -> str``:\n Calculates the address of a new contract created using the new CREATE2 opcode.\n\nEthereum django (REST) utils\n----------------------------\nDjango utils are available under ``gnosis.eth.django``.\nYou can find a set of helpers for working with Ethereum using Django and Django Rest framework.\n\nIt includes:\n\n- **gnosis.eth.django.filters**: EthereumAddressFilter.\n- **gnosis.eth.django.models**: Model fields (Ethereum address, Ethereum big integer field).\n- **gnosis.eth.django.serializers**: Serializer fields (Ethereum address field, hexadecimal field).\n- **gnosis.eth.django.validators**: Ethereum related validators.\n- **gnosis.safe.serializers**: Serializers for Gnosis Safe (signature, transaction...).\n- All the tests are written using Django Test suite.\n\nContributors\n------------\n`See contributors <https://github.com/safe-global/safe-eth-py/graphs/contributors>`_\n\n.. |ci| image:: https://github.com/safe-global/safe-eth-py/actions/workflows/python.yml/badge.svg\n :alt: Github Actions CI build\n\n.. |coveralls| image:: https://coveralls.io/repos/github/safe-global/safe-eth-py/badge.svg\n :target: https://coveralls.io/github/safe-global/safe-eth-py\n\n.. |python| image:: https://img.shields.io/badge/Python-3.12-blue.svg\n :alt: Python 3.12\n\n.. |django| image:: https://img.shields.io/badge/Django-5-blue.svg\n :alt: Django 5\n\n.. |pipy| image:: https://badge.fury.io/py/safe-eth-py.svg\n :target: https://badge.fury.io/py/safe-eth-py\n :alt: Pypi package\n\n.. |readthedocs| image:: https://readthedocs.org/projects/safe-eth-py/badge/?version=latest\n :target: https://safe-eth-py.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\n.. |black| image:: https://img.shields.io/badge/code%20style-black-000000.svg\n :target: https://github.com/psf/black\n :alt: Black\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Safe Ecosystem Foundation utilities for Ethereum projects",
"version": "1.0.0",
"project_urls": {
"Documentation": "https://safe-eth-py.readthedocs.io/en/latest/",
"Homepage": "https://github.com/0xEMMAI/safe-eth-py",
"Source": "https://github.com/safe-global/safe-eth-py",
"Tracker": "https://github.com/safe-global/safe-eth-py/issues"
},
"split_keywords": [
"ethereum",
" web3",
" django",
" safe",
" cowswap",
" gnosis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fddd28de3af2c96705b55ad11bad28c95f941bf72db7e5ba4482353b0d45c480",
"md5": "d1e332a1193b9d89e17910eedbcd2e7c",
"sha256": "091a697da9fc900160441a2d5fdc44d2f655e957d5e5ac262379e9fe2ed7b6ec"
},
"downloads": -1,
"filename": "safe_emmai_py-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d1e332a1193b9d89e17910eedbcd2e7c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 840881,
"upload_time": "2024-04-16T10:05:16",
"upload_time_iso_8601": "2024-04-16T10:05:16.279114Z",
"url": "https://files.pythonhosted.org/packages/fd/dd/28de3af2c96705b55ad11bad28c95f941bf72db7e5ba4482353b0d45c480/safe_emmai_py-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bda669aead78f24afa5e0c2068d7e7b1e22b2011375f25a4c755851357fc1581",
"md5": "e1561ad090d439dc80bc724a662cf632",
"sha256": "944080158b0a01bb93e02b762391022d43a61749314521f0693bb5f0090c5333"
},
"downloads": -1,
"filename": "safe_emmai_py-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "e1561ad090d439dc80bc724a662cf632",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 757695,
"upload_time": "2024-04-16T10:05:21",
"upload_time_iso_8601": "2024-04-16T10:05:21.110406Z",
"url": "https://files.pythonhosted.org/packages/bd/a6/69aead78f24afa5e0c2068d7e7b1e22b2011375f25a4c755851357fc1581/safe_emmai_py-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-16 10:05:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "0xEMMAI",
"github_project": "safe-eth-py",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [
{
"name": "django",
"specs": [
[
"==",
"4.2.11"
]
]
},
{
"name": "django-filter",
"specs": [
[
"==",
"24.2"
]
]
},
{
"name": "djangorestframework",
"specs": [
[
"==",
"3.15.1"
]
]
},
{
"name": "hexbytes",
"specs": [
[
"==",
"0.3.1"
]
]
},
{
"name": "packaging",
"specs": []
},
{
"name": "psycopg2-binary",
"specs": [
[
"==",
"2.9.9"
]
]
},
{
"name": "py-evm",
"specs": [
[
"==",
"0.10.0b6"
]
]
},
{
"name": "pysha3",
"specs": [
[
">=",
"1.0.0"
],
[
"<",
"2.0.0"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.31.0"
]
]
},
{
"name": "safe-pysha3",
"specs": [
[
">=",
"1.0.0"
]
]
},
{
"name": "web3",
"specs": [
[
"==",
"6.17.0"
]
]
}
],
"lcname": "safe-emmai-py"
}
JSON
