feat: oracle live checks

.env.local.example

@@ -62,4 +62,4 @@ MONARCH_API_KEY=
 # ==================== Oracle Metadata ====================
 # Base URL for oracle metadata Gist (without trailing slash)
 # Example: https://gist.githubusercontent.com/username/gist-id/raw
-ORACLE_GIST_BASE_URL=
+NEXT_PUBLIC_ORACLE_GIST_BASE_URL=

AGENTS.md

@@ -21,6 +21,15 @@ Always consult these docs for detailed information:
 4. Do not claim repo facts without evidence (no invented counts).
 5. Prevent double-capture, noisy heuristics, or duplicate logic.
 
+## Post-Implementation Consolidation (Mandatory)
+
+Before closing any non-trivial change:
+
+1. Run one consolidation pass and remove duplicated logic across files (especially repeated UI blocks).
+2. Prefer one chokepoint fix for layout constraints (container-level width/spacing) over per-component ad hoc truncation.
+3. Re-check first principles against the domain model so behavior applies consistently to all valid entities (not vendor-specific shortcuts).
+4. Remove transitional code that was useful during debugging but adds long-term complexity.
+
 ---
 
 ## 🛠️ Skills System

src/abis/chainlink-aggregator-v3.ts

@@ -0,0 +1,24 @@
+import type { Abi } from 'viem';
+
+export const chainlinkAggregatorV3Abi = [
+  {
+    inputs: [],
+    name: 'latestRoundData',
+    outputs: [
+      { internalType: 'uint80', name: 'roundId', type: 'uint80' },
+      { internalType: 'int256', name: 'answer', type: 'int256' },
+      { internalType: 'uint256', name: 'startedAt', type: 'uint256' },
+      { internalType: 'uint256', name: 'updatedAt', type: 'uint256' },
+      { internalType: 'uint80', name: 'answeredInRound', type: 'uint80' },
+    ],
+    stateMutability: 'view',
+    type: 'function',
+  },
+  {
+    inputs: [],
+    name: 'decimals',
+    outputs: [{ internalType: 'uint8', name: '', type: 'uint8' }],
+    stateMutability: 'view',
+    type: 'function',
+  },
+] as const satisfies Abi;

src/components/providers/QueryProvider.tsx

