@metamask-previews/perps-controller 0.0.0-preview-685dbf46b → 1.0.0-preview-bc00f2c

package/dist/services/DepositService.mjs

@@ -0,0 +1,94 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    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 _DepositService_deps, _DepositService_messenger;
+import { toHex } from "@metamask/controller-utils";
+import { parseCaipAssetId } from "@metamask/utils";
+import { getSelectedEvmAccount } from "../utils/accountUtils.mjs";
+import { generateDepositId } from "../utils/idUtils.mjs";
+import { generateERC20TransferData } from "../utils/transferData.mjs";
+// Temporary to avoid estimation failures due to insufficient balance
+const DEPOSIT_GAS_LIMIT = toHex(100000);
+/**
+ * DepositService
+ *
+ * Handles deposit transaction preparation and validation.
+ * Stateless service that prepares transaction data for TransactionController.
+ * Controller handles TransactionController integration and promise lifecycle.
+ *
+ * Instance-based service with constructor injection of platform dependencies
+ * and messenger for inter-controller communication.
+ */
+export class DepositService {
+    /**
+     * Create a new DepositService instance
+     *
+     * @param deps - Platform dependencies for logging, metrics, etc.
+     * @param messenger - Controller messenger for cross-controller communication.
+     */
+    constructor(deps, messenger) {
+        _DepositService_deps.set(this, void 0);
+        _DepositService_messenger.set(this, void 0);
+        __classPrivateFieldSet(this, _DepositService_deps, deps, "f");
+        __classPrivateFieldSet(this, _DepositService_messenger, messenger, "f");
+    }
+    /**
+     * Prepare deposit transaction for confirmation
+     * Extracts transaction construction logic from controller
+     *
+     * @param options - Configuration object
+     * @param options.provider - Active provider instance
+     * @returns Transaction data ready for TransactionController.addTransaction
+     */
+    async prepareTransaction(options) {
+        const { provider } = options;
+        __classPrivateFieldGet(this, _DepositService_deps, "f").debugLogger.log('DepositService: Preparing deposit transaction');
+        // Generate deposit request ID for tracking
+        const currentDepositId = generateDepositId();
+        // Get deposit routes from provider
+        const depositRoutes = provider.getDepositRoutes({ isTestnet: false });
+        const route = depositRoutes[0];
+        const bridgeContractAddress = route.contractAddress;
+        // Generate transfer data for ERC-20 token transfer (portable, no mobile imports)
+        const transferData = generateERC20TransferData(bridgeContractAddress, '0x0');
+        // Get EVM account from selected account group via messenger
+        const evmAccount = getSelectedEvmAccount(__classPrivateFieldGet(this, _DepositService_messenger, "f").call('AccountTreeController:getAccountsFromSelectedAccountGroup'));
+        if (!evmAccount) {
+            throw new Error('No EVM-compatible account found in selected account group');
+        }
+        const accountAddress = evmAccount.address;
+        // Parse CAIP asset ID to extract chain ID and token address
+        const parsedAsset = parseCaipAssetId(route.assetId);
+        const assetChainId = toHex(parsedAsset.chainId.split(':')[1]);
+        const tokenAddress = parsedAsset.assetReference;
+        // Build transaction parameters for TransactionController
+        const transaction = {
+            from: accountAddress,
+            to: tokenAddress,
+            value: '0x0',
+            data: transferData,
+            gas: DEPOSIT_GAS_LIMIT,
+        };
+        __classPrivateFieldGet(this, _DepositService_deps, "f").debugLogger.log('DepositService: Deposit transaction prepared', {
+            depositId: currentDepositId,
+            assetChainId,
+            from: accountAddress,
+            to: tokenAddress,
+        });
+        return {
+            transaction,
+            assetChainId,
+            currentDepositId,
+        };
+    }
+}
+_DepositService_deps = new WeakMap(), _DepositService_messenger = new WeakMap();
+//# sourceMappingURL=DepositService.mjs.map

