faster-eth-abi 5.2.22__cp313-cp313-macosx_11_0_arm64.whl

faster_eth_abi/utils/numeric.py

@@ -0,0 +1,117 @@
+import decimal
+from typing import (
+    Callable,
+    Dict,
+    Final,
+    Tuple,
+)
+
+ABI_DECIMAL_PREC: Final = 999
+
+abi_decimal_context: Final = decimal.Context(prec=ABI_DECIMAL_PREC)
+decimal_localcontext: Final = decimal.localcontext
+
+ZERO: Final = decimal.Decimal(0)
+TEN: Final = decimal.Decimal(10)
+
+Decimal: Final = decimal.Decimal
+
+
+def ceil32(x: int) -> int:
+    remainder = x % 32
+    return x if remainder == 0 else x + 32 - remainder
+
+
+_unsigned_integer_bounds_cache: Final[Dict[int, Tuple[int, int]]] = {}
+
+
+def compute_unsigned_integer_bounds(num_bits: int) -> Tuple[int, int]:
+    bounds = _unsigned_integer_bounds_cache.get(num_bits)
+    if bounds is None:
+        bounds = 0, 2**num_bits - 1
+        _unsigned_integer_bounds_cache[num_bits] = bounds
+    return bounds
+
+
+_signed_integer_bounds_cache: Final[Dict[int, Tuple[int, int]]] = {}
+
+
+def compute_signed_integer_bounds(num_bits: int) -> Tuple[int, int]:
+    bounds = _signed_integer_bounds_cache.get(num_bits)
+    if bounds is None:
+        overflow_at = 2 ** (num_bits - 1)
+        min_value = -overflow_at
+        max_value = overflow_at - 1
+        bounds = min_value, max_value
+        _signed_integer_bounds_cache[num_bits] = bounds
+    return bounds
+
+
+_unsigned_fixed_bounds_cache: Final[Dict[Tuple[int, int], decimal.Decimal]] = {}
+
+
+def compute_unsigned_fixed_bounds(
+    num_bits: int,
+    frac_places: int,
+) -> Tuple[decimal.Decimal, decimal.Decimal]:
+    upper = _unsigned_fixed_bounds_cache.get((num_bits, frac_places))
+    if upper is None:
+        int_upper = 2**num_bits - 1
+
+        with decimal_localcontext(abi_decimal_context):
+            upper = Decimal(int_upper) * TEN**-frac_places
+
+        _unsigned_fixed_bounds_cache[(num_bits, frac_places)] = upper
+
+    return ZERO, upper
+
+
+_signed_fixed_bounds_cache: Final[
+    Dict[Tuple[int, int], Tuple[decimal.Decimal, decimal.Decimal]]
+] = {}
+
+
+def compute_signed_fixed_bounds(
+    num_bits: int,
+    frac_places: int,
+) -> Tuple[decimal.Decimal, decimal.Decimal]:
+    bounds = _signed_fixed_bounds_cache.get((num_bits, frac_places))
+    if bounds is None:
+        int_lower, int_upper = compute_signed_integer_bounds(num_bits)
+
+        with decimal_localcontext(abi_decimal_context):
+            exp = TEN**-frac_places
+            lower = Decimal(int_lower) * exp
+            upper = Decimal(int_upper) * exp
+
+        bounds = lower, upper
+        _signed_fixed_bounds_cache[(num_bits, frac_places)] = bounds
+
+    return bounds
+
+
+def scale_places(places: int) -> Callable[[decimal.Decimal], decimal.Decimal]:
+    """
+    Returns a function that shifts the decimal point of decimal values to the
+    right by ``places`` places.
+    """
+    if not isinstance(places, int):
+        raise ValueError(
+            f"Argument `places` must be int.  Got value {places} "
+            f"of type {type(places)}.",
+        )
+
+    with decimal_localcontext(abi_decimal_context):
+        scaling_factor = TEN**-places
+
+    def f(x: decimal.Decimal) -> decimal.Decimal:
+        with decimal_localcontext(abi_decimal_context):
+            return x * scaling_factor
+
+    places_repr = f"Eneg{places}" if places > 0 else f"Epos{-places}"
+    func_name = f"scale_by_{places_repr}"
+
+    f.__name__ = func_name
+    f.__qualname__ = func_name
+
+    return f

