iwa 0.0.61__py3-none-any.whl → 0.0.64__py3-none-any.whl

{iwa-0.0.61.dist-info → iwa-0.0.64.dist-info}/RECORD

@@ -23,7 +23,7 @@ iwa/core/utils.py,sha256=FTYpIdQ1wnugD4lYU4TQ7d7_TlDs4CTUIhEpHGEJph4,4281
 iwa/core/wallet.py,sha256=xSGFOK5Wzh-ctLGhBMK1BySlXN0Ircpztyk1an21QiQ,13129
 iwa/core/chain/__init__.py,sha256=XJMmn0ed-_aVkY2iEMKpuTxPgIKBd41dexSVmEZTa-o,1604
 iwa/core/chain/errors.py,sha256=9SEbhxZ-qASPkzt-DoI51qq0GRJVqRgqgL720gO7a64,1275
-iwa/core/chain/interface.py,sha256=4VA2qRUZ40J38l7edaeGTlOnwcXLxZxFPo1Flitzl3M,28270
+iwa/core/chain/interface.py,sha256=lW8jmxQNVrUeoBUuYUx9X5kwUhr-Xw3MHS1RsGQeaRQ,29064
 iwa/core/chain/manager.py,sha256=XHwn7ciapFCZVk0rPSJopUqM5Wu3Kpp6XrenkgTE1HA,1397
 iwa/core/chain/models.py,sha256=WUhAighMKcFdbAUkPU_3dkGbWyAUpRJqXMHLcWFC1xg,5261
 iwa/core/chain/rate_limiter.py,sha256=Ps1MrR4HHtylxgUAawe6DoC9tuqKagjQdKulqcJD2gs,9093
@@ -41,7 +41,7 @@ iwa/core/services/account.py,sha256=0l14qD8_-ZbN_hQUNa7bRZt0tkceHPPc4GHmB8UKqy4,
 iwa/core/services/balance.py,sha256=MSCEzPRDPlHIjaWD1A2X2oIuiMz5MFJjD7sSHUxQ8OM,3324
 iwa/core/services/plugin.py,sha256=GNNlbtELyHl7MNVChrypF76GYphxXduxDog4kx1MLi8,3277
 iwa/core/services/safe.py,sha256=vqvpk7aIqHljaG1zYYpmKdW4mi5OVuoyXcpReISPYM0,15744
-iwa/core/services/safe_executor.py,sha256=e7M4Z0w00W5H88I1Yf2qQGP_orI5FDDVSzgilhJaeQo,13509
+iwa/core/services/safe_executor.py,sha256=TqpDgtvh8d5cedYAKBj7s1SW7EnomTT9MW_GnYWMxDE,17157
 iwa/core/services/transaction.py,sha256=FrGRWn1xo5rbGIr2ToZ2kPzapr3zmWW38oycyB87TK8,19971
 iwa/core/services/transfer/__init__.py,sha256=ZJfshFxJRsp8rkOqfVvd1cqEzIJ9tqBJh8pc0l90GLk,5576
 iwa/core/services/transfer/base.py,sha256=sohz-Ss2i-pGYGl4x9bD93cnYKcSvsXaXyvyRawvgQs,9043
@@ -70,7 +70,7 @@ iwa/plugins/olas/constants.py,sha256=BbEDho_TAh10cCGsrlk2vP1OVrS_ZWBE_cAEITd_658
 iwa/plugins/olas/events.py,sha256=HHjYu4pN3tuZATIh8vGWWzDb7z9wuqhsaTqI3_4H0-I,6086
 iwa/plugins/olas/importer.py,sha256=5xTtlQe5hO5bUCOg1sRuFkN2UcohYdJEQwfMm2JckyI,42088
 iwa/plugins/olas/mech_reference.py,sha256=CaSCpQnQL4F7wOG6Ox6Zdoy-uNEQ78YBwVLILQZKL8Q,5782
-iwa/plugins/olas/models.py,sha256=uXih8UcmBYj6PlxqP-cnyAiazJezjShjkCaN1Kqlb2I,4921
+iwa/plugins/olas/models.py,sha256=VtDjSyc63Yxs3aManmALrcf7asehdQ5f-5Y6MtAdWIk,4056
 iwa/plugins/olas/plugin.py,sha256=kz21CxIGQw3Is6HC2dvKvFRIm9m1FRKHO0YgUuDEplQ,15650
 iwa/plugins/olas/contracts/activity_checker.py,sha256=OXh0SFPGfcpeD665ay-I19LqcIx38qEz8o62dw0A9zE,5361
 iwa/plugins/olas/contracts/base.py,sha256=y73aQbDq6l4zUpz_eQAg4MsLkTAEqjjupXlcvxjfgCI,240