package/dist/services/DepositService.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DepositService.mjs","sourceRoot":"","sources":["../../src/services/DepositService.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,mCAAmC;AACnD,OAAO,EAAE,gBAAgB,EAAE,wBAAwB;AASnD,OAAO,EAAE,qBAAqB,EAAE,kCAA8B;AAC9D,OAAO,EAAE,iBAAiB,EAAE,6BAAyB;AACrD,OAAO,EAAE,yBAAyB,EAAE,kCAA8B;AAElE,qEAAqE;AACrE,MAAM,iBAAiB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AAExC;;;;;;;;;GASG;AACH,MAAM,OAAO,cAAc;IAKzB;;;;;OAKG;IACH,YACE,IAA+B,EAC/B,SAAuC;QAZhC,uCAAiC;QAEjC,4CAAyC;QAYhD,uBAAA,IAAI,wBAAS,IAAI,MAAA,CAAC;QAClB,uBAAA,IAAI,6BAAc,SAAS,MAAA,CAAC;IAC9B,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,kBAAkB,CAAC,OAAoC;QAK3D,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAE7B,uBAAA,IAAI,4BAAM,CAAC,WAAW,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;QAE5E,2CAA2C;QAC3C,MAAM,gBAAgB,GAAG,iBAAiB,EAAE,CAAC;QAE7C,mCAAmC;QACnC,MAAM,aAAa,GAAG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACtE,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,qBAAqB,GAAG,KAAK,CAAC,eAAe,CAAC;QAEpD,iFAAiF;QACjF,MAAM,YAAY,GAAG,yBAAyB,CAC5C,qBAAqB,EACrB,KAAK,CACN,CAAC;QAEF,4DAA4D;QAC5D,MAAM,UAAU,GAAG,qBAAqB,CACtC,uBAAA,IAAI,iCAAW,CAAC,IAAI,CAClB,2DAA2D,CAC5D,CACF,CAAC;QACF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;QACJ,CAAC;QACD,MAAM,cAAc,GAAG,UAAU,CAAC,OAAc,CAAC;QAEjD,4DAA4D;QAC5D,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,MAAM,YAAY,GAAG,WAAW,CAAC,cAAqB,CAAC;QAEvD,yDAAyD;QACzD,MAAM,WAAW,GAA2B;YAC1C,IAAI,EAAE,cAAc;YACpB,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,YAAY;YAClB,GAAG,EAAE,iBAAiB;SACvB,CAAC;QAEF,uBAAA,IAAI,4BAAM,CAAC,WAAW,CAAC,GAAG,CAAC,8CAA8C,EAAE;YACzE,SAAS,EAAE,gBAAgB;YAC3B,YAAY;YACZ,IAAI,EAAE,cAAc;YACpB,EAAE,EAAE,YAAY;SACjB,CAAC,CAAC;QAEH,OAAO;YACL,WAAW;YACX,YAAY;YACZ,gBAAgB;SACjB,CAAC;IACJ,CAAC;CACF","sourcesContent":["import { toHex } from '@metamask/controller-utils';\nimport { parseCaipAssetId } from '@metamask/utils';\nimport type { Hex } from '@metamask/utils';\n\nimport type {\n  PerpsProvider,\n  PerpsPlatformDependencies,\n  PerpsTransactionParams,\n} from '../types';\nimport type { PerpsControllerMessengerBase } from '../types/messenger';\nimport { getSelectedEvmAccount } from '../utils/accountUtils';\nimport { generateDepositId } from '../utils/idUtils';\nimport { generateERC20TransferData } from '../utils/transferData';\n\n// Temporary to avoid estimation failures due to insufficient balance\nconst DEPOSIT_GAS_LIMIT = toHex(100000);\n\n/**\n * DepositService\n *\n * Handles deposit transaction preparation and validation.\n * Stateless service that prepares transaction data for TransactionController.\n * Controller handles TransactionController integration and promise lifecycle.\n *\n * Instance-based service with constructor injection of platform dependencies\n * and messenger for inter-controller communication.\n */\nexport class DepositService {\n  readonly #deps: PerpsPlatformDependencies;\n\n  readonly #messenger: PerpsControllerMessengerBase;\n\n  /**\n   * Create a new DepositService instance\n   *\n   * @param deps - Platform dependencies for logging, metrics, etc.\n   * @param messenger - Controller messenger for cross-controller communication.\n   */\n  constructor(\n    deps: PerpsPlatformDependencies,\n    messenger: PerpsControllerMessengerBase,\n  ) {\n    this.#deps = deps;\n    this.#messenger = messenger;\n  }\n\n  /**\n   * Prepare deposit transaction for confirmation\n   * Extracts transaction construction logic from controller\n   *\n   * @param options - Configuration object\n   * @param options.provider - Active provider instance\n   * @returns Transaction data ready for TransactionController.addTransaction\n   */\n  async prepareTransaction(options: { provider: PerpsProvider }): Promise<{\n    transaction: PerpsTransactionParams;\n    assetChainId: Hex;\n    currentDepositId: string;\n  }> {\n    const { provider } = options;\n\n    this.#deps.debugLogger.log('DepositService: Preparing deposit transaction');\n\n    // Generate deposit request ID for tracking\n    const currentDepositId = generateDepositId();\n\n    // Get deposit routes from provider\n    const depositRoutes = provider.getDepositRoutes({ isTestnet: false });\n    const route = depositRoutes[0];\n    const bridgeContractAddress = route.contractAddress;\n\n    // Generate transfer data for ERC-20 token transfer (portable, no mobile imports)\n    const transferData = generateERC20TransferData(\n      bridgeContractAddress,\n      '0x0',\n    );\n\n    // Get EVM account from selected account group via messenger\n    const evmAccount = getSelectedEvmAccount(\n      this.#messenger.call(\n        'AccountTreeController:getAccountsFromSelectedAccountGroup',\n      ),\n    );\n    if (!evmAccount) {\n      throw new Error(\n        'No EVM-compatible account found in selected account group',\n      );\n    }\n    const accountAddress = evmAccount.address as Hex;\n\n    // Parse CAIP asset ID to extract chain ID and token address\n    const parsedAsset = parseCaipAssetId(route.assetId);\n    const assetChainId = toHex(parsedAsset.chainId.split(':')[1]);\n    const tokenAddress = parsedAsset.assetReference as Hex;\n\n    // Build transaction parameters for TransactionController\n    const transaction: PerpsTransactionParams = {\n      from: accountAddress,\n      to: tokenAddress,\n      value: '0x0',\n      data: transferData,\n      gas: DEPOSIT_GAS_LIMIT,\n    };\n\n    this.#deps.debugLogger.log('DepositService: Deposit transaction prepared', {\n      depositId: currentDepositId,\n      assetChainId,\n      from: accountAddress,\n      to: tokenAddress,\n    });\n\n    return {\n      transaction,\n      assetChainId,\n      currentDepositId,\n    };\n  }\n}\n"]}

package/dist/services/EligibilityService.cjs