faster_eth_abi/utils/padding.py

@@ -0,0 +1,22 @@
+def zpad(value: bytes, length: int) -> bytes:
+    return value.rjust(length, b"\x00")
+
+
+def zpad32(value: bytes) -> bytes:
+    return zpad(value, length=32)
+
+
+def zpad_right(value: bytes, length: int) -> bytes:
+    return value.ljust(length, b"\x00")
+
+
+def zpad32_right(value: bytes) -> bytes:
+    return zpad_right(value, length=32)
+
+
+def fpad(value: bytes, length: int) -> bytes:
+    return value.rjust(length, b"\xff")
+
+
+def fpad32(value: bytes) -> bytes:
+    return fpad(value, length=32)

faster_eth_abi/utils/string.py

@@ -0,0 +1,19 @@
+from typing import (
+    Any,
+)
+
+
+def abbr(value: Any, limit: int = 79) -> str:
+    """
+    Converts a value into its string representation and abbreviates that
+    representation based on the given length `limit` if necessary.
+    """
+    rep = repr(value)
+
+    if len(rep) > limit:
+        if limit < 3:
+            raise ValueError("Abbreviation limit may not be less than 3")
+
+        rep = rep[: limit - 3] + "..."
+
+    return rep

faster_eth_abi/utils/validation.py

@@ -0,0 +1,18 @@
+from typing import (
+    Any,
+)
+
+
+def validate_bytes_param(param: Any, param_name: str) -> None:
+    if not isinstance(param, (bytes, bytearray)):
+        raise TypeError(
+            f"The `{param_name}` value must be of bytes type. Got {type(param)}"
+        )
+
+
+def validate_list_like_param(param: Any, param_name: str) -> None:
+    if not isinstance(param, (list, tuple)):
+        raise TypeError(
+            f"The `{param_name}` value type must be one of list or tuple. "
+            f"Got {type(param)}"
+        )

