fix(roi): short-circuit offchain-deposit reader for on-chain-only agents; seed checkpoint on first run

Tightens the pre-deposit-as-loss helper so on-chain-only deployments do
zero extra work and generate no log noise:

- **Early return when ``mech_marketplace_config.use_offchain`` is False.**
  Production on-chain-only traders take this path and never touch the
  contract API. No RPC call, no persist, ROI number bit-identical to
  today.

- **First-run checkpoint seeding.** When ``last_scanned_block == 0`` on
  an off-chain deployment, the helper now fetches the current head block
  via a new ``MechPrepaidReaderContract.get_current_block_number``
  classmethod and stores it as the checkpoint instead of sweeping the
  full history. Off-chain has not shipped in production, so there are
  no pre-existing deposits to backfill; this avoids RPC
  ``eth_getLogs`` block-range caps (Alchemy 10k, Infura 100k, etc.)
  that would otherwise error on every cycle and leave the checkpoint
  pinned at zero.

- **``balance_tracker_address`` added to deployment configs.** The Python
  default in ``mech_interact_abci/models.py`` seeded the address for
  both chains, but the deployment yamls did not, so an operator could
  not override it per-deployment. Added the real deployed addresses
  (Gnosis 0x7D686bD1fD3CFF6E45a40165154D61043af7D67c, Polygon
  0xaaFBeef195BDAb1Bb6f3Dc9cEbA875Cd72499230) to ``trader_pearl`` and
  ``polymarket_trader`` service.yamls, plus zero-address placeholders in
  ``trader_abci/skill.yaml`` and ``trader`` aea-config.yaml.

Existing behaviour under both modes stays correct: on-chain-only agents
see zero on all paths, off-chain agents capture every ``Deposit`` from
first run forward.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: DIvyaNautiyal07

packages/packages.json

@@ -7,19 +7,19 @@
         "contract/valory/relayer/0.1.0": "bafybeifrvzmwkumdachm7wuesfdqvz52xsybpnvdlelltm3qowosgd6tp4",
         "contract/valory/market_maker/0.1.0": "bafybeiaogkujiilubosloromkikuhltgiiadjvtzw2b5p5hc3klzi4m4nq",
         "contract/valory/deposit_wallet/0.1.0": "bafybeifmw77pznzla6zwq7mfncdzboxmlmm5ffmkvlxlqfg442oypfqjje",
-        "contract/valory/mech_prepaid_reader/0.1.0": "bafybeihy66fulkrsc4fxucrpunnr5ulwzudvnzxw5xtwjc7zqarf6bj3mi",
+        "contract/valory/mech_prepaid_reader/0.1.0": "bafybeieeh2xhktqn2xau527sgu6zvaqsf6nmd6um5zpgcds2bsg3l2onoa",
         "connection/valory/polymarket_client/0.1.0": "bafybeid4eo37pka4tfhsjs6rb3knrugmokcvihust2dpfrgob56y77xd44",
         "skill/valory/market_manager_abci/0.1.0": "bafybeig3ak2eoimxwuupybde4napyi2jlf7pxk35se2zclikete2ni5hti",
-        "skill/valory/decision_maker_abci/0.1.0": "bafybeidel24uozve2ndxmwshhyrzsyv7itcodzqjcfzgqqikr4khpn4eiu",
-        "skill/valory/trader_abci/0.1.0": "bafybeiarobiv2d5l6teaslt7s4o36gni3bkwr75nub253mypms56dqzn7y",
-        "skill/valory/tx_settlement_multiplexer_abci/0.1.0": "bafybeibyonzs6wyvbcks5bztmc7rmdooynxmlfhiaub2cmuamqbtijv3ou",
+        "skill/valory/decision_maker_abci/0.1.0": "bafybeiffplku3zbpzhck7pen7mgbn3pi3tdqlat4j4t5746qx5km5jidyq",
+        "skill/valory/trader_abci/0.1.0": "bafybeiaoe2ldtkyygp3w3sjnuiwyhgz6ye5a7lnu4jhwjegmcgakq3ptei",
+        "skill/valory/tx_settlement_multiplexer_abci/0.1.0": "bafybeicgh5cj75ojwhxttjz6bs7xtghkwekgfixnpw5fvbrpecumhrqhc4",
         "skill/valory/staking_abci/0.1.0": "bafybeia6csjgex5zxdt6vymiaengu75lyzjdgfrnp65ewlghthiniquhje",