@@ -0,0 +1,173 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    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 _EligibilityService_instances, _EligibilityService_geoCacheTtlMs, _EligibilityService_deps, _EligibilityService_geoLocationCache, _EligibilityService_geoLocationFetchPromise, _EligibilityService_performGeoLocationFetch;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EligibilityService = void 0;
+const controller_utils_1 = require("@metamask/controller-utils");
+const perpsConfig_1 = require("../constants/perpsConfig.cjs");
+const utils_1 = require("../utils/index.cjs");
+const errorUtils_1 = require("../utils/errorUtils.cjs");
+// Geo-blocking API URLs
+const ON_RAMP_GEO_BLOCKING_URLS = {
+    DEV: 'https://on-ramp.uat-api.cx.metamask.io/geolocation',
+    PROD: 'https://on-ramp.api.cx.metamask.io/geolocation',
+};
+/**
+ * EligibilityService
+ *
+ * Handles geo-location fetching and eligibility checking.
+ * Manages caching to minimize API calls.
+ *
+ * Instance-based service with constructor injection of platform dependencies.
+ * Cache is instance-scoped to support multiple service instances (e.g., testing).
+ */
+class EligibilityService {
+    /**
+     * Create a new EligibilityService instance
+     *
+     * @param deps - Platform dependencies for logging, metrics, etc.
+     */
+    constructor(deps) {
+        _EligibilityService_instances.add(this);
+        _EligibilityService_geoCacheTtlMs.set(this, 5 * 60 * 1000); // 5 minutes
+        _EligibilityService_deps.set(this, void 0);
+        _EligibilityService_geoLocationCache.set(this, null);
+        _EligibilityService_geoLocationFetchPromise.set(this, null);
+        __classPrivateFieldSet(this, _EligibilityService_deps, deps, "f");
+    }
+    /**
+     * Fetch geo location with caching and deduplication
+     *
+     * @returns The user's geo location string.
+     */
+    async fetchGeoLocation() {
+        // Check cache first
+        if (__classPrivateFieldGet(this, _EligibilityService_geoLocationCache, "f")) {
+            const cacheAge = Date.now() - __classPrivateFieldGet(this, _EligibilityService_geoLocationCache, "f").timestamp;
+            if (cacheAge < __classPrivateFieldGet(this, _EligibilityService_geoCacheTtlMs, "f")) {
+                __classPrivateFieldGet(this, _EligibilityService_deps, "f").debugLogger.log('EligibilityService: Using cached geo location', {
+                    location: __classPrivateFieldGet(this, _EligibilityService_geoLocationCache, "f").location,
+                    cacheAge: `${(cacheAge / 1000).toFixed(1)}s`,
+                });
+                return __classPrivateFieldGet(this, _EligibilityService_geoLocationCache, "f").location;
+            }
+        }
+        // If already fetching, return the existing promise
+        if (__classPrivateFieldGet(this, _EligibilityService_geoLocationFetchPromise, "f")) {
+            __classPrivateFieldGet(this, _EligibilityService_deps, "f").debugLogger.log('EligibilityService: Geo location fetch already in progress, waiting...');
+            return __classPrivateFieldGet(this, _EligibilityService_geoLocationFetchPromise, "f");
+        }
+        // Start new fetch
+        __classPrivateFieldSet(this, _EligibilityService_geoLocationFetchPromise, __classPrivateFieldGet(this, _EligibilityService_instances, "m", _EligibilityService_performGeoLocationFetch).call(this), "f");
+        try {
+            const location = await __classPrivateFieldGet(this, _EligibilityService_geoLocationFetchPromise, "f");
+            return location;
+        }
+        finally {
+            // Clear the promise after completion (success or failure)
+            __classPrivateFieldSet(this, _EligibilityService_geoLocationFetchPromise, null, "f");
+        }
+    }
+    /**
+     * Check if user is eligible based on geo-blocked regions
+     *
+     * @param options - The eligibility check parameters.
+     * @param options.blockedRegions - List of blocked region codes (e.g., ['US', 'CN']).
+     * @returns True if eligible (not in blocked region), false otherwise.
+     */
+    async checkEligibility(options) {
+        const { blockedRegions } = options;
+        try {
+            __classPrivateFieldGet(this, _EligibilityService_deps, "f").debugLogger.log('EligibilityService: Checking eligibility', {
+                blockedRegionsCount: blockedRegions.length,
+            });
+            // Returns UNKNOWN if we can't fetch the geo location
+            const geoLocation = await this.fetchGeoLocation();
+            // Only set to eligible if we have valid geolocation and it's not blocked
+            if (geoLocation !== 'UNKNOWN') {
+                const isEligible = blockedRegions.every((geoBlockedRegion) => !geoLocation
+                    .toUpperCase()
+                    .startsWith(geoBlockedRegion.toUpperCase()));
+                __classPrivateFieldGet(this, _EligibilityService_deps, "f").debugLogger.log('EligibilityService: Eligibility check completed', {
+                    geoLocation,
+                    isEligible,
+                    blockedRegions,
+                });
+                return isEligible;
+            }
+            // Default to eligible if location is unknown
+            return true;
+        }
+        catch (error) {
+            __classPrivateFieldGet(this, _EligibilityService_deps, "f").logger.error((0, errorUtils_1.ensureError)(error, 'EligibilityService.checkEligibility'), {
+                tags: { feature: perpsConfig_1.PERPS_CONSTANTS.FeatureName },
+                context: {
+                    name: 'EligibilityService.checkEligibility',
+                    data: {},
+                },
+            });
+            // Default to eligible on error
+            return true;
+        }
+    }
+    /**
+     * Clear the geo-location cache
+     * Useful for testing or forcing a fresh fetch
+     */
+    clearCache() {
+        __classPrivateFieldSet(this, _EligibilityService_geoLocationCache, null, "f");
+        __classPrivateFieldSet(this, _EligibilityService_geoLocationFetchPromise, null, "f");
+        __classPrivateFieldGet(this, _EligibilityService_deps, "f").debugLogger.log('EligibilityService: Cache cleared');
+    }
+}
+exports.EligibilityService = EligibilityService;
+_EligibilityService_geoCacheTtlMs = new WeakMap(), _EligibilityService_deps = new WeakMap(), _EligibilityService_geoLocationCache = new WeakMap(), _EligibilityService_geoLocationFetchPromise = new WeakMap(), _EligibilityService_instances = new WeakSet(), _EligibilityService_performGeoLocationFetch = 
+/**
+ * Perform the actual geo location fetch
+ * Separated to allow proper promise management
+ *
+ * @returns The fetched geo location string, or 'UNKNOWN' on failure.
+ */
+async function _EligibilityService_performGeoLocationFetch() {
+    let location = 'UNKNOWN';
+    try {
+        const environment = (0, utils_1.getEnvironment)();
+        __classPrivateFieldGet(this, _EligibilityService_deps, "f").debugLogger.log('EligibilityService: Fetching geo location from API', {
+            environment,
+        });
+        const response = await (0, controller_utils_1.successfulFetch)(ON_RAMP_GEO_BLOCKING_URLS[environment]);
+        const textResult = await response?.text();
+        location = textResult || 'UNKNOWN';
+        // Cache the successful result
+        __classPrivateFieldSet(this, _EligibilityService_geoLocationCache, {
+            location,
+            timestamp: Date.now(),
+        }, "f");
+        __classPrivateFieldGet(this, _EligibilityService_deps, "f").debugLogger.log('EligibilityService: Geo location fetched successfully', {
+            location,
+        });
+        return location;
+    }
+    catch (error) {
+        __classPrivateFieldGet(this, _EligibilityService_deps, "f").logger.error((0, errorUtils_1.ensureError)(error, 'EligibilityService.performGeoLocationFetch'), {
+            tags: { feature: perpsConfig_1.PERPS_CONSTANTS.FeatureName },
+            context: {
+                name: 'EligibilityService.performGeoLocationFetch',
+                data: {},
+            },
+        });
+        // Don't cache failures
+        return location;
+    }
+};
+//# sourceMappingURL=EligibilityService.cjs.map

