More doc cleanup

eth_defi/enzyme/utils.py

@@ -39,6 +39,7 @@
 
 
 def convert_rate_to_scaled_per_second_rate(rate: Decimal, adjust_inflation: bool) -> int:
+    """Internal helper to deal with Enzyme per second rates."""
     rate_d = rate * 10**18
     effective_rate = rate_d / (1 - rate_d) if adjust_inflation else rate_d
     factor = (1 + effective_rate) ** (1 / ONE_YEAR_IN_SECONDS)

eth_defi/provider/multi_provider.py

@@ -1,6 +1,6 @@
 """Configuring and managing multiple JSON-RPC provider connections.
 
-See :ref:`multi rpc` for details.
+See :ref:`multi rpc` tutorial for details.
 """
 
 import logging
@@ -26,10 +26,11 @@ class MultiProviderConfigurationError(Exception):
 class MultiProviderWeb3(Web3):
     """A web3 instance that knows about multiple RPC endpoints it is using.
 
-    - This is either using or not using :py:class:`eth_defi.provider.mev_blocker.MEVBlockerProvider`
+    - Can use :py:class:`eth_defi.provider.mev_blocker.MEVBlockerProvider`
       for making transactions to prevent frontrunning
 
-    - There might be several providers for reading on-chain data
+    - There might be several call (read) providers for reading on-chain data
+      with fallbacks using :py:class:`eth_defi.provider.fallback.FallbackProvider`
 
     See
 
@@ -121,7 +122,7 @@ def create_multi_provider_web3(
 
     See
 
-    - - :ref:`multi rpc` for details
+    - :ref:`multi rpc` for details
 
     :param configuration_line:
         Configuration line from an environment variable, config file or similar.

eth_defi/usdc/eip_3009.py

@@ -175,7 +175,7 @@ def make_eip_3009_transfer(
         This currently supports only `LocalAccount` because of
         `missing features in web3.py <https://github.com/ethereum/web3.py/issues/2180#issuecomment-943590192>`__.
 
-    Example::
+    Example:
 
     .. code-block:: python