feat(roi): include off-chain BalanceTracker pre-deposits in trader ROI cost

Adds the pre-deposit-as-loss term to trader's in-agent ROI calculation.
Every ``BalanceTracker.Deposit(account=safe, ..., amount)`` credit to
the agent's Safe is booked as spent the moment it lands on chain, since
the tracker has no requester-withdraw path so committed funds are
unrecoverable regardless of whether the mech has consumed them yet.

The existing on-chain path stays unchanged:
- ``_get_total_mech_requests`` still reads the marketplace subgraph counter
- ``_get_open_market_requests`` still filters last-4-days requests via
  ``parsedRequest.questionTitle``
- ``settled_mech_requests = total - open`` unchanged
- ``DEFAULT_MECH_FEE = 0.01`` unchanged

Only the cost formula grows one additive term:

    total_costs_usd = totalTradedSettled + totalFeesSettled
                    + settled_mech_costs_usd            # unchanged
                    + offchain_prepaid_usd              # new

``offchain_prepaid_usd`` is derived from summing ``Deposit`` events
emitted for the agent's Safe by the BalanceTracker contract. For any
Safe that has never called ``depositFor`` (i.e. every production
on-chain trader today), the event stream is empty and the new term is
zero — the ROI number matches the pre-migration calculation exactly.

Storage:
- New ``OffchainDepositState`` dataclass with ``total_deposited_wei`` and
  ``last_scanned_block``, persisted under ``agent_performance.json``'s
  new ``offchain_deposits`` field. Enables incremental log scans; each
  cycle reads only new blocks since the last checkpoint and adds to the
  monotonic cumulative sum.

Reader package:
- New trader-local ``valory/mech_prepaid_reader`` contract package. It
  reuses the same ABI as the vendored ``valory/balance_tracker`` and
  exposes one method (``get_deposit_events_for_requester``) that filters
  the ``Deposit`` topic by the requester address and sums the amounts.
  Kept trader-local so the vendored ``balance_tracker`` package (pinned
  to ``mech-interact``) stays untouched.

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

Author: DIvyaNautiyal07

packages/packages.json

@@ -7,18 +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",
         "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": "bafybeib67kekwmnprt44es47lg4oecy6prxqmv6m5k5zqw4hvrskawlifu",
-        "skill/valory/trader_abci/0.1.0": "bafybeie2mant7aierij5zcq57iyiizbdpqoj7pkodvt2n5m2mvwrtmewca",
-        "skill/valory/tx_settlement_multiplexer_abci/0.1.0": "bafybeic67t7ndzwzekacof7nvk7zgr6dhl6yrqqcashqq3pxjjhhwcilju",
+        "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/staking_abci/0.1.0": "bafybeia6csjgex5zxdt6vymiaengu75lyzjdgfrnp65ewlghthiniquhje",
-        "skill/valory/agent_performance_summary_abci/0.1.0": "bafybeibdudllr3t7lpxwqtipqjpygk5kg64cohpdd5pafr7vcfjcocow6y",
-        "skill/valory/check_stop_trading_abci/0.1.0": "bafybeie5ag4baxeqvp4impypnkcxi2wgmoym2udchei45ovqcydauoyyje",
-        "skill/valory/chatui_abci/0.1.0": "bafybeiddfs7fy23e7lidopd67fcvwzul5invz5ngkufbrlh757inmm2a5e",
-        "agent/valory/trader/0.1.0": "bafybeibistsq3fvrfei6ypqom37y7a4ioxeoob6xbniduukyh2qtyssp24",
-        "service/valory/trader_pearl/0.1.0": "bafybeif6ed2k4m5ec5t6seyycifathbrytamdguwhmbvmdch2kra5yif3e",
-        "service/valory/polymarket_trader/0.1.0": "bafybeihw7p7ezqxytbzlicutcna6ytc33e5xja4yxh6qyeoefhwocuob3a"
+        "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"
     },
     "third_party": {
         "protocol/valory/acn_data_share/0.1.0": "bafybeieqisfr6lhaaesq37lk7vyaxza2h6nucshksgyo2djqfyf2saqo4i",

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

@@ -43,6 +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/escrow_payment_condition:0.1.0:bafybeifghaewxrhssktvscpxpvydq3xvjd5rxx37oz54lhzsg2kelmwkai
 - valory/did_registry:0.1.0:bafybeianxf7gjparfype4xesfdep362odimhgriviweluinnexwuglm2ku
 - valory/nft_sales:0.1.0:bafybeidlzxmxpx25zcn5nhi3lb4kvfhfjsaw2dul2hogghshnxzmurfiom
@@ -69,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:bafybeic67t7ndzwzekacof7nvk7zgr6dhl6yrqqcashqq3pxjjhhwcilju
+- valory/tx_settlement_multiplexer_abci:0.1.0:bafybeibyonzs6wyvbcks5bztmc7rmdooynxmlfhiaub2cmuamqbtijv3ou
 - valory/market_manager_abci:0.1.0:bafybeig3ak2eoimxwuupybde4napyi2jlf7pxk35se2zclikete2ni5hti
-- valory/decision_maker_abci:0.1.0:bafybeib67kekwmnprt44es47lg4oecy6prxqmv6m5k5zqw4hvrskawlifu
-- valory/trader_abci:0.1.0:bafybeie2mant7aierij5zcq57iyiizbdpqoj7pkodvt2n5m2mvwrtmewca
+- valory/decision_maker_abci:0.1.0:bafybeidel24uozve2ndxmwshhyrzsyv7itcodzqjcfzgqqikr4khpn4eiu
+- valory/trader_abci:0.1.0:bafybeiarobiv2d5l6teaslt7s4o36gni3bkwr75nub253mypms56dqzn7y
 - valory/staking_abci:0.1.0:bafybeia6csjgex5zxdt6vymiaengu75lyzjdgfrnp65ewlghthiniquhje
-- valory/check_stop_trading_abci:0.1.0:bafybeie5ag4baxeqvp4impypnkcxi2wgmoym2udchei45ovqcydauoyyje
+- valory/check_stop_trading_abci:0.1.0:bafybeidzz3x3m3cc2z76lqdhwacgrswjgbenc53ljx6ihmra2nnkg2khjm
 - valory/mech_interact_abci:0.1.0:bafybeici5tsgtlypnyrnp5colj7katnsyjfdzt6js4xdbnpdms4232muje
-- valory/chatui_abci:0.1.0:bafybeiddfs7fy23e7lidopd67fcvwzul5invz5ngkufbrlh757inmm2a5e
-- valory/agent_performance_summary_abci:0.1.0:bafybeibdudllr3t7lpxwqtipqjpygk5kg64cohpdd5pafr7vcfjcocow6y
+- valory/chatui_abci:0.1.0:bafybeic6isfmqxmwswrgiuwzlyvmivnxkmwfhkgwzoc226753hcij6c3f4
+- valory/agent_performance_summary_abci:0.1.0:bafybeicejhpfa6cth6hmz5yxbpbp3awbaxk26sulw6xk3lkzp7ruxov3ni
 - valory/funds_manager:0.1.0:bafybeicfw7qjtnlcbw6awsvxdahqu42fxsfsd3wy7mbyhcbls4l5pee3by
 customs:
 - valory/kelly_criterion:0.1.0:bafybeidme2uybzyzagky3jtosheqmpgc6b6w4rum7cdxw2fc35nnpwblfe

packages/valory/contracts/mech_prepaid_reader/__init__.py

@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+# ------------------------------------------------------------------------------
+#
+#   Copyright 2026 Valory AG
+#
+#   Licensed under the Apache License, Version 2.0 (the "License");
+#   you may not use this file except in compliance with the License.
+#   You may obtain a copy of the License at
+#
+#       http://www.apache.org/licenses/LICENSE-2.0
+#
+#   Unless required by applicable law or agreed to in writing, software
+#   distributed under the License is distributed on an "AS IS" BASIS,
+#   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#   See the License for the specific language governing permissions and
+#   limitations under the License.
+#
+# ------------------------------------------------------------------------------
+
+"""Trader-local reader for BalanceTracker.Deposit events.
+
+Adds a helper on top of the same ABI as the vendored balance_tracker
+contract, kept trader-local so trader's off-chain ROI accounting can read
+per-Safe pre-deposit history without modifying the third-party vendored
+package.
+"""
+
+from aea.configurations.base import PublicId
+
+PUBLIC_ID = PublicId.from_str("valory/mech_prepaid_reader:0.1.0")