@metamask/smart-transactions-controller 21.0.0 → 22.0.0

package/dist/constants.d.mts

@@ -19,5 +19,25 @@ export declare enum SmartTransactionsTraceName {
     CancelTransaction = "Smart Transactions: Cancel Transaction",
     FetchLiveness = "Smart Transactions: Fetch Liveness"
 }
+/**
+ * Default feature flags configuration for smart transactions.
+ * Used as a fallback when remote feature flags are unavailable or invalid.
+ * This is voluntarily defensive because it is applied to any network without valid configuration.
+ */
+export declare const DEFAULT_DISABLED_SMART_TRANSACTIONS_FEATURE_FLAGS: {
+    readonly default: {
+        readonly extensionActive: false;
+        readonly mobileActive: false;
+        readonly mobileActiveIOS: false;
+        readonly mobileActiveAndroid: false;
+        readonly expectedDeadline: 45;
+        readonly maxDeadline: 150;
+        readonly extensionReturnTxHashAsap: false;
+        readonly extensionReturnTxHashAsapBatch: false;
+        readonly mobileReturnTxHashAsap: false;
+        readonly extensionSkipSmartTransactionStatusPage: false;
+        readonly batchStatusPollingInterval: 1000;
+    };
+};
 export {};
 //# sourceMappingURL=constants.d.mts.map

package/dist/constants.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.mts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,2CAA2C,CAAC;AAErE,aAAK,qBAAqB,GAAG;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB,CAAC;AAGF,eAAO,MAAM,yBAAyB,EAAE,qBAQvC,CAAC;AAEF,oBAAY,oBAAoB;IAC9B,gBAAgB,uBAAuB;IACvC,YAAY,kBAAkB;IAC9B,qBAAqB,4BAA4B;IACjD,cAAc,oBAAoB;CACnC;AAED,oBAAY,wBAAwB;IAClC,YAAY,iBAAiB;IAC7B,UAAU,eAAe;CAC1B;AAED,oBAAY,0BAA0B;IACpC,OAAO,iCAAiC;IACxC,kBAAkB,4CAA4C;IAC9D,iBAAiB,2CAA2C;IAC5D,aAAa,uCAAuC;CACrD"}
+{"version":3,"file":"constants.d.mts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,2CAA2C,CAAC;AAErE,aAAK,qBAAqB,GAAG;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB,CAAC;AAGF,eAAO,MAAM,yBAAyB,EAAE,qBAQvC,CAAC;AAEF,oBAAY,oBAAoB;IAC9B,gBAAgB,uBAAuB;IACvC,YAAY,kBAAkB;IAC9B,qBAAqB,4BAA4B;IACjD,cAAc,oBAAoB;CACnC;AAED,oBAAY,wBAAwB;IAClC,YAAY,iBAAiB;IAC7B,UAAU,eAAe;CAC1B;AAED,oBAAY,0BAA0B;IACpC,OAAO,iCAAiC;IACxC,kBAAkB,4CAA4C;IAC9D,iBAAiB,2CAA2C;IAC5D,aAAa,uCAAuC;CACrD;AAED;;;;GAIG;AACH,eAAO,MAAM,iDAAiD;;;;;;;;;;;;;;CAcpD,CAAC"}

package/dist/constants.mjs

@@ -28,4 +28,24 @@ export var SmartTransactionsTraceName;
     SmartTransactionsTraceName["CancelTransaction"] = "Smart Transactions: Cancel Transaction";
     SmartTransactionsTraceName["FetchLiveness"] = "Smart Transactions: Fetch Liveness";
 })(SmartTransactionsTraceName = SmartTransactionsTraceName || (SmartTransactionsTraceName = {}));
+/**
+ * Default feature flags configuration for smart transactions.
+ * Used as a fallback when remote feature flags are unavailable or invalid.
+ * This is voluntarily defensive because it is applied to any network without valid configuration.
+ */
+export const DEFAULT_DISABLED_SMART_TRANSACTIONS_FEATURE_FLAGS = {
+    default: {
+        extensionActive: false,
+        mobileActive: false,
+        mobileActiveIOS: false,
+        mobileActiveAndroid: false,
+        expectedDeadline: 45,
+        maxDeadline: 150,
+        extensionReturnTxHashAsap: false,
+        extensionReturnTxHashAsapBatch: false,
+        mobileReturnTxHashAsap: false,
+        extensionSkipSmartTransactionStatusPage: false,
+        batchStatusPollingInterval: 1000,
+    },
+};
 //# sourceMappingURL=constants.mjs.map