@@ -93,8 +93,8 @@ iwa/plugins/olas/scripts/test_full_mech_flow.py,sha256=Fqoq5bn7Z_3YyRrnuqNAZy9cw
 iwa/plugins/olas/scripts/test_simple_lifecycle.py,sha256=8T50tOZx3afeECSfCNAb0rAHNtYOsBaeXlMwKXElCk8,2099
 iwa/plugins/olas/service_manager/__init__.py,sha256=GXiThMEY3nPgHUl1i-DLrF4h96z9jPxxI8Jepo2E1PM,1926
 iwa/plugins/olas/service_manager/base.py,sha256=EBPg0ymqgtAb7ZvVSfTt31QYgv_6gp4UAc6je00NLAg,5009
-iwa/plugins/olas/service_manager/drain.py,sha256=Hoa8rTIDwp9xGf_0O-7Nvn58LMZ_8PTOTr2ETUY5TjY,12920
-iwa/plugins/olas/service_manager/lifecycle.py,sha256=JCLGN7RjJbbPXXHOqvD64OKj2wH2NVh7o3mCBqJQEAQ,50570
+iwa/plugins/olas/service_manager/drain.py,sha256=oIBZON_ypshqaI2MZGKHW63dLEkkIcyAqS5lTZy0Qc4,13714
+iwa/plugins/olas/service_manager/lifecycle.py,sha256=Jz2WTsBE_kGjFnsnpQlUBmMM2csOuqEfYdvj4cLrNuU,50586
 iwa/plugins/olas/service_manager/mech.py,sha256=NVzVbEmyOe3wK92VEzCCOSuy3HDkEP1MSoVt7Av8Psk,27949
 iwa/plugins/olas/service_manager/staking.py,sha256=kT9OOQ4fi3FrIJB2T2gsvmv7DBRD6pDxqcXXh2o6iwc,29600
 iwa/plugins/olas/tests/conftest.py,sha256=4vM7EI00SrTGyeP0hNzsGSQHEj2-iznVgzlNh2_OGfo,739
@@ -104,9 +104,9 @@ iwa/plugins/olas/tests/test_mech_contracts.py,sha256=wvxuigPafF-ySIHVBdWVei3AO41
 iwa/plugins/olas/tests/test_olas_archiving.py,sha256=rwyP-9eZ1cNvvV4h4bBOrs_8qV-du9yt-VNMuH_13nY,3443
 iwa/plugins/olas/tests/test_olas_contracts.py,sha256=B8X-5l1KfYMoZOiM94_rcNzbILLl78rqt_jhyxzAOqE,10835
 iwa/plugins/olas/tests/test_olas_integration.py,sha256=LGkdeso5lvi7_0GjlS9EFlSs6PEEn_b5aD2USmperDA,23086
-iwa/plugins/olas/tests/test_olas_models.py,sha256=5scX-wvRLGH3G44S2okq_tyQ9Rk7Pd0Ak1zNCZ2HtI4,4957
+iwa/plugins/olas/tests/test_olas_models.py,sha256=LCtU01v2LhPgSjzMBGlhRQ9nBb7sgcd7n7F1z-T-IuA,4977
 iwa/plugins/olas/tests/test_olas_view.py,sha256=2SsQYayeV3rf_mAPVvt4vINcMysAXmICkkQe3MRn4K8,10662
-iwa/plugins/olas/tests/test_olas_view_actions.py,sha256=jAxr9bjFNAaxGf1btIrxdMaHgJ0PWX9aDwVU-oPGMpk,5109
+iwa/plugins/olas/tests/test_olas_view_actions.py,sha256=67al8ffNWMETI-foq-FjsXqpjdEruuH1sRCsGo_x9GE,5113
 iwa/plugins/olas/tests/test_olas_view_modals.py,sha256=8j0PNFjKqFC5V1kBdVFWNLMvqGt49H6fLSYGxn02c8o,5562
 iwa/plugins/olas/tests/test_plugin.py,sha256=RVgU-Cq6t_3mOh90xFAGwlJOV7ZIgp0VNaK5ZAxisAQ,2565
 iwa/plugins/olas/tests/test_plugin_full.py,sha256=55EBa07JhJLVG3IMi6QKlR_ivWLYCdLQTySP66qbEXo,8584
@@ -115,9 +115,9 @@ iwa/plugins/olas/tests/test_service_manager.py,sha256=_mFRptssimITHhjvZA5jUPU2bI
 iwa/plugins/olas/tests/test_service_manager_errors.py,sha256=-qpLmU4Uiqqtre59L2wXpO4WPMs4ej_K_gAL3naEvRg,8554
 iwa/plugins/olas/tests/test_service_manager_flows.py,sha256=ZSmBJNa18d_MyAaLQRoPpfFYRwzmk9k-5AhSAGd7WeI,20737
 iwa/plugins/olas/tests/test_service_manager_mech.py,sha256=qG6qu5IPRNypXUsblU2OEkuiuwDJ0TH8RXZbibmTFcQ,4937
