web3 7.0.0b1__py3-none-any.whl → 7.7.0__py3-none-any.whl

ethpm/validation/package.py

@@ -1,80 +0,0 @@
-import re
-from typing import (
-    Any,
-    Dict,
-)
-
-from eth_utils import (
-    is_text,
-)
-
-from ethpm._utils.ipfs import (
-    is_ipfs_uri,
-)
-from ethpm.constants import (
-    PACKAGE_NAME_REGEX,
-)
-from ethpm.exceptions import (
-    EthPMValidationError,
-    InsufficientAssetsError,
-)
-
-
-def validate_minimal_contract_factory_data(contract_data: Dict[str, str]) -> None:
-    """
-    Validate that contract data in a package contains at least an "abi" and
-    "deploymentBytecode" necessary to generate a deployable contract factory.
-    """
-    if not all(key in contract_data.keys() for key in ("abi", "deploymentBytecode")):
-        raise InsufficientAssetsError(
-            "Minimum required contract data to generate a deployable "
-            "contract factory (abi & deploymentBytecode) not found."
-        )
-
-
-def validate_package_version(version: Any) -> None:
-    """
-    Validates that a package version is of text type.
-    """
-    if not is_text(version):
-        raise EthPMValidationError(
-            f"Expected a version of text type, instead received {type(version)}."
-        )
-
-
-def validate_package_name(pkg_name: str) -> None:
-    """
-    Raise an exception if the value is not a valid package name
-    as defined in the EthPM-Spec.
-    """
-    if not bool(re.match(PACKAGE_NAME_REGEX, pkg_name)):
-        raise EthPMValidationError(f"{pkg_name} is not a valid package name.")
-
-
-def validate_manifest_version(version: str) -> None:
-    """
-    Raise an exception if the version is not "ethpm/3".
-    """
-    if not version == "ethpm/3":
-        raise EthPMValidationError(
-            f"Py-EthPM does not support the provided specification version: {version}"
-        )
-
-
-def validate_build_dependency(key: str, uri: str) -> None:
-    """
-    Raise an exception if the key in dependencies is not a valid package name,
-    or if the value is not a valid IPFS URI.
-    """
-    validate_package_name(key)
-    # validate is supported content-addressed uri
-    if not is_ipfs_uri(uri):
-        raise EthPMValidationError(f"URI: {uri} is not a valid IPFS URI.")
-
-
-CONTRACT_NAME_REGEX = re.compile("^[a-zA-Z][-a-zA-Z0-9_]{0,255}$")
-
-
-def validate_contract_name(name: str) -> None:
-    if not CONTRACT_NAME_REGEX.match(name):
-        raise EthPMValidationError(f"Contract name: {name} is not valid.")

ethpm/validation/uri.py

