@metamask-previews/perps-controller 11.0.0-preview-9efd0b754 → 12.0.0-preview-4e64b66e8

package/dist/services/ServiceContext.d.cts

@@ -1,5 +1,5 @@
 import type { PerpsControllerState } from "../PerpsController.cjs";
-import type { Order, Position } from "../types/index.cjs";
+import type { Order, PerpsGlobalSnapshotRequest, PerpsSubscriptionFeeWaiverStatus, Position } from "../types/index.cjs";
 /**
  * ServiceContext
  *
@@ -55,6 +55,22 @@ export type ServiceContext = {
      */
     getOpenOrders?: () => Promise<Order[]>;
     getPositions?: () => Promise<Position[]>;
+    /**
+     * Exact per-call identity and guards for adopting a global market snapshot.
+     * Omitted when the active provider or DEX configuration is not static.
+     */
+    globalSnapshot?: {
+        request: PerpsGlobalSnapshotRequest;
+        isCurrent: () => boolean;
+        isMarketAllowed: (symbol: string) => boolean;
+    };
+    /**
+     * Cached subscription fee-waiver status for read-only fee previews.
+     * Read by the controller from `RewardsIntegrationService` — the same cached
+     * benefits snapshot the fee resolver uses — and omitted entirely when no
+     * subscription source is wired.
+     */
+    subscriptionFeeWaiver?: PerpsSubscriptionFeeWaiverStatus;
     /**
      * Callback functions for controller-specific operations
      */

