web3 7.0.0b5__tar.gz → 7.0.0b7__tar.gz

{web3-7.0.0b5 → web3-7.0.0b7}/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2016 The Ethereum Foundation
+Copyright (c) 2016-2024 The Ethereum Foundation
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

web3-7.0.0b7/MANIFEST.in

@@ -0,0 +1,13 @@
+include LICENSE
+include README.md
+
+recursive-include ens/specs *
+recursive-include scripts *
+recursive-include tests *
+
+global-include *.pyi
+
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]
+prune .tox
+prune venv*

{web3-7.0.0b5/web3.egg-info → web3-7.0.0b7}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: web3
-Version: 7.0.0b5
-Summary: web3.py
+Version: 7.0.0b7
+Summary: web3: A Python library for interacting with Ethereum
 Home-page: https://github.com/ethereum/web3.py
 Author: The Ethereum Foundation
 Author-email: snakecharmers@ethereum.org
@@ -16,7 +16,8 @@ Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
-Requires-Python: >=3.8
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8, <4
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: aiohttp>=3.7.4.post0
@@ -32,39 +33,52 @@ Requires-Dist: requests>=2.16.0
 Requires-Dist: typing-extensions>=4.0.1
 Requires-Dist: websockets>=10.0.0
 Requires-Dist: pyunormalize>=15.0.0
-Provides-Extra: tester
-Requires-Dist: eth-tester[py-evm]<0.12.0b1,>=0.11.0b1; extra == "tester"
-Requires-Dist: py-geth>=4.1.0; extra == "tester"
-Provides-Extra: docs
-Requires-Dist: sphinx>=5.3.0; extra == "docs"
-Requires-Dist: sphinx_rtd_theme>=1.0.0; extra == "docs"
-Requires-Dist: towncrier<22,>=21; extra == "docs"
 Provides-Extra: dev
-Requires-Dist: eth-tester[py-evm]<0.12.0b1,>=0.11.0b1; extra == "dev"
-Requires-Dist: py-geth>=4.1.0; extra == "dev"
-Requires-Dist: sphinx>=5.3.0; extra == "dev"
-Requires-Dist: sphinx_rtd_theme>=1.0.0; extra == "dev"
-Requires-Dist: towncrier<22,>=21; extra == "dev"
 Requires-Dist: build>=0.9.0; extra == "dev"
-Requires-Dist: bumpversion; extra == "dev"
+Requires-Dist: bumpversion>=0.5.3; extra == "dev"
 Requires-Dist: flaky>=3.7.0; extra == "dev"
 Requires-Dist: hypothesis>=3.31.2; extra == "dev"
+Requires-Dist: ipython; extra == "dev"
 Requires-Dist: pre-commit>=3.4.0; extra == "dev"
-Requires-Dist: pytest-asyncio<0.23,>=0.18.1; extra == "dev"
+Requires-Dist: pytest-asyncio<0.23,>=0.21.2; extra == "dev"
 Requires-Dist: pytest-mock>=1.10; extra == "dev"
-Requires-Dist: pytest-watch>=4.2; extra == "dev"
-Requires-Dist: pytest-xdist>=1.29; extra == "dev"
-Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: setuptools>=38.6.0; extra == "dev"
-Requires-Dist: tox>=3.18.0; extra == "dev"
+Requires-Dist: tox>=4.0.0; extra == "dev"
 Requires-Dist: tqdm>4.32; extra == "dev"
 Requires-Dist: twine>=1.13; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+Requires-Dist: sphinx>=6.0.0; extra == "dev"