package/dist/services/EligibilityService.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"EligibilityService.cjs","sourceRoot":"","sources":["../../src/services/EligibilityService.ts"],"names":[],"mappings":"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","sourcesContent":["import { successfulFetch } from '@metamask/controller-utils';\n\nimport { PERPS_CONSTANTS } from '../constants/perpsConfig';\nimport type {\n  PerpsPlatformDependencies,\n  CheckEligibilityParams,\n} from '../types';\nimport { getEnvironment } from '../utils';\nimport { ensureError } from '../utils/errorUtils';\n\n// Geo-blocking API URLs\nconst ON_RAMP_GEO_BLOCKING_URLS = {\n  DEV: 'https://on-ramp.uat-api.cx.metamask.io/geolocation',\n  PROD: 'https://on-ramp.api.cx.metamask.io/geolocation',\n} as const;\n\n/**\n * Geo-location cache entry\n */\ntype GeoLocationCache = {\n  location: string;\n  timestamp: number;\n};\n\n/**\n * EligibilityService\n *\n * Handles geo-location fetching and eligibility checking.\n * Manages caching to minimize API calls.\n *\n * Instance-based service with constructor injection of platform dependencies.\n * Cache is instance-scoped to support multiple service instances (e.g., testing).\n */\nexport class EligibilityService {\n  readonly #geoCacheTtlMs = 5 * 60 * 1000; // 5 minutes\n\n  readonly #deps: PerpsPlatformDependencies;\n\n  #geoLocationCache: GeoLocationCache | null = null;\n\n  #geoLocationFetchPromise: Promise<string> | null = null;\n\n  /**\n   * Create a new EligibilityService instance\n   *\n   * @param deps - Platform dependencies for logging, metrics, etc.\n   */\n  constructor(deps: PerpsPlatformDependencies) {\n    this.#deps = deps;\n  }\n\n  /**\n   * Fetch geo location with caching and deduplication\n   *\n   * @returns The user's geo location string.\n   */\n  async fetchGeoLocation(): Promise<string> {\n    // Check cache first\n    if (this.#geoLocationCache) {\n      const cacheAge = Date.now() - this.#geoLocationCache.timestamp;\n      if (cacheAge < this.#geoCacheTtlMs) {\n        this.#deps.debugLogger.log(\n          'EligibilityService: Using cached geo location',\n          {\n            location: this.#geoLocationCache.location,\n            cacheAge: `${(cacheAge / 1000).toFixed(1)}s`,\n          },\n        );\n        return this.#geoLocationCache.location;\n      }\n    }\n\n    // If already fetching, return the existing promise\n    if (this.#geoLocationFetchPromise) {\n      this.#deps.debugLogger.log(\n        'EligibilityService: Geo location fetch already in progress, waiting...',\n      );\n      return this.#geoLocationFetchPromise;\n    }\n\n    // Start new fetch\n    this.#geoLocationFetchPromise = this.#performGeoLocationFetch();\n\n    try {\n      const location = await this.#geoLocationFetchPromise;\n      return location;\n    } finally {\n      // Clear the promise after completion (success or failure)\n      this.#geoLocationFetchPromise = null;\n    }\n  }\n\n  /**\n   * Perform the actual geo location fetch\n   * Separated to allow proper promise management\n   *\n   * @returns The fetched geo location string, or 'UNKNOWN' on failure.\n   */\n  async #performGeoLocationFetch(): Promise<string> {\n    let location = 'UNKNOWN';\n\n    try {\n      const environment = getEnvironment();\n\n      this.#deps.debugLogger.log(\n        'EligibilityService: Fetching geo location from API',\n        {\n          environment,\n        },\n      );\n\n      const response = await successfulFetch(\n        ON_RAMP_GEO_BLOCKING_URLS[environment],\n      );\n\n      const textResult = await response?.text();\n      location = textResult || 'UNKNOWN';\n\n      // Cache the successful result\n      this.#geoLocationCache = {\n        location,\n        timestamp: Date.now(),\n      };\n\n      this.#deps.debugLogger.log(\n        'EligibilityService: Geo location fetched successfully',\n        {\n          location,\n        },\n      );\n\n      return location;\n    } catch (error) {\n      this.#deps.logger.error(\n        ensureError(error, 'EligibilityService.performGeoLocationFetch'),\n        {\n          tags: { feature: PERPS_CONSTANTS.FeatureName },\n          context: {\n            name: 'EligibilityService.performGeoLocationFetch',\n            data: {},\n          },\n        },\n      );\n      // Don't cache failures\n      return location;\n    }\n  }\n\n  /**\n   * Check if user is eligible based on geo-blocked regions\n   *\n   * @param options - The eligibility check parameters.\n   * @param options.blockedRegions - List of blocked region codes (e.g., ['US', 'CN']).\n   * @returns True if eligible (not in blocked region), false otherwise.\n   */\n  async checkEligibility(options: CheckEligibilityParams): Promise<boolean> {\n    const { blockedRegions } = options;\n    try {\n      this.#deps.debugLogger.log('EligibilityService: Checking eligibility', {\n        blockedRegionsCount: blockedRegions.length,\n      });\n\n      // Returns UNKNOWN if we can't fetch the geo location\n      const geoLocation = await this.fetchGeoLocation();\n\n      // Only set to eligible if we have valid geolocation and it's not blocked\n      if (geoLocation !== 'UNKNOWN') {\n        const isEligible = blockedRegions.every(\n          (geoBlockedRegion) =>\n            !geoLocation\n              .toUpperCase()\n              .startsWith(geoBlockedRegion.toUpperCase()),\n        );\n\n        this.#deps.debugLogger.log(\n          'EligibilityService: Eligibility check completed',\n          {\n            geoLocation,\n            isEligible,\n            blockedRegions,\n          },\n        );\n\n        return isEligible;\n      }\n\n      // Default to eligible if location is unknown\n      return true;\n    } catch (error) {\n      this.#deps.logger.error(\n        ensureError(error, 'EligibilityService.checkEligibility'),\n        {\n          tags: { feature: PERPS_CONSTANTS.FeatureName },\n          context: {\n            name: 'EligibilityService.checkEligibility',\n            data: {},\n          },\n        },\n      );\n      // Default to eligible on error\n      return true;\n    }\n  }\n\n  /**\n   * Clear the geo-location cache\n   * Useful for testing or forcing a fresh fetch\n   */\n  clearCache(): void {\n    this.#geoLocationCache = null;\n    this.#geoLocationFetchPromise = null;\n    this.#deps.debugLogger.log('EligibilityService: Cache cleared');\n  }\n}\n"]}

