@metamask/smart-transactions-controller 21.0.0 → 22.0.0

package/dist/featureFlags/validators.cjs

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateSmartTransactionsNetworkConfig = exports.validateSmartTransactionsFeatureFlags = exports.SmartTransactionsFeatureFlagsConfigSchema = exports.SmartTransactionsNetworkConfigSchema = void 0;
+const superstruct_1 = require("@metamask/superstruct");
+const utils_1 = require("@metamask/utils");
+/**
+ * Validates that a key is a valid chain ID (hex or CAIP-2 format).
+ * Supports both EVM hex chain IDs and chain-agnostic CAIP-2 identifiers.
+ *
+ * @param key - The key to validate
+ * @returns True if the key is a valid chain ID format
+ */
+function isValidChainIdKey(key) {
+    return (0, utils_1.isStrictHexString)(key) || (0, utils_1.isCaipChainId)(key);
+}
+/**
+ * Schema for validating per-network smart transactions configuration.
+ * All fields are optional to allow partial configuration and merging with defaults.
+ */
+exports.SmartTransactionsNetworkConfigSchema = (0, superstruct_1.type)({
+    /** Whether smart transactions are active for the extension client */
+    extensionActive: (0, superstruct_1.optional)((0, superstruct_1.boolean)()),
+    /** Whether smart transactions are active for mobile clients (generic) */
+    mobileActive: (0, superstruct_1.optional)((0, superstruct_1.boolean)()),
+    /** Whether smart transactions are active for iOS specifically */
+    mobileActiveIOS: (0, superstruct_1.optional)((0, superstruct_1.boolean)()),
+    /** Whether smart transactions are active for Android specifically */
+    mobileActiveAndroid: (0, superstruct_1.optional)((0, superstruct_1.boolean)()),
+    /** Expected time in seconds for a smart transaction to be mined */
+    expectedDeadline: (0, superstruct_1.optional)((0, superstruct_1.number)()),
+    /** Maximum time in seconds before a smart transaction is considered failed */
+    maxDeadline: (0, superstruct_1.optional)((0, superstruct_1.number)()),
+    /** Whether extension should return tx hash immediately without waiting for confirmation */
+    extensionReturnTxHashAsap: (0, superstruct_1.optional)((0, superstruct_1.boolean)()),
+    /** Whether extension should return tx hash immediately for batch transactions */
+    extensionReturnTxHashAsapBatch: (0, superstruct_1.optional)((0, superstruct_1.boolean)()),
+    /** Whether mobile should return tx hash immediately without waiting for confirmation */
+    mobileReturnTxHashAsap: (0, superstruct_1.optional)((0, superstruct_1.boolean)()),
+    /** Whether extension should skip the smart transaction status page */
+    extensionSkipSmartTransactionStatusPage: (0, superstruct_1.optional)((0, superstruct_1.boolean)()),
+    /** Polling interval in milliseconds for batch status updates */
+    batchStatusPollingInterval: (0, superstruct_1.optional)((0, superstruct_1.number)()),
+    /** Custom sentinel URL for the network */
+    sentinelUrl: (0, superstruct_1.optional)((0, superstruct_1.string)()),
+});
+/**
+ * Schema for validating the complete smart transactions feature flags configuration.
+ * This includes a default configuration and optional chain-specific overrides.
+ */
+exports.SmartTransactionsFeatureFlagsConfigSchema = (0, superstruct_1.type)({
+    /** Default configuration applied to all chains unless overridden */
+    default: (0, superstruct_1.optional)(exports.SmartTransactionsNetworkConfigSchema),
+});
+/**
+ * Validates smart transactions feature flags with per-chain validation.
+ * - If the input is not an object, returns empty config with error
+ * - If `default` is present and invalid, returns empty config with error
+ * - For each chain: if invalid, removes it and collects error; if valid, includes it
+ *
+ * @param data - The data to validate
+ * @returns The validated config and any validation errors
+ */
+function validateSmartTransactionsFeatureFlags(data) {
+    const errors = [];
+    // Step 1: Check if it's a valid object
+    if (typeof data !== 'object' || data === null || Array.isArray(data)) {
+        const typeDescription = data === null ? 'null' : typeof data;
+        const arraySuffix = Array.isArray(data) ? ' (array)' : '';
+        return {
+            config: {},
+            errors: [
+                new Error(`Expected an object, received ${typeDescription}${arraySuffix}`),
+            ],
+        };
+    }
+    const dataRecord = data;
+    const validConfig = {};
+    // Step 2: Validate 'default' - if present and invalid, reject everything
+    if (dataRecord.default !== undefined) {
+        const [defaultError, validatedDefault] = (0, superstruct_1.validate)(dataRecord.default, exports.SmartTransactionsNetworkConfigSchema);
+        if (defaultError) {
+            return {
+                config: {},
+                errors: [
+                    new Error(`Invalid 'default' config: ${defaultError.message}`),
+                ],
+            };
+        }
+        // validatedDefault is properly typed from superstruct
+        validConfig.default = validatedDefault;
+    }
+    // Step 3: Validate chain-specific configs, keeping valid ones
+    for (const [key, value] of Object.entries(dataRecord)) {
+        if (key === 'default') {
+            continue;
+        }
+        // Check chain ID format
+        if (!isValidChainIdKey(key)) {
+            errors.push(new Error(`Invalid chain ID key "${key}". Expected hex string (e.g., "0x1") or CAIP-2 format (e.g., "eip155:1", "solana:...")`));
+            continue; // Skip this chain, don't add to result
+        }
+        // Validate chain config
+        if (value !== undefined) {
+            const [chainError, validatedChain] = (0, superstruct_1.validate)(value, exports.SmartTransactionsNetworkConfigSchema);
+            if (chainError) {
+                errors.push(new Error(`Chain "${key}": ${chainError.message}`));
+                continue; // Skip this chain, don't add to result
+            }
+            // validatedChain is properly typed from superstruct
+            validConfig[key] = validatedChain;
+        }
+    }
+    return { config: validConfig, errors };
+}
+exports.validateSmartTransactionsFeatureFlags = validateSmartTransactionsFeatureFlags;
+/**
+ * Validates that the given data conforms to the SmartTransactionsNetworkConfig schema.
+ *
+ * @param data - The data to validate
+ * @returns True if the data is valid, false otherwise
+ */
+function validateSmartTransactionsNetworkConfig(data) {
+    return (0, superstruct_1.is)(data, exports.SmartTransactionsNetworkConfigSchema);
+}
+exports.validateSmartTransactionsNetworkConfig = validateSmartTransactionsNetworkConfig;
+//# sourceMappingURL=validators.cjs.map