+Requires-Dist: sphinx-autobuild>=2021.3.14; extra == "dev"
+Requires-Dist: sphinx_rtd_theme>=1.0.0; extra == "dev"
+Requires-Dist: towncrier<22,>=21; extra == "dev"
+Requires-Dist: eth-account>=0.13.0; extra == "dev"
+Requires-Dist: eth-tester[py-evm]<0.13.0b1,>=0.11.0b1; extra == "dev"
+Requires-Dist: py-geth>=5.0.0b1; extra == "dev"
+Requires-Dist: pytest-asyncio<0.23,>=0.18.1; extra == "dev"
+Requires-Dist: pytest-mock>=1.10; extra == "dev"
+Requires-Dist: pytest-xdist>=2.4.0; extra == "dev"
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=6.0.0; extra == "docs"
+Requires-Dist: sphinx-autobuild>=2021.3.14; extra == "docs"
+Requires-Dist: sphinx_rtd_theme>=1.0.0; extra == "docs"
+Requires-Dist: towncrier<22,>=21; extra == "docs"
+Requires-Dist: eth-account>=0.13.0; extra == "docs"
+Provides-Extra: test
+Requires-Dist: eth-tester[py-evm]<0.13.0b1,>=0.11.0b1; extra == "test"
+Requires-Dist: py-geth>=5.0.0b1; extra == "test"
+Requires-Dist: pytest-asyncio<0.23,>=0.18.1; extra == "test"
+Requires-Dist: pytest-mock>=1.10; extra == "test"
+Requires-Dist: pytest-xdist>=2.4.0; extra == "test"
+Requires-Dist: pytest>=7.0.0; extra == "test"
 
 # web3.py
 
