Add error formatters to raise on block not found errors

Author: fselmo

web3/_utils/error_formatters_utils.py

@@ -8,6 +8,7 @@
 )
 
 from web3.exceptions import (
+    BlockNotFound,
     ContractCustomError,
     ContractLogicError,
     ContractPanicError,
@@ -185,3 +186,19 @@ def raise_transaction_indexing_error_if_indexing(response: RPCResponse) -> RPCRe
                 raise TransactionIndexingInProgress(message)
 
     return response
+
+
+def raise_block_not_found_on_error(response: RPCResponse) -> RPCResponse:
+    """
+    Raise ``BlockNotFound`` on specific error message(s).
+    """
+    error = response.get("error")
+    if not isinstance(error, str) and error is not None:
+        message = error.get("message")
+        if message is not None:
+            if "not found" in message.lower() and any(
+                key in message.lower() for key in ("block", "header")
+            ):
+                raise BlockNotFound(message)
+
+    return response

web3/_utils/method_formatters.py

@@ -55,6 +55,7 @@
     is_length,
 )
 from web3._utils.error_formatters_utils import (
+    raise_block_not_found_on_error,
     raise_contract_logic_error_on_revert,
     raise_transaction_indexing_error_if_indexing,
 )
@@ -1092,6 +1093,7 @@ def subscription_formatter(value: Any) -> Union[HexBytes, HexStr, Dict[str, Any]
     RPC.eth_estimateGas: raise_contract_logic_error_on_revert,
     RPC.eth_call: raise_contract_logic_error_on_revert,
     RPC.eth_getTransactionReceipt: raise_transaction_indexing_error_if_indexing,
+    RPC.eth_getBlockReceipts: raise_block_not_found_on_error,
 }