Add abi attribute for ContractFunction

Author: tibor-reiss

newsfragments/3626.feature.rst

@@ -0,0 +1 @@
+Add abi property stateMutability to the ``ContractFunction`` object as ``state_mutability``.

tests/core/contracts/test_contract_example.py

@@ -112,6 +112,11 @@ def test_updating_greeting_emits_event(w3, foo_contract):
     assert event.args._bar == "testing contracts is easy"
 
 
+def test_abi_state_mutability(w3, foo_contract):
+    assert foo_contract.functions.setBar.state_mutability == "nonpayable"
+    assert foo_contract.functions.bar.state_mutability == "view"
+
+
 @pytest.fixture
 def async_eth_tester():
     return AsyncEthereumTesterProvider().ethereum_tester

web3/contract/base_contract.py

@@ -596,6 +596,12 @@ def __init__(self, abi: Optional[ABIFunction] = None) -> None:
         self.argument_names = tuple([input.get("name", None) for input in event_inputs])
         self.argument_types = tuple([input["type"] for input in event_inputs])
 
+    @property
+    def state_mutability(self) -> Optional[str]:
+        if self.abi is None:
+            return None
+        return self.abi.get("stateMutability")
+
     @combomethod
     def _get_abi(cls) -> ABIFunction:
         if not cls.args and not cls.kwargs: