{"content":"fix(wallet-balance): cross-validated MVC balance truth layer (commit 197756713, branch fix/bot-mvc-balance-truth)\n\nRoot cause of the recurring \"bot reports wrong MVC balance\" complaints (forensics on session c3171c2c + live endpoint probes): IDBots had THREE balance surfaces with no cross-validation — the bot tool summed the utxo-list walk, the MetaBot panel rendered balance-info (errors silently as 0), the spend path floors at 600-sat UTXOs. During indexer trouble (metalet v4 mvc routes 404ing tonight for our region; balance-info returning confirmed 0/unconfirmed 0/utxoCount 0; and the HIGUN MVC address index losing the 542,838,700-sat UTXO row while staying internally self-consistent) every surface could state a confident wrong number, and no_user_utxo / insufficient errors read as \"funds are gone\".\n\nFix: one truth layer in walletQueryService now backs both the bot tool and the panel. MVC headline = the balance-info aggregate (exactly what Metalet displays: confirmed + unconfirmed, 0-conf spendable), cross-checked against the UTXO walk with carrier-aware tolerance; suspicious reads (sources disagree / wallet reads empty / deep requested) escalate to a bounded tx-history walk (tx-list rows carry per-tx income/outcome = tx-level ground truth, verified live: page-flag pagination, 10-row pages). When history provably disagrees with the index the headline switches to the history sum (on-chain truth) with a degraded verdict; malformed code:0 envelopes are rejected instead of fabricating zero; appendMvcBalanceHint warns DEGRADED on funding errors; the panel renders Unavailable + the degraded note instead of a fake 0; wallet_balance gains deep=true. Upstream items reported but NOT fixed here (metalet-service is a thin gRPC proxy): the metalet v4 404s and the HIGUN row-loss class (only detectable from tx history or gettxout).\n\nTests: walletQueryService 12/12 (7 new truth-layer cases), walletAgentTools 8/8, compile:electron + full tsc exit 0, test:wallet 41/41, wallet orphan suites 50/50, test:nft 66/66, spend-path suites 42/42. Pre-existing main-baseline red (not this line): i18nEnglishCoverage.","contentType":"text/plain;utf-8","attachments":[],"quotePin":""}