faster_eth_abi-5.2.22.dist-info/METADATA

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: faster_eth_abi
+Version: 5.2.22
+Summary: A ~2-6x faster fork of eth_abi: Python utilities for working with Ethereum ABI definitions, especially encoding and decoding. Implemented in C.
+Home-page: https://github.com/BobTheBuidler/faster-eth-abi
+Author: The Ethereum Foundation
+Author-email: snakecharmers@ethereum.org
+License: MIT
+Project-URL: Documentation, https://eth-abi.readthedocs.io/en/stable/
+Project-URL: Release Notes, https://github.com/BobTheBuidler/faster-eth-abi/releases
+Project-URL: Issues, https://github.com/BobTheBuidler/faster-eth-abi/issues
+Project-URL: Source - Precompiled (.py), https://github.com/BobTheBuidler/faster-eth-utils/tree/master/faster_eth_utils
+Project-URL: Source - Compiled (.c), https://github.com/BobTheBuidler/faster-eth-utils/tree/master/build
+Project-URL: Benchmarks, https://github.com/BobTheBuidler/faster-eth-utils/tree/master/benchmarks
+Project-URL: Benchmarks - Results, https://github.com/BobTheBuidler/faster-eth-utils/tree/master/benchmarks/results
+Project-URL: Original, https://github.com/ethereum/eth-abi
+Keywords: ethereum
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Requires-Python: >=3.8, <4
+Description-Content-Type: text/markdown
+Requires-Dist: cchecksum<0.4,>=0.3.7.dev0
+Requires-Dist: faster-eth-utils==5.3.20
+Requires-Dist: eth-abi==5.2.0
+Requires-Dist: eth-typing==5.2.1
+Requires-Dist: mypy_extensions
+Requires-Dist: parsimonious<0.11.0,>=0.10.0
+Provides-Extra: dev
+Requires-Dist: mypy<1.18.3,>=1.14.1; extra == "dev"
+Requires-Dist: tqdm; extra == "dev"
+Requires-Dist: build>=0.9.0; extra == "dev"
+Requires-Dist: bump_my_version>=0.19.0; extra == "dev"
+Requires-Dist: ipython; extra == "dev"
+Requires-Dist: mypy<1.18.3,>=1.14.1; extra == "dev"
+Requires-Dist: pre-commit>=3.4.0; extra == "dev"
+Requires-Dist: tox>=4.0.0; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+Requires-Dist: pytest-benchmark; 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<26,>=24; extra == "dev"
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: hypothesis<6.108.7,>=6.22.0; extra == "dev"
+Requires-Dist: pytest-timeout>=2.0.0; extra == "dev"
+Requires-Dist: pytest-xdist>=2.4.0; extra == "dev"
+Requires-Dist: pytest-pythonpath>=0.7.1; extra == "dev"
+Requires-Dist: eth-hash[pycryptodome]; 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<26,>=24; extra == "docs"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: hypothesis<6.108.7,>=6.22.0; extra == "test"
+Requires-Dist: pytest-timeout>=2.0.0; extra == "test"
+Requires-Dist: pytest-xdist>=2.4.0; extra == "test"
+Requires-Dist: pytest-pythonpath>=0.7.1; extra == "test"
+Requires-Dist: eth-hash[pycryptodome]; extra == "test"
+Provides-Extra: tools
+Requires-Dist: hypothesis<6.108.7,>=6.22.0; extra == "tools"
+Provides-Extra: codspeed
+Requires-Dist: pytest>=7.0.0; extra == "codspeed"
+Requires-Dist: pytest-codspeed<4.3,>=4.2; extra == "codspeed"
+Requires-Dist: pytest-test-groups; extra == "codspeed"
+Provides-Extra: benchmark
+Requires-Dist: pytest>=7.0.0; extra == "benchmark"
+Requires-Dist: pytest-codspeed<4.3,>=4.2; extra == "benchmark"
+Requires-Dist: pytest-test-groups; extra == "benchmark"
+Provides-Extra: mypy
+Requires-Dist: mypy<1.18.3,>=1.14.1; extra == "mypy"
+Requires-Dist: tqdm; extra == "mypy"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+### I forked eth-abi, added comprehensive type annotations, and compiled it to C. It does the same stuff, now ~2-6x faster.
+
+[![PyPI](https://img.shields.io/pypi/v/faster-eth-abi.svg?logo=Python&logoColor=white)](https://pypi.org/project/faster-eth-abi/)
+[![Monthly Downloads](https://img.shields.io/pypi/dm/faster-eth-abi)](https://pypistats.org/packages/faster-eth-abi)
+[![Codspeed.io Status](https://img.shields.io/endpoint?url=https://codspeed.io/badge.json)](https://codspeed.io/BobTheBuidler/faster-eth-abi)
+
+##### This fork will be kept up-to-date with [eth-abi](https://github.com/ethereum/eth-abi). I will pull updates as they are released and push new [faster-eth-abi](https://github.com/BobTheBuidler/faster-eth-abi) releases to [PyPI](https://pypi.org/project/faster-eth-abi/).
+
+##### Starting in [v5.2.12](https://github.com/BobTheBuidler/faster-eth-abi/releases/tag/v5.2.12), all `faster-eth-abi` Exception classes inherit from the matching Exception class in `eth-abi`, so porting to `faster-eth-abi` does not require any change to your existing exception handlers. All existing exception handling in your codebase will continue to work as it did when originaly implemented.
+
+##### We benchmark `faster-eth-abi` against the original `eth-abi` for your convenience. [See results](https://github.com/BobTheBuidler/faster-eth-abi/tree/master/benchmarks/results).
+
+##### You can find the compiled C code and header files in the [build](https://github.com/BobTheBuidler/faster-eth-abi/tree/master/build) directory.
+
+###### You may also be interested in: [faster-web3.py](https://github.com/BobTheBuidler/faster-web3.py/), [faster-hexbytes](https://github.com/BobTheBuidler/faster-hexbytes/), and [faster-eth-utils](https://github.com/BobTheBuidler/faster-eth-utils/)
+
+##### The original eth-abi readme is below:
+
+# Ethereum Contract Interface (ABI) Utility
+
+[![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/faster-eth-abi.svg?style=shield)](https://circleci.com/gh/ethereum/faster-eth-abi)
+[![PyPI version](https://badge.fury.io/py/faster-eth-abi.svg)](https://badge.fury.io/py/faster-eth-abi)
+[![Python versions](https://img.shields.io/pypi/pyversions/faster-eth-abi.svg)](https://pypi.python.org/pypi/faster-eth-abi)
+[![Docs build](https://readthedocs.org/projects/faster-eth-abi/badge/?version=latest)](https://faster-eth-abi.readthedocs.io/en/latest/?badge=latest)
+
+Python utilities for working with Ethereum ABI definitions, especially encoding and decoding
+
+Read the [documentation](https://faster-eth-abi.readthedocs.io/).
+
+View the [change log](https://faster-eth-abi.readthedocs.io/en/latest/release_notes.html).
+
+## Installation
+
+```sh
+python -m pip install faster-eth-abi
+```

faster_eth_abi-5.2.22.dist-info/RECORD

@@ -0,0 +1,46 @@
+faster_eth_abi__mypyc.cpython-313-darwin.so,sha256=It4oE8d7QfNCnwQELdgGcZBrVzY_uIqm-ywbCByT3KE,719352
+faster_eth_abi/abi.cpython-313-darwin.so,sha256=VlXhIWbXiXjH-8UYQj3dqBZTJD73W-SQ1jYSFMoraEY,50632
+faster_eth_abi/constants.cpython-313-darwin.so,sha256=hlPEvDY_IsByEZ4JGN2L4Dxzw8t7RhFpgEIsEOSgTYM,50656
+faster_eth_abi/_encoding.py,sha256=HXGg3nv3i67LRd96j8KMvJ-f15lgqbgKQiJgrw_YVA8,13190
+faster_eth_abi/_codec.cpython-313-darwin.so,sha256=x897nianHsD638-beH9qyUY92Dn4BewT50AwWfaNU-4,50640
+faster_eth_abi/packed.py,sha256=YN1k8heenRMVQQsPEKAYfpd1XhWNF3mOn4sbaR4HiYE,418
+faster_eth_abi/encoding.py,sha256=zWtt2TKEfmdeQ3kHtz5lRJZCCzuMO0il8BtMHmTBu1g,21381
+faster_eth_abi/_grammar.cpython-313-darwin.so,sha256=B-8SWStna9IXB2UNR9H2SKr2U40GcizNFrM25den0t0,50656
+faster_eth_abi/registry.py,sha256=zIZOlhaSoKsLxDw6UWBiS1xvspm9wDzu6t5LUbgvZ3c,23840
+faster_eth_abi/_decoding.py,sha256=EXzYr_fTnzieWBLBivCSlgDwcHBmnRoxlrB2dChZX6s,9913
+faster_eth_abi/constants.py,sha256=uJbuND1rFs_Pexuz58TKd-BJPuoA6hLqFEX6kkDS-dE,107
+faster_eth_abi/io.py,sha256=BcSNri4jEpw2DKzpwAlr-0HNqcGfDE5fbynEzT1EvNw,3885
+faster_eth_abi/_encoding.cpython-313-darwin.so,sha256=Xl9cpxPIP-Mgju3NXUBSfrTa_ugun5H0PfkuJKsD3O4,50656
+faster_eth_abi/__init__.py,sha256=55jGpiVbsTGNu-c_rr-wwyH3eqEv9MELSTWa4AMiKvU,205
+faster_eth_abi/_grammar.py,sha256=31Eu5ZMoR2oa7Lpd8M0kfLJ9rUX2qEkKxMN5rAUSAuc,10912
+faster_eth_abi/decoding.py,sha256=kYFsCXgLhyOJK2GlbLeVcyul4yOAA1Lle4mRs_hfy7Y,17565
+faster_eth_abi/grammar.py,sha256=EXxzpdPuzXfBhUxYmZfR0R8gtBK77CDnE0fkAAE6cTE,4521
+faster_eth_abi/from_type_str.py,sha256=U3Xl7zjRL4C7J0t1aGBpBzhEqGo7BS8sxLYnF5pBu4Y,4490
+faster_eth_abi/from_type_str.cpython-313-darwin.so,sha256=G3hdsw-TJwTZfj4WfHo7pnkVR7et0tjS3vjIOORIGHc,50672
+faster_eth_abi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+faster_eth_abi/abi.py,sha256=HzkXy0EjHraNbbC5l-EhVqVcx5vy8tcykiKIO4Fp1xw,366
+faster_eth_abi/exceptions.py,sha256=I_uWNRq8a1UcWNahYDBJd1rKbET1bYTiTbDf3R4eFOI,3646
+faster_eth_abi/_codec.py,sha256=D_Vn5gtUWZi2ltiqKfH5qm5xr1w8k9CAwDRWSnzOINE,2514
+faster_eth_abi/typing.py,sha256=FIMFquzJeZrL6qslWhMlfdRbO95P851gt2lt3T5S16E,105020
+faster_eth_abi/codec.py,sha256=A04ZzXppz3QK0RzZcsDMoYxuH1eGx6fzOqGGGdNu62c,66624
+faster_eth_abi/base.py,sha256=j7IVwKBATnjfOnA58FjhPH94KibVkuWsAMBe6fsNiI8,1337
+faster_eth_abi/packed.cpython-313-darwin.so,sha256=MRDbhbinOBRlO-d4w2rTVontjKFOHRtGzjFYig9AHsg,50640
+faster_eth_abi/_decoding.cpython-313-darwin.so,sha256=beVRuP0McEsNHGcldAB9BJgvgbeSTHLsYLhdp7IYugA,50656
+faster_eth_abi/tools/__init__.cpython-313-darwin.so,sha256=od8yKjFFPQBfC3FIgLZe5XlnRgUALCKGqCg0UM6XBJQ,50640
+faster_eth_abi/tools/_strategies.py,sha256=csDbLq2jKEKWyyzRKE3OGvUWnVsvEyYd3vvtE0JjX1o,6138
+faster_eth_abi/tools/__init__.py,sha256=trtATEmgu4ctg04qkejbODDzvDSofgcVJ3rkzMP_hQE,51
+faster_eth_abi/tools/_strategies.cpython-313-darwin.so,sha256=nz8W-d9rMGgKSY-BpFcSC-P_iwVXEJGo4tVcK1V56q0,50672
+faster_eth_abi/utils/validation.cpython-313-darwin.so,sha256=6RwzzmfDZC6jy6WJOh-n_x1zkUpwqv9VBj4uxsrHQUk,50672
+faster_eth_abi/utils/__init__.cpython-313-darwin.so,sha256=1knvruuvC419OoI6zgxvfMAALx-gXrcpZWXlYKx1vVE,50640
+faster_eth_abi/utils/numeric.cpython-313-darwin.so,sha256=qRIioYBQRFQu9DMg-apPXQ9DODzQn8PBWOHBi8Bff-w,50656
+faster_eth_abi/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+faster_eth_abi/utils/padding.cpython-313-darwin.so,sha256=ypXlmJrnRZ9sGIJfZ_ENiw2lDUWV-4PHGlkf3y5jwyo,50656
+faster_eth_abi/utils/numeric.py,sha256=fkdazLcgd7FN0JGSSyb6Jsx555QdgRf2N0mxrm6rGB4,3278
+faster_eth_abi/utils/string.cpython-313-darwin.so,sha256=uCnbF5SG8GTJRG2DKwvKc1-oPdWjer4bSiNugmrqTT4,50656
+faster_eth_abi/utils/string.py,sha256=fjsAR2C7Xlu5bHomxx5l4rlADFtByzGTQfugMTo8TQk,436
+faster_eth_abi/utils/padding.py,sha256=JBuFhdrvKWLrmmJBZ-a6pqbHWydAuiUBt2aBjCwVcVE,493
+faster_eth_abi/utils/validation.py,sha256=NA2wRacYEBdkpQnZfmeDvzF-sHyy6NT2QzCFuBnYJVI,521
+faster_eth_abi-5.2.22.dist-info/RECORD,,
+faster_eth_abi-5.2.22.dist-info/WHEEL,sha256=oqGJCpG61FZJmvyZ3C_0aCv-2mdfcY9e3fXvyUNmWfM,136
+faster_eth_abi-5.2.22.dist-info/top_level.txt,sha256=Y0kTTMPnPpssaR0jlmJwQ2XbkYXMEj_80Ewd7quo1Cg,37
+faster_eth_abi-5.2.22.dist-info/METADATA,sha256=vO5dv_kLvAaItmsrOrmTNjKXPf-7uLQUylLd0Lfa78U,7402

faster_eth_abi-5.2.22.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp313-cp313-macosx_11_0_arm64
+Generator: delocate 0.13.0
+

faster_eth_abi-5.2.22.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+faster_eth_abi
+faster_eth_abi__mypyc