-[![Documentation Status](https://readthedocs.org/projects/web3py/badge/?version=latest)](https://web3py.readthedocs.io/en/latest/?badge=latest)
-[![Discord](https://img.shields.io/discord/809793915578089484?color=blue&label=chat&logo=discord&logoColor=white)](https://discord.gg/GHryRvPB84)
+[![Join the conversation on Discord](https://img.shields.io/discord/809793915578089484?color=blue&label=chat&logo=discord&logoColor=white)](https://discord.gg/GHryRvPB84)
 [![Build Status](https://circleci.com/gh/ethereum/web3.py.svg?style=shield)](https://circleci.com/gh/ethereum/web3.py)
+[![PyPI version](https://badge.fury.io/py/web3.svg)](https://badge.fury.io/py/web3)
+[![Python versions](https://img.shields.io/pypi/pyversions/web3.svg)](https://pypi.python.org/pypi/web3)
+[![Docs build](https://readthedocs.org/projects/web3py/badge/?version=latest)](https://web3py.readthedocs.io/en/latest/?badge=latest)
 
 A Python library for interacting with Ethereum.
 

{web3-7.0.0b5 → web3-7.0.0b7}/README.md

@@ -1,8 +1,10 @@
 # web3.py
 
-[![Documentation Status](https://readthedocs.org/projects/web3py/badge/?version=latest)](https://web3py.readthedocs.io/en/latest/?badge=latest)
-[![Discord](https://img.shields.io/discord/809793915578089484?color=blue&label=chat&logo=discord&logoColor=white)](https://discord.gg/GHryRvPB84)
+[![Join the conversation on Discord](https://img.shields.io/discord/809793915578089484?color=blue&label=chat&logo=discord&logoColor=white)](https://discord.gg/GHryRvPB84)
 [![Build Status](https://circleci.com/gh/ethereum/web3.py.svg?style=shield)](https://circleci.com/gh/ethereum/web3.py)
+[![PyPI version](https://badge.fury.io/py/web3.svg)](https://badge.fury.io/py/web3)
+[![Python versions](https://img.shields.io/pypi/pyversions/web3.svg)](https://pypi.python.org/pypi/web3)
+[![Docs build](https://readthedocs.org/projects/web3py/badge/?version=latest)](https://web3py.readthedocs.io/en/latest/?badge=latest)
 
 A Python library for interacting with Ethereum.
 

{web3-7.0.0b5 → web3-7.0.0b7}/ens/__init__.py

@@ -1,5 +1,3 @@
-# flake8: noqa
-
 from .async_ens import (
     AsyncENS,
 )
@@ -18,3 +16,16 @@ from .exceptions import (
     UnderfundedBid,
     UnownedName,
 )
+
+__all__ = [
+    "AsyncENS",
+    "BaseENS",
+    "ENS",
+    "AddressMismatch",
+    "BidTooLow",
+    "InvalidLabel",
+    "InvalidName",
+    "UnauthorizedError",
+    "UnderfundedBid",
+    "UnownedName",
+]

{web3-7.0.0b5 → web3-7.0.0b7}/setup.py

@@ -5,47 +5,56 @@ from setuptools import (
 )
 
 extras_require = {
-    "tester": [
-        "eth-tester[py-evm]>=0.11.0b1,<0.12.0b1",
-        "py-geth>=4.1.0",
-    ],
-    "docs": [
-        "sphinx>=5.3.0",
-        "sphinx_rtd_theme>=1.0.0",
-        "towncrier>=21,<22",
-    ],
     "dev": [
         "build>=0.9.0",
-        "bumpversion",
+        "bumpversion>=0.5.3",
         "flaky>=3.7.0",
         "hypothesis>=3.31.2",
+        "ipython",
         "pre-commit>=3.4.0",
-        "pytest-asyncio>=0.18.1,<0.23",
+        "pytest-asyncio>=0.21.2,<0.23",
         "pytest-mock>=1.10",
-        "pytest-watch>=4.2",
-        "pytest-xdist>=1.29",
-        "pytest>=7.0.0",
         "setuptools>=38.6.0",
-        "tox>=3.18.0",
+        "tox>=4.0.0",
         "tqdm>4.32",
         "twine>=1.13",
+        "wheel",
+    ],
+    "docs": [
+        "sphinx>=6.0.0",
+        "sphinx-autobuild>=2021.3.14",
+        "sphinx_rtd_theme>=1.0.0",
+        "towncrier>=21,<22",
+        # web3 will work but emit warnings with eth-account>=0.12.2,
+        # but doctests fail between 0.12.2 and 0.13.0
+        "eth-account>=0.13.0",
+    ],
+    "test": [
+        "eth-tester[py-evm]>=0.11.0b1,<0.13.0b1",
+        "py-geth>=5.0.0b1",
+        "pytest-asyncio>=0.18.1,<0.23",
+        "pytest-mock>=1.10",
+        "pytest-xdist>=2.4.0",
+        "pytest>=7.0.0",
     ],
 }
 
 extras_require["dev"] = (
-    extras_require["tester"] + extras_require["docs"] + extras_require["dev"]
+    extras_require["dev"] + extras_require["docs"] + extras_require["test"]
 )
 
+
 with open("./README.md") as readme:
     long_description = readme.read()
 
+
 setup(
     name="web3",
-    # *IMPORTANT*: Don't manually change the version here. Use the 'bumpversion' utility.
-    version="7.0.0-beta.5",
-    description="""web3.py""",
-    long_description_content_type="text/markdown",
+    # *IMPORTANT*: Don't manually change the version here. Use `make bump`, as described in readme
+    version="7.0.0-beta.7",
+    description="""web3: A Python library for interacting with Ethereum""",
     long_description=long_description,
+    long_description_content_type="text/markdown",
     author="The Ethereum Foundation",
     author_email="snakecharmers@ethereum.org",
     url="https://github.com/ethereum/web3.py",
@@ -65,13 +74,13 @@ setup(
         "websockets>=10.0.0",
         "pyunormalize>=15.0.0",
     ],
-    python_requires=">=3.8",
+    python_requires=">=3.8, <4",
     extras_require=extras_require,
     py_modules=["web3", "ens"],
     license="MIT",
     zip_safe=False,
     keywords="ethereum",
-    packages=find_packages(exclude=["tests", "tests.*"]),
+    packages=find_packages(exclude=["scripts", "scripts.*", "tests", "tests.*"]),
     package_data={"web3": ["py.typed"]},
     classifiers=[
         "Development Status :: 5 - Production/Stable",
@@ -83,5 +92,6 @@ setup(
         "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
     ],
 )

web3-7.0.0b7/tests/beacon/test_async_beacon.py

@@ -0,0 +1,269 @@
+import pytest
+from random import (
+    randint,
+)
+
+from aiohttp.client_exceptions import (
+    InvalidURL,
+)
+import pytest_asyncio
+
+from web3.beacon import (
+    AsyncBeacon,
+)
+
+# tested against lighthouse which uses port 5052 by default
+BASE_URL = "http://localhost:5052"
+
+
+def _assert_valid_response(response):
+    # assert valid response according to Beacon API spec
+    assert isinstance(response, dict)
+    assert "data" in response
+
+
+@pytest.fixture
+def async_beacon():
+    return AsyncBeacon(base_url=BASE_URL, request_timeout=30.0)
+
+
+@pytest_asyncio.fixture(autouse=True)
+async def _cleanup(async_beacon):
+    yield
+    [
+        await session.close()
+        for _, session in async_beacon._request_session_manager.session_cache.items()
+    ]
+
+
+# sanity check to make sure the positive test cases are valid
+@pytest.mark.asyncio
+async def test_async_cl_beacon_raises_exception_on_invalid_url(async_beacon):
+    with pytest.raises(InvalidURL):
+        await async_beacon._async_make_get_request(
+            BASE_URL + "/eth/v1/beacon/nonexistent"
+        )
+
+
+@pytest.mark.asyncio
+async def test_async_beacon_user_request_timeout():
+    beacon = AsyncBeacon(base_url=BASE_URL, request_timeout=0.001)
+    with pytest.raises(TimeoutError):
+        await beacon.get_validators()
+
+
+# Beacon endpoint tests:
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_genesis(async_beacon):
+    response = await async_beacon.get_genesis()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_hash_root(async_beacon):
+    response = await async_beacon.get_hash_root()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_fork_data(async_beacon):
+    response = await async_beacon.get_fork_data()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_finality_checkpoint(async_beacon):
+    response = await async_beacon.get_finality_checkpoint()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_validators(async_beacon):
+    response = await async_beacon.get_validators()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_validator(async_beacon):
+    validators_response = await async_beacon.get_validators()
+    _assert_valid_response(validators_response)
+
+    validators = validators_response["data"]
+    random_validator = validators[randint(0, len(validators))]
+    random_validator_pubkey = random_validator["validator"]["pubkey"]
+
+    response = await async_beacon.get_validator(random_validator_pubkey)
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_validator_balances(async_beacon):
+    response = await async_beacon.get_validator_balances()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_epoch_committees(async_beacon):
+    response = await async_beacon.get_epoch_committees()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_epoch_sync_committees(async_beacon):
+    response = await async_beacon.get_epoch_sync_committees()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_epoch_randao(async_beacon):
+    response = await async_beacon.get_epoch_randao()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_block_headers(async_beacon):
+    response = await async_beacon.get_block_headers()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_block_header(async_beacon):
+    response = await async_beacon.get_block_header("head")
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_block(async_beacon):
+    response = await async_beacon.get_block("head")
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_block_root(async_beacon):
+    response = await async_beacon.get_block_root("head")
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_blinded_blocks(async_beacon):
+    response = await async_beacon.get_blinded_blocks("head")
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_rewards(async_beacon):
+    response = await async_beacon.get_rewards("head")
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_block_attestations(async_beacon):
+    response = await async_beacon.get_block_attestations("head")
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_attestations(async_beacon):
+    response = await async_beacon.get_attestations()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_attester_slashings(async_beacon):
+    response = await async_beacon.get_attester_slashings()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_proposer_slashings(async_beacon):
+    response = await async_beacon.get_proposer_slashings()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_voluntary_exits(async_beacon):
+    response = await async_beacon.get_voluntary_exits()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_beacon_get_bls_to_execution_changes(async_beacon):
+    response = await async_beacon.get_bls_to_execution_changes()
+    _assert_valid_response(response)
+
+
+# Config endpoint tests:
+
+
+@pytest.mark.asyncio
+async def test_async_cl_config_get_fork_schedule(async_beacon):
+    response = await async_beacon.get_fork_schedule()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_config_get_spec(async_beacon):
+    response = await async_beacon.get_spec()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_config_get_deposit_contract(async_beacon):
+    response = await async_beacon.get_deposit_contract()
+    _assert_valid_response(response)
+
+
+# Debug endpoint tests:
+
+
+@pytest.mark.asyncio
+async def test_async_cl_debug_get_beacon_state(async_beacon):
+    response = await async_beacon.get_beacon_state()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_debug_get_beacon_heads(async_beacon):
+    response = await async_beacon.get_beacon_heads()
+    _assert_valid_response(response)
+
+
+# Node endpoint tests:
+
+
+@pytest.mark.asyncio
+async def test_async_cl_node_get_node_identity(async_beacon):
+    response = await async_beacon.get_node_identity()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_node_get_peers(async_beacon):
+    response = await async_beacon.get_peers()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_node_get_peer(async_beacon):
+    response = await async_beacon.get_peer("")
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_node_get_health(async_beacon):
+    response = await async_beacon.get_health()
+    assert isinstance(response, int)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_node_get_version(async_beacon):
+    response = await async_beacon.get_version()
+    _assert_valid_response(response)
+
+
+@pytest.mark.asyncio
+async def test_async_cl_node_get_syncing(async_beacon):
+    response = await async_beacon.get_syncing()
+    _assert_valid_response(response)