package/dist/constants.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"constants.mjs","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,wCAAwC,CAAC;AAMrE,6BAA6B;AAC7B,MAAM,CAAC,MAAM,yBAAyB,GAA0B;IAC9D,CAAC,EAAE,yDAAyD;IAC5D,EAAE,EAAE,oDAAoD;IACxD,GAAG,EAAE,wDAAwD;IAC7D,IAAI,EAAE,qDAAqD;IAC3D,KAAK,EAAE,yDAAyD;IAChE,KAAK,EAAE,sDAAsD;IAC7D,QAAQ,EAAE,yDAAyD;CACpE,CAAC;AAEF,MAAM,CAAN,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC9B,+DAAuC,CAAA;IACvC,sDAA8B,CAAA;IAC9B,yEAAiD,CAAA;IACjD,0DAAkC,CAAA;AACpC,CAAC,EALW,oBAAoB,GAApB,oBAAoB,KAApB,oBAAoB,QAK/B;AAED,MAAM,CAAN,IAAY,wBAGX;AAHD,WAAY,wBAAwB;IAClC,yDAA6B,CAAA;IAC7B,qDAAyB,CAAA;AAC3B,CAAC,EAHW,wBAAwB,GAAxB,wBAAwB,KAAxB,wBAAwB,QAGnC;AAED,MAAM,CAAN,IAAY,0BAKX;AALD,WAAY,0BAA0B;IACpC,sEAAwC,CAAA;IACxC,4FAA8D,CAAA;IAC9D,0FAA4D,CAAA;IAC5D,kFAAoD,CAAA;AACtD,CAAC,EALW,0BAA0B,GAA1B,0BAA0B,KAA1B,0BAA0B,QAKrC","sourcesContent":["export const API_BASE_URL = 'https://transaction.api.cx.metamask.io';\n\ntype SentinelApiBaseUrlMap = {\n  [key: number]: string;\n};\n\n// The map with types applied\nexport const SENTINEL_API_BASE_URL_MAP: SentinelApiBaseUrlMap = {\n  1: 'https://tx-sentinel-ethereum-mainnet.api.cx.metamask.io',\n  56: 'https://tx-sentinel-bsc-mainnet.api.cx.metamask.io',\n  137: 'https://tx-sentinel-polygon-mainnet.api.cx.metamask.io',\n  8453: 'https://tx-sentinel-base-mainnet.api.cx.metamask.io',\n  42161: 'https://tx-sentinel-arbitrum-mainnet.api.cx.metamask.io',\n  59144: 'https://tx-sentinel-linea-mainnet.api.cx.metamask.io',\n  11155111: 'https://tx-sentinel-ethereum-sepolia.api.cx.metamask.io',\n};\n\nexport enum MetaMetricsEventName {\n  StxStatusUpdated = 'STX Status Updated',\n  StxConfirmed = 'STX Confirmed',\n  StxConfirmationFailed = 'STX Confirmation Failed',\n  ReceiveRequest = 'Receive Request',\n}\n\nexport enum MetaMetricsEventCategory {\n  Transactions = 'Transactions',\n  Navigation = 'Navigation',\n}\n\nexport enum SmartTransactionsTraceName {\n  GetFees = 'Smart Transactions: Get Fees',\n  SubmitTransactions = 'Smart Transactions: Submit Transactions',\n  CancelTransaction = 'Smart Transactions: Cancel Transaction',\n  FetchLiveness = 'Smart Transactions: Fetch Liveness',\n}\n"]}
+{"version":3,"file":"constants.mjs","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,wCAAwC,CAAC;AAMrE,6BAA6B;AAC7B,MAAM,CAAC,MAAM,yBAAyB,GAA0B;IAC9D,CAAC,EAAE,yDAAyD;IAC5D,EAAE,EAAE,oDAAoD;IACxD,GAAG,EAAE,wDAAwD;IAC7D,IAAI,EAAE,qDAAqD;IAC3D,KAAK,EAAE,yDAAyD;IAChE,KAAK,EAAE,sDAAsD;IAC7D,QAAQ,EAAE,yDAAyD;CACpE,CAAC;AAEF,MAAM,CAAN,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC9B,+DAAuC,CAAA;IACvC,sDAA8B,CAAA;IAC9B,yEAAiD,CAAA;IACjD,0DAAkC,CAAA;AACpC,CAAC,EALW,oBAAoB,GAApB,oBAAoB,KAApB,oBAAoB,QAK/B;AAED,MAAM,CAAN,IAAY,wBAGX;AAHD,WAAY,wBAAwB;IAClC,yDAA6B,CAAA;IAC7B,qDAAyB,CAAA;AAC3B,CAAC,EAHW,wBAAwB,GAAxB,wBAAwB,KAAxB,wBAAwB,QAGnC;AAED,MAAM,CAAN,IAAY,0BAKX;AALD,WAAY,0BAA0B;IACpC,sEAAwC,CAAA;IACxC,4FAA8D,CAAA;IAC9D,0FAA4D,CAAA;IAC5D,kFAAoD,CAAA;AACtD,CAAC,EALW,0BAA0B,GAA1B,0BAA0B,KAA1B,0BAA0B,QAKrC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,iDAAiD,GAAG;IAC/D,OAAO,EAAE;QACP,eAAe,EAAE,KAAK;QACtB,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,KAAK;QACtB,mBAAmB,EAAE,KAAK;QAC1B,gBAAgB,EAAE,EAAE;QACpB,WAAW,EAAE,GAAG;QAChB,yBAAyB,EAAE,KAAK;QAChC,8BAA8B,EAAE,KAAK;QACrC,sBAAsB,EAAE,KAAK;QAC7B,uCAAuC,EAAE,KAAK;QAC9C,0BAA0B,EAAE,IAAI;KACjC;CACO,CAAC","sourcesContent":["export const API_BASE_URL = 'https://transaction.api.cx.metamask.io';\n\ntype SentinelApiBaseUrlMap = {\n  [key: number]: string;\n};\n\n// The map with types applied\nexport const SENTINEL_API_BASE_URL_MAP: SentinelApiBaseUrlMap = {\n  1: 'https://tx-sentinel-ethereum-mainnet.api.cx.metamask.io',\n  56: 'https://tx-sentinel-bsc-mainnet.api.cx.metamask.io',\n  137: 'https://tx-sentinel-polygon-mainnet.api.cx.metamask.io',\n  8453: 'https://tx-sentinel-base-mainnet.api.cx.metamask.io',\n  42161: 'https://tx-sentinel-arbitrum-mainnet.api.cx.metamask.io',\n  59144: 'https://tx-sentinel-linea-mainnet.api.cx.metamask.io',\n  11155111: 'https://tx-sentinel-ethereum-sepolia.api.cx.metamask.io',\n};\n\nexport enum MetaMetricsEventName {\n  StxStatusUpdated = 'STX Status Updated',\n  StxConfirmed = 'STX Confirmed',\n  StxConfirmationFailed = 'STX Confirmation Failed',\n  ReceiveRequest = 'Receive Request',\n}\n\nexport enum MetaMetricsEventCategory {\n  Transactions = 'Transactions',\n  Navigation = 'Navigation',\n}\n\nexport enum SmartTransactionsTraceName {\n  GetFees = 'Smart Transactions: Get Fees',\n  SubmitTransactions = 'Smart Transactions: Submit Transactions',\n  CancelTransaction = 'Smart Transactions: Cancel Transaction',\n  FetchLiveness = 'Smart Transactions: Fetch Liveness',\n}\n\n/**\n * Default feature flags configuration for smart transactions.\n * Used as a fallback when remote feature flags are unavailable or invalid.\n * This is voluntarily defensive because it is applied to any network without valid configuration.\n */\nexport const DEFAULT_DISABLED_SMART_TRANSACTIONS_FEATURE_FLAGS = {\n  default: {\n    extensionActive: false,\n    mobileActive: false,\n    mobileActiveIOS: false,\n    mobileActiveAndroid: false,\n    expectedDeadline: 45,\n    maxDeadline: 150,\n    extensionReturnTxHashAsap: false,\n    extensionReturnTxHashAsapBatch: false,\n    mobileReturnTxHashAsap: false,\n    extensionSkipSmartTransactionStatusPage: false,\n    batchStatusPollingInterval: 1000,\n  },\n} as const;\n"]}