@@ -1,163 +0,0 @@
-import hashlib
-from typing import (
-    TYPE_CHECKING,
-    List,
-)
-from urllib import (
-    parse,
-)
-
-from eth_utils import (
-    is_checksum_address,
-    to_bytes,
-    to_int,
-    to_text,
-)
-
-from ethpm._utils.chains import (
-    is_supported_chain_id,
-)
-from ethpm._utils.ipfs import (
-    is_ipfs_uri,
-)
-from ethpm._utils.registry import (
-    is_ens_domain,
-)
-from ethpm.constants import (
-    REGISTRY_URI_SCHEMES,
-)
-from ethpm.exceptions import (
-    EthPMValidationError,
-)
-from ethpm.validation.misc import (
-    validate_escaped_string,
-)
-from ethpm.validation.package import (
-    validate_package_name,
-)
-
-if TYPE_CHECKING:
-    from web3 import Web3  # noqa: F401
-
-
-def validate_ipfs_uri(uri: str) -> None:
-    """
-    Raise an exception if the provided URI is not a valid IPFS URI.
-    """
-    if not is_ipfs_uri(uri):
-        raise EthPMValidationError(f"URI: {uri} is not a valid IPFS URI.")
-
-
-def validate_registry_uri(uri: str) -> None:
-    """
-    Raise an exception if the URI does not conform to the registry URI scheme.
-    """
-    parsed = parse.urlparse(uri)
-    scheme, authority, pkg_path = (
-        parsed.scheme,
-        parsed.netloc,
-        parsed.path,
-    )
-    pkg_id = pkg_path.strip("/")
-
-    if "@" in pkg_id:
-        if len(pkg_id.split("@")) != 2:
-            raise EthPMValidationError("Registry URI: {pkg_id} is not properly escaped")
-        pkg_name, pkg_version = pkg_id.split("@")
-    else:
-        pkg_name, pkg_version = (pkg_id, None)
-
-    validate_registry_uri_scheme(scheme)
-    validate_registry_uri_authority(authority)
-    if pkg_name:
-        validate_package_name(pkg_name)
-    if not pkg_name and pkg_version:
-        raise EthPMValidationError(
-            "Registry URIs cannot provide a version without a package name."
-        )
-    if pkg_version:
-        validate_escaped_string(pkg_version)
-
-
-def validate_registry_uri_authority(auth: str) -> None:
-    """
-    Raise an exception if the authority is not a valid ENS domain
-    or a valid checksummed contract address.
-    """
-    if ":" in auth:
-        if len(auth.split(":")) != 2:
-            raise EthPMValidationError(
-                f"{auth} is not a valid registry URI authority. "
-                "Please try again with a valid registry URI."
-            )
-        address, chain_id = auth.split(":")
-    else:
-        address, chain_id = auth, "1"
-
-    if is_ens_domain(address) is False and not is_checksum_address(address):
-        raise EthPMValidationError(
-            f"{address} is not a valid registry address. "
-            "Please try again with a valid registry URI."
-        )
-
-    if not is_supported_chain_id(to_int(text=chain_id)):
-        raise EthPMValidationError(
-            f"Chain ID: {chain_id} is not supported. Supported chain ids include: "
-            "1 (mainnet), 5 (goerli), and 11155111 (sepolia)."
-            "Please try again with a valid registry URI."
-        )
-
-
-def validate_registry_uri_scheme(scheme: str) -> None:
-    """
-    Raise an exception if the scheme is not a valid registry URI scheme:
-     - 'erc1319'
-     - 'ethpm'
-    """
-    if scheme not in REGISTRY_URI_SCHEMES:
-        raise EthPMValidationError(
-            f"{scheme} is not a valid registry URI scheme. "
-            f"Valid schemes include: {REGISTRY_URI_SCHEMES}"
-        )
-
-
-def validate_single_matching_uri(all_blockchain_uris: List[str], w3: "Web3") -> str:
-    """
-    Return a single block URI after validating that it is the *only* URI in
-    all_blockchain_uris that matches the w3 instance.
-    """
-    from ethpm.uri import (
-        check_if_chain_matches_chain_uri,
-    )
-
-    matching_uris = [
-        uri for uri in all_blockchain_uris if check_if_chain_matches_chain_uri(w3, uri)
-    ]
-
-    if not matching_uris:
-        raise EthPMValidationError("Package has no matching URIs on chain.")
-    elif len(matching_uris) != 1:
-        raise EthPMValidationError(
-            f"Package has too many ({len(matching_uris)}) "
-            "matching URIs: {matching_uris}."
-        )
-    return matching_uris[0]
-
-
-def validate_blob_uri_contents(contents: bytes, blob_uri: str) -> None:
-    """
-    Raises an exception if the sha1 hash of the contents does not match the
-    hash found in the blob_uri. Formula for how git calculates the hash
-    found here: http://alblue.bandlem.com/2011/08/git-tip-of-week-objects.html
-    """
-    blob_path = parse.urlparse(blob_uri).path
-    blob_hash = blob_path.split("/")[-1]
-    contents_str = to_text(contents)
-    content_length = len(contents_str)
-    hashable_contents = "blob " + str(content_length) + "\0" + contents_str
-    hash_object = hashlib.sha1(to_bytes(text=hashable_contents))
-    if hash_object.hexdigest() != blob_hash:
-        raise EthPMValidationError(
-            f"Hash of contents fetched from {blob_uri} do not "
-            f"match its hash: {blob_hash}."
-        )

web3/_utils/caching.py

