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``