package/dist/featureFlags/feature-flags.cjs

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSmartTransactionsFeatureFlagsForChain = exports.getSmartTransactionsFeatureFlags = exports.processSmartTransactionsFeatureFlags = exports.normalizeChainId = void 0;
+const utils_1 = require("@metamask/utils");
+const constants_1 = require("../constants.cjs");
+const validators_1 = require("./validators.cjs");
+/**
+ * Normalizes a chain ID to hex format for EVM chains.
+ * - CAIP-2 EVM format (eip155:X) is converted to hex (0xY)
+ * - Hex format is returned as-is
+ * - Non-EVM CAIP-2 formats are returned as-is (exact match)
+ * - Invalid eip155 formats (non-numeric reference) are returned as-is
+ * - This is used because the current STX chains are EVM and declared as hex chain IDs in the existing flag.
+ *
+ * @param chainId - The chain ID in any supported format
+ * @returns Normalized chain ID (hex for EVM, original for non-EVM)
+ * @example
+ * ```ts
+ * normalizeChainId('0x1')           // → '0x1'
+ * normalizeChainId('eip155:1')      // → '0x1'
+ * normalizeChainId('eip155:137')    // → '0x89'
+ * normalizeChainId('solana:...')    // → 'solana:...' (unchanged)
+ * normalizeChainId('eip155:abc')    // → 'eip155:abc' (invalid, unchanged)
+ * ```
+ */
+function normalizeChainId(chainId) {
+    // If it's already hex or not a valid CAIP chain ID, return as-is
+    if (!(0, utils_1.isCaipChainId)(chainId)) {
+        return chainId;
+    }
+    const { namespace, reference } = (0, utils_1.parseCaipChainId)(chainId);
+    // Only normalize EVM CAIP-2 chains with valid numeric references to hex
+    if (namespace === utils_1.KnownCaipNamespace.Eip155) {
+        const decimal = parseInt(reference, 10);
+        // If reference is not a valid number, return as-is
+        if (Number.isNaN(decimal)) {
+            return chainId;
+        }
+        return (0, utils_1.numberToHex)(decimal);
+    }
+    // Non-EVM CAIP chains remain unchanged
+    return chainId;
+}
+exports.normalizeChainId = normalizeChainId;
+/**
+ * Processes raw feature flags data and returns a validated configuration.
+ * Invalid chain configs are silently removed. Error reporting is handled by
+ * the SmartTransactionsController via ErrorReportingService.
+ *
+ * @param rawFeatureFlags - The raw feature flags data from the remote feature flag controller
+ * @returns The validated feature flags configuration (partial if some chains were invalid)
+ */
+function processSmartTransactionsFeatureFlags(rawFeatureFlags) {
+    const { config } = (0, validators_1.validateSmartTransactionsFeatureFlags)(rawFeatureFlags);
+    // Return config if it has any valid data, otherwise return defaults
+    if (Object.keys(config).length > 0) {
+        return config;
+    }
+    return constants_1.DEFAULT_DISABLED_SMART_TRANSACTIONS_FEATURE_FLAGS;
+}
+exports.processSmartTransactionsFeatureFlags = processSmartTransactionsFeatureFlags;
+/**
+ * Gets the smart transactions feature flags from the remote feature flag controller.
+ *
+ * @param messenger - Any messenger with access to RemoteFeatureFlagController:getState
+ * @returns The smart transactions feature flags configuration
+ * @example
+ * ```ts
+ * const featureFlags = getSmartTransactionsFeatureFlags(messenger);
+ * const chainConfig = featureFlags['0x1'] ?? featureFlags.default;
+ * ```
+ */
+function getSmartTransactionsFeatureFlags(messenger) {
+    var _a;
+    const remoteFeatureFlagControllerState = messenger.call('RemoteFeatureFlagController:getState');
+    const rawSmartTransactionsNetworks = (_a = remoteFeatureFlagControllerState === null || remoteFeatureFlagControllerState === void 0 ? void 0 : remoteFeatureFlagControllerState.remoteFeatureFlags) === null || _a === void 0 ? void 0 : _a.smartTransactionsNetworks;
+    return processSmartTransactionsFeatureFlags(rawSmartTransactionsNetworks);
+}
+exports.getSmartTransactionsFeatureFlags = getSmartTransactionsFeatureFlags;
+/**
+ * Gets the merged feature flags configuration for a specific chain.
+ * Chain-specific configuration takes precedence over default configuration.
+ *
+ * For EVM chains, the chain ID is normalized to hex format before lookup.
+ * This means both '0x1' and 'eip155:1' will resolve to the same configuration.
+ * Non-EVM chains (e.g., Solana, Bitcoin) use exact match.
+ *
+ * @param featureFlags - The full feature flags configuration
+ * @param chainId - The chain ID to get configuration for.
+ * Supports both hex (e.g., "0x1") and CAIP-2 format (e.g., "eip155:1", "solana:...")
+ * @returns The merged configuration for the specified chain
+ * @example
+ * ```ts
+ * const featureFlags = getSmartTransactionsFeatureFlags(messenger);
+ *
+ * // Both resolve to the same config (normalized to 0x1)
+ * const chainConfig = getSmartTransactionsFeatureFlagsForChain(featureFlags, '0x1');
+ * const sameConfig = getSmartTransactionsFeatureFlagsForChain(featureFlags, 'eip155:1');
+ *
+ * // Non-EVM uses exact match
+ * const solanaConfig = getSmartTransactionsFeatureFlagsForChain(featureFlags, 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp');
+ *
+ * if (chainConfig.extensionActive) {
+ *   // Smart transactions are enabled for this chain
+ * }
+ * ```
+ */
+function getSmartTransactionsFeatureFlagsForChain(featureFlags, chainId) {
+    var _a;
+    const normalizedChainId = normalizeChainId(chainId);
+    const defaultRemoteConfig = (_a = featureFlags.default) !== null && _a !== void 0 ? _a : {};
+    const chainRemoteConfig = featureFlags[normalizedChainId];
+    if (chainRemoteConfig === undefined) {
+        return constants_1.DEFAULT_DISABLED_SMART_TRANSACTIONS_FEATURE_FLAGS.default;
+    }
+    return Object.assign(Object.assign({}, defaultRemoteConfig), chainRemoteConfig);
+}
+exports.getSmartTransactionsFeatureFlagsForChain = getSmartTransactionsFeatureFlagsForChain;
+//# sourceMappingURL=feature-flags.cjs.map