@@ -1,155 +0,0 @@
-import collections
-import hashlib
-import threading
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Callable,
-    Coroutine,
-    List,
-    Tuple,
-    TypeVar,
-    Union,
-)
-
-from eth_utils import (
-    is_boolean,
-    is_bytes,
-    is_dict,
-    is_list_like,
-    is_null,
-    is_number,
-    is_text,
-    to_bytes,
-)
-
-if TYPE_CHECKING:
-    from web3.providers import (  # noqa: F401
-        AsyncBaseProvider,
-        BaseProvider,
-    )
-    from web3.types import (  # noqa: F401
-        AsyncMakeRequestFn,
-        MakeRequestFn,
-        RPCEndpoint,
-        RPCResponse,
-    )
-
-
-SYNC_PROVIDER_TYPE = TypeVar("SYNC_PROVIDER_TYPE", bound="BaseProvider")
-ASYNC_PROVIDER_TYPE = TypeVar("ASYNC_PROVIDER_TYPE", bound="AsyncBaseProvider")
-
-
-def generate_cache_key(value: Any) -> str:
-    """
-    Generates a cache key for the *args and **kwargs
-    """
-    if is_bytes(value):
-        return hashlib.md5(value).hexdigest()
-    elif is_text(value):
-        return generate_cache_key(to_bytes(text=value))
-    elif is_boolean(value) or is_null(value) or is_number(value):
-        return generate_cache_key(repr(value))
-    elif is_dict(value):
-        return generate_cache_key(((key, value[key]) for key in sorted(value.keys())))
-    elif is_list_like(value) or isinstance(value, collections.abc.Generator):
-        return generate_cache_key("".join((generate_cache_key(item) for item in value)))
-    else:
-        raise TypeError(
-            f"Cannot generate cache key for value {value} of type {type(value)}"
-        )
-
-
-class RequestInformation:
-    def __init__(
-        self,
-        method: "RPCEndpoint",
-        params: Any,
-        response_formatters: Tuple[Callable[..., Any], ...],
-        subscription_id: str = None,
-    ):
-        self.method = method
-        self.params = params
-        self.response_formatters = response_formatters
-        self.subscription_id = subscription_id
-        self.middleware_response_processors: List[Callable[..., Any]] = []
-
-
-def is_cacheable_request(
-    provider: Union[ASYNC_PROVIDER_TYPE, SYNC_PROVIDER_TYPE], method: "RPCEndpoint"
-) -> bool:
-    if provider.cache_allowed_requests and method in provider.cacheable_requests:
-        return True
-    return False
-
-
-# -- request caching decorators -- #
-
-
-def _should_cache_response(response: "RPCResponse") -> bool:
-    return (
-        "error" not in response
-        and "result" in response
-        and not is_null(response["result"])
-    )
-
-
-def handle_request_caching(
-    func: Callable[[SYNC_PROVIDER_TYPE, "RPCEndpoint", Any], "RPCResponse"]
-) -> Callable[..., "RPCResponse"]:
-    def wrapper(
-        provider: SYNC_PROVIDER_TYPE, method: "RPCEndpoint", params: Any
-    ) -> "RPCResponse":
-        if is_cacheable_request(provider, method):
-            request_cache = provider._request_cache
-            cache_key = generate_cache_key(
-                f"{threading.get_ident()}:{(method, params)}"
-            )
-            cache_result = request_cache.get_cache_entry(cache_key)
-            if cache_result is not None:
-                return cache_result
-            else:
-                response = func(provider, method, params)
-                if _should_cache_response(response):
-                    with provider._request_cache_lock:
-                        request_cache.cache(cache_key, response)
-                return response
-        else:
-            return func(provider, method, params)
-
-    # save a reference to the decorator on the wrapped function
-    wrapper._decorator = handle_request_caching  # type: ignore
-    return wrapper
-
-
-# -- async -- #
-
-
-def async_handle_request_caching(
-    func: Callable[
-        [ASYNC_PROVIDER_TYPE, "RPCEndpoint", Any], Coroutine[Any, Any, "RPCResponse"]
-    ],
-) -> Callable[..., Coroutine[Any, Any, "RPCResponse"]]:
-    async def wrapper(
-        provider: ASYNC_PROVIDER_TYPE, method: "RPCEndpoint", params: Any
-    ) -> "RPCResponse":
-        if is_cacheable_request(provider, method):
-            request_cache = provider._request_cache
-            cache_key = generate_cache_key(
-                f"{threading.get_ident()}:{(method, params)}"
-            )
-            cache_result = request_cache.get_cache_entry(cache_key)
-            if cache_result is not None:
-                return cache_result
-            else:
-                response = await func(provider, method, params)
-                if _should_cache_response(response):
-                    async with provider._request_cache_lock:
-                        request_cache.cache(cache_key, response)
-                return response
-        else:
-            return await func(provider, method, params)
-
-    # save a reference to the decorator on the wrapped function
-    wrapper._decorator = async_handle_request_caching  # type: ignore
-    return wrapper

web3/_utils/contract_sources/contract_data/address_reflector.py