-iwa/plugins/olas/tests/test_service_manager_rewards.py,sha256=jVAe4HSAxDfnq8Ec-JMsvE2E0HYsydO78ITFHnSSka4,11993
+iwa/plugins/olas/tests/test_service_manager_rewards.py,sha256=2YCrXBU5bEkPuhBoGBhjnO1nA2qwHxn5Ivrror18FHM,12248
 iwa/plugins/olas/tests/test_service_manager_validation.py,sha256=ajlfH5uc4mAHf8A7GLE5cW7X8utM2vUilM0JdGDdlVg,5382
-iwa/plugins/olas/tests/test_service_staking.py,sha256=ETNnWzV52FDhK0mrPb9xl9gSiYRH2EeDVxcaQIV0d5Q,15849
+iwa/plugins/olas/tests/test_service_staking.py,sha256=78yyPoLo51N1aQyDxjzj7I0a263JHKHqekL-W3oQAsw,15914
 iwa/plugins/olas/tests/test_staking_integration.py,sha256=QCBQf6P2ZmmsEGt2k8W2r53lG2aVRuoMJE-aFxVDLss,9701
 iwa/plugins/olas/tests/test_staking_validation.py,sha256=uug64jFcXYJ3Nw_lNa3O4fnhNr5wAWHHIrchSbR2MVE,4020
 iwa/plugins/olas/tui/__init__.py,sha256=5ZRsbC7J3z1xfkZRiwr4bLEklf78rNVjdswe2p7SlS8,28
@@ -163,10 +163,10 @@ iwa/web/static/app.js,sha256=hBjUSivxf5Uyy2H6BR-rfdvF8e7qBoDPK23aY3dagNY,114418
 iwa/web/static/index.html,sha256=q7s7plnMbN1Nkzr5bRxZgvgOFerUChEGIZW7SpAVtPc,28514
 iwa/web/static/style.css,sha256=7i6T96pS7gXSLDZfyp_87gRlyB9rpsFWJEHJ-dRY1ug,24371
 iwa/web/tests/test_web_endpoints.py,sha256=vA25YghHNB23sbmhD4ciesn_f_okSq0tjlkrSiKZ0rs,24007
-iwa/web/tests/test_web_olas.py,sha256=0CVSsrncOeJ3x0ECV7mVLQV_CXZRrOqGiVjgLIi6hZ8,16308
+iwa/web/tests/test_web_olas.py,sha256=GunKEAzcbzL7FoUGMtEl8wqiqwYwA5lB9sOhfCNj0TA,16312
 iwa/web/tests/test_web_swap.py,sha256=7A4gBJFL01kIXPtW1E1J17SCsVc_0DmUn-R8kKrnnVA,2974
 iwa/web/tests/test_web_swap_coverage.py,sha256=zGNrzlhZ_vWDCvWmLcoUwFgqxnrp_ACbo49AtWBS_Kw,5584
-iwa-0.0.61.dist-info/licenses/LICENSE,sha256=eIubm_IlBHPYRQlLNZKbBNKhJUUP3JH0A2miZUhAVfI,1078
+iwa-0.0.64.dist-info/licenses/LICENSE,sha256=eIubm_IlBHPYRQlLNZKbBNKhJUUP3JH0A2miZUhAVfI,1078
 tests/legacy_cow.py,sha256=oOkZvIxL70ReEoD9oHQbOD5GpjIr6AGNHcOCgfPlerU,8389
 tests/legacy_safe.py,sha256=AssM2g13E74dNGODu_H0Q0y412lgqsrYnEzI97nm_Ts,2972
 tests/legacy_transaction_retry_logic.py,sha256=D9RqZ7DBu61Xr2djBAodU2p9UE939LL-DnQXswX5iQk,1497
@@ -178,11 +178,12 @@ tests/test_balance_service.py,sha256=wcuCOVszxPy8nPkldAVcEiygcOK3BuQt797fqAJvbp4
 tests/test_chain.py,sha256=VZoidSojWyt1y4mQdZdoZsjuuDZjLC6neTC-2SF_Q7I,13957
 tests/test_chain_interface.py,sha256=bgqGM8wJGZjc-BOX6i0K4sh06KCJl-6UAvrwl8x24lA,8324
 tests/test_chain_interface_coverage.py,sha256=fvrVvw8-DMwdsSFKQHUhpbfutrVRxnnTc-tjB7Bb-jo,3327
-tests/test_chainlist_enrichment.py,sha256=P7WctRhZ0sBTlsHsJXj5hv97CzgaEH556Nir2J8vWpg,12928
+tests/test_chainlist_enrichment.py,sha256=hxfYjI54hT2pBXeacmQkLJGEPyuaAwDtNL5sEVZURp8,22065
 tests/test_cli.py,sha256=Pl4RC2xp1omiJUnL3Dza6pCmIoO29LJ0vGw33_ZpT5c,3980
 tests/test_contract.py,sha256=tApHAxsfKGawYJWA9PhTNrOZUE0VVAq79ruIe3KxeWY,14412