package/dist/featureFlags/validators.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.cjs","sourceRoot":"","sources":["../../src/featureFlags/validators.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  boolean,\n  number,\n  optional,\n  string,\n  type,\n  is,\n  validate,\n} from '@metamask/superstruct';\nimport type { Infer } from '@metamask/superstruct';\nimport { isCaipChainId, isStrictHexString } from '@metamask/utils';\n\n/**\n * Validates that a key is a valid chain ID (hex or CAIP-2 format).\n * Supports both EVM hex chain IDs and chain-agnostic CAIP-2 identifiers.\n *\n * @param key - The key to validate\n * @returns True if the key is a valid chain ID format\n */\nfunction isValidChainIdKey(key: string): boolean {\n  return isStrictHexString(key) || isCaipChainId(key);\n}\n\n/**\n * Schema for validating per-network smart transactions configuration.\n * All fields are optional to allow partial configuration and merging with defaults.\n */\nexport const SmartTransactionsNetworkConfigSchema = type({\n  /** Whether smart transactions are active for the extension client */\n  extensionActive: optional(boolean()),\n  /** Whether smart transactions are active for mobile clients (generic) */\n  mobileActive: optional(boolean()),\n  /** Whether smart transactions are active for iOS specifically */\n  mobileActiveIOS: optional(boolean()),\n  /** Whether smart transactions are active for Android specifically */\n  mobileActiveAndroid: optional(boolean()),\n  /** Expected time in seconds for a smart transaction to be mined */\n  expectedDeadline: optional(number()),\n  /** Maximum time in seconds before a smart transaction is considered failed */\n  maxDeadline: optional(number()),\n  /** Whether extension should return tx hash immediately without waiting for confirmation */\n  extensionReturnTxHashAsap: optional(boolean()),\n  /** Whether extension should return tx hash immediately for batch transactions */\n  extensionReturnTxHashAsapBatch: optional(boolean()),\n  /** Whether mobile should return tx hash immediately without waiting for confirmation */\n  mobileReturnTxHashAsap: optional(boolean()),\n  /** Whether extension should skip the smart transaction status page */\n  extensionSkipSmartTransactionStatusPage: optional(boolean()),\n  /** Polling interval in milliseconds for batch status updates */\n  batchStatusPollingInterval: optional(number()),\n  /** Custom sentinel URL for the network */\n  sentinelUrl: optional(string()),\n});\n\n/**\n * Schema for validating the complete smart transactions feature flags configuration.\n * This includes a default configuration and optional chain-specific overrides.\n */\nexport const SmartTransactionsFeatureFlagsConfigSchema = type({\n  /** Default configuration applied to all chains unless overridden */\n  default: optional(SmartTransactionsNetworkConfigSchema),\n});\n\n/**\n * Type inferred from the SmartTransactionsNetworkConfigSchema\n */\nexport type SmartTransactionsNetworkConfigFromSchema = Infer<\n  typeof SmartTransactionsNetworkConfigSchema\n>;\n\n/**\n * Type inferred from the SmartTransactionsFeatureFlagsConfigSchema\n */\nexport type SmartTransactionsFeatureFlagsConfigFromSchema = Infer<\n  typeof SmartTransactionsFeatureFlagsConfigSchema\n>;\n\n/**\n * Result of processing feature flags with collected validation errors.\n * Uses per-chain validation: invalid chains are removed, valid ones are kept.\n */\nexport type FeatureFlagsProcessResult = {\n  /** The validated configuration (may be partial if some chains were invalid) */\n  config: SmartTransactionsFeatureFlagsConfigFromSchema &\n    Record<string, SmartTransactionsNetworkConfigFromSchema | undefined>;\n  /** Validation errors for invalid parts of the configuration */\n  errors: Error[];\n};\n\n/**\n * Validates smart transactions feature flags with per-chain validation.\n * - If the input is not an object, returns empty config with error\n * - If `default` is present and invalid, returns empty config with error\n * - For each chain: if invalid, removes it and collects error; if valid, includes it\n *\n * @param data - The data to validate\n * @returns The validated config and any validation errors\n */\nexport function validateSmartTransactionsFeatureFlags(\n  data: unknown,\n): FeatureFlagsProcessResult {\n  const errors: Error[] = [];\n\n  // Step 1: Check if it's a valid object\n  if (typeof data !== 'object' || data === null || Array.isArray(data)) {\n    const typeDescription = data === null ? 'null' : typeof data;\n    const arraySuffix = Array.isArray(data) ? ' (array)' : '';\n    return {\n      config: {},\n      errors: [\n        new Error(\n          `Expected an object, received ${typeDescription}${arraySuffix}`,\n        ),\n      ],\n    };\n  }\n\n  const dataRecord = data as Record<string, unknown>;\n  const validConfig: FeatureFlagsProcessResult['config'] = {};\n\n  // Step 2: Validate 'default' - if present and invalid, reject everything\n  if (dataRecord.default !== undefined) {\n    const [defaultError, validatedDefault] = validate(\n      dataRecord.default,\n      SmartTransactionsNetworkConfigSchema,\n    );\n    if (defaultError) {\n      return {\n        config: {},\n        errors: [\n          new Error(`Invalid 'default' config: ${defaultError.message}`),\n        ],\n      };\n    }\n    // validatedDefault is properly typed from superstruct\n    validConfig.default = validatedDefault;\n  }\n\n  // Step 3: Validate chain-specific configs, keeping valid ones\n  for (const [key, value] of Object.entries(dataRecord)) {\n    if (key === 'default') {\n      continue;\n    }\n\n    // Check chain ID format\n    if (!isValidChainIdKey(key)) {\n      errors.push(\n        new Error(\n          `Invalid chain ID key \"${key}\". Expected hex string (e.g., \"0x1\") or CAIP-2 format (e.g., \"eip155:1\", \"solana:...\")`,\n        ),\n      );\n      continue; // Skip this chain, don't add to result\n    }\n\n    // Validate chain config\n    if (value !== undefined) {\n      const [chainError, validatedChain] = validate(\n        value,\n        SmartTransactionsNetworkConfigSchema,\n      );\n      if (chainError) {\n        errors.push(new Error(`Chain \"${key}\": ${chainError.message}`));\n        continue; // Skip this chain, don't add to result\n      }\n      // validatedChain is properly typed from superstruct\n      validConfig[key] = validatedChain;\n    }\n  }\n\n  return { config: validConfig, errors };\n}\n\n/**\n * Validates that the given data conforms to the SmartTransactionsNetworkConfig schema.\n *\n * @param data - The data to validate\n * @returns True if the data is valid, false otherwise\n */\nexport function validateSmartTransactionsNetworkConfig(\n  data: unknown,\n): data is SmartTransactionsNetworkConfigFromSchema {\n  return is(data, SmartTransactionsNetworkConfigSchema);\n}\n"]}

package/dist/featureFlags/validators.d.cts

@@ -0,0 +1,141 @@
+import type { Infer } from "@metamask/superstruct";
+/**
+ * Schema for validating per-network smart transactions configuration.
+ * All fields are optional to allow partial configuration and merging with defaults.
+ */
+export declare const SmartTransactionsNetworkConfigSchema: import("@metamask/superstruct").Struct<{
+    extensionActive?: boolean | undefined;
+    mobileActive?: boolean | undefined;
+    mobileActiveIOS?: boolean | undefined;
+    mobileActiveAndroid?: boolean | undefined;
+    expectedDeadline?: number | undefined;
+    maxDeadline?: number | undefined;
+    extensionReturnTxHashAsap?: boolean | undefined;
+    extensionReturnTxHashAsapBatch?: boolean | undefined;
+    mobileReturnTxHashAsap?: boolean | undefined;
+    extensionSkipSmartTransactionStatusPage?: boolean | undefined;
+    batchStatusPollingInterval?: number | undefined;
+    sentinelUrl?: string | undefined;
+}, {
+    /** Whether smart transactions are active for the extension client */
+    extensionActive: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+    /** Whether smart transactions are active for mobile clients (generic) */
+    mobileActive: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+    /** Whether smart transactions are active for iOS specifically */
+    mobileActiveIOS: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+    /** Whether smart transactions are active for Android specifically */
+    mobileActiveAndroid: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+    /** Expected time in seconds for a smart transaction to be mined */
+    expectedDeadline: import("@metamask/superstruct").Struct<number | undefined, null>;
+    /** Maximum time in seconds before a smart transaction is considered failed */
+    maxDeadline: import("@metamask/superstruct").Struct<number | undefined, null>;
+    /** Whether extension should return tx hash immediately without waiting for confirmation */
+    extensionReturnTxHashAsap: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+    /** Whether extension should return tx hash immediately for batch transactions */
+    extensionReturnTxHashAsapBatch: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+    /** Whether mobile should return tx hash immediately without waiting for confirmation */
+    mobileReturnTxHashAsap: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+    /** Whether extension should skip the smart transaction status page */
+    extensionSkipSmartTransactionStatusPage: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+    /** Polling interval in milliseconds for batch status updates */
+    batchStatusPollingInterval: import("@metamask/superstruct").Struct<number | undefined, null>;
+    /** Custom sentinel URL for the network */
+    sentinelUrl: import("@metamask/superstruct").Struct<string | undefined, null>;
+}>;
+/**
+ * Schema for validating the complete smart transactions feature flags configuration.
+ * This includes a default configuration and optional chain-specific overrides.
+ */
+export declare const SmartTransactionsFeatureFlagsConfigSchema: import("@metamask/superstruct").Struct<{
+    default?: {
+        extensionActive?: boolean | undefined;
+        mobileActive?: boolean | undefined;
+        mobileActiveIOS?: boolean | undefined;
+        mobileActiveAndroid?: boolean | undefined;
+        expectedDeadline?: number | undefined;
+        maxDeadline?: number | undefined;
+        extensionReturnTxHashAsap?: boolean | undefined;
+        extensionReturnTxHashAsapBatch?: boolean | undefined;
+        mobileReturnTxHashAsap?: boolean | undefined;
+        extensionSkipSmartTransactionStatusPage?: boolean | undefined;
+        batchStatusPollingInterval?: number | undefined;
+        sentinelUrl?: string | undefined;
+    } | undefined;
+}, {
+    /** Default configuration applied to all chains unless overridden */
+    default: import("@metamask/superstruct").Struct<{
+        extensionActive?: boolean | undefined;
+        mobileActive?: boolean | undefined;
+        mobileActiveIOS?: boolean | undefined;
+        mobileActiveAndroid?: boolean | undefined;
+        expectedDeadline?: number | undefined;
+        maxDeadline?: number | undefined;
+        extensionReturnTxHashAsap?: boolean | undefined;
+        extensionReturnTxHashAsapBatch?: boolean | undefined;
+        mobileReturnTxHashAsap?: boolean | undefined;
+        extensionSkipSmartTransactionStatusPage?: boolean | undefined;
+        batchStatusPollingInterval?: number | undefined;
+        sentinelUrl?: string | undefined;
+    } | undefined, {
+        /** Whether smart transactions are active for the extension client */
+        extensionActive: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+        /** Whether smart transactions are active for mobile clients (generic) */
+        mobileActive: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+        /** Whether smart transactions are active for iOS specifically */
+        mobileActiveIOS: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+        /** Whether smart transactions are active for Android specifically */
+        mobileActiveAndroid: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+        /** Expected time in seconds for a smart transaction to be mined */
+        expectedDeadline: import("@metamask/superstruct").Struct<number | undefined, null>;
+        /** Maximum time in seconds before a smart transaction is considered failed */
+        maxDeadline: import("@metamask/superstruct").Struct<number | undefined, null>;
+        /** Whether extension should return tx hash immediately without waiting for confirmation */
+        extensionReturnTxHashAsap: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+        /** Whether extension should return tx hash immediately for batch transactions */
+        extensionReturnTxHashAsapBatch: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+        /** Whether mobile should return tx hash immediately without waiting for confirmation */
+        mobileReturnTxHashAsap: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+        /** Whether extension should skip the smart transaction status page */
+        extensionSkipSmartTransactionStatusPage: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+        /** Polling interval in milliseconds for batch status updates */
+        batchStatusPollingInterval: import("@metamask/superstruct").Struct<number | undefined, null>;
+        /** Custom sentinel URL for the network */
+        sentinelUrl: import("@metamask/superstruct").Struct<string | undefined, null>;
+    }>;
+}>;
+/**
+ * Type inferred from the SmartTransactionsNetworkConfigSchema
+ */
+export declare type SmartTransactionsNetworkConfigFromSchema = Infer<typeof SmartTransactionsNetworkConfigSchema>;
+/**
+ * Type inferred from the SmartTransactionsFeatureFlagsConfigSchema
+ */
+export declare type SmartTransactionsFeatureFlagsConfigFromSchema = Infer<typeof SmartTransactionsFeatureFlagsConfigSchema>;
+/**
+ * Result of processing feature flags with collected validation errors.
+ * Uses per-chain validation: invalid chains are removed, valid ones are kept.
+ */
+export declare type FeatureFlagsProcessResult = {
+    /** The validated configuration (may be partial if some chains were invalid) */
+    config: SmartTransactionsFeatureFlagsConfigFromSchema & Record<string, SmartTransactionsNetworkConfigFromSchema | undefined>;
+    /** Validation errors for invalid parts of the configuration */
+    errors: Error[];
+};
+/**
+ * Validates smart transactions feature flags with per-chain validation.
+ * - If the input is not an object, returns empty config with error
+ * - If `default` is present and invalid, returns empty config with error
+ * - For each chain: if invalid, removes it and collects error; if valid, includes it
+ *
+ * @param data - The data to validate
+ * @returns The validated config and any validation errors
+ */
+export declare function validateSmartTransactionsFeatureFlags(data: unknown): FeatureFlagsProcessResult;
+/**
+ * Validates that the given data conforms to the SmartTransactionsNetworkConfig schema.
+ *
+ * @param data - The data to validate
+ * @returns True if the data is valid, false otherwise
+ */
+export declare function validateSmartTransactionsNetworkConfig(data: unknown): data is SmartTransactionsNetworkConfigFromSchema;
+//# sourceMappingURL=validators.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.cts","sourceRoot":"","sources":["../../src/featureFlags/validators.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,KAAK,EAAE,8BAA8B;AAcnD;;;GAGG;AACH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;IAC/C,qEAAqE;;IAErE,yEAAyE;;IAEzE,iEAAiE;;IAEjE,qEAAqE;;IAErE,mEAAmE;;IAEnE,8EAA8E;;IAE9E,2FAA2F;;IAE3F,iFAAiF;;IAEjF,wFAAwF;;IAExF,sEAAsE;;IAEtE,gEAAgE;;IAEhE,0CAA0C;;EAE1C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,yCAAyC;;;;;;;;;;;;;;;;IACpD,oEAAoE;;;;;;;;;;;;;;;QA/BpE,qEAAqE;;QAErE,yEAAyE;;QAEzE,iEAAiE;;QAEjE,qEAAqE;;QAErE,mEAAmE;;QAEnE,8EAA8E;;QAE9E,2FAA2F;;QAE3F,iFAAiF;;QAEjF,wFAAwF;;QAExF,sEAAsE;;QAEtE,gEAAgE;;QAEhE,0CAA0C;;;EAW1C,CAAC;AAEH;;GAEG;AACH,oBAAY,wCAAwC,GAAG,KAAK,CAC1D,OAAO,oCAAoC,CAC5C,CAAC;AAEF;;GAEG;AACH,oBAAY,6CAA6C,GAAG,KAAK,CAC/D,OAAO,yCAAyC,CACjD,CAAC;AAEF;;;GAGG;AACH,oBAAY,yBAAyB,GAAG;IACtC,+EAA+E;IAC/E,MAAM,EAAE,6CAA6C,GACnD,MAAM,CAAC,MAAM,EAAE,wCAAwC,GAAG,SAAS,CAAC,CAAC;IACvE,+DAA+D;IAC/D,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,OAAO,GACZ,yBAAyB,CAsE3B;AAED;;;;;GAKG;AACH,wBAAgB,sCAAsC,CACpD,IAAI,EAAE,OAAO,GACZ,IAAI,IAAI,wCAAwC,CAElD"}

package/dist/featureFlags/validators.d.mts

@@ -0,0 +1,141 @@
+import type { Infer } from "@metamask/superstruct";
+/**
+ * Schema for validating per-network smart transactions configuration.
+ * All fields are optional to allow partial configuration and merging with defaults.
+ */
+export declare const SmartTransactionsNetworkConfigSchema: import("@metamask/superstruct").Struct<{
+    extensionActive?: boolean | undefined;
+    mobileActive?: boolean | undefined;
+    mobileActiveIOS?: boolean | undefined;
+    mobileActiveAndroid?: boolean | undefined;
+    expectedDeadline?: number | undefined;
+    maxDeadline?: number | undefined;
+    extensionReturnTxHashAsap?: boolean | undefined;
+    extensionReturnTxHashAsapBatch?: boolean | undefined;
+    mobileReturnTxHashAsap?: boolean | undefined;
+    extensionSkipSmartTransactionStatusPage?: boolean | undefined;
+    batchStatusPollingInterval?: number | undefined;
+    sentinelUrl?: string | undefined;
+}, {
+    /** Whether smart transactions are active for the extension client */
+    extensionActive: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+    /** Whether smart transactions are active for mobile clients (generic) */
+    mobileActive: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+    /** Whether smart transactions are active for iOS specifically */
+    mobileActiveIOS: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+    /** Whether smart transactions are active for Android specifically */
+    mobileActiveAndroid: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+    /** Expected time in seconds for a smart transaction to be mined */
+    expectedDeadline: import("@metamask/superstruct").Struct<number | undefined, null>;
+    /** Maximum time in seconds before a smart transaction is considered failed */
+    maxDeadline: import("@metamask/superstruct").Struct<number | undefined, null>;
+    /** Whether extension should return tx hash immediately without waiting for confirmation */
+    extensionReturnTxHashAsap: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+    /** Whether extension should return tx hash immediately for batch transactions */
+    extensionReturnTxHashAsapBatch: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+    /** Whether mobile should return tx hash immediately without waiting for confirmation */
+    mobileReturnTxHashAsap: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+    /** Whether extension should skip the smart transaction status page */
+    extensionSkipSmartTransactionStatusPage: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+    /** Polling interval in milliseconds for batch status updates */
+    batchStatusPollingInterval: import("@metamask/superstruct").Struct<number | undefined, null>;
+    /** Custom sentinel URL for the network */
+    sentinelUrl: import("@metamask/superstruct").Struct<string | undefined, null>;
+}>;
+/**
+ * Schema for validating the complete smart transactions feature flags configuration.
+ * This includes a default configuration and optional chain-specific overrides.
+ */
+export declare const SmartTransactionsFeatureFlagsConfigSchema: import("@metamask/superstruct").Struct<{
+    default?: {
+        extensionActive?: boolean | undefined;
+        mobileActive?: boolean | undefined;
+        mobileActiveIOS?: boolean | undefined;
+        mobileActiveAndroid?: boolean | undefined;
+        expectedDeadline?: number | undefined;
+        maxDeadline?: number | undefined;
+        extensionReturnTxHashAsap?: boolean | undefined;
+        extensionReturnTxHashAsapBatch?: boolean | undefined;
+        mobileReturnTxHashAsap?: boolean | undefined;
+        extensionSkipSmartTransactionStatusPage?: boolean | undefined;
+        batchStatusPollingInterval?: number | undefined;
+        sentinelUrl?: string | undefined;
+    } | undefined;
+}, {
+    /** Default configuration applied to all chains unless overridden */
+    default: import("@metamask/superstruct").Struct<{
+        extensionActive?: boolean | undefined;
+        mobileActive?: boolean | undefined;
+        mobileActiveIOS?: boolean | undefined;
+        mobileActiveAndroid?: boolean | undefined;
+        expectedDeadline?: number | undefined;
+        maxDeadline?: number | undefined;
+        extensionReturnTxHashAsap?: boolean | undefined;
+        extensionReturnTxHashAsapBatch?: boolean | undefined;
+        mobileReturnTxHashAsap?: boolean | undefined;
+        extensionSkipSmartTransactionStatusPage?: boolean | undefined;
+        batchStatusPollingInterval?: number | undefined;
+        sentinelUrl?: string | undefined;
+    } | undefined, {
+        /** Whether smart transactions are active for the extension client */
+        extensionActive: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+        /** Whether smart transactions are active for mobile clients (generic) */
+        mobileActive: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+        /** Whether smart transactions are active for iOS specifically */
+        mobileActiveIOS: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+        /** Whether smart transactions are active for Android specifically */
+        mobileActiveAndroid: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+        /** Expected time in seconds for a smart transaction to be mined */
+        expectedDeadline: import("@metamask/superstruct").Struct<number | undefined, null>;
+        /** Maximum time in seconds before a smart transaction is considered failed */
+        maxDeadline: import("@metamask/superstruct").Struct<number | undefined, null>;
+        /** Whether extension should return tx hash immediately without waiting for confirmation */
+        extensionReturnTxHashAsap: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+        /** Whether extension should return tx hash immediately for batch transactions */
+        extensionReturnTxHashAsapBatch: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+        /** Whether mobile should return tx hash immediately without waiting for confirmation */
+        mobileReturnTxHashAsap: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+        /** Whether extension should skip the smart transaction status page */
+        extensionSkipSmartTransactionStatusPage: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+        /** Polling interval in milliseconds for batch status updates */
+        batchStatusPollingInterval: import("@metamask/superstruct").Struct<number | undefined, null>;
+        /** Custom sentinel URL for the network */
+        sentinelUrl: import("@metamask/superstruct").Struct<string | undefined, null>;
+    }>;
+}>;
+/**
+ * Type inferred from the SmartTransactionsNetworkConfigSchema
+ */
+export declare type SmartTransactionsNetworkConfigFromSchema = Infer<typeof SmartTransactionsNetworkConfigSchema>;
+/**
+ * Type inferred from the SmartTransactionsFeatureFlagsConfigSchema
+ */
+export declare type SmartTransactionsFeatureFlagsConfigFromSchema = Infer<typeof SmartTransactionsFeatureFlagsConfigSchema>;
+/**
+ * Result of processing feature flags with collected validation errors.
+ * Uses per-chain validation: invalid chains are removed, valid ones are kept.
+ */
+export declare type FeatureFlagsProcessResult = {
+    /** The validated configuration (may be partial if some chains were invalid) */
+    config: SmartTransactionsFeatureFlagsConfigFromSchema & Record<string, SmartTransactionsNetworkConfigFromSchema | undefined>;
+    /** Validation errors for invalid parts of the configuration */
+    errors: Error[];
+};
+/**
+ * Validates smart transactions feature flags with per-chain validation.
+ * - If the input is not an object, returns empty config with error
+ * - If `default` is present and invalid, returns empty config with error
+ * - For each chain: if invalid, removes it and collects error; if valid, includes it
+ *
+ * @param data - The data to validate
+ * @returns The validated config and any validation errors
+ */
+export declare function validateSmartTransactionsFeatureFlags(data: unknown): FeatureFlagsProcessResult;
+/**
+ * Validates that the given data conforms to the SmartTransactionsNetworkConfig schema.
+ *
+ * @param data - The data to validate
+ * @returns True if the data is valid, false otherwise
+ */
+export declare function validateSmartTransactionsNetworkConfig(data: unknown): data is SmartTransactionsNetworkConfigFromSchema;
+//# sourceMappingURL=validators.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.mts","sourceRoot":"","sources":["../../src/featureFlags/validators.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,KAAK,EAAE,8BAA8B;AAcnD;;;GAGG;AACH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;IAC/C,qEAAqE;;IAErE,yEAAyE;;IAEzE,iEAAiE;;IAEjE,qEAAqE;;IAErE,mEAAmE;;IAEnE,8EAA8E;;IAE9E,2FAA2F;;IAE3F,iFAAiF;;IAEjF,wFAAwF;;IAExF,sEAAsE;;IAEtE,gEAAgE;;IAEhE,0CAA0C;;EAE1C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,yCAAyC;;;;;;;;;;;;;;;;IACpD,oEAAoE;;;;;;;;;;;;;;;QA/BpE,qEAAqE;;QAErE,yEAAyE;;QAEzE,iEAAiE;;QAEjE,qEAAqE;;QAErE,mEAAmE;;QAEnE,8EAA8E;;QAE9E,2FAA2F;;QAE3F,iFAAiF;;QAEjF,wFAAwF;;QAExF,sEAAsE;;QAEtE,gEAAgE;;QAEhE,0CAA0C;;;EAW1C,CAAC;AAEH;;GAEG;AACH,oBAAY,wCAAwC,GAAG,KAAK,CAC1D,OAAO,oCAAoC,CAC5C,CAAC;AAEF;;GAEG;AACH,oBAAY,6CAA6C,GAAG,KAAK,CAC/D,OAAO,yCAAyC,CACjD,CAAC;AAEF;;;GAGG;AACH,oBAAY,yBAAyB,GAAG;IACtC,+EAA+E;IAC/E,MAAM,EAAE,6CAA6C,GACnD,MAAM,CAAC,MAAM,EAAE,wCAAwC,GAAG,SAAS,CAAC,CAAC;IACvE,+DAA+D;IAC/D,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,OAAO,GACZ,yBAAyB,CAsE3B;AAED;;;;;GAKG;AACH,wBAAgB,sCAAsC,CACpD,IAAI,EAAE,OAAO,GACZ,IAAI,IAAI,wCAAwC,CAElD"}

package/dist/featureFlags/validators.mjs

@@ -0,0 +1,121 @@
+import { boolean, number, optional, string, type, is, validate } from "@metamask/superstruct";
+import { isCaipChainId, isStrictHexString } from "@metamask/utils";
+/**
+ * Validates that a key is a valid chain ID (hex or CAIP-2 format).
+ * Supports both EVM hex chain IDs and chain-agnostic CAIP-2 identifiers.
+ *
+ * @param key - The key to validate
+ * @returns True if the key is a valid chain ID format
+ */
+function isValidChainIdKey(key) {
+    return isStrictHexString(key) || isCaipChainId(key);
+}
+/**
+ * Schema for validating per-network smart transactions configuration.
+ * All fields are optional to allow partial configuration and merging with defaults.
+ */
+export const SmartTransactionsNetworkConfigSchema = type({
+    /** Whether smart transactions are active for the extension client */
+    extensionActive: optional(boolean()),
+    /** Whether smart transactions are active for mobile clients (generic) */
+    mobileActive: optional(boolean()),
+    /** Whether smart transactions are active for iOS specifically */
+    mobileActiveIOS: optional(boolean()),
+    /** Whether smart transactions are active for Android specifically */
+    mobileActiveAndroid: optional(boolean()),
+    /** Expected time in seconds for a smart transaction to be mined */
+    expectedDeadline: optional(number()),
+    /** Maximum time in seconds before a smart transaction is considered failed */
+    maxDeadline: optional(number()),
+    /** Whether extension should return tx hash immediately without waiting for confirmation */
+    extensionReturnTxHashAsap: optional(boolean()),
+    /** Whether extension should return tx hash immediately for batch transactions */
+    extensionReturnTxHashAsapBatch: optional(boolean()),
+    /** Whether mobile should return tx hash immediately without waiting for confirmation */
+    mobileReturnTxHashAsap: optional(boolean()),
+    /** Whether extension should skip the smart transaction status page */
+    extensionSkipSmartTransactionStatusPage: optional(boolean()),
+    /** Polling interval in milliseconds for batch status updates */
+    batchStatusPollingInterval: optional(number()),
+    /** Custom sentinel URL for the network */
+    sentinelUrl: optional(string()),
+});
+/**
+ * Schema for validating the complete smart transactions feature flags configuration.
+ * This includes a default configuration and optional chain-specific overrides.
+ */
+export const SmartTransactionsFeatureFlagsConfigSchema = type({
+    /** Default configuration applied to all chains unless overridden */
+    default: optional(SmartTransactionsNetworkConfigSchema),
+});
+/**
+ * Validates smart transactions feature flags with per-chain validation.
+ * - If the input is not an object, returns empty config with error
+ * - If `default` is present and invalid, returns empty config with error
+ * - For each chain: if invalid, removes it and collects error; if valid, includes it
+ *
+ * @param data - The data to validate
+ * @returns The validated config and any validation errors
+ */
+export function validateSmartTransactionsFeatureFlags(data) {
+    const errors = [];
+    // Step 1: Check if it's a valid object
+    if (typeof data !== 'object' || data === null || Array.isArray(data)) {
+        const typeDescription = data === null ? 'null' : typeof data;
+        const arraySuffix = Array.isArray(data) ? ' (array)' : '';
+        return {
+            config: {},
+            errors: [
+                new Error(`Expected an object, received ${typeDescription}${arraySuffix}`),
+            ],
+        };
+    }
+    const dataRecord = data;
+    const validConfig = {};
+    // Step 2: Validate 'default' - if present and invalid, reject everything
+    if (dataRecord.default !== undefined) {
+        const [defaultError, validatedDefault] = validate(dataRecord.default, SmartTransactionsNetworkConfigSchema);
+        if (defaultError) {
+            return {
+                config: {},
+                errors: [
+                    new Error(`Invalid 'default' config: ${defaultError.message}`),
+                ],
+            };
+        }
+        // validatedDefault is properly typed from superstruct
+        validConfig.default = validatedDefault;
+    }
+    // Step 3: Validate chain-specific configs, keeping valid ones
+    for (const [key, value] of Object.entries(dataRecord)) {
+        if (key === 'default') {
+            continue;
+        }
+        // Check chain ID format
+        if (!isValidChainIdKey(key)) {
+            errors.push(new Error(`Invalid chain ID key "${key}". Expected hex string (e.g., "0x1") or CAIP-2 format (e.g., "eip155:1", "solana:...")`));
+            continue; // Skip this chain, don't add to result
+        }
+        // Validate chain config
+        if (value !== undefined) {
+            const [chainError, validatedChain] = validate(value, SmartTransactionsNetworkConfigSchema);
+            if (chainError) {
+                errors.push(new Error(`Chain "${key}": ${chainError.message}`));
+                continue; // Skip this chain, don't add to result
+            }
+            // validatedChain is properly typed from superstruct
+            validConfig[key] = validatedChain;
+        }
+    }
+    return { config: validConfig, errors };
+}
+/**
+ * Validates that the given data conforms to the SmartTransactionsNetworkConfig schema.
+ *
+ * @param data - The data to validate
+ * @returns True if the data is valid, false otherwise
+ */
+export function validateSmartTransactionsNetworkConfig(data) {
+    return is(data, SmartTransactionsNetworkConfigSchema);
+}
+//# sourceMappingURL=validators.mjs.map

package/dist/featureFlags/validators.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.mjs","sourceRoot":"","sources":["../../src/featureFlags/validators.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,IAAI,EACJ,EAAE,EACF,QAAQ,EACT,8BAA8B;AAE/B,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,wBAAwB;AAEnE;;;;;;GAMG;AACH,SAAS,iBAAiB,CAAC,GAAW;IACpC,OAAO,iBAAiB,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,IAAI,CAAC;IACvD,qEAAqE;IACrE,eAAe,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IACpC,yEAAyE;IACzE,YAAY,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IACjC,iEAAiE;IACjE,eAAe,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IACpC,qEAAqE;IACrE,mBAAmB,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IACxC,mEAAmE;IACnE,gBAAgB,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IACpC,8EAA8E;IAC9E,WAAW,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC/B,2FAA2F;IAC3F,yBAAyB,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC9C,iFAAiF;IACjF,8BAA8B,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IACnD,wFAAwF;IACxF,sBAAsB,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC3C,sEAAsE;IACtE,uCAAuC,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC5D,gEAAgE;IAChE,0BAA0B,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC9C,0CAA0C;IAC1C,WAAW,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;CAChC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,yCAAyC,GAAG,IAAI,CAAC;IAC5D,oEAAoE;IACpE,OAAO,EAAE,QAAQ,CAAC,oCAAoC,CAAC;CACxD,CAAC,CAAC;AA4BH;;;;;;;;GAQG;AACH,MAAM,UAAU,qCAAqC,CACnD,IAAa;IAEb,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,uCAAuC;IACvC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QACpE,MAAM,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC;QAC7D,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,OAAO;YACL,MAAM,EAAE,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,KAAK,CACP,gCAAgC,eAAe,GAAG,WAAW,EAAE,CAChE;aACF;SACF,CAAC;KACH;IAED,MAAM,UAAU,GAAG,IAA+B,CAAC;IACnD,MAAM,WAAW,GAAwC,EAAE,CAAC;IAE5D,yEAAyE;IACzE,IAAI,UAAU,CAAC,OAAO,KAAK,SAAS,EAAE;QACpC,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAC/C,UAAU,CAAC,OAAO,EAClB,oCAAoC,CACrC,CAAC;QACF,IAAI,YAAY,EAAE;YAChB,OAAO;gBACL,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,KAAK,CAAC,6BAA6B,YAAY,CAAC,OAAO,EAAE,CAAC;iBAC/D;aACF,CAAC;SACH;QACD,sDAAsD;QACtD,WAAW,CAAC,OAAO,GAAG,gBAAgB,CAAC;KACxC;IAED,8DAA8D;IAC9D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;QACrD,IAAI,GAAG,KAAK,SAAS,EAAE;YACrB,SAAS;SACV;QAED,wBAAwB;QACxB,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE;YAC3B,MAAM,CAAC,IAAI,CACT,IAAI,KAAK,CACP,yBAAyB,GAAG,wFAAwF,CACrH,CACF,CAAC;YACF,SAAS,CAAC,uCAAuC;SAClD;QAED,wBAAwB;QACxB,IAAI,KAAK,KAAK,SAAS,EAAE;YACvB,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,GAAG,QAAQ,CAC3C,KAAK,EACL,oCAAoC,CACrC,CAAC;YACF,IAAI,UAAU,EAAE;gBACd,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,UAAU,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAChE,SAAS,CAAC,uCAAuC;aAClD;YACD,oDAAoD;YACpD,WAAW,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC;SACnC;KACF;IAED,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sCAAsC,CACpD,IAAa;IAEb,OAAO,EAAE,CAAC,IAAI,EAAE,oCAAoC,CAAC,CAAC;AACxD,CAAC","sourcesContent":["import {\n  boolean,\n  number,\n  optional,\n  string,\n  type,\n  is,\n  validate,\n} from '@metamask/superstruct';\nimport type { Infer } from '@metamask/superstruct';\nimport { isCaipChainId, isStrictHexString } from '@metamask/utils';\n\n/**\n * Validates that a key is a valid chain ID (hex or CAIP-2 format).\n * Supports both EVM hex chain IDs and chain-agnostic CAIP-2 identifiers.\n *\n * @param key - The key to validate\n * @returns True if the key is a valid chain ID format\n */\nfunction isValidChainIdKey(key: string): boolean {\n  return isStrictHexString(key) || isCaipChainId(key);\n}\n\n/**\n * Schema for validating per-network smart transactions configuration.\n * All fields are optional to allow partial configuration and merging with defaults.\n */\nexport const SmartTransactionsNetworkConfigSchema = type({\n  /** Whether smart transactions are active for the extension client */\n  extensionActive: optional(boolean()),\n  /** Whether smart transactions are active for mobile clients (generic) */\n  mobileActive: optional(boolean()),\n  /** Whether smart transactions are active for iOS specifically */\n  mobileActiveIOS: optional(boolean()),\n  /** Whether smart transactions are active for Android specifically */\n  mobileActiveAndroid: optional(boolean()),\n  /** Expected time in seconds for a smart transaction to be mined */\n  expectedDeadline: optional(number()),\n  /** Maximum time in seconds before a smart transaction is considered failed */\n  maxDeadline: optional(number()),\n  /** Whether extension should return tx hash immediately without waiting for confirmation */\n  extensionReturnTxHashAsap: optional(boolean()),\n  /** Whether extension should return tx hash immediately for batch transactions */\n  extensionReturnTxHashAsapBatch: optional(boolean()),\n  /** Whether mobile should return tx hash immediately without waiting for confirmation */\n  mobileReturnTxHashAsap: optional(boolean()),\n  /** Whether extension should skip the smart transaction status page */\n  extensionSkipSmartTransactionStatusPage: optional(boolean()),\n  /** Polling interval in milliseconds for batch status updates */\n  batchStatusPollingInterval: optional(number()),\n  /** Custom sentinel URL for the network */\n  sentinelUrl: optional(string()),\n});\n\n/**\n * Schema for validating the complete smart transactions feature flags configuration.\n * This includes a default configuration and optional chain-specific overrides.\n */\nexport const SmartTransactionsFeatureFlagsConfigSchema = type({\n  /** Default configuration applied to all chains unless overridden */\n  default: optional(SmartTransactionsNetworkConfigSchema),\n});\n\n/**\n * Type inferred from the SmartTransactionsNetworkConfigSchema\n */\nexport type SmartTransactionsNetworkConfigFromSchema = Infer<\n  typeof SmartTransactionsNetworkConfigSchema\n>;\n\n/**\n * Type inferred from the SmartTransactionsFeatureFlagsConfigSchema\n */\nexport type SmartTransactionsFeatureFlagsConfigFromSchema = Infer<\n  typeof SmartTransactionsFeatureFlagsConfigSchema\n>;\n\n/**\n * Result of processing feature flags with collected validation errors.\n * Uses per-chain validation: invalid chains are removed, valid ones are kept.\n */\nexport type FeatureFlagsProcessResult = {\n  /** The validated configuration (may be partial if some chains were invalid) */\n  config: SmartTransactionsFeatureFlagsConfigFromSchema &\n    Record<string, SmartTransactionsNetworkConfigFromSchema | undefined>;\n  /** Validation errors for invalid parts of the configuration */\n  errors: Error[];\n};\n\n/**\n * Validates smart transactions feature flags with per-chain validation.\n * - If the input is not an object, returns empty config with error\n * - If `default` is present and invalid, returns empty config with error\n * - For each chain: if invalid, removes it and collects error; if valid, includes it\n *\n * @param data - The data to validate\n * @returns The validated config and any validation errors\n */\nexport function validateSmartTransactionsFeatureFlags(\n  data: unknown,\n): FeatureFlagsProcessResult {\n  const errors: Error[] = [];\n\n  // Step 1: Check if it's a valid object\n  if (typeof data !== 'object' || data === null || Array.isArray(data)) {\n    const typeDescription = data === null ? 'null' : typeof data;\n    const arraySuffix = Array.isArray(data) ? ' (array)' : '';\n    return {\n      config: {},\n      errors: [\n        new Error(\n          `Expected an object, received ${typeDescription}${arraySuffix}`,\n        ),\n      ],\n    };\n  }\n\n  const dataRecord = data as Record<string, unknown>;\n  const validConfig: FeatureFlagsProcessResult['config'] = {};\n\n  // Step 2: Validate 'default' - if present and invalid, reject everything\n  if (dataRecord.default !== undefined) {\n    const [defaultError, validatedDefault] = validate(\n      dataRecord.default,\n      SmartTransactionsNetworkConfigSchema,\n    );\n    if (defaultError) {\n      return {\n        config: {},\n        errors: [\n          new Error(`Invalid 'default' config: ${defaultError.message}`),\n        ],\n      };\n    }\n    // validatedDefault is properly typed from superstruct\n    validConfig.default = validatedDefault;\n  }\n\n  // Step 3: Validate chain-specific configs, keeping valid ones\n  for (const [key, value] of Object.entries(dataRecord)) {\n    if (key === 'default') {\n      continue;\n    }\n\n    // Check chain ID format\n    if (!isValidChainIdKey(key)) {\n      errors.push(\n        new Error(\n          `Invalid chain ID key \"${key}\". Expected hex string (e.g., \"0x1\") or CAIP-2 format (e.g., \"eip155:1\", \"solana:...\")`,\n        ),\n      );\n      continue; // Skip this chain, don't add to result\n    }\n\n    // Validate chain config\n    if (value !== undefined) {\n      const [chainError, validatedChain] = validate(\n        value,\n        SmartTransactionsNetworkConfigSchema,\n      );\n      if (chainError) {\n        errors.push(new Error(`Chain \"${key}\": ${chainError.message}`));\n        continue; // Skip this chain, don't add to result\n      }\n      // validatedChain is properly typed from superstruct\n      validConfig[key] = validatedChain;\n    }\n  }\n\n  return { config: validConfig, errors };\n}\n\n/**\n * Validates that the given data conforms to the SmartTransactionsNetworkConfig schema.\n *\n * @param data - The data to validate\n * @returns True if the data is valid, false otherwise\n */\nexport function validateSmartTransactionsNetworkConfig(\n  data: unknown,\n): data is SmartTransactionsNetworkConfigFromSchema {\n  return is(data, SmartTransactionsNetworkConfigSchema);\n}\n"]}

package/dist/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSmartTransactionMetricsSensitiveProperties = exports.getSmartTransactionMetricsProperties = exports.MetaMetricsEventCategory = exports.MetaMetricsEventName = exports.ClientId = exports.SmartTransactionStatuses = exports.SmartTransactionCancellationReason = exports.SmartTransactionMinedTx = exports.SmartTransactionsController = void 0;
+exports.selectSmartTransactionsFeatureFlagsForChain = exports.selectSmartTransactionsFeatureFlags = exports.getSmartTransactionMetricsSensitiveProperties = exports.getSmartTransactionMetricsProperties = exports.MetaMetricsEventCategory = exports.MetaMetricsEventName = exports.ClientId = exports.SmartTransactionStatuses = exports.SmartTransactionCancellationReason = exports.SmartTransactionMinedTx = exports.SmartTransactionsController = void 0;
 var SmartTransactionsController_1 = require("./SmartTransactionsController.cjs");
 Object.defineProperty(exports, "SmartTransactionsController", { enumerable: true, get: function () { return SmartTransactionsController_1.SmartTransactionsController; } });
 var types_1 = require("./types.cjs");
@@ -14,4 +14,8 @@ Object.defineProperty(exports, "MetaMetricsEventCategory", { enumerable: true, g
 var utils_1 = require("./utils.cjs");
 Object.defineProperty(exports, "getSmartTransactionMetricsProperties", { enumerable: true, get: function () { return utils_1.getSmartTransactionMetricsProperties; } });
 Object.defineProperty(exports, "getSmartTransactionMetricsSensitiveProperties", { enumerable: true, get: function () { return utils_1.getSmartTransactionMetricsSensitiveProperties; } });
+// Feature flag selectors
+var selectors_1 = require("./selectors.cjs");
+Object.defineProperty(exports, "selectSmartTransactionsFeatureFlags", { enumerable: true, get: function () { return selectors_1.selectSmartTransactionsFeatureFlags; } });
+Object.defineProperty(exports, "selectSmartTransactionsFeatureFlagsForChain", { enumerable: true, get: function () { return selectors_1.selectSmartTransactionsFeatureFlagsForChain; } });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iFAA4E;AAAnE,0IAAA,2BAA2B,OAAA;AAWpC,qCAUiB;AAJf,gHAAA,uBAAuB,OAAA;AACvB,2HAAA,kCAAkC,OAAA;AAClC,iHAAA,wBAAwB,OAAA;AACxB,iGAAA,QAAQ,OAAA;AAEV,6CAA6E;AAApE,iHAAA,oBAAoB,OAAA;AAAE,qHAAA,wBAAwB,OAAA;AACvD,qCAGiB;AAFf,6HAAA,oCAAoC,OAAA;AACpC,sIAAA,6CAA6C,OAAA","sourcesContent":["export { SmartTransactionsController } from './SmartTransactionsController';\nexport type {\n  SmartTransactionsControllerMessenger,\n  SmartTransactionsControllerState,\n  SmartTransactionsControllerGetStateAction,\n  SmartTransactionsControllerActions,\n  SmartTransactionsControllerStateChangeEvent,\n  SmartTransactionsControllerSmartTransactionEvent,\n  SmartTransactionsControllerSmartTransactionConfirmationDoneEvent,\n  SmartTransactionsControllerEvents,\n} from './SmartTransactionsController';\nexport {\n  type Fee,\n  type Fees,\n  type IndividualTxFees,\n  type FeatureFlags,\n  type SmartTransaction,\n  SmartTransactionMinedTx,\n  SmartTransactionCancellationReason,\n  SmartTransactionStatuses,\n  ClientId,\n} from './types';\nexport { MetaMetricsEventName, MetaMetricsEventCategory } from './constants';\nexport {\n  getSmartTransactionMetricsProperties,\n  getSmartTransactionMetricsSensitiveProperties,\n} from './utils';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iFAA4E;AAAnE,0IAAA,2BAA2B,OAAA;AAWpC,qCAYiB;AAJf,gHAAA,uBAAuB,OAAA;AACvB,2HAAA,kCAAkC,OAAA;AAClC,iHAAA,wBAAwB,OAAA;AACxB,iGAAA,QAAQ,OAAA;AAEV,6CAA6E;AAApE,iHAAA,oBAAoB,OAAA;AAAE,qHAAA,wBAAwB,OAAA;AACvD,qCAGiB;AAFf,6HAAA,oCAAoC,OAAA;AACpC,sIAAA,6CAA6C,OAAA;AAG/C,yBAAyB;AACzB,6CAIqB;AAHnB,gIAAA,mCAAmC,OAAA;AACnC,wIAAA,2CAA2C,OAAA","sourcesContent":["export { SmartTransactionsController } from './SmartTransactionsController';\nexport type {\n  SmartTransactionsControllerMessenger,\n  SmartTransactionsControllerState,\n  SmartTransactionsControllerGetStateAction,\n  SmartTransactionsControllerActions,\n  SmartTransactionsControllerStateChangeEvent,\n  SmartTransactionsControllerSmartTransactionEvent,\n  SmartTransactionsControllerSmartTransactionConfirmationDoneEvent,\n  SmartTransactionsControllerEvents,\n} from './SmartTransactionsController';\nexport {\n  type Fee,\n  type Fees,\n  type IndividualTxFees,\n  type FeatureFlags,\n  type SmartTransaction,\n  type SmartTransactionsNetworkConfig,\n  type SmartTransactionsFeatureFlagsConfig,\n  SmartTransactionMinedTx,\n  SmartTransactionCancellationReason,\n  SmartTransactionStatuses,\n  ClientId,\n} from './types';\nexport { MetaMetricsEventName, MetaMetricsEventCategory } from './constants';\nexport {\n  getSmartTransactionMetricsProperties,\n  getSmartTransactionMetricsSensitiveProperties,\n} from './utils';\n\n// Feature flag selectors\nexport {\n  selectSmartTransactionsFeatureFlags,\n  selectSmartTransactionsFeatureFlagsForChain,\n  type SmartTransactionsFeatureFlagsState,\n} from './selectors';\n"]}

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 export { SmartTransactionsController } from "./SmartTransactionsController.cjs";
 export type { SmartTransactionsControllerMessenger, SmartTransactionsControllerState, SmartTransactionsControllerGetStateAction, SmartTransactionsControllerActions, SmartTransactionsControllerStateChangeEvent, SmartTransactionsControllerSmartTransactionEvent, SmartTransactionsControllerSmartTransactionConfirmationDoneEvent, SmartTransactionsControllerEvents, } from "./SmartTransactionsController.cjs";
-export { type Fee, type Fees, type IndividualTxFees, type FeatureFlags, type SmartTransaction, SmartTransactionMinedTx, SmartTransactionCancellationReason, SmartTransactionStatuses, ClientId, } from "./types.cjs";
+export { type Fee, type Fees, type IndividualTxFees, type FeatureFlags, type SmartTransaction, type SmartTransactionsNetworkConfig, type SmartTransactionsFeatureFlagsConfig, SmartTransactionMinedTx, SmartTransactionCancellationReason, SmartTransactionStatuses, ClientId, } from "./types.cjs";
 export { MetaMetricsEventName, MetaMetricsEventCategory } from "./constants.cjs";
 export { getSmartTransactionMetricsProperties, getSmartTransactionMetricsSensitiveProperties, } from "./utils.cjs";
+export { selectSmartTransactionsFeatureFlags, selectSmartTransactionsFeatureFlagsForChain, type SmartTransactionsFeatureFlagsState, } from "./selectors.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,0CAAsC;AAC5E,YAAY,EACV,oCAAoC,EACpC,gCAAgC,EAChC,yCAAyC,EACzC,kCAAkC,EAClC,2CAA2C,EAC3C,gDAAgD,EAChD,gEAAgE,EAChE,iCAAiC,GAClC,0CAAsC;AACvC,OAAO,EACL,KAAK,GAAG,EACR,KAAK,IAAI,EACT,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,uBAAuB,EACvB,kCAAkC,EAClC,wBAAwB,EACxB,QAAQ,GACT,oBAAgB;AACjB,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,wBAAoB;AAC7E,OAAO,EACL,oCAAoC,EACpC,6CAA6C,GAC9C,oBAAgB"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,0CAAsC;AAC5E,YAAY,EACV,oCAAoC,EACpC,gCAAgC,EAChC,yCAAyC,EACzC,kCAAkC,EAClC,2CAA2C,EAC3C,gDAAgD,EAChD,gEAAgE,EAChE,iCAAiC,GAClC,0CAAsC;AACvC,OAAO,EACL,KAAK,GAAG,EACR,KAAK,IAAI,EACT,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,8BAA8B,EACnC,KAAK,mCAAmC,EACxC,uBAAuB,EACvB,kCAAkC,EAClC,wBAAwB,EACxB,QAAQ,GACT,oBAAgB;AACjB,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,wBAAoB;AAC7E,OAAO,EACL,oCAAoC,EACpC,6CAA6C,GAC9C,oBAAgB;AAGjB,OAAO,EACL,mCAAmC,EACnC,2CAA2C,EAC3C,KAAK,kCAAkC,GACxC,wBAAoB"}