-        "skill/valory/agent_performance_summary_abci/0.1.0": "bafybeicejhpfa6cth6hmz5yxbpbp3awbaxk26sulw6xk3lkzp7ruxov3ni",
-        "skill/valory/check_stop_trading_abci/0.1.0": "bafybeidzz3x3m3cc2z76lqdhwacgrswjgbenc53ljx6ihmra2nnkg2khjm",
-        "skill/valory/chatui_abci/0.1.0": "bafybeic6isfmqxmwswrgiuwzlyvmivnxkmwfhkgwzoc226753hcij6c3f4",
-        "agent/valory/trader/0.1.0": "bafybeihmsgrivxffvdzr46dm4pftc4erf7v5j4vxdzl3q5blaysbeknree",
-        "service/valory/trader_pearl/0.1.0": "bafybeic3peosuizvdyqeu6bycpy6le2ssl3vqlzopj6sl7ixs77uscr4ea",
-        "service/valory/polymarket_trader/0.1.0": "bafybeifkpi37hfv5pvo4yncfk5ja6bhd4ee5j5iydnizmgvufyyvvgeu5q"
+        "skill/valory/agent_performance_summary_abci/0.1.0": "bafybeibtuq7refjfnvzap4usjxnjwpgxpd5xbeeqwxut5nbnr7sjpo5nfi",
+        "skill/valory/check_stop_trading_abci/0.1.0": "bafybeid4dlfnxg7lo2wz4pilpavz2mfpwwjosmrueelrbtniuy22iw3xuq",
+        "skill/valory/chatui_abci/0.1.0": "bafybeicdkch7riy2bui3j34rfjm57d4dbdqja6mkf5n5htpvets5gxa36e",
+        "agent/valory/trader/0.1.0": "bafybeiglmixxve7juzdhkgtndzkrbwyzbxpe44z3dzbbrrrkjoq6zwsfhu",
+        "service/valory/trader_pearl/0.1.0": "bafybeifjhqnzv6tbcytp44g4tpvaviaczptelo7hyqdh5drg6q6csniqr4",
+        "service/valory/polymarket_trader/0.1.0": "bafybeigzkm662lypc2drcipklum5nlxafgjzocd6xi7ihycnmykx6r3jyy"
     },
     "third_party": {
         "protocol/valory/acn_data_share/0.1.0": "bafybeieqisfr6lhaaesq37lk7vyaxza2h6nucshksgyo2djqfyf2saqo4i",

packages/valory/agents/trader/aea-config.yaml

@@ -43,7 +43,7 @@ contracts:
 - valory/mech_marketplace:0.1.0:bafybeigrcnjaycggulxyx2tsjub4ssjij66d7nfzsavo6gd54hm7beliiu
 - valory/balance_tracker:0.1.0:bafybeiayyxl643qfpw57vopytxgyd6flxxmwassswuxen7myekqaxdxxvi
 - valory/balance_tracker_fixed_price_native:0.1.0:bafybeihyaxqkyw2ulroqlhpfcgkrwtrwkhshn35fdq2ystraezwyco3k4u
-- valory/mech_prepaid_reader:0.1.0:bafybeihy66fulkrsc4fxucrpunnr5ulwzudvnzxw5xtwjc7zqarf6bj3mi
+- valory/mech_prepaid_reader:0.1.0:bafybeieeh2xhktqn2xau527sgu6zvaqsf6nmd6um5zpgcds2bsg3l2onoa
 - valory/escrow_payment_condition:0.1.0:bafybeifghaewxrhssktvscpxpvydq3xvjd5rxx37oz54lhzsg2kelmwkai
 - valory/did_registry:0.1.0:bafybeianxf7gjparfype4xesfdep362odimhgriviweluinnexwuglm2ku
 - valory/nft_sales:0.1.0:bafybeidlzxmxpx25zcn5nhi3lb4kvfhfjsaw2dul2hogghshnxzmurfiom
@@ -70,15 +70,15 @@ skills:
 - valory/reset_pause_abci:0.1.0:bafybeifrnmlscfiki7wojs6zasppefupd2wkjyq6orhdllfppjud7isrxi
 - valory/termination_abci:0.1.0:bafybeih6sa2ttcvvjk7rcfn7ure2ws23kcfufssb4qmluzcfvednkfpvoi
 - valory/transaction_settlement_abci:0.1.0:bafybeihizaapype5sz7vlosms3nfo6jzfj4ujycuf5uthviq2otvmw6f6m
-- valory/tx_settlement_multiplexer_abci:0.1.0:bafybeibyonzs6wyvbcks5bztmc7rmdooynxmlfhiaub2cmuamqbtijv3ou
+- valory/tx_settlement_multiplexer_abci:0.1.0:bafybeicgh5cj75ojwhxttjz6bs7xtghkwekgfixnpw5fvbrpecumhrqhc4
 - valory/market_manager_abci:0.1.0:bafybeig3ak2eoimxwuupybde4napyi2jlf7pxk35se2zclikete2ni5hti
-- valory/decision_maker_abci:0.1.0:bafybeidel24uozve2ndxmwshhyrzsyv7itcodzqjcfzgqqikr4khpn4eiu
-- valory/trader_abci:0.1.0:bafybeiarobiv2d5l6teaslt7s4o36gni3bkwr75nub253mypms56dqzn7y
+- valory/decision_maker_abci:0.1.0:bafybeiffplku3zbpzhck7pen7mgbn3pi3tdqlat4j4t5746qx5km5jidyq
+- valory/trader_abci:0.1.0:bafybeiaoe2ldtkyygp3w3sjnuiwyhgz6ye5a7lnu4jhwjegmcgakq3ptei
 - valory/staking_abci:0.1.0:bafybeia6csjgex5zxdt6vymiaengu75lyzjdgfrnp65ewlghthiniquhje
-- valory/check_stop_trading_abci:0.1.0:bafybeidzz3x3m3cc2z76lqdhwacgrswjgbenc53ljx6ihmra2nnkg2khjm
+- valory/check_stop_trading_abci:0.1.0:bafybeid4dlfnxg7lo2wz4pilpavz2mfpwwjosmrueelrbtniuy22iw3xuq
 - valory/mech_interact_abci:0.1.0:bafybeici5tsgtlypnyrnp5colj7katnsyjfdzt6js4xdbnpdms4232muje
-- valory/chatui_abci:0.1.0:bafybeic6isfmqxmwswrgiuwzlyvmivnxkmwfhkgwzoc226753hcij6c3f4
-- valory/agent_performance_summary_abci:0.1.0:bafybeicejhpfa6cth6hmz5yxbpbp3awbaxk26sulw6xk3lkzp7ruxov3ni
+- valory/chatui_abci:0.1.0:bafybeicdkch7riy2bui3j34rfjm57d4dbdqja6mkf5n5htpvets5gxa36e
+- valory/agent_performance_summary_abci:0.1.0:bafybeibtuq7refjfnvzap4usjxnjwpgxpd5xbeeqwxut5nbnr7sjpo5nfi
 - valory/funds_manager:0.1.0:bafybeicfw7qjtnlcbw6awsvxdahqu42fxsfsd3wy7mbyhcbls4l5pee3by
 customs:
 - valory/kelly_criterion:0.1.0:bafybeidme2uybzyzagky3jtosheqmpgc6b6w4rum7cdxw2fc35nnpwblfe
@@ -258,7 +258,7 @@ models:
       mech_interaction_sleep_time: ${int:10}
       use_mech_marketplace: ${USE_MECH_MARKETPLACE:bool:false}
       policy_store_update_offset: ${int:259200}
-      mech_marketplace_config: ${MECH_MARKETPLACE_CONFIG:dict:{"mech_marketplace_address":"0x0000000000000000000000000000000000000000","priority_mech_address":"0x0000000000000000000000000000000000000000","priority_mech_staking_instance_address":"0x0000000000000000000000000000000000000000","priority_mech_service_id":0,"requester_staking_instance_address":"0x0000000000000000000000000000000000000000","response_timeout":300}}
+      mech_marketplace_config: ${MECH_MARKETPLACE_CONFIG:dict:{"mech_marketplace_address":"0x0000000000000000000000000000000000000000","priority_mech_address":"0x0000000000000000000000000000000000000000","priority_mech_staking_instance_address":"0x0000000000000000000000000000000000000000","priority_mech_service_id":0,"requester_staking_instance_address":"0x0000000000000000000000000000000000000000","response_timeout":300,"balance_tracker_address":"0x0000000000000000000000000000000000000000"}}
       expected_mech_response_time: ${int:300}
       mech_invalid_response: ${str:Invalid Response}
       mech_consecutive_failures_threshold: ${int:2}

packages/valory/contracts/mech_prepaid_reader/contract.py

@@ -113,3 +113,27 @@ def get_deposit_events_for_requester(
                 latest_block = block_number
 
         return {"total_wei": total_wei, "latest_block": latest_block}
+
+    @classmethod
+    def get_current_block_number(
+        cls,
+        ledger_api: LedgerApi,
+        contract_address: str,
+    ) -> JSONLike:
+        """Return the current head block number of the ledger.
+
+        Used by the caller as a seed on first run so incremental log scans
+        start from the current block rather than sweeping the full history —
+        pre-migration on-chain-only Safes never emitted ``Deposit`` events for
+        their account, so nothing is lost by skipping the past.
+
+        :param ledger_api: the ledger API object.
+        :param contract_address: the BalanceTracker contract address, retained
+            for framework symmetry with other contract-callable methods; the
+            call itself does not touch the contract.
+        :return: ``{"block_number": int}`` where the value is the latest block
+            the RPC endpoint reports.
+        """
+        del contract_address  # unused — framework requires it in the signature
+        ledger_api = cast(EthereumApi, ledger_api)
+        return {"block_number": int(ledger_api.api.eth.block_number)}

packages/valory/contracts/mech_prepaid_reader/contract.yaml

@@ -8,7 +8,7 @@ aea_version: '>=2.0.0, <3.0.0'
 fingerprint:
   __init__.py: bafybeieearschnqbcpbecmkvxozipxh3bqktkutnb5tp2to3ko5phrcigm
   build/BalanceTracker.json: bafybeig2ywevvapgqoprxnnkid3atvq6qg7aqfhyd2uvqokdnydcfp2is4
-  contract.py: bafybeibte6xnlv2e56n6jldfckf4j4j24e3efj6ntrq2qewh4fatcp3t34
+  contract.py: bafybeie4okijr53pivy3aeon24bezqutprre5vfl2ejqeqwnccaoccorha
   tests/__init__.py: bafybeiadfytuqaujcf6s34242uiptiwqqp3dprxvcglxtdlnkchaepyvay
 fingerprint_ignore_patterns: []
 class_name: MechPrepaidReaderContract

packages/valory/services/polymarket_trader/service.yaml

@@ -8,7 +8,7 @@ license: Apache-2.0
 fingerprint:
   README.md: bafybeichoh5tnk4qctaazcjcrxvpwc5yasodleqoeapnfapwrrdh3tm5gu
 fingerprint_ignore_patterns: []
-agent: valory/trader:0.1.0:bafybeihmsgrivxffvdzr46dm4pftc4erf7v5j4vxdzl3q5blaysbeknree
+agent: valory/trader:0.1.0:bafybeiglmixxve7juzdhkgtndzkrbwyzbxpe44z3dzbbrrrkjoq6zwsfhu
 number_of_agents: 1
 deployment:
   agent:
@@ -137,7 +137,7 @@ models:
       strategies_kwargs: ${STRATEGIES_KWARGS:dict:{"floor_balance":0,"default_max_bet_size":2500000,"absolute_min_bet_size":1000000,"absolute_max_bet_size":2500000,"n_bets":1,"min_edge":0.01,"max_edge":0.15,"min_oracle_prob":0.1,"fee_per_trade":10000,"grid_points":500}}
       use_subgraph_for_redeeming: ${USE_SUBGRAPH_FOR_REDEEMING:bool:true}
       use_mech_marketplace: ${USE_MECH_MARKETPLACE:bool:true}
-      mech_marketplace_config: ${MECH_MARKETPLACE_CONFIG:dict:{"mech_marketplace_address":"0x343F2B005cF6D70bA610CD9F1F1927049414B582","priority_mech_address":"0x1DCbC9368327776F8B20Dc041D40b8076C8AC173","priority_mech_staking_instance_address":"0x0000000000000000000000000000000000000000","priority_mech_service_id":25,"requester_staking_instance_address":"0x0000000000000000000000000000000000000000","response_timeout":300,"use_offchain":false,"offchain_url":null,"offchain_deposit_target_calls":10,"auto_deposit_cap_per_cycle":5000000,"offchain_poll_interval_seconds":3.0,"offchain_poll_timeout_seconds":300.0,"offchain_failover_max_retries":2}}
+      mech_marketplace_config: ${MECH_MARKETPLACE_CONFIG:dict:{"mech_marketplace_address":"0x343F2B005cF6D70bA610CD9F1F1927049414B582","priority_mech_address":"0x1DCbC9368327776F8B20Dc041D40b8076C8AC173","priority_mech_staking_instance_address":"0x0000000000000000000000000000000000000000","priority_mech_service_id":25,"requester_staking_instance_address":"0x0000000000000000000000000000000000000000","response_timeout":300,"balance_tracker_address":"0xaaFBeef195BDAb1Bb6f3Dc9cEbA875Cd72499230","use_offchain":false,"offchain_url":null,"offchain_deposit_target_calls":10,"auto_deposit_cap_per_cycle":5000000,"offchain_poll_interval_seconds":3.0,"offchain_poll_timeout_seconds":300.0,"offchain_failover_max_retries":2}}
       service_endpoint: ${SERVICE_ENDPOINT:str:https://trader.autonolas.tech/}
       rpc_sleep_time: ${RPC_SLEEP_TIME:int:10}
       safe_voting_range: ${SAFE_VOTING_RANGE:int:600}

packages/valory/services/trader_pearl/service.yaml

@@ -8,7 +8,7 @@ license: Apache-2.0
 fingerprint:
   README.md: bafybeibg7bdqpioh4lmvknw3ygnllfku32oca4eq5pqtvdrdsgw6buko7e
 fingerprint_ignore_patterns: []
-agent: valory/trader:0.1.0:bafybeihmsgrivxffvdzr46dm4pftc4erf7v5j4vxdzl3q5blaysbeknree
+agent: valory/trader:0.1.0:bafybeiglmixxve7juzdhkgtndzkrbwyzbxpe44z3dzbbrrrkjoq6zwsfhu
 number_of_agents: 1
 deployment:
   agent:
@@ -135,7 +135,7 @@ models:
       strategies_kwargs: ${STRATEGIES_KWARGS:dict:{"floor_balance":0,"default_max_bet_size":2000000000000000000,"absolute_min_bet_size":25000000000000000,"absolute_max_bet_size":2000000000000000000,"n_bets":1,"min_edge":0.03,"min_oracle_prob":0.5,"fee_per_trade":10000000000000000,"grid_points":500}}
       use_subgraph_for_redeeming: ${USE_SUBGRAPH_FOR_REDEEMING:bool:true}
       use_mech_marketplace: ${USE_MECH_MARKETPLACE:bool:false}
-      mech_marketplace_config: ${MECH_MARKETPLACE_CONFIG:dict:{"mech_marketplace_address":"0x4554fE75c1f5576c1d7F765B2A036c199Adae329","priority_mech_address":"0x0000000000000000000000000000000000000000","priority_mech_staking_instance_address":"0x998dEFafD094817EF329f6dc79c703f1CF18bC90","priority_mech_service_id":975,"requester_staking_instance_address":"0x0000000000000000000000000000000000000000","response_timeout":300,"use_offchain":false,"offchain_url":null,"offchain_deposit_target_calls":10,"auto_deposit_cap_per_cycle":5000000000000000000,"offchain_poll_interval_seconds":3.0,"offchain_poll_timeout_seconds":300.0,"offchain_failover_max_retries":2}}
+      mech_marketplace_config: ${MECH_MARKETPLACE_CONFIG:dict:{"mech_marketplace_address":"0x4554fE75c1f5576c1d7F765B2A036c199Adae329","priority_mech_address":"0x0000000000000000000000000000000000000000","priority_mech_staking_instance_address":"0x998dEFafD094817EF329f6dc79c703f1CF18bC90","priority_mech_service_id":975,"requester_staking_instance_address":"0x0000000000000000000000000000000000000000","response_timeout":300,"balance_tracker_address":"0x7D686bD1fD3CFF6E45a40165154D61043af7D67c","use_offchain":false,"offchain_url":null,"offchain_deposit_target_calls":10,"auto_deposit_cap_per_cycle":5000000000000000000,"offchain_poll_interval_seconds":3.0,"offchain_poll_timeout_seconds":300.0,"offchain_failover_max_retries":2}}
       service_endpoint: ${SERVICE_ENDPOINT:str:https://trader.autonolas.tech/}
       rpc_sleep_time: ${RPC_SLEEP_TIME:int:10}
       safe_voting_range: ${SAFE_VOTING_RANGE:int:600}

packages/valory/skills/agent_performance_summary_abci/behaviours.py

@@ -373,39 +373,83 @@ def _fetch_offchain_prepaid_wei(
         requester-withdraw path — money committed is unrecoverable regardless
         of consumption.
 
-        This helper reads the ``Deposit(indexed account, indexed token, amount)``
-        event stream from the last-scanned block cached in the performance
-        summary JSON, sums the new entries into the running total, updates
-        the checkpoint, and persists both fields under ``offchain_deposits``
-        for the next cycle.
-
-        On-chain-only deployments (i.e. every production trader today) never
-        emit these events for their Safe, so ``get_logs`` returns an empty
-        list and the running total stays at 0. Existing ROI numbers do not
-        change.
+        The helper is a strict no-op for on-chain-only deployments — it
+        short-circuits immediately when ``mech_marketplace_config.use_offchain``
+        is ``False`` or when no ``balance_tracker_address`` is configured,
+        so no contract call, no persist, no log noise.
+
+        On off-chain deployments the helper reads
+        ``Deposit(indexed account, indexed token, amount)`` events from the
+        last-scanned block cached in the performance summary JSON, sums new
+        entries into the running total, updates the checkpoint, and persists
+        both fields under ``offchain_deposits`` for the next cycle. On the
+        very first run (``last_scanned_block == 0``) it seeds the checkpoint
+        to the current head block instead of sweeping history — off-chain has
+        not shipped in production yet, so there are no pre-existing deposits
+        to backfill, and this avoids RPC ``eth_getLogs`` block-range caps.
 
         :param safe_address: the agent's own Safe address, used as the
             ``account`` filter on the ``Deposit`` event.
         :return: cumulative sum (in wei-scaled units) of every
             ``BalanceTracker.Deposit`` credit to this Safe up to and
-            including the latest block scanned.
+            including the latest block scanned. Zero for on-chain-only
+            deployments, matching pre-migration ROI exactly.
         :yield: contract-API response(s) via the abstract-round-abci
             base behaviour helpers.
         """
-        # Read the checkpoint from the persisted summary.
+        marketplace_config = self.params.mech_marketplace_config
+        if not marketplace_config.use_offchain:
+            # On-chain-only deployment (default for all production traders).
+            # No contract call, no persist, ROI number is bit-identical to
+            # pre-migration.
+            return 0
+
         summary = self.shared_state.read_existing_performance_summary()
         state = summary.offchain_deposits or OffchainDepositState()
         cached_total = int(state.total_deposited_wei)
-        from_block = state.last_scanned_block
 
-        balance_tracker_address = (
-            self.params.mech_marketplace_config.balance_tracker_address
-        )
+        balance_tracker_address = marketplace_config.balance_tracker_address
         if not balance_tracker_address:
-            # No tracker configured (e.g. on-chain-only deployment where the
-            # off-chain wiring was never populated). Nothing to sum.
+            # Off-chain enabled but the tracker address is missing from the
+            # config — misconfiguration, treat as zero and keep the cached
+            # total (which will also be zero on first run).
             return cached_total
 
+        # First-run seed: don't sweep history from block 0. Off-chain hasn't
+        # shipped in production, so there are no pre-existing deposits to
+        # capture, and starting from the current head avoids RPC
+        # ``eth_getLogs`` block-range caps.
+        if state.last_scanned_block == 0:
+            block_response = yield from self.get_contract_api_response(
+                performative=ContractApiMessage.Performative.GET_STATE,  # type: ignore
+                contract_address=balance_tracker_address,
+                contract_id=str(MechPrepaidReaderContract.contract_id),
+                contract_callable="get_current_block_number",
+                chain_id=self.params.mech_chain_id,
+            )
+            if block_response.performative != ContractApiMessage.Performative.STATE:
+                self.context.logger.warning(
+                    "Failed to seed offchain-deposit checkpoint from current "
+                    f"block (response: {block_response}); leaving cached total."
+                )
+                return cached_total
+
+            current_block = int(block_response.state.body.get("block_number", 0))
+            summary.offchain_deposits = OffchainDepositState(
+                total_deposited_wei="0",
+                last_scanned_block=current_block,
+            )
+            summary.timestamp = self.shared_state.synced_timestamp
+            self.shared_state.overwrite_performance_summary(summary)
+            self.context.logger.info(
+                f"[Offchain Deposits] First run — seeded checkpoint to block "
+                f"{current_block}, cumulative total starts at 0."
+            )
+            return 0
+
+        # Subsequent runs: scan strictly forward from the checkpoint.
+        from_block = state.last_scanned_block + 1
+
         response = yield from self.get_contract_api_response(
             performative=ContractApiMessage.Performative.GET_STATE,  # type: ignore
             contract_address=balance_tracker_address,