+tests/test_contract_cache.py,sha256=TYIYPwIm_pVsdDjXJj_9-yDah_RFYB3PBn_fyE-a_YU,8454
 tests/test_db.py,sha256=dmbrupj0qlUeiiycZ2mzMFjf7HrDa6tcqMPY8zpiKIk,5710
-tests/test_drain_coverage.py,sha256=oFpY7tFPXWe9WLh3z2D4L2GxuAJO6_txLNxJmtgZT7M,7208
+tests/test_drain_coverage.py,sha256=x-ANNt2YVJcuJApMe7VlzZE-1RRpSvGtDz5M_UXLc4I,18497
 tests/test_erc20.py,sha256=kNEw1afpm5EbXRNXkjpkBNZIy7Af1nqGlztKH5IWAwU,3074
 tests/test_gnosis_plugin.py,sha256=XMoHBCTrnVBq9bXYPzMUIrhr95caucMVRxooCjKrzjg,3454
 tests/test_keys.py,sha256=Qk4n3QDZ2HjXYRvehdrSlvDS_q3NLRLMnCq45Eo1Q9o,17551
@@ -203,14 +204,14 @@ tests/test_rpc_rate_limit.py,sha256=3P_Nd9voFmz-4r_Et-vw8W-Esbq5elSYmRBSOtJGx1Y,
 tests/test_rpc_rotation.py,sha256=a1cFKsf0fo-73_MSDnTuU6Zpv7bJHjrCVu3ANe8PXDU,12541
 tests/test_rpc_view.py,sha256=sgZ53KEHl8VGb7WKYa0VI7Cdxbf8JH1SdroHYbWHjfQ,2031
 tests/test_safe_coverage.py,sha256=KBxKz64XkK8CgN0N0LTNVKakf8Wg8EpghcBlLmDFmLs,6119
-tests/test_safe_executor.py,sha256=HYdyWdoKs3xK-1wJ9QGcLx58Dk2GV4-IpDqE9hUhA8I,22149
+tests/test_safe_executor.py,sha256=xyiNmPo0Ux3jIcdz5AT98YSmha7Pn3HUDoBtBF6AYRE,25032
 tests/test_safe_integration.py,sha256=WWAKDio3N-CFyr5RRvphbOPdu3TI9WSM8IesfbFbvWQ,5363
 tests/test_safe_service.py,sha256=5ULlj0fPZRwg-4fCBJplhm4Msr_Beof7W-Zf_JljZc8,5782
 tests/test_service_manager_integration.py,sha256=I_BLUzEKrVTyg_8jqsUK0oFD3aQVPCRJ7z0gY8P-j04,2354
 tests/test_service_manager_structure.py,sha256=zK506ucCXCBHcjPYKrKEuK1bgq0xsbawyL8Y-wahXf8,868
 tests/test_service_transaction.py,sha256=IeqYhmRD-pIXffBJrBQwfPx-qnfNEJs0iPM3eCb8MLo,7054
 tests/test_staking_router.py,sha256=cnOtwWeQPu09kecVhlCf1WA4ONqs13OcQJhJCx2EOPY,3067
-tests/test_staking_simple.py,sha256=NHyZ1pcVQEJGFiGseC5m6Y9Y6FJGnRIFJUwhd1hAV9g,1138
+tests/test_staking_simple.py,sha256=LN1ehVpNlT2oGGNhj0B1DAmazoL5xRmSCHB5AUL8900,19643
 tests/test_tables.py,sha256=1KQHgxuizoOrRxpubDdnzk9iaU5Lwyp3bcWP_hZD5uU,2686
 tests/test_transaction_service.py,sha256=q2IQ6cJ6sZtzc_pVCM_dv0vW7LW2sONNrK5Pvrm63rU,12816
 tests/test_transfer_multisend.py,sha256=PErjNqNwN66TMh4oVa307re64Ucccg1LkXqB0KlkmsI,6677
@@ -223,8 +224,8 @@ tests/test_utils.py,sha256=vkP49rYNI8BRzLpWR3WnKdDr8upeZjZcs7Rx0pjbQMo,1292
 tests/test_workers.py,sha256=MInwdkFY5LdmFB3o1odIaSD7AQZb3263hNafO1De5PE,2793
 tools/create_and_stake_service.py,sha256=1xwy_bJQI1j9yIQ968Oc9Db_F6mk1659LuuZntTASDE,3742
 tools/verify_drain.py,sha256=PkMjblyOOAuQge88FwfEzRtCYeEtJxXhPBmtQYCoQ-8,6743