package/dist/featureFlags/feature-flags.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.cjs","sourceRoot":"","sources":["../../src/featureFlags/feature-flags.ts"],"names":[],"mappings":";;;AAEA,2CAKyB;AAEzB,gDAAiF;AAKjF,iDAAqE;AAErE;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,gBAAgB,CAC9B,OAA0B;IAE1B,iEAAiE;IACjE,IAAI,CAAC,IAAA,qBAAa,EAAC,OAAO,CAAC,EAAE;QAC3B,OAAO,OAAO,CAAC;KAChB;IAED,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAAA,wBAAgB,EAAC,OAAO,CAAC,CAAC;IAE3D,wEAAwE;IACxE,IAAI,SAAS,KAAK,0BAAkB,CAAC,MAAM,EAAE;QAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACxC,mDAAmD;QACnD,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE;YACzB,OAAO,OAAO,CAAC;SAChB;QACD,OAAO,IAAA,mBAAW,EAAC,OAAO,CAAC,CAAC;KAC7B;IAED,uCAAuC;IACvC,OAAO,OAAO,CAAC;AACjB,CAAC;AAtBD,4CAsBC;AAED;;;;;;;GAOG;AACH,SAAgB,oCAAoC,CAClD,eAAwB;IAExB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,kDAAqC,EAAC,eAAe,CAAC,CAAC;IAE1E,oEAAoE;IACpE,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE;QAClC,OAAO,MAAM,CAAC;KACf;IAED,OAAO,6DAAiD,CAAC;AAC3D,CAAC;AAXD,oFAWC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,gCAAgC,CAM9C,SAAY;;IACZ,MAAM,gCAAgC,GAAG,SAAS,CAAC,IAAI,CACrD,sCAAsC,CACvC,CAAC;IAEF,MAAM,4BAA4B,GAChC,MAAA,gCAAgC,aAAhC,gCAAgC,uBAAhC,gCAAgC,CAAE,kBAAkB,0CAChD,yBAAyB,CAAC;IAEhC,OAAO,oCAAoC,CAAC,4BAA4B,CAAC,CAAC;AAC5E,CAAC;AAhBD,4EAgBC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAgB,wCAAwC,CACtD,YAAiD,EACjD,OAA0B;;IAE1B,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,mBAAmB,GAAG,MAAA,YAAY,CAAC,OAAO,mCAAI,EAAE,CAAC;IACvD,MAAM,iBAAiB,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC;IAE1D,IAAI,iBAAiB,KAAK,SAAS,EAAE;QACnC,OAAO,6DAAiD,CAAC,OAAO,CAAC;KAClE;IAED,uCACK,mBAAmB,GACnB,iBAAiB,EACpB;AACJ,CAAC;AAhBD,4FAgBC","sourcesContent":["import type { RemoteFeatureFlagControllerState } from '@metamask/remote-feature-flag-controller';\nimport type { CaipChainId, Hex } from '@metamask/utils';\nimport {\n  isCaipChainId,\n  KnownCaipNamespace,\n  numberToHex,\n  parseCaipChainId,\n} from '@metamask/utils';\n\nimport { DEFAULT_DISABLED_SMART_TRANSACTIONS_FEATURE_FLAGS } from '../constants';\nimport type {\n  SmartTransactionsFeatureFlagsConfig,\n  SmartTransactionsNetworkConfig,\n} from '../types';\nimport { validateSmartTransactionsFeatureFlags } from './validators';\n\n/**\n * Normalizes a chain ID to hex format for EVM chains.\n * - CAIP-2 EVM format (eip155:X) is converted to hex (0xY)\n * - Hex format is returned as-is\n * - Non-EVM CAIP-2 formats are returned as-is (exact match)\n * - Invalid eip155 formats (non-numeric reference) are returned as-is\n * - This is used because the current STX chains are EVM and declared as hex chain IDs in the existing flag.\n *\n * @param chainId - The chain ID in any supported format\n * @returns Normalized chain ID (hex for EVM, original for non-EVM)\n * @example\n * ```ts\n * normalizeChainId('0x1')           // → '0x1'\n * normalizeChainId('eip155:1')      // → '0x1'\n * normalizeChainId('eip155:137')    // → '0x89'\n * normalizeChainId('solana:...')    // → 'solana:...' (unchanged)\n * normalizeChainId('eip155:abc')    // → 'eip155:abc' (invalid, unchanged)\n * ```\n */\nexport function normalizeChainId(\n  chainId: Hex | CaipChainId,\n): Hex | CaipChainId {\n  // If it's already hex or not a valid CAIP chain ID, return as-is\n  if (!isCaipChainId(chainId)) {\n    return chainId;\n  }\n\n  const { namespace, reference } = parseCaipChainId(chainId);\n\n  // Only normalize EVM CAIP-2 chains with valid numeric references to hex\n  if (namespace === KnownCaipNamespace.Eip155) {\n    const decimal = parseInt(reference, 10);\n    // If reference is not a valid number, return as-is\n    if (Number.isNaN(decimal)) {\n      return chainId;\n    }\n    return numberToHex(decimal);\n  }\n\n  // Non-EVM CAIP chains remain unchanged\n  return chainId;\n}\n\n/**\n * Processes raw feature flags data and returns a validated configuration.\n * Invalid chain configs are silently removed. Error reporting is handled by\n * the SmartTransactionsController via ErrorReportingService.\n *\n * @param rawFeatureFlags - The raw feature flags data from the remote feature flag controller\n * @returns The validated feature flags configuration (partial if some chains were invalid)\n */\nexport function processSmartTransactionsFeatureFlags(\n  rawFeatureFlags: unknown,\n): SmartTransactionsFeatureFlagsConfig {\n  const { config } = validateSmartTransactionsFeatureFlags(rawFeatureFlags);\n\n  // Return config if it has any valid data, otherwise return defaults\n  if (Object.keys(config).length > 0) {\n    return config;\n  }\n\n  return DEFAULT_DISABLED_SMART_TRANSACTIONS_FEATURE_FLAGS;\n}\n\n/**\n * Gets the smart transactions feature flags from the remote feature flag controller.\n *\n * @param messenger - Any messenger with access to RemoteFeatureFlagController:getState\n * @returns The smart transactions feature flags configuration\n * @example\n * ```ts\n * const featureFlags = getSmartTransactionsFeatureFlags(messenger);\n * const chainConfig = featureFlags['0x1'] ?? featureFlags.default;\n * ```\n */\nexport function getSmartTransactionsFeatureFlags<\n  T extends {\n    call(\n      action: 'RemoteFeatureFlagController:getState',\n    ): RemoteFeatureFlagControllerState;\n  },\n>(messenger: T): SmartTransactionsFeatureFlagsConfig {\n  const remoteFeatureFlagControllerState = messenger.call(\n    'RemoteFeatureFlagController:getState',\n  );\n\n  const rawSmartTransactionsNetworks =\n    remoteFeatureFlagControllerState?.remoteFeatureFlags\n      ?.smartTransactionsNetworks;\n\n  return processSmartTransactionsFeatureFlags(rawSmartTransactionsNetworks);\n}\n\n/**\n * Gets the merged feature flags configuration for a specific chain.\n * Chain-specific configuration takes precedence over default configuration.\n *\n * For EVM chains, the chain ID is normalized to hex format before lookup.\n * This means both '0x1' and 'eip155:1' will resolve to the same configuration.\n * Non-EVM chains (e.g., Solana, Bitcoin) use exact match.\n *\n * @param featureFlags - The full feature flags configuration\n * @param chainId - The chain ID to get configuration for.\n * Supports both hex (e.g., \"0x1\") and CAIP-2 format (e.g., \"eip155:1\", \"solana:...\")\n * @returns The merged configuration for the specified chain\n * @example\n * ```ts\n * const featureFlags = getSmartTransactionsFeatureFlags(messenger);\n *\n * // Both resolve to the same config (normalized to 0x1)\n * const chainConfig = getSmartTransactionsFeatureFlagsForChain(featureFlags, '0x1');\n * const sameConfig = getSmartTransactionsFeatureFlagsForChain(featureFlags, 'eip155:1');\n *\n * // Non-EVM uses exact match\n * const solanaConfig = getSmartTransactionsFeatureFlagsForChain(featureFlags, 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp');\n *\n * if (chainConfig.extensionActive) {\n *   // Smart transactions are enabled for this chain\n * }\n * ```\n */\nexport function getSmartTransactionsFeatureFlagsForChain(\n  featureFlags: SmartTransactionsFeatureFlagsConfig,\n  chainId: Hex | CaipChainId,\n): SmartTransactionsNetworkConfig {\n  const normalizedChainId = normalizeChainId(chainId);\n  const defaultRemoteConfig = featureFlags.default ?? {};\n  const chainRemoteConfig = featureFlags[normalizedChainId];\n\n  if (chainRemoteConfig === undefined) {\n    return DEFAULT_DISABLED_SMART_TRANSACTIONS_FEATURE_FLAGS.default;\n  }\n\n  return {\n    ...defaultRemoteConfig,\n    ...chainRemoteConfig,\n  };\n}\n"]}

package/dist/featureFlags/feature-flags.d.cts

@@ -0,0 +1,76 @@
+import type { RemoteFeatureFlagControllerState } from "@metamask/remote-feature-flag-controller";
+import type { CaipChainId, Hex } from "@metamask/utils";
+import type { SmartTransactionsFeatureFlagsConfig, SmartTransactionsNetworkConfig } from "../types.cjs";
+/**
+ * Normalizes a chain ID to hex format for EVM chains.
+ * - CAIP-2 EVM format (eip155:X) is converted to hex (0xY)
+ * - Hex format is returned as-is
+ * - Non-EVM CAIP-2 formats are returned as-is (exact match)
+ * - Invalid eip155 formats (non-numeric reference) are returned as-is
+ * - This is used because the current STX chains are EVM and declared as hex chain IDs in the existing flag.
+ *
+ * @param chainId - The chain ID in any supported format
+ * @returns Normalized chain ID (hex for EVM, original for non-EVM)
+ * @example
+ * ```ts
+ * normalizeChainId('0x1')           // → '0x1'
+ * normalizeChainId('eip155:1')      // → '0x1'
+ * normalizeChainId('eip155:137')    // → '0x89'
+ * normalizeChainId('solana:...')    // → 'solana:...' (unchanged)
+ * normalizeChainId('eip155:abc')    // → 'eip155:abc' (invalid, unchanged)
+ * ```
+ */
+export declare function normalizeChainId(chainId: Hex | CaipChainId): Hex | CaipChainId;
+/**
+ * Processes raw feature flags data and returns a validated configuration.
+ * Invalid chain configs are silently removed. Error reporting is handled by
+ * the SmartTransactionsController via ErrorReportingService.
+ *
+ * @param rawFeatureFlags - The raw feature flags data from the remote feature flag controller
+ * @returns The validated feature flags configuration (partial if some chains were invalid)
+ */
+export declare function processSmartTransactionsFeatureFlags(rawFeatureFlags: unknown): SmartTransactionsFeatureFlagsConfig;
+/**
+ * Gets the smart transactions feature flags from the remote feature flag controller.
+ *
+ * @param messenger - Any messenger with access to RemoteFeatureFlagController:getState
+ * @returns The smart transactions feature flags configuration
+ * @example
+ * ```ts
+ * const featureFlags = getSmartTransactionsFeatureFlags(messenger);
+ * const chainConfig = featureFlags['0x1'] ?? featureFlags.default;
+ * ```
+ */
+export declare function getSmartTransactionsFeatureFlags<T extends {
+    call(action: 'RemoteFeatureFlagController:getState'): RemoteFeatureFlagControllerState;
+}>(messenger: T): SmartTransactionsFeatureFlagsConfig;
+/**
+ * Gets the merged feature flags configuration for a specific chain.
+ * Chain-specific configuration takes precedence over default configuration.
+ *
+ * For EVM chains, the chain ID is normalized to hex format before lookup.
+ * This means both '0x1' and 'eip155:1' will resolve to the same configuration.
+ * Non-EVM chains (e.g., Solana, Bitcoin) use exact match.
+ *
+ * @param featureFlags - The full feature flags configuration
+ * @param chainId - The chain ID to get configuration for.
+ * Supports both hex (e.g., "0x1") and CAIP-2 format (e.g., "eip155:1", "solana:...")
+ * @returns The merged configuration for the specified chain
+ * @example
+ * ```ts
+ * const featureFlags = getSmartTransactionsFeatureFlags(messenger);
+ *
+ * // Both resolve to the same config (normalized to 0x1)
+ * const chainConfig = getSmartTransactionsFeatureFlagsForChain(featureFlags, '0x1');
+ * const sameConfig = getSmartTransactionsFeatureFlagsForChain(featureFlags, 'eip155:1');
+ *
+ * // Non-EVM uses exact match
+ * const solanaConfig = getSmartTransactionsFeatureFlagsForChain(featureFlags, 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp');
+ *
+ * if (chainConfig.extensionActive) {
+ *   // Smart transactions are enabled for this chain
+ * }
+ * ```
+ */
+export declare function getSmartTransactionsFeatureFlagsForChain(featureFlags: SmartTransactionsFeatureFlagsConfig, chainId: Hex | CaipChainId): SmartTransactionsNetworkConfig;
+//# sourceMappingURL=feature-flags.d.cts.map

package/dist/featureFlags/feature-flags.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.d.cts","sourceRoot":"","sources":["../../src/featureFlags/feature-flags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gCAAgC,EAAE,iDAAiD;AACjG,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,wBAAwB;AASxD,OAAO,KAAK,EACV,mCAAmC,EACnC,8BAA8B,EAC/B,qBAAiB;AAGlB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,GAAG,GAAG,WAAW,GACzB,GAAG,GAAG,WAAW,CAoBnB;AAED;;;;;;;GAOG;AACH,wBAAgB,oCAAoC,CAClD,eAAe,EAAE,OAAO,GACvB,mCAAmC,CASrC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAC9C,CAAC,SAAS;IACR,IAAI,CACF,MAAM,EAAE,sCAAsC,GAC7C,gCAAgC,CAAC;CACrC,EACD,SAAS,EAAE,CAAC,GAAG,mCAAmC,CAUnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,wCAAwC,CACtD,YAAY,EAAE,mCAAmC,EACjD,OAAO,EAAE,GAAG,GAAG,WAAW,GACzB,8BAA8B,CAahC"}

package/dist/featureFlags/feature-flags.d.mts

@@ -0,0 +1,76 @@
+import type { RemoteFeatureFlagControllerState } from "@metamask/remote-feature-flag-controller";
+import type { CaipChainId, Hex } from "@metamask/utils";
+import type { SmartTransactionsFeatureFlagsConfig, SmartTransactionsNetworkConfig } from "../types.mjs";
+/**
+ * Normalizes a chain ID to hex format for EVM chains.
+ * - CAIP-2 EVM format (eip155:X) is converted to hex (0xY)
+ * - Hex format is returned as-is
+ * - Non-EVM CAIP-2 formats are returned as-is (exact match)
+ * - Invalid eip155 formats (non-numeric reference) are returned as-is
+ * - This is used because the current STX chains are EVM and declared as hex chain IDs in the existing flag.
+ *
+ * @param chainId - The chain ID in any supported format
+ * @returns Normalized chain ID (hex for EVM, original for non-EVM)
+ * @example
+ * ```ts
+ * normalizeChainId('0x1')           // → '0x1'
+ * normalizeChainId('eip155:1')      // → '0x1'
+ * normalizeChainId('eip155:137')    // → '0x89'
+ * normalizeChainId('solana:...')    // → 'solana:...' (unchanged)
+ * normalizeChainId('eip155:abc')    // → 'eip155:abc' (invalid, unchanged)
+ * ```
+ */
+export declare function normalizeChainId(chainId: Hex | CaipChainId): Hex | CaipChainId;
+/**
+ * Processes raw feature flags data and returns a validated configuration.
+ * Invalid chain configs are silently removed. Error reporting is handled by
+ * the SmartTransactionsController via ErrorReportingService.
+ *
+ * @param rawFeatureFlags - The raw feature flags data from the remote feature flag controller
+ * @returns The validated feature flags configuration (partial if some chains were invalid)
+ */
+export declare function processSmartTransactionsFeatureFlags(rawFeatureFlags: unknown): SmartTransactionsFeatureFlagsConfig;
+/**
+ * Gets the smart transactions feature flags from the remote feature flag controller.
+ *
+ * @param messenger - Any messenger with access to RemoteFeatureFlagController:getState
+ * @returns The smart transactions feature flags configuration
+ * @example
+ * ```ts
+ * const featureFlags = getSmartTransactionsFeatureFlags(messenger);
+ * const chainConfig = featureFlags['0x1'] ?? featureFlags.default;
+ * ```
+ */
+export declare function getSmartTransactionsFeatureFlags<T extends {
+    call(action: 'RemoteFeatureFlagController:getState'): RemoteFeatureFlagControllerState;
+}>(messenger: T): SmartTransactionsFeatureFlagsConfig;
+/**
+ * Gets the merged feature flags configuration for a specific chain.
+ * Chain-specific configuration takes precedence over default configuration.
+ *
+ * For EVM chains, the chain ID is normalized to hex format before lookup.
+ * This means both '0x1' and 'eip155:1' will resolve to the same configuration.
+ * Non-EVM chains (e.g., Solana, Bitcoin) use exact match.
+ *
+ * @param featureFlags - The full feature flags configuration
+ * @param chainId - The chain ID to get configuration for.
+ * Supports both hex (e.g., "0x1") and CAIP-2 format (e.g., "eip155:1", "solana:...")
+ * @returns The merged configuration for the specified chain
+ * @example
+ * ```ts
+ * const featureFlags = getSmartTransactionsFeatureFlags(messenger);
+ *
+ * // Both resolve to the same config (normalized to 0x1)
+ * const chainConfig = getSmartTransactionsFeatureFlagsForChain(featureFlags, '0x1');
+ * const sameConfig = getSmartTransactionsFeatureFlagsForChain(featureFlags, 'eip155:1');
+ *
+ * // Non-EVM uses exact match
+ * const solanaConfig = getSmartTransactionsFeatureFlagsForChain(featureFlags, 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp');
+ *
+ * if (chainConfig.extensionActive) {
+ *   // Smart transactions are enabled for this chain
+ * }
+ * ```
+ */
+export declare function getSmartTransactionsFeatureFlagsForChain(featureFlags: SmartTransactionsFeatureFlagsConfig, chainId: Hex | CaipChainId): SmartTransactionsNetworkConfig;
+//# sourceMappingURL=feature-flags.d.mts.map

package/dist/featureFlags/feature-flags.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.d.mts","sourceRoot":"","sources":["../../src/featureFlags/feature-flags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gCAAgC,EAAE,iDAAiD;AACjG,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,wBAAwB;AASxD,OAAO,KAAK,EACV,mCAAmC,EACnC,8BAA8B,EAC/B,qBAAiB;AAGlB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,GAAG,GAAG,WAAW,GACzB,GAAG,GAAG,WAAW,CAoBnB;AAED;;;;;;;GAOG;AACH,wBAAgB,oCAAoC,CAClD,eAAe,EAAE,OAAO,GACvB,mCAAmC,CASrC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAC9C,CAAC,SAAS;IACR,IAAI,CACF,MAAM,EAAE,sCAAsC,GAC7C,gCAAgC,CAAC;CACrC,EACD,SAAS,EAAE,CAAC,GAAG,mCAAmC,CAUnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,wCAAwC,CACtD,YAAY,EAAE,mCAAmC,EACjD,OAAO,EAAE,GAAG,GAAG,WAAW,GACzB,8BAA8B,CAahC"}

package/dist/featureFlags/feature-flags.mjs

@@ -0,0 +1,112 @@
+import { isCaipChainId, KnownCaipNamespace, numberToHex, parseCaipChainId } from "@metamask/utils";
+import { DEFAULT_DISABLED_SMART_TRANSACTIONS_FEATURE_FLAGS } from "../constants.mjs";
+import { validateSmartTransactionsFeatureFlags } from "./validators.mjs";
+/**
+ * Normalizes a chain ID to hex format for EVM chains.
+ * - CAIP-2 EVM format (eip155:X) is converted to hex (0xY)
+ * - Hex format is returned as-is
+ * - Non-EVM CAIP-2 formats are returned as-is (exact match)
+ * - Invalid eip155 formats (non-numeric reference) are returned as-is
+ * - This is used because the current STX chains are EVM and declared as hex chain IDs in the existing flag.
+ *
+ * @param chainId - The chain ID in any supported format
+ * @returns Normalized chain ID (hex for EVM, original for non-EVM)
+ * @example
+ * ```ts
+ * normalizeChainId('0x1')           // → '0x1'
+ * normalizeChainId('eip155:1')      // → '0x1'
+ * normalizeChainId('eip155:137')    // → '0x89'
+ * normalizeChainId('solana:...')    // → 'solana:...' (unchanged)
+ * normalizeChainId('eip155:abc')    // → 'eip155:abc' (invalid, unchanged)
+ * ```
+ */
+export function normalizeChainId(chainId) {
+    // If it's already hex or not a valid CAIP chain ID, return as-is
+    if (!isCaipChainId(chainId)) {
+        return chainId;
+    }
+    const { namespace, reference } = parseCaipChainId(chainId);
+    // Only normalize EVM CAIP-2 chains with valid numeric references to hex
+    if (namespace === KnownCaipNamespace.Eip155) {
+        const decimal = parseInt(reference, 10);
+        // If reference is not a valid number, return as-is
+        if (Number.isNaN(decimal)) {
+            return chainId;
+        }
+        return numberToHex(decimal);
+    }
+    // Non-EVM CAIP chains remain unchanged
+    return chainId;
+}
+/**
+ * Processes raw feature flags data and returns a validated configuration.
+ * Invalid chain configs are silently removed. Error reporting is handled by
+ * the SmartTransactionsController via ErrorReportingService.
+ *
+ * @param rawFeatureFlags - The raw feature flags data from the remote feature flag controller
+ * @returns The validated feature flags configuration (partial if some chains were invalid)
+ */
+export function processSmartTransactionsFeatureFlags(rawFeatureFlags) {
+    const { config } = validateSmartTransactionsFeatureFlags(rawFeatureFlags);
+    // Return config if it has any valid data, otherwise return defaults
+    if (Object.keys(config).length > 0) {
+        return config;
+    }
+    return DEFAULT_DISABLED_SMART_TRANSACTIONS_FEATURE_FLAGS;
+}
+/**
+ * Gets the smart transactions feature flags from the remote feature flag controller.
+ *
+ * @param messenger - Any messenger with access to RemoteFeatureFlagController:getState
+ * @returns The smart transactions feature flags configuration
+ * @example
+ * ```ts
+ * const featureFlags = getSmartTransactionsFeatureFlags(messenger);
+ * const chainConfig = featureFlags['0x1'] ?? featureFlags.default;
+ * ```
+ */
+export function getSmartTransactionsFeatureFlags(messenger) {
+    var _a;
+    const remoteFeatureFlagControllerState = messenger.call('RemoteFeatureFlagController:getState');
+    const rawSmartTransactionsNetworks = (_a = remoteFeatureFlagControllerState === null || remoteFeatureFlagControllerState === void 0 ? void 0 : remoteFeatureFlagControllerState.remoteFeatureFlags) === null || _a === void 0 ? void 0 : _a.smartTransactionsNetworks;
+    return processSmartTransactionsFeatureFlags(rawSmartTransactionsNetworks);
+}
+/**
+ * Gets the merged feature flags configuration for a specific chain.
+ * Chain-specific configuration takes precedence over default configuration.
+ *
+ * For EVM chains, the chain ID is normalized to hex format before lookup.
+ * This means both '0x1' and 'eip155:1' will resolve to the same configuration.
+ * Non-EVM chains (e.g., Solana, Bitcoin) use exact match.
+ *
+ * @param featureFlags - The full feature flags configuration
+ * @param chainId - The chain ID to get configuration for.
+ * Supports both hex (e.g., "0x1") and CAIP-2 format (e.g., "eip155:1", "solana:...")
+ * @returns The merged configuration for the specified chain
+ * @example
+ * ```ts
+ * const featureFlags = getSmartTransactionsFeatureFlags(messenger);
+ *
+ * // Both resolve to the same config (normalized to 0x1)
+ * const chainConfig = getSmartTransactionsFeatureFlagsForChain(featureFlags, '0x1');
+ * const sameConfig = getSmartTransactionsFeatureFlagsForChain(featureFlags, 'eip155:1');
+ *
+ * // Non-EVM uses exact match
+ * const solanaConfig = getSmartTransactionsFeatureFlagsForChain(featureFlags, 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp');
+ *
+ * if (chainConfig.extensionActive) {
+ *   // Smart transactions are enabled for this chain
+ * }
+ * ```
+ */
+export function getSmartTransactionsFeatureFlagsForChain(featureFlags, chainId) {
+    var _a;
+    const normalizedChainId = normalizeChainId(chainId);
+    const defaultRemoteConfig = (_a = featureFlags.default) !== null && _a !== void 0 ? _a : {};
+    const chainRemoteConfig = featureFlags[normalizedChainId];
+    if (chainRemoteConfig === undefined) {
+        return DEFAULT_DISABLED_SMART_TRANSACTIONS_FEATURE_FLAGS.default;
+    }
+    return Object.assign(Object.assign({}, defaultRemoteConfig), chainRemoteConfig);
+}
+//# sourceMappingURL=feature-flags.mjs.map

package/dist/featureFlags/feature-flags.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.mjs","sourceRoot":"","sources":["../../src/featureFlags/feature-flags.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EACjB,wBAAwB;AAEzB,OAAO,EAAE,iDAAiD,EAAE,yBAAqB;AAKjF,OAAO,EAAE,qCAAqC,EAAE,yBAAqB;AAErE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAA0B;IAE1B,iEAAiE;IACjE,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE;QAC3B,OAAO,OAAO,CAAC;KAChB;IAED,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE3D,wEAAwE;IACxE,IAAI,SAAS,KAAK,kBAAkB,CAAC,MAAM,EAAE;QAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACxC,mDAAmD;QACnD,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE;YACzB,OAAO,OAAO,CAAC;SAChB;QACD,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;KAC7B;IAED,uCAAuC;IACvC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oCAAoC,CAClD,eAAwB;IAExB,MAAM,EAAE,MAAM,EAAE,GAAG,qCAAqC,CAAC,eAAe,CAAC,CAAC;IAE1E,oEAAoE;IACpE,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE;QAClC,OAAO,MAAM,CAAC;KACf;IAED,OAAO,iDAAiD,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gCAAgC,CAM9C,SAAY;;IACZ,MAAM,gCAAgC,GAAG,SAAS,CAAC,IAAI,CACrD,sCAAsC,CACvC,CAAC;IAEF,MAAM,4BAA4B,GAChC,MAAA,gCAAgC,aAAhC,gCAAgC,uBAAhC,gCAAgC,CAAE,kBAAkB,0CAChD,yBAAyB,CAAC;IAEhC,OAAO,oCAAoC,CAAC,4BAA4B,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,wCAAwC,CACtD,YAAiD,EACjD,OAA0B;;IAE1B,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,mBAAmB,GAAG,MAAA,YAAY,CAAC,OAAO,mCAAI,EAAE,CAAC;IACvD,MAAM,iBAAiB,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC;IAE1D,IAAI,iBAAiB,KAAK,SAAS,EAAE;QACnC,OAAO,iDAAiD,CAAC,OAAO,CAAC;KAClE;IAED,uCACK,mBAAmB,GACnB,iBAAiB,EACpB;AACJ,CAAC","sourcesContent":["import type { RemoteFeatureFlagControllerState } from '@metamask/remote-feature-flag-controller';\nimport type { CaipChainId, Hex } from '@metamask/utils';\nimport {\n  isCaipChainId,\n  KnownCaipNamespace,\n  numberToHex,\n  parseCaipChainId,\n} from '@metamask/utils';\n\nimport { DEFAULT_DISABLED_SMART_TRANSACTIONS_FEATURE_FLAGS } from '../constants';\nimport type {\n  SmartTransactionsFeatureFlagsConfig,\n  SmartTransactionsNetworkConfig,\n} from '../types';\nimport { validateSmartTransactionsFeatureFlags } from './validators';\n\n/**\n * Normalizes a chain ID to hex format for EVM chains.\n * - CAIP-2 EVM format (eip155:X) is converted to hex (0xY)\n * - Hex format is returned as-is\n * - Non-EVM CAIP-2 formats are returned as-is (exact match)\n * - Invalid eip155 formats (non-numeric reference) are returned as-is\n * - This is used because the current STX chains are EVM and declared as hex chain IDs in the existing flag.\n *\n * @param chainId - The chain ID in any supported format\n * @returns Normalized chain ID (hex for EVM, original for non-EVM)\n * @example\n * ```ts\n * normalizeChainId('0x1')           // → '0x1'\n * normalizeChainId('eip155:1')      // → '0x1'\n * normalizeChainId('eip155:137')    // → '0x89'\n * normalizeChainId('solana:...')    // → 'solana:...' (unchanged)\n * normalizeChainId('eip155:abc')    // → 'eip155:abc' (invalid, unchanged)\n * ```\n */\nexport function normalizeChainId(\n  chainId: Hex | CaipChainId,\n): Hex | CaipChainId {\n  // If it's already hex or not a valid CAIP chain ID, return as-is\n  if (!isCaipChainId(chainId)) {\n    return chainId;\n  }\n\n  const { namespace, reference } = parseCaipChainId(chainId);\n\n  // Only normalize EVM CAIP-2 chains with valid numeric references to hex\n  if (namespace === KnownCaipNamespace.Eip155) {\n    const decimal = parseInt(reference, 10);\n    // If reference is not a valid number, return as-is\n    if (Number.isNaN(decimal)) {\n      return chainId;\n    }\n    return numberToHex(decimal);\n  }\n\n  // Non-EVM CAIP chains remain unchanged\n  return chainId;\n}\n\n/**\n * Processes raw feature flags data and returns a validated configuration.\n * Invalid chain configs are silently removed. Error reporting is handled by\n * the SmartTransactionsController via ErrorReportingService.\n *\n * @param rawFeatureFlags - The raw feature flags data from the remote feature flag controller\n * @returns The validated feature flags configuration (partial if some chains were invalid)\n */\nexport function processSmartTransactionsFeatureFlags(\n  rawFeatureFlags: unknown,\n): SmartTransactionsFeatureFlagsConfig {\n  const { config } = validateSmartTransactionsFeatureFlags(rawFeatureFlags);\n\n  // Return config if it has any valid data, otherwise return defaults\n  if (Object.keys(config).length > 0) {\n    return config;\n  }\n\n  return DEFAULT_DISABLED_SMART_TRANSACTIONS_FEATURE_FLAGS;\n}\n\n/**\n * Gets the smart transactions feature flags from the remote feature flag controller.\n *\n * @param messenger - Any messenger with access to RemoteFeatureFlagController:getState\n * @returns The smart transactions feature flags configuration\n * @example\n * ```ts\n * const featureFlags = getSmartTransactionsFeatureFlags(messenger);\n * const chainConfig = featureFlags['0x1'] ?? featureFlags.default;\n * ```\n */\nexport function getSmartTransactionsFeatureFlags<\n  T extends {\n    call(\n      action: 'RemoteFeatureFlagController:getState',\n    ): RemoteFeatureFlagControllerState;\n  },\n>(messenger: T): SmartTransactionsFeatureFlagsConfig {\n  const remoteFeatureFlagControllerState = messenger.call(\n    'RemoteFeatureFlagController:getState',\n  );\n\n  const rawSmartTransactionsNetworks =\n    remoteFeatureFlagControllerState?.remoteFeatureFlags\n      ?.smartTransactionsNetworks;\n\n  return processSmartTransactionsFeatureFlags(rawSmartTransactionsNetworks);\n}\n\n/**\n * Gets the merged feature flags configuration for a specific chain.\n * Chain-specific configuration takes precedence over default configuration.\n *\n * For EVM chains, the chain ID is normalized to hex format before lookup.\n * This means both '0x1' and 'eip155:1' will resolve to the same configuration.\n * Non-EVM chains (e.g., Solana, Bitcoin) use exact match.\n *\n * @param featureFlags - The full feature flags configuration\n * @param chainId - The chain ID to get configuration for.\n * Supports both hex (e.g., \"0x1\") and CAIP-2 format (e.g., \"eip155:1\", \"solana:...\")\n * @returns The merged configuration for the specified chain\n * @example\n * ```ts\n * const featureFlags = getSmartTransactionsFeatureFlags(messenger);\n *\n * // Both resolve to the same config (normalized to 0x1)\n * const chainConfig = getSmartTransactionsFeatureFlagsForChain(featureFlags, '0x1');\n * const sameConfig = getSmartTransactionsFeatureFlagsForChain(featureFlags, 'eip155:1');\n *\n * // Non-EVM uses exact match\n * const solanaConfig = getSmartTransactionsFeatureFlagsForChain(featureFlags, 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp');\n *\n * if (chainConfig.extensionActive) {\n *   // Smart transactions are enabled for this chain\n * }\n * ```\n */\nexport function getSmartTransactionsFeatureFlagsForChain(\n  featureFlags: SmartTransactionsFeatureFlagsConfig,\n  chainId: Hex | CaipChainId,\n): SmartTransactionsNetworkConfig {\n  const normalizedChainId = normalizeChainId(chainId);\n  const defaultRemoteConfig = featureFlags.default ?? {};\n  const chainRemoteConfig = featureFlags[normalizedChainId];\n\n  if (chainRemoteConfig === undefined) {\n    return DEFAULT_DISABLED_SMART_TRANSACTIONS_FEATURE_FLAGS.default;\n  }\n\n  return {\n    ...defaultRemoteConfig,\n    ...chainRemoteConfig,\n  };\n}\n"]}

package/dist/featureFlags/index.cjs

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeChainId = exports.getSmartTransactionsFeatureFlagsForChain = exports.processSmartTransactionsFeatureFlags = exports.getSmartTransactionsFeatureFlags = exports.SmartTransactionsFeatureFlagsConfigSchema = exports.SmartTransactionsNetworkConfigSchema = exports.validateSmartTransactionsNetworkConfig = exports.validateSmartTransactionsFeatureFlags = void 0;
+var validators_1 = require("./validators.cjs");
+Object.defineProperty(exports, "validateSmartTransactionsFeatureFlags", { enumerable: true, get: function () { return validators_1.validateSmartTransactionsFeatureFlags; } });
+Object.defineProperty(exports, "validateSmartTransactionsNetworkConfig", { enumerable: true, get: function () { return validators_1.validateSmartTransactionsNetworkConfig; } });
+Object.defineProperty(exports, "SmartTransactionsNetworkConfigSchema", { enumerable: true, get: function () { return validators_1.SmartTransactionsNetworkConfigSchema; } });
+Object.defineProperty(exports, "SmartTransactionsFeatureFlagsConfigSchema", { enumerable: true, get: function () { return validators_1.SmartTransactionsFeatureFlagsConfigSchema; } });
+var feature_flags_1 = require("./feature-flags.cjs");
+Object.defineProperty(exports, "getSmartTransactionsFeatureFlags", { enumerable: true, get: function () { return feature_flags_1.getSmartTransactionsFeatureFlags; } });
+Object.defineProperty(exports, "processSmartTransactionsFeatureFlags", { enumerable: true, get: function () { return feature_flags_1.processSmartTransactionsFeatureFlags; } });
+Object.defineProperty(exports, "getSmartTransactionsFeatureFlagsForChain", { enumerable: true, get: function () { return feature_flags_1.getSmartTransactionsFeatureFlagsForChain; } });
+Object.defineProperty(exports, "normalizeChainId", { enumerable: true, get: function () { return feature_flags_1.normalizeChainId; } });
+//# sourceMappingURL=index.cjs.map

package/dist/featureFlags/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/featureFlags/index.ts"],"names":[],"mappings":";;;AAAA,+CASsB;AARpB,mIAAA,qCAAqC,OAAA;AACrC,oIAAA,sCAAsC,OAAA;AACtC,kIAAA,oCAAoC,OAAA;AACpC,uIAAA,yCAAyC,OAAA;AAO3C,qDAKyB;AAJvB,iIAAA,gCAAgC,OAAA;AAChC,qIAAA,oCAAoC,OAAA;AACpC,yIAAA,wCAAwC,OAAA;AACxC,iHAAA,gBAAgB,OAAA","sourcesContent":["export {\n  validateSmartTransactionsFeatureFlags,\n  validateSmartTransactionsNetworkConfig,\n  SmartTransactionsNetworkConfigSchema,\n  SmartTransactionsFeatureFlagsConfigSchema,\n  type SmartTransactionsNetworkConfigFromSchema,\n  type SmartTransactionsNetworkConfigFromSchema as SmartTransactionsNetworkConfig,\n  type SmartTransactionsFeatureFlagsConfigFromSchema,\n  type FeatureFlagsProcessResult,\n} from './validators';\n\nexport {\n  getSmartTransactionsFeatureFlags,\n  processSmartTransactionsFeatureFlags,\n  getSmartTransactionsFeatureFlagsForChain,\n  normalizeChainId,\n} from './feature-flags';\n"]}

package/dist/featureFlags/index.d.cts

@@ -0,0 +1,3 @@
+export { validateSmartTransactionsFeatureFlags, validateSmartTransactionsNetworkConfig, SmartTransactionsNetworkConfigSchema, SmartTransactionsFeatureFlagsConfigSchema, type SmartTransactionsNetworkConfigFromSchema, type SmartTransactionsNetworkConfigFromSchema as SmartTransactionsNetworkConfig, type SmartTransactionsFeatureFlagsConfigFromSchema, type FeatureFlagsProcessResult, } from "./validators.cjs";
+export { getSmartTransactionsFeatureFlags, processSmartTransactionsFeatureFlags, getSmartTransactionsFeatureFlagsForChain, normalizeChainId, } from "./feature-flags.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/featureFlags/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/featureFlags/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qCAAqC,EACrC,sCAAsC,EACtC,oCAAoC,EACpC,yCAAyC,EACzC,KAAK,wCAAwC,EAC7C,KAAK,wCAAwC,IAAI,8BAA8B,EAC/E,KAAK,6CAA6C,EAClD,KAAK,yBAAyB,GAC/B,yBAAqB;AAEtB,OAAO,EACL,gCAAgC,EAChC,oCAAoC,EACpC,wCAAwC,EACxC,gBAAgB,GACjB,4BAAwB"}

package/dist/featureFlags/index.d.mts

@@ -0,0 +1,3 @@
+export { validateSmartTransactionsFeatureFlags, validateSmartTransactionsNetworkConfig, SmartTransactionsNetworkConfigSchema, SmartTransactionsFeatureFlagsConfigSchema, type SmartTransactionsNetworkConfigFromSchema, type SmartTransactionsNetworkConfigFromSchema as SmartTransactionsNetworkConfig, type SmartTransactionsFeatureFlagsConfigFromSchema, type FeatureFlagsProcessResult, } from "./validators.mjs";
+export { getSmartTransactionsFeatureFlags, processSmartTransactionsFeatureFlags, getSmartTransactionsFeatureFlagsForChain, normalizeChainId, } from "./feature-flags.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/featureFlags/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/featureFlags/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qCAAqC,EACrC,sCAAsC,EACtC,oCAAoC,EACpC,yCAAyC,EACzC,KAAK,wCAAwC,EAC7C,KAAK,wCAAwC,IAAI,8BAA8B,EAC/E,KAAK,6CAA6C,EAClD,KAAK,yBAAyB,GAC/B,yBAAqB;AAEtB,OAAO,EACL,gCAAgC,EAChC,oCAAoC,EACpC,wCAAwC,EACxC,gBAAgB,GACjB,4BAAwB"}