@@ -12,6 +12,7 @@ type QueryProviderProps = {
 const ACTIONABLE_QUERY_ROOT_KEYS = new Set<string>([
   'all-position-snapshots',
   'enhanced-positions',
+  'feed-snapshot',
   'fresh-markets-state',
   'historicalSupplierPositions',
   'marketData',
@@ -37,9 +38,7 @@ const ACTIONABLE_QUERY_ROOT_KEYS = new Set<string>([
   'vault-allocations',
 ]);
 
-const TRANSACTION_MUTATION_ROOT_KEYS = new Set<string>([
-  'sendTransaction',
-]);
+const TRANSACTION_MUTATION_ROOT_KEYS = new Set<string>(['sendTransaction']);
 
 const getQueryRootKey = (queryKey: QueryKey): string => {
   const root = queryKey[0];

src/features/markets/components/oracle/MarketOracle/ChainlinkFeedTooltip.tsx

@@ -6,14 +6,16 @@ import { Badge } from '@/components/ui/badge';
 import { useGlobalModal } from '@/contexts/GlobalModalContext';
 import etherscanLogo from '@/imgs/etherscan.png';
 import { getExplorerURL } from '@/utils/external';
-import { PriceFeedVendors, OracleVendorIcons, getChainlinkFeedUrl, type FeedData } from '@/utils/oracle';
+import { getChainlinkFeedUrl, OracleVendorIcons, PriceFeedVendors, type FeedData, type FeedFreshnessStatus } from '@/utils/oracle';
 import type { OracleFeed } from '@/utils/types';
 import { ChainlinkRiskTiersModal } from './ChainlinkRiskTiersModal';
+import { FeedFreshnessSection } from './FeedFreshnessSection';
 
 type ChainlinkFeedTooltipProps = {
   feed: OracleFeed;
   feedData?: FeedData | null;
   chainId: number;
+  feedFreshness?: FeedFreshnessStatus;
 };
 
 function getRiskTierBadge(category: string) {
@@ -36,7 +38,7 @@ function getRiskTierBadge(category: string) {
   );
 }
 
-export function ChainlinkFeedTooltip({ feed, feedData, chainId }: ChainlinkFeedTooltipProps) {
+export function ChainlinkFeedTooltip({ feed, feedData, chainId, feedFreshness }: ChainlinkFeedTooltipProps) {
   const { toggleModal, closeModal } = useGlobalModal();
   const baseAsset = feed.pair?.[0] ?? feedData?.pair[0] ?? 'Unknown';
   const quoteAsset = feed.pair?.[1] ?? feedData?.pair[1] ?? 'Unknown';
@@ -48,7 +50,7 @@ export function ChainlinkFeedTooltip({ feed, feedData, chainId }: ChainlinkFeedT
   const hasDetails = feedData?.heartbeat != null || feedData?.tier != null || feedData?.deviationThreshold != null;
 
   return (
-    <div className="flex max-w-xs flex-col gap-3">
+    <div className="flex w-fit max-w-[22rem] flex-col gap-3">
       {/* Header with icon and title */}
       <div className="flex items-center gap-2">
         {vendorIcon && (
@@ -113,6 +115,7 @@ export function ChainlinkFeedTooltip({ feed, feedData, chainId }: ChainlinkFeedT
           )}
         </div>
       )}
+      <FeedFreshnessSection feedFreshness={feedFreshness} />
 
       {/* External Links */}
       <div className="border-t border-gray-200/30 pt-3 dark:border-gray-600/20">

src/features/markets/components/oracle/MarketOracle/CompoundFeedTooltip.tsx

@@ -3,23 +3,25 @@ import Link from 'next/link';
 import type { Address } from 'viem';
 import etherscanLogo from '@/imgs/etherscan.png';
 import { getExplorerURL } from '@/utils/external';
-import { PriceFeedVendors, OracleVendorIcons, type FeedData } from '@/utils/oracle';
+import { OracleVendorIcons, PriceFeedVendors, type FeedData, type FeedFreshnessStatus } from '@/utils/oracle';
 import type { OracleFeed } from '@/utils/types';
+import { FeedFreshnessSection } from './FeedFreshnessSection';
 
 type CompoundFeedTooltipProps = {
   feed: OracleFeed;
   feedData?: FeedData | null;
   chainId: number;
+  feedFreshness?: FeedFreshnessStatus;
 };
 
-export function CompoundFeedTooltip({ feed, feedData, chainId }: CompoundFeedTooltipProps) {
+export function CompoundFeedTooltip({ feed, feedData, chainId, feedFreshness }: CompoundFeedTooltipProps) {
   const baseAsset = feed.pair?.[0] ?? feedData?.pair[0] ?? 'Unknown';
   const quoteAsset = feed.pair?.[1] ?? feedData?.pair[1] ?? 'Unknown';
 
   const compoundLogo = OracleVendorIcons[PriceFeedVendors.Compound];
 
   return (
-    <div className="flex max-w-xs flex-col gap-3">
+    <div className="flex w-fit max-w-[22rem] flex-col gap-3">
       {/* Header with icon and title */}
       <div className="flex items-center gap-2">
         {compoundLogo && (
@@ -49,6 +51,8 @@ export function CompoundFeedTooltip({ feed, feedData, chainId }: CompoundFeedToo
         </div>
       )}
 
+      <FeedFreshnessSection feedFreshness={feedFreshness} />
+
       {/* External Links */}
       <div className="border-t border-gray-200/30 pt-3 dark:border-gray-600/20">
         <div className="mb-2 font-zen text-sm font-medium text-gray-700 dark:text-gray-300">View on:</div>

src/features/markets/components/oracle/MarketOracle/FeedEntry.tsx

@@ -4,14 +4,22 @@ import Image from 'next/image';
 import { IoIosSwap } from 'react-icons/io';
 import { IoHelpCircleOutline } from 'react-icons/io5';
 import type { Address } from 'viem';
+import type { FeedSnapshotByAddress } from '@/hooks/useFeedLastUpdatedByChain';
 import {
   getFeedFromOracleData,
   getOracleFromMetadata,
   isMetaOracleData,
   type EnrichedFeed,
   type OracleMetadataRecord,
 } from '@/hooks/useOracleMetadata';
-import { detectFeedVendor, detectFeedVendorFromMetadata, getTruncatedAssetName, PriceFeedVendors, OracleVendorIcons } from '@/utils/oracle';
+import {
+  detectFeedVendor,
+  detectFeedVendorFromMetadata,
+  getFeedFreshnessStatus,
+  getTruncatedAssetName,
+  OracleVendorIcons,
+  PriceFeedVendors,
+} from '@/utils/oracle';
 import type { OracleFeed } from '@/utils/types';
 import { ChainlinkFeedTooltip } from './ChainlinkFeedTooltip';
 import { CompoundFeedTooltip } from './CompoundFeedTooltip';
@@ -26,9 +34,17 @@ type FeedEntryProps = {
   oracleAddress?: string;
   oracleMetadataMap?: OracleMetadataRecord;
   enrichedFeed?: EnrichedFeed;
+  feedSnapshotsByAddress?: FeedSnapshotByAddress;
 };
 
-export function FeedEntry({ feed, chainId, oracleAddress, oracleMetadataMap, enrichedFeed }: FeedEntryProps): JSX.Element | null {
+export function FeedEntry({
+  feed,
+  chainId,
+  oracleAddress,
+  oracleMetadataMap,
+  enrichedFeed,
+  feedSnapshotsByAddress,
+}: FeedEntryProps): JSX.Element | null {
   // Use metadata-based detection when available, fallback to legacy
   const feedVendorResult = useMemo(() => {
     if (!feed?.address) return null;
@@ -66,10 +82,13 @@ export function FeedEntry({ feed, chainId, oracleAddress, oracleMetadataMap, enr
   const showAssetPair = !(assetPair.baseAsset === 'Unknown' && assetPair.quoteAsset === 'Unknown');
 
   const vendorIcon = OracleVendorIcons[vendor];
-  const isChainlink = vendor === PriceFeedVendors.Chainlink;
-  const isCompound = vendor === PriceFeedVendors.Compound;
-  const isRedstone = vendor === PriceFeedVendors.Redstone;
-  const isPendle = vendor === PriceFeedVendors.Pendle;
+  const hasKnownVendorIcon = vendor !== PriceFeedVendors.Unknown && Boolean(vendorIcon);
+  const feedAddressKey = feed.address.toLowerCase();
+  const snapshot = feedSnapshotsByAddress?.[feedAddressKey];
+  const freshness = getFeedFreshnessStatus(snapshot?.updatedAt ?? null, data?.heartbeat, {
+    updateKind: snapshot?.updateKind,
+    normalizedPrice: snapshot?.normalizedPrice,
+  });
 
   const getTooltipContent = () => {
     switch (vendor) {
@@ -79,6 +98,7 @@ export function FeedEntry({ feed, chainId, oracleAddress, oracleMetadataMap, enr
             feed={feed}
             feedData={data}
             chainId={chainId}
+            feedFreshness={freshness}
           />
         );
 
@@ -88,6 +108,7 @@ export function FeedEntry({ feed, chainId, oracleAddress, oracleMetadataMap, enr
             feed={feed}
             feedData={data}
             chainId={chainId}
+            feedFreshness={freshness}
           />
         );
 
@@ -97,6 +118,7 @@ export function FeedEntry({ feed, chainId, oracleAddress, oracleMetadataMap, enr
             feed={feed}
             feedData={data}
             chainId={chainId}
+            feedFreshness={freshness}
           />
         );
 
@@ -106,6 +128,7 @@ export function FeedEntry({ feed, chainId, oracleAddress, oracleMetadataMap, enr
             feed={feed}
             feedData={data}
             chainId={chainId}
+            feedFreshness={freshness}
           />
         );
 
@@ -117,6 +140,7 @@ export function FeedEntry({ feed, chainId, oracleAddress, oracleMetadataMap, enr
             feed={feed}
             feedData={data}
             chainId={chainId}
+            feedFreshness={freshness}
           />
         );
 
@@ -127,6 +151,7 @@ export function FeedEntry({ feed, chainId, oracleAddress, oracleMetadataMap, enr
               feed={feed}
               feedData={data}
               chainId={chainId}
+              feedFreshness={freshness}
             />
           );
         }
@@ -148,7 +173,10 @@ export function FeedEntry({ feed, chainId, oracleAddress, oracleMetadataMap, enr
   };
 
   return (
-    <Tooltip content={getTooltipContent()}>
+    <Tooltip
+      content={getTooltipContent()}
+      className="w-fit max-w-[calc(100vw-2rem)]"
+    >
       <div className="bg-hovered flex w-full cursor-pointer items-center justify-between rounded-sm px-2 py-1 hover:bg-opacity-80 gap-1">
         {showAssetPair ? (
           <div className="flex min-w-0 flex-1 items-center gap-1">
@@ -166,7 +194,7 @@ export function FeedEntry({ feed, chainId, oracleAddress, oracleMetadataMap, enr
         )}
 
         <div className="flex flex-shrink-0 items-center gap-1">
-          {(isChainlink || isCompound || isRedstone || isPendle) && vendorIcon ? (
+          {hasKnownVendorIcon ? (
             <Image
               src={vendorIcon}
               alt="Oracle"

src/features/markets/components/oracle/MarketOracle/FeedFreshnessSection.tsx

@@ -0,0 +1,64 @@
+import { Badge } from '@/components/ui/badge';
+import { cn } from '@/utils/components';
+import { formatOracleDuration, formatOracleTimestamp, type FeedFreshnessStatus } from '@/utils/oracle';
+
+type FeedFreshnessSectionProps = {
+  feedFreshness?: FeedFreshnessStatus;
+  className?: string;
+};
+
+export function FeedFreshnessSection({ feedFreshness, className }: FeedFreshnessSectionProps) {
+  if (!feedFreshness) return null;
+
+  const updatedAt = feedFreshness.updatedAt;
+  const normalizedPrice = feedFreshness.normalizedPrice;
+  const hasTimestamp = updatedAt != null;
+  const hasPrice = normalizedPrice != null;
+  const isDerived = feedFreshness.updateKind === 'derived';
+  if (!hasTimestamp && !hasPrice && !isDerived) return null;
+
+  return (
+    <div className={cn('space-y-1 border-t border-gray-200/30 pt-2 dark:border-gray-600/20', className)}>
+      {normalizedPrice != null && (
+        <div className="flex items-center justify-between gap-1">
+          <span className="font-zen text-xs text-gray-600 dark:text-gray-400">Price:</span>
+          <span className="font-zen text-xs font-medium">{normalizedPrice}</span>
+        </div>
+      )}
+
+      {updatedAt != null && (
+        <div className="flex items-center justify-between gap-1">
+          <span className="font-zen text-xs text-gray-600 dark:text-gray-400">Last Updated:</span>
+          <span className="whitespace-nowrap text-right font-zen text-xs font-medium">{formatOracleTimestamp(updatedAt)}</span>
+        </div>
+      )}
+
+      {feedFreshness.ageSeconds != null && (
+        <div className="flex items-center justify-between gap-1">
+          <span className="font-zen text-xs text-gray-600 dark:text-gray-400">Age:</span>
+          <span className="text-right font-zen text-xs font-medium">{formatOracleDuration(feedFreshness.ageSeconds)} ago</span>
+        </div>
+      )}
+
+      {isDerived && (
+        <div className="flex items-center justify-between gap-1">
+          <span className="font-zen text-xs text-gray-600 dark:text-gray-400">Mode:</span>
+          <Badge
+            variant="primary"
+            size="sm"
+            className="font-zen"
+          >
+            DERIVED
+          </Badge>
+        </div>
+      )}
+
+      {feedFreshness.isStale && (
+        <div className="flex items-center justify-between gap-1">
+          <span className="font-zen text-xs text-gray-600 dark:text-gray-400">Status:</span>
+          <span className="text-right font-zen text-xs font-medium text-yellow-700 dark:text-yellow-300">Stale</span>
+        </div>
+      )}
+    </div>
+  );
+}