-iwa-0.0.61.dist-info/METADATA,sha256=FLMOGU9L47jQQ45Cd7i64bfZNXCtNidn1ryV4-uBjCA,7337
-iwa-0.0.61.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-iwa-0.0.61.dist-info/entry_points.txt,sha256=nwB6kscrfA7M00pYmL2j-sBH6eF6h2ga9IK1BZxdiyQ,241
-iwa-0.0.61.dist-info/top_level.txt,sha256=kedS9cRUbm4JE2wYeabIXilhHjN8KCw0IGbqqqsw0Bs,16
-iwa-0.0.61.dist-info/RECORD,,
+iwa-0.0.64.dist-info/METADATA,sha256=9wa9UGdHrJz-WdMtiNRkwK9yvqAk-QDETX5UXJJaxWA,7337
+iwa-0.0.64.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+iwa-0.0.64.dist-info/entry_points.txt,sha256=nwB6kscrfA7M00pYmL2j-sBH6eF6h2ga9IK1BZxdiyQ,241
+iwa-0.0.64.dist-info/top_level.txt,sha256=kedS9cRUbm4JE2wYeabIXilhHjN8KCw0IGbqqqsw0Bs,16
+iwa-0.0.64.dist-info/RECORD,,

tests/test_chainlist_enrichment.py

@@ -343,12 +343,245 @@ class TestEnrichFromChainlist:
 
         chain = MagicMock(spec=SupportedChain)
         chain.name = "TestChain"
-        chain.rpcs = [f"https://rpc{i}.example.com" for i in range(10)]
+        chain.rpcs = [f"https://rpc{i}.example.com" for i in range(20)]
         chain.rpc = "https://rpc0.example.com"
         chain.chain_id = 100
 
         with patch("iwa.core.chainlist.ChainlistRPC") as mock_cl_cls:
             ChainInterface(chain)
 
-        # Already at MAX_RPCS=10, ChainlistRPC should not be called
+        # Already at MAX_RPCS=20, ChainlistRPC should not be called
         mock_cl_cls.assert_not_called()