package/dist/featureFlags/index.mjs

@@ -0,0 +1,3 @@
+export { validateSmartTransactionsFeatureFlags, validateSmartTransactionsNetworkConfig, SmartTransactionsNetworkConfigSchema, SmartTransactionsFeatureFlagsConfigSchema } from "./validators.mjs";
+export { getSmartTransactionsFeatureFlags, processSmartTransactionsFeatureFlags, getSmartTransactionsFeatureFlagsForChain, normalizeChainId } from "./feature-flags.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/featureFlags/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/featureFlags/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qCAAqC,EACrC,sCAAsC,EACtC,oCAAoC,EACpC,yCAAyC,EAK1C,yBAAqB;AAEtB,OAAO,EACL,gCAAgC,EAChC,oCAAoC,EACpC,wCAAwC,EACxC,gBAAgB,EACjB,4BAAwB","sourcesContent":["export {\n  validateSmartTransactionsFeatureFlags,\n  validateSmartTransactionsNetworkConfig,\n  SmartTransactionsNetworkConfigSchema,\n  SmartTransactionsFeatureFlagsConfigSchema,\n  type SmartTransactionsNetworkConfigFromSchema,\n  type SmartTransactionsNetworkConfigFromSchema as SmartTransactionsNetworkConfig,\n  type SmartTransactionsFeatureFlagsConfigFromSchema,\n  type FeatureFlagsProcessResult,\n} from './validators';\n\nexport {\n  getSmartTransactionsFeatureFlags,\n  processSmartTransactionsFeatureFlags,\n  getSmartTransactionsFeatureFlagsForChain,\n  normalizeChainId,\n} from './feature-flags';\n"]}