package/dist/services/ServiceContext.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"ServiceContext.d.cts","sourceRoot":"","sources":["../../src/services/ServiceContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,+BAA8B;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,2BAA0B;AAEzD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,cAAc,EAAE;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IAEF;;;OAGG;IACH,YAAY,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IAEF;;;;OAIG;IACH,YAAY,CAAC,EAAE;QACb,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,KAAK,IAAI,CAAC;QACjE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;KACtC,CAAC;IAEF;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEzC;;OAEG;IACH,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpE;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM;QAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;KAC/B,CAAC;IACF,oBAAoB,CAAC,EAAE,CACrB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,QAAQ,GAAG,UAAU,KAC1B,IAAI,CAAC;IACV,aAAa,CAAC,EAAE,MAAM;QACpB,OAAO,EAAE,OAAO,CAAC;QACjB,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;KAC/B,CAAC;IACF,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE;QACvB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;KAC/B,KAAK,IAAI,CAAC;IACX,0BAA0B,CAAC,EAAE,MAAM,MAAM,CAAC;IAC1C,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C,CAAC"}
+{"version":3,"file":"ServiceContext.d.cts","sourceRoot":"","sources":["../../src/services/ServiceContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,+BAA8B;AAClE,OAAO,KAAK,EACV,KAAK,EACL,0BAA0B,EAC1B,gCAAgC,EAChC,QAAQ,EACT,2BAA0B;AAE3B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,cAAc,EAAE;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IAEF;;;OAGG;IACH,YAAY,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IAEF;;;;OAIG;IACH,YAAY,CAAC,EAAE;QACb,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,KAAK,IAAI,CAAC;QACjE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;KACtC,CAAC;IAEF;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEzC;;;OAGG;IACH,cAAc,CAAC,EAAE;QACf,OAAO,EAAE,0BAA0B,CAAC;QACpC,SAAS,EAAE,MAAM,OAAO,CAAC;QACzB,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;KAC9C,CAAC;IAEF;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,gCAAgC,CAAC;IAEzD;;OAEG;IACH,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpE;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM;QAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;KAC/B,CAAC;IACF,oBAAoB,CAAC,EAAE,CACrB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,QAAQ,GAAG,UAAU,KAC1B,IAAI,CAAC;IACV,aAAa,CAAC,EAAE,MAAM;QACpB,OAAO,EAAE,OAAO,CAAC;QACjB,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;KAC/B,CAAC;IACF,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE;QACvB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;KAC/B,KAAK,IAAI,CAAC;IACX,0BAA0B,CAAC,EAAE,MAAM,MAAM,CAAC;IAC1C,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C,CAAC"}

package/dist/services/ServiceContext.d.mts

@@ -1,5 +1,5 @@
 import type { PerpsControllerState } from "../PerpsController.mjs";
-import type { Order, Position } from "../types/index.mjs";
+import type { Order, PerpsGlobalSnapshotRequest, PerpsSubscriptionFeeWaiverStatus, Position } from "../types/index.mjs";
 /**
  * ServiceContext
  *
@@ -55,6 +55,22 @@ export type ServiceContext = {
      */
     getOpenOrders?: () => Promise<Order[]>;
     getPositions?: () => Promise<Position[]>;
+    /**
+     * Exact per-call identity and guards for adopting a global market snapshot.
+     * Omitted when the active provider or DEX configuration is not static.
+     */
+    globalSnapshot?: {
+        request: PerpsGlobalSnapshotRequest;
+        isCurrent: () => boolean;
+        isMarketAllowed: (symbol: string) => boolean;
+    };
+    /**
+     * Cached subscription fee-waiver status for read-only fee previews.
+     * Read by the controller from `RewardsIntegrationService` — the same cached
+     * benefits snapshot the fee resolver uses — and omitted entirely when no
+     * subscription source is wired.
+     */
+    subscriptionFeeWaiver?: PerpsSubscriptionFeeWaiverStatus;
     /**
      * Callback functions for controller-specific operations
      */

package/dist/services/ServiceContext.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ServiceContext.d.mts","sourceRoot":"","sources":["../../src/services/ServiceContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,+BAA8B;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,2BAA0B;AAEzD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,cAAc,EAAE;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IAEF;;;OAGG;IACH,YAAY,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IAEF;;;;OAIG;IACH,YAAY,CAAC,EAAE;QACb,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,KAAK,IAAI,CAAC;QACjE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;KACtC,CAAC;IAEF;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEzC;;OAEG;IACH,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpE;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM;QAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;KAC/B,CAAC;IACF,oBAAoB,CAAC,EAAE,CACrB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,QAAQ,GAAG,UAAU,KAC1B,IAAI,CAAC;IACV,aAAa,CAAC,EAAE,MAAM;QACpB,OAAO,EAAE,OAAO,CAAC;QACjB,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;KAC/B,CAAC;IACF,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE;QACvB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;KAC/B,KAAK,IAAI,CAAC;IACX,0BAA0B,CAAC,EAAE,MAAM,MAAM,CAAC;IAC1C,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C,CAAC"}
+{"version":3,"file":"ServiceContext.d.mts","sourceRoot":"","sources":["../../src/services/ServiceContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,+BAA8B;AAClE,OAAO,KAAK,EACV,KAAK,EACL,0BAA0B,EAC1B,gCAAgC,EAChC,QAAQ,EACT,2BAA0B;AAE3B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,cAAc,EAAE;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IAEF;;;OAGG;IACH,YAAY,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IAEF;;;;OAIG;IACH,YAAY,CAAC,EAAE;QACb,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,KAAK,IAAI,CAAC;QACjE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;KACtC,CAAC;IAEF;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEzC;;;OAGG;IACH,cAAc,CAAC,EAAE;QACf,OAAO,EAAE,0BAA0B,CAAC;QACpC,SAAS,EAAE,MAAM,OAAO,CAAC;QACzB,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;KAC9C,CAAC;IAEF;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,gCAAgC,CAAC;IAEzD;;OAEG;IACH,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpE;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM;QAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;KAC/B,CAAC;IACF,oBAAoB,CAAC,EAAE,CACrB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,QAAQ,GAAG,UAAU,KAC1B,IAAI,CAAC;IACV,aAAa,CAAC,EAAE,MAAM;QACpB,OAAO,EAAE,OAAO,CAAC;QACjB,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;KAC/B,CAAC;IACF,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE;QACvB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;KAC/B,KAAK,IAAI,CAAC;IACX,0BAA0B,CAAC,EAAE,MAAM,MAAM,CAAC;IAC1C,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C,CAAC"}

package/dist/services/ServiceContext.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ServiceContext.mjs","sourceRoot":"","sources":["../../src/services/ServiceContext.ts"],"names":[],"mappings":"","sourcesContent":["import type { PerpsControllerState } from '../PerpsController.js';\nimport type { Order, Position } from '../types/index.js';\n\n/**\n * ServiceContext\n *\n * Lightweight per-call context for Perps services.\n * Contains ONLY data that varies per operation:\n * - Tracing context (provider, network)\n * - Error context (controller, method)\n * - State management callbacks\n * - Query/action callbacks specific to the operation\n *\n * Platform dependencies (logging, metrics, tracing) are injected into service\n * instances via constructor, not passed per-call.\n *\n * Controller-level singletons (RewardsController, NetworkController, messenger)\n * are also injected into services that need them, not passed per-call.\n *\n * This enables:\n * - Clean method signatures (no verbose dependency passing)\n * - Fat services with complete orchestration\n * - Thin controller with pure delegation\n * - Easy testing through mock contexts and constructor injection\n */\nexport type ServiceContext = {\n  /**\n   * Tracing context for performance monitoring\n   * Used in trace() calls to tag operations\n   */\n  tracingContext: {\n    provider: string;\n    isTestnet: boolean;\n  };\n\n  /**\n   * Error logging context\n   * Provides consistent error logging across services\n   */\n  errorContext: {\n    controller: string;\n    method: string;\n    extra?: Record<string, unknown>;\n  };\n\n  /**\n   * State management functions (optional)\n   * Only provided for operations that need to mutate controller state\n   * Example: Trading operations that update lastTransaction\n   */\n  stateManager?: {\n    update: (updater: (state: PerpsControllerState) => void) => void;\n    getState: () => PerpsControllerState;\n  };\n\n  /**\n   * Query functions for dependent data\n   * Required by: Operations that need to fetch related data\n   */\n  getOpenOrders?: () => Promise<Order[]>;\n  getPositions?: () => Promise<Position[]>;\n\n  /**\n   * Callback functions for controller-specific operations\n   */\n  saveTradeConfiguration?: (symbol: string, leverage: number) => void;\n\n  /**\n   * Feature flag configuration callbacks\n   * Required by: FeatureFlagConfigurationService\n   */\n  getBlockedRegionList?: () => {\n    list: string[];\n    source: 'remote' | 'fallback';\n  };\n  setBlockedRegionList?: (\n    list: string[],\n    source: 'remote' | 'fallback',\n  ) => void;\n  getHip3Config?: () => {\n    enabled: boolean;\n    allowlistMarkets: string[];\n    blocklistMarkets: string[];\n    source: 'remote' | 'fallback';\n  };\n  setHip3Config?: (config: {\n    enabled?: boolean;\n    allowlistMarkets?: string[];\n    blocklistMarkets?: string[];\n    source: 'remote' | 'fallback';\n  }) => void;\n  incrementHip3ConfigVersion?: () => number;\n  refreshEligibility?: () => Promise<void>;\n};\n"]}
+{"version":3,"file":"ServiceContext.mjs","sourceRoot":"","sources":["../../src/services/ServiceContext.ts"],"names":[],"mappings":"","sourcesContent":["import type { PerpsControllerState } from '../PerpsController.js';\nimport type {\n  Order,\n  PerpsGlobalSnapshotRequest,\n  PerpsSubscriptionFeeWaiverStatus,\n  Position,\n} from '../types/index.js';\n\n/**\n * ServiceContext\n *\n * Lightweight per-call context for Perps services.\n * Contains ONLY data that varies per operation:\n * - Tracing context (provider, network)\n * - Error context (controller, method)\n * - State management callbacks\n * - Query/action callbacks specific to the operation\n *\n * Platform dependencies (logging, metrics, tracing) are injected into service\n * instances via constructor, not passed per-call.\n *\n * Controller-level singletons (RewardsController, NetworkController, messenger)\n * are also injected into services that need them, not passed per-call.\n *\n * This enables:\n * - Clean method signatures (no verbose dependency passing)\n * - Fat services with complete orchestration\n * - Thin controller with pure delegation\n * - Easy testing through mock contexts and constructor injection\n */\nexport type ServiceContext = {\n  /**\n   * Tracing context for performance monitoring\n   * Used in trace() calls to tag operations\n   */\n  tracingContext: {\n    provider: string;\n    isTestnet: boolean;\n  };\n\n  /**\n   * Error logging context\n   * Provides consistent error logging across services\n   */\n  errorContext: {\n    controller: string;\n    method: string;\n    extra?: Record<string, unknown>;\n  };\n\n  /**\n   * State management functions (optional)\n   * Only provided for operations that need to mutate controller state\n   * Example: Trading operations that update lastTransaction\n   */\n  stateManager?: {\n    update: (updater: (state: PerpsControllerState) => void) => void;\n    getState: () => PerpsControllerState;\n  };\n\n  /**\n   * Query functions for dependent data\n   * Required by: Operations that need to fetch related data\n   */\n  getOpenOrders?: () => Promise<Order[]>;\n  getPositions?: () => Promise<Position[]>;\n\n  /**\n   * Exact per-call identity and guards for adopting a global market snapshot.\n   * Omitted when the active provider or DEX configuration is not static.\n   */\n  globalSnapshot?: {\n    request: PerpsGlobalSnapshotRequest;\n    isCurrent: () => boolean;\n    isMarketAllowed: (symbol: string) => boolean;\n  };\n\n  /**\n   * Cached subscription fee-waiver status for read-only fee previews.\n   * Read by the controller from `RewardsIntegrationService` — the same cached\n   * benefits snapshot the fee resolver uses — and omitted entirely when no\n   * subscription source is wired.\n   */\n  subscriptionFeeWaiver?: PerpsSubscriptionFeeWaiverStatus;\n\n  /**\n   * Callback functions for controller-specific operations\n   */\n  saveTradeConfiguration?: (symbol: string, leverage: number) => void;\n\n  /**\n   * Feature flag configuration callbacks\n   * Required by: FeatureFlagConfigurationService\n   */\n  getBlockedRegionList?: () => {\n    list: string[];\n    source: 'remote' | 'fallback';\n  };\n  setBlockedRegionList?: (\n    list: string[],\n    source: 'remote' | 'fallback',\n  ) => void;\n  getHip3Config?: () => {\n    enabled: boolean;\n    allowlistMarkets: string[];\n    blocklistMarkets: string[];\n    source: 'remote' | 'fallback';\n  };\n  setHip3Config?: (config: {\n    enabled?: boolean;\n    allowlistMarkets?: string[];\n    blocklistMarkets?: string[];\n    source: 'remote' | 'fallback';\n  }) => void;\n  incrementHip3ConfigVersion?: () => number;\n  refreshEligibility?: () => Promise<void>;\n};\n"]}

package/dist/services/TerminalMarketService.cjs

@@ -10,17 +10,70 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _TerminalMarketService_instances, _TerminalMarketService_deps, _TerminalMarketService_cache, _TerminalMarketService_validateItems, _TerminalMarketService_mapToMarketInfo, _TerminalMarketService_extractMetadata;
+var _TerminalMarketService_instances, _TerminalMarketService_deps, _TerminalMarketService_cache, _TerminalMarketService_globalSnapshotCache, _TerminalMarketService_globalSnapshotInFlight, _TerminalMarketService_globalSnapshotGeneration, _TerminalMarketService_fetchAndValidateGlobalSnapshot, _TerminalMarketService_validateAndMapGlobalSnapshot, _TerminalMarketService_validateRequestedIdentity, _TerminalMarketService_buildGlobalSnapshotUrl, _TerminalMarketService_normalizeDexes, _TerminalMarketService_createFingerprint, _TerminalMarketService_validateSnapshotMarket, _TerminalMarketService_mapSnapshotMarket, _TerminalMarketService_marketTypeFor, _TerminalMarketService_cloneGlobalSnapshotResult, _TerminalMarketService_isNonNegativeSafeInteger, _TerminalMarketService_isPositiveSafeInteger, _TerminalMarketService_validateItems, _TerminalMarketService_mapToMarketInfo, _TerminalMarketService_extractMetadata;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TerminalMarketService = void 0;
 const superstruct_1 = require("@metamask/superstruct");
+const utils_1 = require("@metamask/utils");
+const hyperLiquidConfig_js_1 = require("../constants/hyperLiquidConfig.cjs");
 const perpsConfig_js_1 = require("../constants/perpsConfig.cjs");
 const index_js_1 = require("../types/index.cjs");
 const errorUtils_js_1 = require("../utils/errorUtils.cjs");
+const marketDataTransform_js_1 = require("../utils/marketDataTransform.cjs");
+const marketUtils_js_1 = require("../utils/marketUtils.cjs");
 const VALID_MARKET_TYPES = new Set(Object.values(index_js_1.MarketCategory));
+const GLOBAL_SNAPSHOT_SCHEMA_VERSION = 2;
+const GLOBAL_SNAPSHOT_CONSUMER_MAX_AGE_MS = 30000;
+const GLOBAL_SNAPSHOT_MAX_PAYLOAD_BYTES = 1048576;
+const GLOBAL_SNAPSHOT_PERCENT_TOLERANCE = 0.01;
+const GLOBAL_SNAPSHOT_MAX_FUTURE_CLOCK_SKEW_MS = 5000;
+const MINIMUM_EPOCH_MILLISECONDS = Date.UTC(2000, 0, 1);
+const DECIMAL_PATTERN = /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/u;
+const NON_NEGATIVE_DECIMAL_PATTERN = /^(?:0|[1-9]\d*)(?:\.\d+)?$/u;
+const DEX_PATTERN = /^(?:main|[a-z0-9][a-z0-9-]*)$/u;
+const GlobalSnapshotMarketStruct = (0, superstruct_1.object)({
+    symbol: (0, superstruct_1.string)(),
+    provider: (0, superstruct_1.string)(),
+    dex: (0, superstruct_1.string)(),
+    name: (0, superstruct_1.nullable)((0, superstruct_1.string)()),
+    description: (0, superstruct_1.nullable)((0, superstruct_1.string)()),
+    iconUrl: (0, superstruct_1.nullable)((0, superstruct_1.string)()),
+    szDecimals: (0, superstruct_1.number)(),
+    maxLeverage: (0, superstruct_1.number)(),
+    markPrice: (0, superstruct_1.string)(),
+    price: (0, superstruct_1.string)(),
+    midPrice: (0, superstruct_1.nullable)((0, superstruct_1.string)()),
+    oraclePrice: (0, superstruct_1.string)(),
+    change24h: (0, superstruct_1.string)(),
+    changePercent24h: (0, superstruct_1.number)(),
+    funding: (0, superstruct_1.string)(),
+    volume24h: (0, superstruct_1.string)(),
+    openInterest: (0, superstruct_1.string)(),
+    category: (0, superstruct_1.nullable)((0, superstruct_1.string)()),
+    keywords: (0, superstruct_1.nullable)((0, superstruct_1.array)((0, superstruct_1.string)())),
+    tags: (0, superstruct_1.nullable)((0, superstruct_1.array)((0, superstruct_1.string)())),
+    listedAt: (0, superstruct_1.nullable)((0, superstruct_1.number)()),
+    trend: (0, superstruct_1.array)((0, superstruct_1.tuple)([(0, superstruct_1.number)(), (0, superstruct_1.string)()])),
+});
+const GlobalSnapshotStruct = (0, superstruct_1.object)({
+    schemaVersion: (0, superstruct_1.number)(),
+    provider: (0, superstruct_1.string)(),
+    network: (0, superstruct_1.string)(),
+    enabledDexes: (0, superstruct_1.array)((0, superstruct_1.string)()),
+    fingerprint: (0, superstruct_1.string)(),
+    generatedAt: (0, superstruct_1.number)(),
+    receivedAt: (0, superstruct_1.number)(),
+    maxAgeMs: (0, superstruct_1.number)(),
+    complete: (0, superstruct_1.boolean)(),
+    perDexErrors: (0, superstruct_1.array)((0, superstruct_1.object)({
+        dex: (0, superstruct_1.string)(),
+        error: (0, superstruct_1.string)(),
+    })),
+    markets: (0, superstruct_1.array)(GlobalSnapshotMarketStruct),
+});
 /**
  * Runtime validation schema for a single market item returned by
- * `GET {terminalApiUrl}`.
+ * `GET {terminalApi.marketDataUrl}`.
  *
  * Uses `type()` (loose object matching) so that extra fields the API sends
  * (e.g. `price`, `iconUrl`, `trend`) are silently accepted.
@@ -57,6 +110,9 @@ class TerminalMarketService {
         _TerminalMarketService_instances.add(this);
         _TerminalMarketService_deps.set(this, void 0);
         _TerminalMarketService_cache.set(this, null);
+        _TerminalMarketService_globalSnapshotCache.set(this, new Map());
+        _TerminalMarketService_globalSnapshotInFlight.set(this, new Map());
+        _TerminalMarketService_globalSnapshotGeneration.set(this, 0);
         __classPrivateFieldSet(this, _TerminalMarketService_deps, deps, "f");
     }
     /**
@@ -73,10 +129,11 @@ class TerminalMarketService {
                 metadata: __classPrivateFieldGet(this, _TerminalMarketService_cache, "f").metadata,
             };
         }
-        if (!__classPrivateFieldGet(this, _TerminalMarketService_deps, "f").terminalApiUrl) {
-            throw new Error('Terminal API URL not configured (terminalApiUrl is required)');
+        const marketDataUrl = __classPrivateFieldGet(this, _TerminalMarketService_deps, "f").terminalApi?.marketDataUrl ?? __classPrivateFieldGet(this, _TerminalMarketService_deps, "f").terminalApiUrl;
+        if (!marketDataUrl) {
+            throw new Error('Terminal API market-data URL not configured');
         }
-        const url = __classPrivateFieldGet(this, _TerminalMarketService_deps, "f").terminalApiUrl;
+        const url = marketDataUrl;
         const controller = new AbortController();
         const timeoutId = setTimeout(() => controller.abort(new Error('Terminal API fetch timed out')), perpsConfig_js_1.TERMINAL_API_CONFIG.FetchTimeoutMs);
         let response;
@@ -103,11 +160,65 @@ class TerminalMarketService {
         __classPrivateFieldSet(this, _TerminalMarketService_cache, { markets, metadata, timestamp: Date.now() }, "f");
         return { markets, metadata };
     }
+    /**
+     * Fetch, authenticate by exact identity, and map a schema-v2 atomic market
+     * snapshot. Accepted entries remain inside the source freshness window;
+     * rejected responses are never cached.
+     *
+     * @param request - Exact provider/network/DEX identity expected by the client.
+     * @returns UI-ready market data and its source-bounded expiry.
+     */
+    async fetchGlobalSnapshot(request) {
+        const identity = __classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_validateRequestedIdentity).call(this, request);
+        if (!__classPrivateFieldGet(this, _TerminalMarketService_deps, "f").terminalApi?.globalSnapshotUrl) {
+            throw new Error('Terminal global snapshot URL not configured');
+        }
+        const url = __classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_buildGlobalSnapshotUrl).call(this, __classPrivateFieldGet(this, _TerminalMarketService_deps, "f").terminalApi.globalSnapshotUrl, identity);
+        const cacheKey = [
+            url,
+            String(GLOBAL_SNAPSHOT_SCHEMA_VERSION),
+            identity.provider,
+            identity.network,
+            identity.enabledDexes.join(','),
+        ].join('|');
+        const now = Date.now();
+        const cached = __classPrivateFieldGet(this, _TerminalMarketService_globalSnapshotCache, "f").get(cacheKey);
+        if (cached && now < cached.expiresAt) {
+            return __classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_cloneGlobalSnapshotResult).call(this, cached);
+        }
+        if (cached) {
+            __classPrivateFieldGet(this, _TerminalMarketService_globalSnapshotCache, "f").delete(cacheKey);
+        }
+        const existing = __classPrivateFieldGet(this, _TerminalMarketService_globalSnapshotInFlight, "f").get(cacheKey);
+        if (existing) {
+            return __classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_cloneGlobalSnapshotResult).call(this, await existing);
+        }
+        const generation = __classPrivateFieldGet(this, _TerminalMarketService_globalSnapshotGeneration, "f");
+        const pending = __classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_fetchAndValidateGlobalSnapshot).call(this, identity, url).then((result) => {
+            if (__classPrivateFieldGet(this, _TerminalMarketService_globalSnapshotGeneration, "f") !== generation) {
+                return result;
+            }
+            __classPrivateFieldGet(this, _TerminalMarketService_globalSnapshotCache, "f").set(cacheKey, result);
+            return result;
+        });
+        __classPrivateFieldGet(this, _TerminalMarketService_globalSnapshotInFlight, "f").set(cacheKey, pending);
+        try {
+            return __classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_cloneGlobalSnapshotResult).call(this, await pending);
+        }
+        finally {
+            if (__classPrivateFieldGet(this, _TerminalMarketService_globalSnapshotInFlight, "f").get(cacheKey) === pending) {
+                __classPrivateFieldGet(this, _TerminalMarketService_globalSnapshotInFlight, "f").delete(cacheKey);
+            }
+        }
+    }
     /**
      * Invalidate the internal cache so the next fetch hits the network.
      */
     clearCache() {
         __classPrivateFieldSet(this, _TerminalMarketService_cache, null, "f");
+        __classPrivateFieldSet(this, _TerminalMarketService_globalSnapshotGeneration, __classPrivateFieldGet(this, _TerminalMarketService_globalSnapshotGeneration, "f") + 1, "f");
+        __classPrivateFieldGet(this, _TerminalMarketService_globalSnapshotCache, "f").clear();
+        __classPrivateFieldGet(this, _TerminalMarketService_globalSnapshotInFlight, "f").clear();
     }
     /**
      * Log a Terminal API error to Sentry without surfacing it to the user.
@@ -120,13 +231,317 @@ class TerminalMarketService {
             tags: { feature: perpsConfig_js_1.PERPS_CONSTANTS.FeatureName, source: 'terminal-api' },
             context: {
                 name: `TerminalMarketService.${method}`,
-                data: { url: __classPrivateFieldGet(this, _TerminalMarketService_deps, "f").terminalApiUrl },
+                data: {
+                    url: method.includes('globalSnapshot')
+                        ? __classPrivateFieldGet(this, _TerminalMarketService_deps, "f").terminalApi?.globalSnapshotUrl
+                        : (__classPrivateFieldGet(this, _TerminalMarketService_deps, "f").terminalApi?.marketDataUrl ??
+                            __classPrivateFieldGet(this, _TerminalMarketService_deps, "f").terminalApiUrl),
+                },
             },
         });
     }
 }
 exports.TerminalMarketService = TerminalMarketService;
-_TerminalMarketService_deps = new WeakMap(), _TerminalMarketService_cache = new WeakMap(), _TerminalMarketService_instances = new WeakSet(), _TerminalMarketService_validateItems = function _TerminalMarketService_validateItems(raw) {
+_TerminalMarketService_deps = new WeakMap(), _TerminalMarketService_cache = new WeakMap(), _TerminalMarketService_globalSnapshotCache = new WeakMap(), _TerminalMarketService_globalSnapshotInFlight = new WeakMap(), _TerminalMarketService_globalSnapshotGeneration = new WeakMap(), _TerminalMarketService_instances = new WeakSet(), _TerminalMarketService_fetchAndValidateGlobalSnapshot = async function _TerminalMarketService_fetchAndValidateGlobalSnapshot(identity, url) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(new Error('Terminal global snapshot timed out')), perpsConfig_js_1.TERMINAL_API_CONFIG.FetchTimeoutMs);
+    try {
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: { 'Content-Type': 'application/json' },
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            throw new Error(`Terminal global snapshot returned ${String(response.status)}: ${response.statusText}`);
+        }
+        const declaredLength = response.headers?.get('content-length');
+        if (declaredLength !== null &&
+            declaredLength !== undefined &&
+            /^\d+$/u.test(declaredLength) &&
+            Number(declaredLength) > GLOBAL_SNAPSHOT_MAX_PAYLOAD_BYTES) {
+            throw new Error('Terminal global snapshot payload exceeds 1 MiB');
+        }
+        // React Native fetch does not consistently expose a streaming reader.
+        // Reject declared oversize bodies before allocation, then enforce the same
+        // byte cap after text() for servers that omit Content-Length.
+        const text = await response.text();
+        if ((0, utils_1.stringToBytes)(text).byteLength > GLOBAL_SNAPSHOT_MAX_PAYLOAD_BYTES) {
+            throw new Error('Terminal global snapshot payload exceeds 1 MiB');
+        }
+        let body;
+        try {
+            body = JSON.parse(text);
+        }
+        catch {
+            throw new Error('Terminal global snapshot returned invalid JSON');
+        }
+        if (!(0, superstruct_1.is)(body, GlobalSnapshotStruct)) {
+            throw new Error('Terminal global snapshot failed schema validation');
+        }
+        return __classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_validateAndMapGlobalSnapshot).call(this, body, identity, Date.now());
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}, _TerminalMarketService_validateAndMapGlobalSnapshot = async function _TerminalMarketService_validateAndMapGlobalSnapshot(snapshot, identity, now) {
+    if (snapshot.schemaVersion !== GLOBAL_SNAPSHOT_SCHEMA_VERSION) {
+        throw new Error('Terminal global snapshot schema version mismatch');
+    }
+    if (snapshot.provider !== identity.provider ||
+        snapshot.network !== identity.network) {
+        throw new Error('Terminal global snapshot identity mismatch');
+    }
+    const responseDexes = __classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_normalizeDexes).call(this, snapshot.enabledDexes);
+    if (responseDexes.length !== identity.enabledDexes.length ||
+        responseDexes.some((dex, index) => dex !== identity.enabledDexes[index])) {
+        throw new Error('Terminal global snapshot DEX mismatch');
+    }
+    const expectedFingerprint = await __classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_createFingerprint).call(this, identity);
+    if (snapshot.fingerprint !== expectedFingerprint) {
+        throw new Error('Terminal global snapshot fingerprint mismatch');
+    }
+    if (!snapshot.complete || snapshot.perDexErrors.length > 0) {
+        throw new Error('Terminal global snapshot is incomplete');
+    }
+    if (!__classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_isNonNegativeSafeInteger).call(this, snapshot.generatedAt) ||
+        !__classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_isNonNegativeSafeInteger).call(this, snapshot.receivedAt) ||
+        !__classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_isPositiveSafeInteger).call(this, snapshot.maxAgeMs) ||
+        snapshot.receivedAt > snapshot.generatedAt ||
+        snapshot.generatedAt > now + GLOBAL_SNAPSHOT_MAX_FUTURE_CLOCK_SKEW_MS ||
+        snapshot.receivedAt > now + GLOBAL_SNAPSHOT_MAX_FUTURE_CLOCK_SKEW_MS) {
+        throw new Error('Terminal global snapshot has invalid timestamps');
+    }
+    const trustedMaxAgeMs = Math.min(snapshot.maxAgeMs, GLOBAL_SNAPSHOT_CONSUMER_MAX_AGE_MS);
+    const expiresAt = snapshot.receivedAt + trustedMaxAgeMs;
+    if (now >= expiresAt) {
+        throw new Error('Terminal global snapshot is stale');
+    }
+    if (snapshot.markets.length === 0) {
+        throw new Error('Terminal global snapshot has no markets');
+    }
+    const marketKeys = new Set();
+    const representedDexes = new Set();
+    const markets = snapshot.markets
+        .map((market, index) => {
+        __classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_validateSnapshotMarket).call(this, market, identity, index, snapshot.generatedAt);
+        const key = `${market.dex}:${market.symbol}`;
+        if (marketKeys.has(key)) {
+            throw new Error(`Terminal global snapshot duplicates market ${key}`);
+        }
+        marketKeys.add(key);
+        representedDexes.add(market.dex);
+        return market;
+    })
+        .map((market) => __classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_mapSnapshotMarket).call(this, market, expiresAt));
+    if (identity.enabledDexes.some((dex) => !representedDexes.has(dex))) {
+        throw new Error('Terminal global snapshot is missing a requested DEX');
+    }
+    if (markets.length === 0) {
+        throw new Error('Terminal global snapshot has no tradable markets');
+    }
+    return { markets, expiresAt };
+}, _TerminalMarketService_validateRequestedIdentity = function _TerminalMarketService_validateRequestedIdentity(request) {
+    if (request.provider !== 'hyperliquid') {
+        throw new Error('Terminal global snapshot provider is unsupported');
+    }
+    if (request.network !== 'mainnet' && request.network !== 'testnet') {
+        throw new Error('Terminal global snapshot network is unsupported');
+    }
+    return {
+        provider: request.provider,
+        network: request.network,
+        enabledDexes: __classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_normalizeDexes).call(this, request.enabledDexes),
+    };
+}, _TerminalMarketService_buildGlobalSnapshotUrl = function _TerminalMarketService_buildGlobalSnapshotUrl(baseUrl, identity) {
+    const query = new URLSearchParams({
+        provider: identity.provider,
+        network: identity.network,
+        dexes: identity.enabledDexes.join(','),
+    });
+    return `${baseUrl}${baseUrl.includes('?') ? '&' : '?'}${query.toString()}`;
+}, _TerminalMarketService_normalizeDexes = function _TerminalMarketService_normalizeDexes(dexes) {
+    if (!Array.isArray(dexes) || dexes.length === 0) {
+        throw new Error('Terminal global snapshot requires at least one DEX');
+    }
+    const normalized = dexes.map((dex) => {
+        if (typeof dex !== 'string' || !DEX_PATTERN.test(dex)) {
+            throw new Error('Terminal global snapshot contains an invalid DEX');
+        }
+        return dex;
+    });
+    if (new Set(normalized).size !== normalized.length) {
+        throw new Error('Terminal global snapshot contains duplicate DEXes');
+    }
+    if (!normalized.includes('main')) {
+        throw new Error('Terminal global snapshot requires the main DEX');
+    }
+    return (0, hyperLiquidConfig_js_1.canonicalizeHyperLiquidDexes)(normalized);
+}, _TerminalMarketService_createFingerprint = async function _TerminalMarketService_createFingerprint(identity) {
+    const canonicalIdentity = JSON.stringify({
+        provider: identity.provider,
+        network: identity.network,
+        enabledDexes: identity.enabledDexes,
+    });
+    const digest = await (0, utils_1.sha256)((0, utils_1.stringToBytes)(canonicalIdentity));
+    return `sha256:${(0, utils_1.bytesToHex)(digest).slice(2)}`;
+}, _TerminalMarketService_validateSnapshotMarket = function _TerminalMarketService_validateSnapshotMarket(market, identity, index, generatedAt) {
+    const invalid = (field) => new Error(`Terminal global snapshot market ${String(index)} has invalid ${field}`);
+    if (!identity.enabledDexes.includes(market.dex)) {
+        throw invalid('dex');
+    }
+    const expectedProvider = market.dex === 'main' ? 'hyperliquid' : market.dex;
+    if (market.provider !== expectedProvider) {
+        throw invalid('provider');
+    }
+    const expectedPrefix = market.dex === 'main' ? '' : `${market.dex}:`;
+    if (market.symbol.length === 0 ||
+        (expectedPrefix
+            ? !market.symbol.startsWith(expectedPrefix)
+            : market.symbol.includes(':'))) {
+        throw invalid('symbol');
+    }
+    if (!__classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_isNonNegativeSafeInteger).call(this, market.szDecimals) ||
+        !__classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_isPositiveSafeInteger).call(this, market.maxLeverage) ||
+        (market.listedAt !== null &&
+            (!__classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_isNonNegativeSafeInteger).call(this, market.listedAt) ||
+                market.listedAt < MINIMUM_EPOCH_MILLISECONDS ||
+                market.listedAt > generatedAt))) {
+        throw invalid('integer field');
+    }
+    const decimalFields = [
+        ['markPrice', market.markPrice, true],
+        ['price', market.price, true],
+        ['oraclePrice', market.oraclePrice, true],
+        ['change24h', market.change24h, false],
+        ['volume24h', market.volume24h, true],
+        ['openInterest', market.openInterest, true],
+        ['funding', market.funding, false],
+    ];
+    if (market.midPrice !== null) {
+        decimalFields.push(['midPrice', market.midPrice, true]);
+    }
+    for (const [field, value, nonNegative] of decimalFields) {
+        const pattern = nonNegative
+            ? NON_NEGATIVE_DECIMAL_PATTERN
+            : DECIMAL_PATTERN;
+        if (!pattern.test(value) || !Number.isFinite(Number(value))) {
+            throw invalid(field);
+        }
+    }
+    if (market.price !== market.markPrice) {
+        throw invalid('deprecated price alias');
+    }
+    if (Number(market.oraclePrice) <= 0 ||
+        (market.midPrice !== null && Number(market.midPrice) <= 0)) {
+        throw invalid('reference price');
+    }
+    const price = Number(market.markPrice);
+    const change24h = Number(market.change24h);
+    const previousPrice = price - change24h;
+    if (price <= 0 || previousPrice <= 0 || !Number.isFinite(previousPrice)) {
+        throw invalid('mark/change coherence');
+    }
+    const derivedPercent = (change24h / previousPrice) * 100;
+    if (!Number.isFinite(derivedPercent) ||
+        !Number.isFinite(market.changePercent24h) ||
+        Math.abs(market.changePercent24h - derivedPercent) >
+            GLOBAL_SNAPSHOT_PERCENT_TOLERANCE) {
+        throw invalid('changePercent24h coherence');
+    }
+    for (const [field, values] of [
+        ['keywords', market.keywords],
+        ['tags', market.tags],
+    ]) {
+        if (values !== null &&
+            (values.some((value) => value.length === 0) ||
+                new Set(values).size !== values.length)) {
+            throw invalid(field);
+        }
+    }
+    for (const [field, value] of [
+        ['name', market.name],
+        ['description', market.description],
+        ['iconUrl', market.iconUrl],
+        ['category', market.category],
+    ]) {
+        if (value !== null && value.length === 0) {
+            throw invalid(field);
+        }
+    }
+    let previousTrendTimestamp = -1;
+    for (const [timestamp, trendPrice] of market.trend) {
+        if (!__classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_isNonNegativeSafeInteger).call(this, timestamp) ||
+            timestamp < MINIMUM_EPOCH_MILLISECONDS ||
+            timestamp > generatedAt ||
+            timestamp <= previousTrendTimestamp ||
+            !NON_NEGATIVE_DECIMAL_PATTERN.test(trendPrice) ||
+            !Number.isFinite(Number(trendPrice)) ||
+            Number(trendPrice) <= 0) {
+            throw invalid('trend');
+        }
+        previousTrendTimestamp = timestamp;
+    }
+}, _TerminalMarketService_mapSnapshotMarket = function _TerminalMarketService_mapSnapshotMarket(market, sourceExpiresAt) {
+    const formatters = __classPrivateFieldGet(this, _TerminalMarketService_deps, "f").marketDataFormatters;
+    // Keep both provider price semantics explicit in the wire contract. Core
+    // maps markPrice to its UI price while retaining validation of midPrice.
+    const price = Number(market.markPrice);
+    const change24h = Number(market.change24h);
+    const volume = Number(market.volume24h);
+    const openInterest = Number(market.openInterest);
+    const isHip3 = market.dex !== 'main';
+    const marketType = __classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_marketTypeFor).call(this, market.dex, market.category);
+    return {
+        symbol: market.symbol,
+        name: market.name ?? market.symbol,
+        ...(market.description !== null && {
+            description: market.description,
+        }),
+        maxLeverage: `${String(market.maxLeverage)}x`,
+        price: formatters.formatPerpsFiat(price, {
+            ranges: formatters.priceRangesUniversal,
+        }),
+        change24h: (0, marketDataTransform_js_1.formatChange)(change24h, formatters),
+        change24hPercent: formatters.formatPercentage(market.changePercent24h),
+        volume: formatters.formatVolume(volume),
+        openInterest: formatters.formatVolume(openInterest),
+        fundingRate: Number(market.funding),
+        marketSource: isHip3 ? market.dex : undefined,
+        marketType,
+        isHip3,
+        isNewMarket: isHip3 && marketType === undefined,
+        ...(market.keywords && { keywords: market.keywords }),
+        ...(market.tags && { tags: market.tags }),
+        ...(market.category && { categories: [market.category] }),
+        ...(market.listedAt !== null && { listedAt: market.listedAt }),
+        trend: market.trend,
+        dataSource: 'terminal-global-snapshot-mark',
+        sourceExpiresAt,
+    };
+}, _TerminalMarketService_marketTypeFor = function _TerminalMarketService_marketTypeFor(dex, category) {
+    if (dex === 'main') {
+        return index_js_1.MarketCategory.CryptoCurrency;
+    }
+    if (category === 'stocks') {
+        return index_js_1.MarketCategory.Stock;
+    }
+    if (category === 'pre_ipo') {
+        return index_js_1.MarketCategory.PreIpo;
+    }
+    if (category && VALID_MARKET_TYPES.has(category)) {
+        return category;
+    }
+    return undefined;
+}, _TerminalMarketService_cloneGlobalSnapshotResult = function _TerminalMarketService_cloneGlobalSnapshotResult(result) {
+    return {
+        expiresAt: result.expiresAt,
+        markets: (0, marketUtils_js_1.clonePerpsMarketData)(result.markets),
+    };
+}, _TerminalMarketService_isNonNegativeSafeInteger = function _TerminalMarketService_isNonNegativeSafeInteger(value) {
+    return (typeof value === 'number' && Number.isSafeInteger(value) && value >= 0);
+}, _TerminalMarketService_isPositiveSafeInteger = function _TerminalMarketService_isPositiveSafeInteger(value) {
+    return __classPrivateFieldGet(this, _TerminalMarketService_instances, "m", _TerminalMarketService_isNonNegativeSafeInteger).call(this, value) && value > 0;
+}, _TerminalMarketService_validateItems = function _TerminalMarketService_validateItems(raw) {
     const valid = [];
     for (const item of raw) {
         if ((0, superstruct_1.is)(item, TerminalPerpetualItemStruct)) {