+
+
+class TestRPCNode:
+    """Test RPCNode dataclass."""
+
+    def test_is_tracking_privacy(self):
+        """Test is_tracking returns True for privacy tracking."""
+        node = RPCNode(url="https://example.com", is_working=True, privacy="privacy")
+        assert node.is_tracking is True
+
+    def test_is_tracking_limited(self):
+        """Test is_tracking returns True for limited tracking."""
+        node = RPCNode(url="https://example.com", is_working=True, tracking="limited")
+        assert node.is_tracking is True
+
+    def test_is_tracking_yes(self):
+        """Test is_tracking returns True for explicit yes tracking."""
+        node = RPCNode(url="https://example.com", is_working=True, tracking="yes")
+        assert node.is_tracking is True
+
+    def test_is_tracking_none(self):
+        """Test is_tracking returns False for no tracking."""
+        node = RPCNode(url="https://example.com", is_working=True, tracking="none")
+        assert node.is_tracking is False
+
+    def test_is_tracking_default(self):
+        """Test is_tracking returns False by default."""
+        node = RPCNode(url="https://example.com", is_working=True)
+        assert node.is_tracking is False
+
+
+class TestFilterCandidates:
+    """Test _filter_candidates function."""
+
+    def test_max_candidates_limit(self):
+        """Test that _filter_candidates respects MAX_CHAINLIST_CANDIDATES."""
+        from iwa.core.chainlist import MAX_CHAINLIST_CANDIDATES, _filter_candidates
+
+        # Create more nodes than MAX_CHAINLIST_CANDIDATES
+        nodes = [
+            RPCNode(url=f"https://rpc{i}.example.com", is_working=True)
+            for i in range(MAX_CHAINLIST_CANDIDATES + 10)
+        ]
+
+        result = _filter_candidates(nodes, set())
+
+        # Should be limited to MAX_CHAINLIST_CANDIDATES
+        assert len(result) == MAX_CHAINLIST_CANDIDATES
+
+
+class TestChainlistRPCFetchData:
+    """Test ChainlistRPC.fetch_data with caching."""
+
+    def test_fetch_data_uses_cache(self, tmp_path):
+        """Test fetch_data uses cached data when valid."""
+        import json
+        from unittest.mock import patch
+
+        cache_file = tmp_path / "chainlist_rpcs.json"
+        cache_data = [{"chainId": 100, "name": "Test", "rpc": []}]
+        cache_file.write_text(json.dumps(cache_data))
+
+        with patch.object(ChainlistRPC, "CACHE_PATH", cache_file):
+            with patch("iwa.core.chainlist.requests.Session") as mock_session:
+                cl = ChainlistRPC()
+                cl.fetch_data()
+
+                # Should not make network request when cache is valid
+                mock_session.return_value.get.assert_not_called()
+                assert cl._data == cache_data
+
+    def test_fetch_data_force_refresh(self, tmp_path):
+        """Test fetch_data ignores cache when force_refresh=True."""
+        import json
+
+        cache_file = tmp_path / "chainlist_rpcs.json"
+        cache_data = [{"chainId": 100, "name": "Cached", "rpc": []}]
+        cache_file.write_text(json.dumps(cache_data))
+
+        fresh_data = [{"chainId": 100, "name": "Fresh", "rpc": []}]
+
+        with patch.object(ChainlistRPC, "CACHE_PATH", cache_file):
+            with patch("iwa.core.chainlist.requests.Session") as mock_session_cls:
+                mock_session = MagicMock()
+                mock_session_cls.return_value.__enter__ = MagicMock(
+                    return_value=mock_session
+                )
+                mock_session_cls.return_value.__exit__ = MagicMock(return_value=False)
+                mock_resp = MagicMock()
+                mock_resp.json.return_value = fresh_data
+                mock_session.get.return_value = mock_resp
+
+                cl = ChainlistRPC()
+                cl.fetch_data(force_refresh=True)
+
+                mock_session.get.assert_called_once()
+                assert cl._data == fresh_data
+
+    def test_fetch_data_network_error_falls_back_to_cache(self, tmp_path):
+        """Test fetch_data falls back to expired cache on network error."""
+        import json
+
+        cache_file = tmp_path / "chainlist_rpcs.json"
+        cache_data = [{"chainId": 100, "name": "ExpiredCache", "rpc": []}]
+        cache_file.write_text(json.dumps(cache_data))
+
+        with patch.object(ChainlistRPC, "CACHE_PATH", cache_file):
+            # Force cache to be expired by setting CACHE_TTL to 0
+            with patch.object(ChainlistRPC, "CACHE_TTL", 0):
+                with patch("iwa.core.chainlist.requests.Session") as mock_session_cls:
+                    mock_session = MagicMock()
+                    mock_session_cls.return_value.__enter__ = MagicMock(
+                        return_value=mock_session
+                    )
+                    mock_session_cls.return_value.__exit__ = MagicMock(return_value=False)
+                    mock_session.get.side_effect = requests.RequestException("Network error")
+
+                    cl = ChainlistRPC()
+                    cl.fetch_data()
+
+                    # Should fall back to expired cache
+                    assert cl._data == cache_data
+
+
+class TestChainlistRPCGetRpcs:
+    """Test ChainlistRPC.get_rpcs and related methods."""
+
+    def test_get_chain_data_no_data(self):
+        """Test get_chain_data returns None when no data."""
+        with patch.object(ChainlistRPC, "fetch_data"):
+            cl = ChainlistRPC()
+            cl._data = []
+            result = cl.get_chain_data(999)
+            assert result is None
+
+    def test_get_chain_data_found(self):
+        """Test get_chain_data returns chain data when found."""
+        with patch.object(ChainlistRPC, "fetch_data"):
+            cl = ChainlistRPC()
+            cl._data = [{"chainId": 100, "name": "Gnosis"}, {"chainId": 1, "name": "Ethereum"}]
+            result = cl.get_chain_data(100)
+            assert result == {"chainId": 100, "name": "Gnosis"}
+
+    def test_get_rpcs_parses_nodes(self):
+        """Test get_rpcs parses RPC data into RPCNode objects."""
+        with patch.object(ChainlistRPC, "fetch_data"):
+            cl = ChainlistRPC()
+            cl._data = [
+                {
+                    "chainId": 100,
+                    "rpc": [
+                        {"url": "https://rpc1.example.com", "privacy": "privacy"},
+                        {"url": "https://rpc2.example.com", "tracking": "none"},
+                    ],
+                }
+            ]
+            result = cl.get_rpcs(100)
+
+            assert len(result) == 2
+            assert result[0].url == "https://rpc1.example.com"
+            assert result[0].privacy == "privacy"
+            assert result[1].url == "https://rpc2.example.com"
+            assert result[1].tracking == "none"
+
+    def test_get_rpcs_chain_not_found(self):
+        """Test get_rpcs returns empty list when chain not found."""
+        with patch.object(ChainlistRPC, "fetch_data"):
+            cl = ChainlistRPC()
+            cl._data = [{"chainId": 1, "rpc": []}]
+            result = cl.get_rpcs(999)
+            assert result == []
+
+    def test_get_https_rpcs(self):
+        """Test get_https_rpcs filters to HTTPS/HTTP URLs."""
+        with patch.object(ChainlistRPC, "fetch_data"):
+            cl = ChainlistRPC()
+            cl._data = [
+                {
+                    "chainId": 100,
+                    "rpc": [
+                        {"url": "https://rpc1.example.com"},
+                        {"url": "http://rpc2.example.com"},
+                        {"url": "wss://ws.example.com"},
+                    ],
+                }
+            ]
+            result = cl.get_https_rpcs(100)
+
+            assert len(result) == 2
+            assert "https://rpc1.example.com" in result
+            assert "http://rpc2.example.com" in result
+            assert "wss://ws.example.com" not in result
+
+    def test_get_wss_rpcs(self):
+        """Test get_wss_rpcs filters to WSS/WS URLs."""
+        with patch.object(ChainlistRPC, "fetch_data"):
+            cl = ChainlistRPC()
+            cl._data = [
+                {
+                    "chainId": 100,
+                    "rpc": [
+                        {"url": "https://rpc1.example.com"},
+                        {"url": "wss://ws.example.com"},
+                        {"url": "ws://ws2.example.com"},
+                    ],
+                }
+            ]
+            result = cl.get_wss_rpcs(100)
+
+            assert len(result) == 2
+            assert "wss://ws.example.com" in result
+            assert "ws://ws2.example.com" in result
+            assert "https://rpc1.example.com" not in result
+
+
+class TestGetValidatedRpcsEdgeCases:
+    """Test edge cases in get_validated_rpcs."""
+
+    def _make_node(self, url):
+        return RPCNode(url=url, is_working=True)
+
+    @patch.object(ChainlistRPC, "get_rpcs")
+    def test_returns_empty_when_all_filtered(self, mock_get_rpcs):
+        """Test returns empty list when all candidates are filtered."""
+        mock_get_rpcs.return_value = [
+            self._make_node("https://template.com/${API_KEY}"),
+            self._make_node("http://insecure.com"),  # Not HTTPS
+        ]
+
+        cl = ChainlistRPC()
+        result = cl.get_validated_rpcs(100, existing_rpcs=[])
+
+        assert result == []