package/dist/services/EligibilityService.d.cts

@@ -0,0 +1,39 @@
+import type { PerpsPlatformDependencies, CheckEligibilityParams } from "../types/index.cjs";
+/**
+ * EligibilityService
+ *
+ * Handles geo-location fetching and eligibility checking.
+ * Manages caching to minimize API calls.
+ *
+ * Instance-based service with constructor injection of platform dependencies.
+ * Cache is instance-scoped to support multiple service instances (e.g., testing).
+ */
+export declare class EligibilityService {
+    #private;
+    /**
+     * Create a new EligibilityService instance
+     *
+     * @param deps - Platform dependencies for logging, metrics, etc.
+     */
+    constructor(deps: PerpsPlatformDependencies);
+    /**
+     * Fetch geo location with caching and deduplication
+     *
+     * @returns The user's geo location string.
+     */
+    fetchGeoLocation(): Promise<string>;
+    /**
+     * Check if user is eligible based on geo-blocked regions
+     *
+     * @param options - The eligibility check parameters.
+     * @param options.blockedRegions - List of blocked region codes (e.g., ['US', 'CN']).
+     * @returns True if eligible (not in blocked region), false otherwise.
+     */
+    checkEligibility(options: CheckEligibilityParams): Promise<boolean>;
+    /**
+     * Clear the geo-location cache
+     * Useful for testing or forcing a fresh fetch
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=EligibilityService.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EligibilityService.d.cts","sourceRoot":"","sources":["../../src/services/EligibilityService.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,yBAAyB,EACzB,sBAAsB,EACvB,2BAAiB;AAkBlB;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;;IAS7B;;;;OAIG;gBACS,IAAI,EAAE,yBAAyB;IAI3C;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IA4FzC;;;;;;OAMG;IACG,gBAAgB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC;IAiDzE;;;OAGG;IACH,UAAU,IAAI,IAAI;CAKnB"}

package/dist/services/EligibilityService.d.mts

@@ -0,0 +1,39 @@
+import type { PerpsPlatformDependencies, CheckEligibilityParams } from "../types/index.mjs";
+/**
+ * EligibilityService
+ *
+ * Handles geo-location fetching and eligibility checking.
+ * Manages caching to minimize API calls.
+ *
+ * Instance-based service with constructor injection of platform dependencies.
+ * Cache is instance-scoped to support multiple service instances (e.g., testing).
+ */
+export declare class EligibilityService {
+    #private;
+    /**
+     * Create a new EligibilityService instance
+     *
+     * @param deps - Platform dependencies for logging, metrics, etc.
+     */
+    constructor(deps: PerpsPlatformDependencies);
+    /**
+     * Fetch geo location with caching and deduplication
+     *
+     * @returns The user's geo location string.
+     */
+    fetchGeoLocation(): Promise<string>;
+    /**
+     * Check if user is eligible based on geo-blocked regions
+     *
+     * @param options - The eligibility check parameters.
+     * @param options.blockedRegions - List of blocked region codes (e.g., ['US', 'CN']).
+     * @returns True if eligible (not in blocked region), false otherwise.
+     */
+    checkEligibility(options: CheckEligibilityParams): Promise<boolean>;
+    /**
+     * Clear the geo-location cache
+     * Useful for testing or forcing a fresh fetch
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=EligibilityService.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EligibilityService.d.mts","sourceRoot":"","sources":["../../src/services/EligibilityService.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,yBAAyB,EACzB,sBAAsB,EACvB,2BAAiB;AAkBlB;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;;IAS7B;;;;OAIG;gBACS,IAAI,EAAE,yBAAyB;IAI3C;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IA4FzC;;;;;;OAMG;IACG,gBAAgB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC;IAiDzE;;;OAGG;IACH,UAAU,IAAI,IAAI;CAKnB"}

package/dist/services/EligibilityService.mjs

@@ -0,0 +1,169 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    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 _EligibilityService_instances, _EligibilityService_geoCacheTtlMs, _EligibilityService_deps, _EligibilityService_geoLocationCache, _EligibilityService_geoLocationFetchPromise, _EligibilityService_performGeoLocationFetch;
+import { successfulFetch } from "@metamask/controller-utils";
+import { PERPS_CONSTANTS } from "../constants/perpsConfig.mjs";
+import { getEnvironment } from "../utils/index.mjs";
+import { ensureError } from "../utils/errorUtils.mjs";
+// Geo-blocking API URLs
+const ON_RAMP_GEO_BLOCKING_URLS = {
+    DEV: 'https://on-ramp.uat-api.cx.metamask.io/geolocation',
+    PROD: 'https://on-ramp.api.cx.metamask.io/geolocation',
+};
+/**
+ * EligibilityService
+ *
+ * Handles geo-location fetching and eligibility checking.
+ * Manages caching to minimize API calls.
+ *
+ * Instance-based service with constructor injection of platform dependencies.
+ * Cache is instance-scoped to support multiple service instances (e.g., testing).
+ */
+export class EligibilityService {
+    /**
+     * Create a new EligibilityService instance
+     *
+     * @param deps - Platform dependencies for logging, metrics, etc.
+     */
+    constructor(deps) {
+        _EligibilityService_instances.add(this);
+        _EligibilityService_geoCacheTtlMs.set(this, 5 * 60 * 1000); // 5 minutes
+        _EligibilityService_deps.set(this, void 0);
+        _EligibilityService_geoLocationCache.set(this, null);
+        _EligibilityService_geoLocationFetchPromise.set(this, null);
+        __classPrivateFieldSet(this, _EligibilityService_deps, deps, "f");
+    }
+    /**
+     * Fetch geo location with caching and deduplication
+     *
+     * @returns The user's geo location string.
+     */
+    async fetchGeoLocation() {
+        // Check cache first
+        if (__classPrivateFieldGet(this, _EligibilityService_geoLocationCache, "f")) {
+            const cacheAge = Date.now() - __classPrivateFieldGet(this, _EligibilityService_geoLocationCache, "f").timestamp;
+            if (cacheAge < __classPrivateFieldGet(this, _EligibilityService_geoCacheTtlMs, "f")) {
+                __classPrivateFieldGet(this, _EligibilityService_deps, "f").debugLogger.log('EligibilityService: Using cached geo location', {
+                    location: __classPrivateFieldGet(this, _EligibilityService_geoLocationCache, "f").location,
+                    cacheAge: `${(cacheAge / 1000).toFixed(1)}s`,
+                });
+                return __classPrivateFieldGet(this, _EligibilityService_geoLocationCache, "f").location;
+            }
+        }
+        // If already fetching, return the existing promise
+        if (__classPrivateFieldGet(this, _EligibilityService_geoLocationFetchPromise, "f")) {
+            __classPrivateFieldGet(this, _EligibilityService_deps, "f").debugLogger.log('EligibilityService: Geo location fetch already in progress, waiting...');
+            return __classPrivateFieldGet(this, _EligibilityService_geoLocationFetchPromise, "f");
+        }
+        // Start new fetch
+        __classPrivateFieldSet(this, _EligibilityService_geoLocationFetchPromise, __classPrivateFieldGet(this, _EligibilityService_instances, "m", _EligibilityService_performGeoLocationFetch).call(this), "f");
+        try {
+            const location = await __classPrivateFieldGet(this, _EligibilityService_geoLocationFetchPromise, "f");
+            return location;
+        }
+        finally {
+            // Clear the promise after completion (success or failure)
+            __classPrivateFieldSet(this, _EligibilityService_geoLocationFetchPromise, null, "f");
+        }
+    }
+    /**
+     * Check if user is eligible based on geo-blocked regions
+     *
+     * @param options - The eligibility check parameters.
+     * @param options.blockedRegions - List of blocked region codes (e.g., ['US', 'CN']).
+     * @returns True if eligible (not in blocked region), false otherwise.
+     */
+    async checkEligibility(options) {
+        const { blockedRegions } = options;
+        try {
+            __classPrivateFieldGet(this, _EligibilityService_deps, "f").debugLogger.log('EligibilityService: Checking eligibility', {
+                blockedRegionsCount: blockedRegions.length,
+            });
+            // Returns UNKNOWN if we can't fetch the geo location
+            const geoLocation = await this.fetchGeoLocation();
+            // Only set to eligible if we have valid geolocation and it's not blocked
+            if (geoLocation !== 'UNKNOWN') {
+                const isEligible = blockedRegions.every((geoBlockedRegion) => !geoLocation
+                    .toUpperCase()
+                    .startsWith(geoBlockedRegion.toUpperCase()));
+                __classPrivateFieldGet(this, _EligibilityService_deps, "f").debugLogger.log('EligibilityService: Eligibility check completed', {
+                    geoLocation,
+                    isEligible,
+                    blockedRegions,
+                });
+                return isEligible;
+            }
+            // Default to eligible if location is unknown
+            return true;
+        }
+        catch (error) {
+            __classPrivateFieldGet(this, _EligibilityService_deps, "f").logger.error(ensureError(error, 'EligibilityService.checkEligibility'), {
+                tags: { feature: PERPS_CONSTANTS.FeatureName },
+                context: {
+                    name: 'EligibilityService.checkEligibility',
+                    data: {},
+                },
+            });
+            // Default to eligible on error
+            return true;
+        }
+    }
+    /**
+     * Clear the geo-location cache
+     * Useful for testing or forcing a fresh fetch
+     */
+    clearCache() {
+        __classPrivateFieldSet(this, _EligibilityService_geoLocationCache, null, "f");
+        __classPrivateFieldSet(this, _EligibilityService_geoLocationFetchPromise, null, "f");
+        __classPrivateFieldGet(this, _EligibilityService_deps, "f").debugLogger.log('EligibilityService: Cache cleared');
+    }
+}
+_EligibilityService_geoCacheTtlMs = new WeakMap(), _EligibilityService_deps = new WeakMap(), _EligibilityService_geoLocationCache = new WeakMap(), _EligibilityService_geoLocationFetchPromise = new WeakMap(), _EligibilityService_instances = new WeakSet(), _EligibilityService_performGeoLocationFetch = 
+/**
+ * Perform the actual geo location fetch
+ * Separated to allow proper promise management
+ *
+ * @returns The fetched geo location string, or 'UNKNOWN' on failure.
+ */
+async function _EligibilityService_performGeoLocationFetch() {
+    let location = 'UNKNOWN';
+    try {
+        const environment = getEnvironment();
+        __classPrivateFieldGet(this, _EligibilityService_deps, "f").debugLogger.log('EligibilityService: Fetching geo location from API', {
+            environment,
+        });
+        const response = await successfulFetch(ON_RAMP_GEO_BLOCKING_URLS[environment]);
+        const textResult = await response?.text();
+        location = textResult || 'UNKNOWN';
+        // Cache the successful result
+        __classPrivateFieldSet(this, _EligibilityService_geoLocationCache, {
+            location,
+            timestamp: Date.now(),
+        }, "f");
+        __classPrivateFieldGet(this, _EligibilityService_deps, "f").debugLogger.log('EligibilityService: Geo location fetched successfully', {
+            location,
+        });
+        return location;
+    }
+    catch (error) {
+        __classPrivateFieldGet(this, _EligibilityService_deps, "f").logger.error(ensureError(error, 'EligibilityService.performGeoLocationFetch'), {
+            tags: { feature: PERPS_CONSTANTS.FeatureName },
+            context: {
+                name: 'EligibilityService.performGeoLocationFetch',
+                data: {},
+            },
+        });
+        // Don't cache failures
+        return location;
+    }
+};
+//# sourceMappingURL=EligibilityService.mjs.map

package/dist/services/EligibilityService.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"EligibilityService.mjs","sourceRoot":"","sources":["../../src/services/EligibilityService.ts"],"names":[],"mappings":"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","sourcesContent":["import { successfulFetch } from '@metamask/controller-utils';\n\nimport { PERPS_CONSTANTS } from '../constants/perpsConfig';\nimport type {\n  PerpsPlatformDependencies,\n  CheckEligibilityParams,\n} from '../types';\nimport { getEnvironment } from '../utils';\nimport { ensureError } from '../utils/errorUtils';\n\n// Geo-blocking API URLs\nconst ON_RAMP_GEO_BLOCKING_URLS = {\n  DEV: 'https://on-ramp.uat-api.cx.metamask.io/geolocation',\n  PROD: 'https://on-ramp.api.cx.metamask.io/geolocation',\n} as const;\n\n/**\n * Geo-location cache entry\n */\ntype GeoLocationCache = {\n  location: string;\n  timestamp: number;\n};\n\n/**\n * EligibilityService\n *\n * Handles geo-location fetching and eligibility checking.\n * Manages caching to minimize API calls.\n *\n * Instance-based service with constructor injection of platform dependencies.\n * Cache is instance-scoped to support multiple service instances (e.g., testing).\n */\nexport class EligibilityService {\n  readonly #geoCacheTtlMs = 5 * 60 * 1000; // 5 minutes\n\n  readonly #deps: PerpsPlatformDependencies;\n\n  #geoLocationCache: GeoLocationCache | null = null;\n\n  #geoLocationFetchPromise: Promise<string> | null = null;\n\n  /**\n   * Create a new EligibilityService instance\n   *\n   * @param deps - Platform dependencies for logging, metrics, etc.\n   */\n  constructor(deps: PerpsPlatformDependencies) {\n    this.#deps = deps;\n  }\n\n  /**\n   * Fetch geo location with caching and deduplication\n   *\n   * @returns The user's geo location string.\n   */\n  async fetchGeoLocation(): Promise<string> {\n    // Check cache first\n    if (this.#geoLocationCache) {\n      const cacheAge = Date.now() - this.#geoLocationCache.timestamp;\n      if (cacheAge < this.#geoCacheTtlMs) {\n        this.#deps.debugLogger.log(\n          'EligibilityService: Using cached geo location',\n          {\n            location: this.#geoLocationCache.location,\n            cacheAge: `${(cacheAge / 1000).toFixed(1)}s`,\n          },\n        );\n        return this.#geoLocationCache.location;\n      }\n    }\n\n    // If already fetching, return the existing promise\n    if (this.#geoLocationFetchPromise) {\n      this.#deps.debugLogger.log(\n        'EligibilityService: Geo location fetch already in progress, waiting...',\n      );\n      return this.#geoLocationFetchPromise;\n    }\n\n    // Start new fetch\n    this.#geoLocationFetchPromise = this.#performGeoLocationFetch();\n\n    try {\n      const location = await this.#geoLocationFetchPromise;\n      return location;\n    } finally {\n      // Clear the promise after completion (success or failure)\n      this.#geoLocationFetchPromise = null;\n    }\n  }\n\n  /**\n   * Perform the actual geo location fetch\n   * Separated to allow proper promise management\n   *\n   * @returns The fetched geo location string, or 'UNKNOWN' on failure.\n   */\n  async #performGeoLocationFetch(): Promise<string> {\n    let location = 'UNKNOWN';\n\n    try {\n      const environment = getEnvironment();\n\n      this.#deps.debugLogger.log(\n        'EligibilityService: Fetching geo location from API',\n        {\n          environment,\n        },\n      );\n\n      const response = await successfulFetch(\n        ON_RAMP_GEO_BLOCKING_URLS[environment],\n      );\n\n      const textResult = await response?.text();\n      location = textResult || 'UNKNOWN';\n\n      // Cache the successful result\n      this.#geoLocationCache = {\n        location,\n        timestamp: Date.now(),\n      };\n\n      this.#deps.debugLogger.log(\n        'EligibilityService: Geo location fetched successfully',\n        {\n          location,\n        },\n      );\n\n      return location;\n    } catch (error) {\n      this.#deps.logger.error(\n        ensureError(error, 'EligibilityService.performGeoLocationFetch'),\n        {\n          tags: { feature: PERPS_CONSTANTS.FeatureName },\n          context: {\n            name: 'EligibilityService.performGeoLocationFetch',\n            data: {},\n          },\n        },\n      );\n      // Don't cache failures\n      return location;\n    }\n  }\n\n  /**\n   * Check if user is eligible based on geo-blocked regions\n   *\n   * @param options - The eligibility check parameters.\n   * @param options.blockedRegions - List of blocked region codes (e.g., ['US', 'CN']).\n   * @returns True if eligible (not in blocked region), false otherwise.\n   */\n  async checkEligibility(options: CheckEligibilityParams): Promise<boolean> {\n    const { blockedRegions } = options;\n    try {\n      this.#deps.debugLogger.log('EligibilityService: Checking eligibility', {\n        blockedRegionsCount: blockedRegions.length,\n      });\n\n      // Returns UNKNOWN if we can't fetch the geo location\n      const geoLocation = await this.fetchGeoLocation();\n\n      // Only set to eligible if we have valid geolocation and it's not blocked\n      if (geoLocation !== 'UNKNOWN') {\n        const isEligible = blockedRegions.every(\n          (geoBlockedRegion) =>\n            !geoLocation\n              .toUpperCase()\n              .startsWith(geoBlockedRegion.toUpperCase()),\n        );\n\n        this.#deps.debugLogger.log(\n          'EligibilityService: Eligibility check completed',\n          {\n            geoLocation,\n            isEligible,\n            blockedRegions,\n          },\n        );\n\n        return isEligible;\n      }\n\n      // Default to eligible if location is unknown\n      return true;\n    } catch (error) {\n      this.#deps.logger.error(\n        ensureError(error, 'EligibilityService.checkEligibility'),\n        {\n          tags: { feature: PERPS_CONSTANTS.FeatureName },\n          context: {\n            name: 'EligibilityService.checkEligibility',\n            data: {},\n          },\n        },\n      );\n      // Default to eligible on error\n      return true;\n    }\n  }\n\n  /**\n   * Clear the geo-location cache\n   * Useful for testing or forcing a fresh fetch\n   */\n  clearCache(): void {\n    this.#geoLocationCache = null;\n    this.#geoLocationFetchPromise = null;\n    this.#deps.debugLogger.log('EligibilityService: Cache cleared');\n  }\n}\n"]}