Add static methods for converting to and from wei with decimals

docs/web3.main.rst

@@ -324,6 +324,30 @@ Currency Conversions
         Decimal('1')
 
 
+.. py:method:: Web3.to_wei_decimals(value, decimals)
+
+    Returns the value in the denomination specified by the ``decimals`` argument
+    converted to wei.
+
+
+    .. code-block:: python
+
+        >>> Web3.to_wei_decimals(1, 18)
+        1000000000000000000
+
+
+.. py:method:: Web3.from_wei_decimals(value, decimals)
+
+    Returns the value in wei converted to the given number of decimals. The value is returned
+    as a ``Decimal`` to ensure precision down to the wei.
+
+
+    .. code-block:: python
+
+        >>> Web3.from_wei_decimals(1000000000000000000, 18)
+        Decimal('1')
+
+
 .. _overview_addresses:
 
 Addresses

newsfragments/3768.feature.rst

@@ -0,0 +1 @@
+Add static methods for converting to and from wei with decimals

web3/main.py

@@ -14,6 +14,7 @@
     add_0x_prefix,
     apply_to_return_value,
     from_wei,
+    from_wei_decimals,
     is_address,
     is_checksum_address,
     keccak as eth_utils_keccak,
@@ -23,6 +24,7 @@
     to_int,
     to_text,
     to_wei,
+    to_wei_decimals,
 )
 from functools import (
     wraps,
@@ -261,6 +263,18 @@ def to_wei(number: Union[int, float, str, decimal.Decimal], unit: str) -> Wei:
     def from_wei(number: int, unit: str) -> Union[int, decimal.Decimal]:
         return from_wei(number, unit)
 
+    @staticmethod
+    @wraps(to_wei_decimals)
+    def to_wei_decimals(
+        number: Union[int, float, str, decimal.Decimal], decimals: int
+    ) -> Wei:
+        return cast(Wei, to_wei_decimals(number, decimals))
+
+    @staticmethod
+    @wraps(from_wei_decimals)
+    def from_wei_decimals(number: int, decimals: int) -> Union[int, decimal.Decimal]:
+        return from_wei_decimals(number, decimals)
+
     # Address Utility
     @staticmethod
     @wraps(is_address)