tests/test_contract_cache.py

@@ -0,0 +1,253 @@
+"""Tests for contract instance caching."""
+
+import time
+from unittest.mock import MagicMock, patch
+
+import pytest
+
+
+@pytest.fixture(autouse=True)
+def reset_singleton():
+    """Reset the ContractCache singleton before each test."""
+    from iwa.core.contracts.cache import ContractCache
+
+    ContractCache._instance = None
+    yield
+    ContractCache._instance = None
+
+
+class TestContractCache:
+    """Test ContractCache singleton and caching behavior."""
+
+    def test_singleton_pattern(self):
+        """Test that ContractCache is a singleton."""
+        from iwa.core.contracts.cache import ContractCache
+
+        c1 = ContractCache()
+        c2 = ContractCache()
+        assert c1 is c2
+
+    def test_get_contract_creates_new_instance(self):
+        """Test get_contract creates new instance when not cached."""
+        from iwa.core.contracts.cache import ContractCache
+
+        cache = ContractCache()
+        mock_cls = MagicMock(__name__="MockContract")
+        mock_instance = MagicMock()
+        mock_cls.return_value = mock_instance
+
+        result = cache.get_contract(
+            mock_cls, "0x1234567890123456789012345678901234567890", "gnosis"
+        )
+
+        mock_cls.assert_called_once_with(
+            "0x1234567890123456789012345678901234567890", chain_name="gnosis"
+        )
+        assert result is mock_instance
+
+    def test_get_contract_returns_cached_instance(self):
+        """Test get_contract returns cached instance on second call."""
+        from iwa.core.contracts.cache import ContractCache
+
+        cache = ContractCache()
+        mock_cls = MagicMock(__name__="MockContract")
+        mock_instance = MagicMock()
+        mock_cls.return_value = mock_instance
+
+        result1 = cache.get_contract(
+            mock_cls, "0x1234567890123456789012345678901234567890", "gnosis"
+        )
+        result2 = cache.get_contract(
+            mock_cls, "0x1234567890123456789012345678901234567890", "gnosis"
+        )
+
+        # Should only create once
+        mock_cls.assert_called_once()
+        assert result1 is result2
+
+    def test_get_contract_raises_on_empty_address(self):
+        """Test get_contract raises ValueError for empty address."""
+        from iwa.core.contracts.cache import ContractCache
+
+        cache = ContractCache()
+        mock_cls = MagicMock(__name__="MockContract")
+
+        with pytest.raises(ValueError, match="Address is required"):
+            cache.get_contract(mock_cls, "", "gnosis")
+
+    def test_get_contract_respects_ttl_expiry(self):
+        """Test get_contract recreates instance after TTL expires."""
+        from iwa.core.contracts.cache import ContractCache
+
+        cache = ContractCache()
+        mock_cls = MagicMock(__name__="MockContract")
+        mock_cls.return_value = MagicMock()
+
+        # First call
+        cache.get_contract(
+            mock_cls, "0x1234567890123456789012345678901234567890", "gnosis", ttl=0
+        )
+
+        # Wait for expiry (TTL=0 means immediate expiry)
+        time.sleep(0.01)
+
+        # Second call should create new instance
+        cache.get_contract(
+            mock_cls, "0x1234567890123456789012345678901234567890", "gnosis", ttl=0
+        )
+
+        assert mock_cls.call_count == 2
+
+    def test_get_if_cached_returns_cached_instance(self):
+        """Test get_if_cached returns cached instance."""
+        from iwa.core.contracts.cache import ContractCache
+
+        cache = ContractCache()
+        mock_cls = MagicMock(__name__="MockContract")
+        mock_instance = MagicMock()
+        mock_cls.return_value = mock_instance
+
+        # First populate cache
+        cache.get_contract(
+            mock_cls, "0x1234567890123456789012345678901234567890", "gnosis"
+        )
+
+        # get_if_cached should return it
+        result = cache.get_if_cached(
+            mock_cls, "0x1234567890123456789012345678901234567890", "gnosis"
+        )
+
+        assert result is mock_instance
+
+    def test_get_if_cached_returns_none_when_not_cached(self):
+        """Test get_if_cached returns None when not cached."""
+        from iwa.core.contracts.cache import ContractCache
+
+        cache = ContractCache()
+        mock_cls = MagicMock(__name__="MockContract")
+
+        result = cache.get_if_cached(
+            mock_cls, "0x1234567890123456789012345678901234567890", "gnosis"
+        )
+
+        assert result is None
+
+    def test_get_if_cached_returns_none_for_empty_address(self):
+        """Test get_if_cached returns None for empty address."""
+        from iwa.core.contracts.cache import ContractCache
+
+        cache = ContractCache()
+        mock_cls = MagicMock(__name__="MockContract")
+
+        result = cache.get_if_cached(mock_cls, "", "gnosis")
+
+        assert result is None
+
+    def test_get_if_cached_returns_none_after_expiry(self):
+        """Test get_if_cached returns None after TTL expires."""
+        from iwa.core.contracts.cache import ContractCache
+
+        cache = ContractCache()
+        cache.ttl = 0  # Immediate expiry
+        mock_cls = MagicMock(__name__="MockContract")
+        mock_cls.return_value = MagicMock()
+
+        # Populate cache
+        cache.get_contract(
+            mock_cls, "0x1234567890123456789012345678901234567890", "gnosis"
+        )
+
+        time.sleep(0.01)
+
+        # get_if_cached should return None due to expiry
+        result = cache.get_if_cached(
+            mock_cls, "0x1234567890123456789012345678901234567890", "gnosis"
+        )
+
+        assert result is None
+
+    def test_clear_removes_all_entries(self):
+        """Test clear removes all cached contracts."""
+        from iwa.core.contracts.cache import ContractCache
+
+        cache = ContractCache()
+        mock_cls = MagicMock(__name__="MockContract")
+        mock_cls.return_value = MagicMock()
+
+        # Populate cache
+        cache.get_contract(
+            mock_cls, "0x1234567890123456789012345678901234567890", "gnosis"
+        )
+
+        cache.clear()
+
+        # get_if_cached should return None
+        result = cache.get_if_cached(
+            mock_cls, "0x1234567890123456789012345678901234567890", "gnosis"
+        )
+        assert result is None
+
+    def test_invalidate_removes_specific_entry(self):
+        """Test invalidate removes specific cached contract."""
+        from iwa.core.contracts.cache import ContractCache
+
+        cache = ContractCache()
+        mock_cls1 = MagicMock(__name__="Contract1")
+        mock_cls2 = MagicMock(__name__="Contract2")
+        mock_cls1.return_value = MagicMock()
+        mock_cls2.return_value = MagicMock()
+
+        # Populate cache with two contracts
+        cache.get_contract(
+            mock_cls1, "0x1234567890123456789012345678901234567890", "gnosis"
+        )
+        cache.get_contract(
+            mock_cls2, "0xABCDEF1234567890123456789012345678901234", "gnosis"
+        )
+
+        # Invalidate only the first one
+        cache.invalidate(
+            mock_cls1, "0x1234567890123456789012345678901234567890", "gnosis"
+        )
+
+        # First should be gone
+        result1 = cache.get_if_cached(
+            mock_cls1, "0x1234567890123456789012345678901234567890", "gnosis"
+        )
+        assert result1 is None
+
+        # Second should still exist
+        result2 = cache.get_if_cached(
+            mock_cls2, "0xABCDEF1234567890123456789012345678901234", "gnosis"
+        )
+        assert result2 is not None
+
+    def test_invalidate_nonexistent_does_nothing(self):
+        """Test invalidate does nothing for non-existent entry."""
+        from iwa.core.contracts.cache import ContractCache
+
+        cache = ContractCache()
+        mock_cls = MagicMock(__name__="Contract")
+
+        # Should not raise
+        cache.invalidate(
+            mock_cls, "0x1234567890123456789012345678901234567890", "gnosis"
+        )
+
+    def test_env_ttl_configuration(self):
+        """Test TTL is configurable via environment variable."""
+        from iwa.core.contracts.cache import ContractCache
+
+        with patch.dict("os.environ", {"IWA_CONTRACT_CACHE_TTL": "7200"}):
+            ContractCache._instance = None
+            cache = ContractCache()
+            assert cache.ttl == 7200
+
+    def test_invalid_env_ttl_uses_default(self):
+        """Test invalid TTL env var uses default value."""
+        from iwa.core.contracts.cache import ContractCache
+
+        with patch.dict("os.environ", {"IWA_CONTRACT_CACHE_TTL": "invalid"}):
+            ContractCache._instance = None
+            cache = ContractCache()
+            assert cache.ttl == 3600