Merge pull request #1767 from BobTheBuidler/patch-1

feat: add `eager_caching: true` to default-config.yaml

brownie/data/default-config.yaml

@@ -71,3 +71,4 @@ hypothesis:
 autofetch_sources: false
 dependencies: null
 dev_deployment_artifacts: false
+eager_caching: true

brownie/network/middlewares/caching.py

@@ -117,6 +117,9 @@ def start_block_filter_loop(self):
 
     @classmethod
     def get_layer(cls, w3: Web3, network_type: str) -> Optional[int]:
+        if CONFIG.settings['eager_caching'] is False:
+            # do not cache when user doesn't want it
+            return None
         if network_type != "live":
             # do not cache on development chains
             return None

docs/config.rst

@@ -390,3 +390,10 @@ Other Settings
     .. code-block:: yaml
 
         dotenv: .env
+
+.. py:attribute:: eager_caching
+    If set to ``false``, brownie will not start the background caching thread and will only call the RPC on an as-needed basis.
+
+    This is useful for always-on services or while using pay-as-you-go private RPCs
+
+    default value: ``true``