Add market evidence notes to explorer surfaces

frontend/src/components/common/MarketEvidenceNote.tsx

@@ -0,0 +1,37 @@
+import { formatRelativeAge, formatTimestamp } from '@/utils/format'
+
+function formatSource(source?: string | null): string {
+  switch (source) {
+    case 'token-aggregation':
+      return 'token aggregation API'
+    case 'blockscout':
+      return 'Blockscout index'
+    case 'derived':
+      return 'derived from indexed supply and price inputs'
+    case 'mission-control':
+      return 'mission-control liquidity inventory'
+    default:
+      return source || 'source unavailable'
+  }
+}
+
+export default function MarketEvidenceNote({
+  source = 'token-aggregation',
+  lastUpdated,
+  method = 'DEX route and pool aggregation; visible liquidity only where indexed.',
+  compact = false,
+}: {
+  source?: string | null
+  lastUpdated?: string | null
+  method?: string
+  compact?: boolean
+}) {
+  const freshness = lastUpdated ? `${formatRelativeAge(lastUpdated)} (${formatTimestamp(lastUpdated)})` : 'timestamp unavailable'
+  const text = `Source: ${formatSource(source)}. Updated: ${freshness}. Method: ${method}`
+
+  return (
+    <p className={`${compact ? 'mt-1' : 'mt-3'} text-xs leading-5 text-gray-500 dark:text-gray-400`}>
+      {text}
+    </p>
+  )
+}

frontend/src/components/explorer/LiquidityOperationsPage.tsx

@@ -20,6 +20,7 @@ import { statsApi, type ExplorerStats } from '@/services/api/stats'
 import { summarizeChainActivity } from '@/utils/activityContext'
 import ActivityContextPanel from '@/components/common/ActivityContextPanel'
 import FreshnessTrustNote from '@/components/common/FreshnessTrustNote'
+import MarketEvidenceNote from '@/components/common/MarketEvidenceNote'
 import SubsystemPosturePanel from '@/components/common/SubsystemPosturePanel'
 import { resolveEffectiveFreshness } from '@/utils/explorerFreshness'
 import {
@@ -318,6 +319,12 @@ export default function LiquidityOperationsPage({
           <div className="mt-2 text-sm text-gray-600 dark:text-gray-400">
             {formatNumber(dexCount)} DEX families in the current discovered pools.
           </div>
+          <MarketEvidenceNote
+            source="mission-control"
+            lastUpdated={routeMatrix?.updated}
+            method="Route matrix, provider capabilities, and mission-control pool inventory are reconciled for visible public liquidity only."
+            compact
+          />
         </Card>
         <Card>
           <div className="text-sm text-gray-500 dark:text-gray-400">Fallback posture</div>
@@ -354,6 +361,12 @@ export default function LiquidityOperationsPage({
                 <div className="mt-2 text-sm text-gray-600 dark:text-gray-400">
                   Seen from {pool.sourceSymbols.join(', ')}
                 </div>
+                <MarketEvidenceNote
+                  source="mission-control"
+                  lastUpdated={routeMatrix?.updated}
+                  method="Pool TVL is the visible mission-control value for discovered route-backed liquidity."
+                  compact
+                />
               </div>
             ))}
             {aggregatedPools.length === 0 ? (

frontend/src/components/home/HomePage.tsx

@@ -21,6 +21,7 @@ import { transactionsApi, type Transaction } from '@/services/api/transactions'
 import { summarizeChainActivity } from '@/utils/activityContext'
 import ActivityContextPanel from '@/components/common/ActivityContextPanel'
 import FreshnessTrustNote from '@/components/common/FreshnessTrustNote'
+import MarketEvidenceNote from '@/components/common/MarketEvidenceNote'
 import { Explain, useUiMode } from '@/components/common/UiModeContext'
 import { resolveEffectiveFreshness, shouldExplainEmptyHeadBlocks } from '@/utils/explorerFreshness'
 import { tokenAggregationApi, type TokenAggregationTokenSnapshot } from '@/services/api/tokenAggregation'
@@ -794,6 +795,7 @@ export default function Home({
                   <div className="mt-1 text-xs text-gray-500 dark:text-gray-400">
                     {token.market?.lastUpdated ? `Updated ${formatRelativeAge(token.market.lastUpdated)}` : 'Update time unavailable'}
                   </div>
+                  <MarketEvidenceNote lastUpdated={token.market?.lastUpdated} compact />
                 </Link>
               ))}
             </div>