@@ -1,29 +0,0 @@
-"""
-Generated by `compile_contract_sources.py` script.
-Compiled with Solidity v0.8.17.
-"""
-
-# source: web3/_utils/contract_sources/AddressReflector.sol:AddressReflector
-ADDRESS_REFLECTOR_BYTECODE = "0x608060405234801561001057600080fd5b50610430806100206000396000f3fe608060405234801561001057600080fd5b50600436106100365760003560e01c80630b816c161461003b578063c04d11fc1461006b575b600080fd5b61005560048036038101906100509190610121565b61009b565b604051610062919061015d565b60405180910390f35b610085600480360381019061008091906102d1565b6100a5565b60405161009291906103d8565b60405180910390f35b6000819050919050565b6060819050919050565b6000604051905090565b600080fd5b600080fd5b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b60006100ee826100c3565b9050919050565b6100fe816100e3565b811461010957600080fd5b50565b60008135905061011b816100f5565b92915050565b600060208284031215610137576101366100b9565b5b60006101458482850161010c565b91505092915050565b610157816100e3565b82525050565b6000602082019050610172600083018461014e565b92915050565b600080fd5b6000601f19601f8301169050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b6101c68261017d565b810181811067ffffffffffffffff821117156101e5576101e461018e565b5b80604052505050565b60006101f86100af565b905061020482826101bd565b919050565b600067ffffffffffffffff8211156102245761022361018e565b5b602082029050602081019050919050565b600080fd5b600061024d61024884610209565b6101ee565b905080838252602082019050602084028301858111156102705761026f610235565b5b835b818110156102995780610285888261010c565b845260208401935050602081019050610272565b5050509392505050565b600082601f8301126102b8576102b7610178565b5b81356102c884826020860161023a565b91505092915050565b6000602082840312156102e7576102e66100b9565b5b600082013567ffffffffffffffff811115610305576103046100be565b5b610311848285016102a3565b91505092915050565b600081519050919050565b600082825260208201905092915050565b6000819050602082019050919050565b61034f816100e3565b82525050565b60006103618383610346565b60208301905092915050565b6000602082019050919050565b60006103858261031a565b61038f8185610325565b935061039a83610336565b8060005b838110156103cb5781516103b28882610355565b97506103bd8361036d565b92505060018101905061039e565b5085935050505092915050565b600060208201905081810360008301526103f2818461037a565b90509291505056fea264697066735822122035083763a0f4c4f5a71055f0da2f3d4f78e64159a8f3bc215c430daec7ac5e2064736f6c63430008110033"  # noqa: E501
-ADDRESS_REFLECTOR_RUNTIME = "0x608060405234801561001057600080fd5b50600436106100365760003560e01c80630b816c161461003b578063c04d11fc1461006b575b600080fd5b61005560048036038101906100509190610121565b61009b565b604051610062919061015d565b60405180910390f35b610085600480360381019061008091906102d1565b6100a5565b60405161009291906103d8565b60405180910390f35b6000819050919050565b6060819050919050565b6000604051905090565b600080fd5b600080fd5b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b60006100ee826100c3565b9050919050565b6100fe816100e3565b811461010957600080fd5b50565b60008135905061011b816100f5565b92915050565b600060208284031215610137576101366100b9565b5b60006101458482850161010c565b91505092915050565b610157816100e3565b82525050565b6000602082019050610172600083018461014e565b92915050565b600080fd5b6000601f19601f8301169050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b6101c68261017d565b810181811067ffffffffffffffff821117156101e5576101e461018e565b5b80604052505050565b60006101f86100af565b905061020482826101bd565b919050565b600067ffffffffffffffff8211156102245761022361018e565b5b602082029050602081019050919050565b600080fd5b600061024d61024884610209565b6101ee565b905080838252602082019050602084028301858111156102705761026f610235565b5b835b818110156102995780610285888261010c565b845260208401935050602081019050610272565b5050509392505050565b600082601f8301126102b8576102b7610178565b5b81356102c884826020860161023a565b91505092915050565b6000602082840312156102e7576102e66100b9565b5b600082013567ffffffffffffffff811115610305576103046100be565b5b610311848285016102a3565b91505092915050565b600081519050919050565b600082825260208201905092915050565b6000819050602082019050919050565b61034f816100e3565b82525050565b60006103618383610346565b60208301905092915050565b6000602082019050919050565b60006103858261031a565b61038f8185610325565b935061039a83610336565b8060005b838110156103cb5781516103b28882610355565b97506103bd8361036d565b92505060018101905061039e565b5085935050505092915050565b600060208201905081810360008301526103f2818461037a565b90509291505056fea264697066735822122035083763a0f4c4f5a71055f0da2f3d4f78e64159a8f3bc215c430daec7ac5e2064736f6c63430008110033"  # noqa: E501
-ADDRESS_REFLECTOR_ABI = [
-    {
-        "inputs": [{"internalType": "address", "name": "arg", "type": "address"}],
-        "name": "reflect",
-        "outputs": [{"internalType": "address", "name": "", "type": "address"}],
-        "stateMutability": "pure",
-        "type": "function",
-    },
-    {
-        "inputs": [{"internalType": "address[]", "name": "arg", "type": "address[]"}],
-        "name": "reflect",
-        "outputs": [{"internalType": "address[]", "name": "", "type": "address[]"}],
-        "stateMutability": "pure",
-        "type": "function",
-    },
-]
-ADDRESS_REFLECTOR_DATA = {
-    "bytecode": ADDRESS_REFLECTOR_BYTECODE,
-    "bytecode_runtime": ADDRESS_REFLECTOR_RUNTIME,
-    "abi": ADDRESS_REFLECTOR_ABI,
-}