@metamask-previews/transaction-controller 69.6.1-preview-4f4c98e → 69.6.1-preview-eb263b0ee

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

@@ -0,0 +1,313 @@
+import type { Hex } from "@metamask/utils";
+import type { TransactionControllerMessenger } from "../TransactionController.mjs";
+/**
+ * Feature flags supporting the transaction controller.
+ */
+export declare enum FeatureFlag {
+    EIP7702 = "confirmations_eip_7702",
+    GasBuffer = "confirmations_gas_buffer",
+    Transactions = "confirmations_transactions"
+}
+type GasEstimateFallback = {
+    /**
+     * The fixed gas estimate fallback for a transaction.
+     */
+    fixed?: number;
+    /**
+     * The percentage multiplier gas estimate fallback for a transaction.
+     */
+    percentage?: number;
+    /**
+     * The maximum gas limit the fallback can resolve to, representing the chain's
+     * per-transaction gas cap. Clamps the `fixed` or `percentage`-derived fallback
+     * so it can never exceed the gas limit the RPC will accept (e.g. ~33.5M on
+     * Polygon, whereas 35% of its ~140M block gas limit would otherwise be ~49M).
+     */
+    maxGasLimit?: number;
+};
+export type TransactionControllerFeatureFlags = {
+    /** Feature flags to support EIP-7702 / type-4 transactions. */
+    [FeatureFlag.EIP7702]?: {
+        /**
+         * All contracts that support EIP-7702 batch transactions.
+         * Keyed by chain ID.
+         * First entry in each array is the contract that standard EOAs will be upgraded to.
+         */
+        contracts?: Record<Hex, {
+            /** Address of the smart contract. */
+            address: Hex;
+            /** Signature to verify the contract is authentic. */
+            signature: Hex;
+        }[]>;
+        /** Chains enabled for EIP-7702 batch transactions. */
+        supportedChains?: Hex[];
+    };
+    /**
+     * Buffers added to gas limit estimations.
+     * Values are multipliers such as `1.5` meaning 150% of the original gas limit.
+     */
+    [FeatureFlag.GasBuffer]?: {
+        /** Fallback buffer for all chains and transactions. */
+        default?: number;
+        /**
+         * Buffer for included network RPCs only and not those added by user.
+         * Takes priority over `default`.
+         */
+        included?: number;
+        /** Buffers for specific chains. */
+        perChainConfig?: {
+            [chainId: Hex]: {
+                /**
+                 * Buffer for the chain for all transactions.
+                 * Takes priority over non-chain `included`.
+                 */
+                base?: number;
+                /**
+                 * Buffer if network RPC is included and not added by user.
+                 * Takes priority over `base`.
+                 */
+                included?: number;
+                /**
+                 * Buffer for the chain for EIP-7702 / type 4 transactions only.
+                 * Only if `data` included and `to` matches `from`.
+                 * Takes priority over `included` and `base`.
+                 */
+                eip7702?: number;
+            };
+        };
+    };
+    /** Miscellaneous feature flags to support the transaction controller. */
+    [FeatureFlag.Transactions]?: {
+        /** Maximum number of transactions that can be in an external batch. */
+        batchSizeLimit?: number;
+        /** Maximum number of entries in the submit history. */
+        submitHistoryLimit?: number;
+        /** Maximum number of transactions stored in state. */
+        transactionHistoryLimit?: number;
+        /**
+         * Accelerated polling is used to speed up the polling process for
+         * transactions that are not yet confirmed.
+         */
+        acceleratedPolling?: {
+            /** Accelerated polling parameters on a per-chain basis. */
+            perChainConfig?: {
+                [chainId: Hex]: {
+                    /**
+                     * Block time in milliseconds.
+                     */
+                    blockTime?: number;
+                    /**
+                     * Maximum number of polling requests that can be made in a row, before
+                     * the normal polling resumes.
+                     */
+                    countMax?: number;
+                    /** Interval between polling requests in milliseconds. */
+                    intervalMs?: number;
+                };
+            };
+            /** Default `countMax` in case no chain-specific parameter is set. */
+            defaultCountMax?: number;
+            /** Default `intervalMs` in case no chain-specific parameter is set. */
+            defaultIntervalMs?: number;
+        };
+        gasFeeRandomisation?: {
+            /** Randomised gas fee digits per chainId. */
+            randomisedGasFeeDigits?: Record<Hex, number>;
+            /** Number of digits to preserve for randomised gas fee digits. */
+            preservedNumberOfDigits?: number;
+        };
+        /** Gas estimate fallback is used as a fallback in case of failure to obtain the gas estimate values. */
+        gasEstimateFallback?: {
+            /** Gas estimate fallback per-chain basis. */
+            perChainConfig?: {
+                [chainId: Hex]: GasEstimateFallback;
+            };
+            /**
+             * Default gas estimate fallback.
+             * This value is used when no specific gas estimate fallback is found for a chain ID.
+             */
+            default?: GasEstimateFallback;
+        };
+        /**
+         * Number of attempts to wait before automatically marking a transaction as failed
+         * if it has no receipt status and hash is not found on the network.
+         */
+        timeoutAttempts?: {
+            /** Automatic fail threshold on a per-chain basis. */
+            perChainConfig?: {
+                [chainId: Hex]: number;
+            };
+            /**
+             * Default automatic fail threshold.
+             * This value is used when no specific threshold is found for a chain ID.
+             */
+            default?: number;
+        };
+        /**
+         * Replacement of underpriced dapp-suggested gas fees.
+         * If enabled, dapp-suggested EIP-1559 fees with a `maxFeePerGas` below the
+         * current low estimate are replaced with the wallet's suggested fees, as
+         * they are unlikely to be included in a block before fee values change.
+         */
+        replaceUnderpricedDappGasFees?: {
+            /** Enablement on a per-chain basis. */
+            perChainConfig?: {
+                [chainId: Hex]: boolean;
+            };
+            /**
+             * Default enablement.
+             * This value is used when no specific value is found for a chain ID.
+             */
+            default?: boolean;
+        };
+        /**
+         * Replacement of underpriced saved (advanced) gas fee preferences.
+         * If enabled, saved custom fees with a `maxBaseFee` below the current low
+         * estimate are ignored in favour of the wallet's suggested fees, as they
+         * are unlikely to be included in a block before fee values change.
+         * Level-based saved preferences track current estimates and are never
+         * ignored.
+         */
+        replaceUnderpricedSavedGasFees?: {
+            /** Enablement on a per-chain basis. */
+            perChainConfig?: {
+                [chainId: Hex]: boolean;
+            };
+            /**
+             * Default enablement.
+             * This value is used when no specific value is found for a chain ID.
+             */
+            default?: boolean;
+        };
+    };
+};
+/**
+ * Retrieves the supported EIP-7702 chains.
+ *
+ * @param messenger - The controller messenger instance.
+ * @returns The supported chains.
+ */
+export declare function getEIP7702SupportedChains(messenger: TransactionControllerMessenger): Hex[];
+/**
+ * Retrieves the supported EIP-7702 contract addresses for a given chain ID.
+ *
+ * @param chainId - The chain ID.
+ * @param messenger - The controller messenger instance.
+ * @param publicKey - The public key used to validate the contract authenticity.
+ * @returns The supported contract addresses.
+ */
+export declare function getEIP7702ContractAddresses(chainId: Hex, messenger: TransactionControllerMessenger, publicKey: Hex): Hex[];
+/**
+ * Retrieves the EIP-7702 upgrade contract address.
+ *
+ * @param chainId - The chain ID.
+ * @param messenger - The controller messenger instance.
+ * @param publicKey - The public key used to validate the contract authenticity.
+ * @returns The upgrade contract address.
+ */
+export declare function getEIP7702UpgradeContractAddress(chainId: Hex, messenger: TransactionControllerMessenger, publicKey: Hex): Hex | undefined;
+/**
+ * Retrieves the batch size limit.
+ * Defaults to 10 if not set.
+ *
+ * @param messenger - The controller messenger instance.
+ * @returns  The batch size limit.
+ */
+export declare function getBatchSizeLimit(messenger: TransactionControllerMessenger): number;
+/**
+ * Retrieves the submit history limit.
+ * Defaults to 100 if not set.
+ *
+ * @param messenger - The controller messenger instance.
+ * @returns The submit history limit.
+ */
+export declare function getSubmitHistoryLimit(messenger: TransactionControllerMessenger): number;
+/**
+ * Retrieves the transaction history limit.
+ * Defaults to 40 if not set.
+ *
+ * @param messenger - The controller messenger instance.
+ * @returns The transaction history limit.
+ */
+export declare function getTransactionHistoryLimit(messenger: TransactionControllerMessenger): number | undefined;
+/**
+ * Retrieves the accelerated polling parameters for a given chain ID.
+ *
+ * @param chainId - The chain ID.
+ * @param messenger - The controller messenger instance.
+ * @returns The accelerated polling parameters: `countMax` and `intervalMs`.
+ */
+export declare function getAcceleratedPollingParams(chainId: Hex, messenger: TransactionControllerMessenger): {
+    blockTime: number;
+    countMax: number;
+    intervalMs: number;
+};
+/**
+ * Retrieves the gas fee randomisation parameters.
+ *
+ * @param messenger - The controller messenger instance.
+ * @returns The gas fee randomisation parameters.
+ */
+export declare function getGasFeeRandomisation(messenger: TransactionControllerMessenger): {
+    randomisedGasFeeDigits: Record<Hex, number>;
+    preservedNumberOfDigits: number | undefined;
+};
+/**
+ * Retrieves the gas estimate fallback for a given chain ID.
+ * Defaults to the default gas estimate fallback if not set.
+ *
+ * @param chainId - The chain ID.
+ * @param messenger - The controller messenger instance.
+ * @returns The gas estimate fallback.
+ */
+export declare function getGasEstimateFallback(chainId: Hex, messenger: TransactionControllerMessenger): {
+    fixed?: number;
+    percentage: number;
+    maxGasLimit?: number;
+};
+/**
+ * Retrieves the gas buffers for a given chain ID.
+ *
+ * @param request - The request object.
+ * @param request.chainId - The chain ID.
+ * @param request.isCustomRPC - Whether the network RPC is added by the user.
+ * @param request.isUpgradeWithData - Whether the transaction is an EIP-7702 upgrade combined with a call.
+ * @param request.messenger - The controller messenger instance.
+ * @returns The gas buffers.
+ */
+export declare function getGasEstimateBuffer({ chainId, isCustomRPC, isUpgradeWithData, messenger, }: {
+    chainId: Hex;
+    isCustomRPC: boolean;
+    isUpgradeWithData: boolean;
+    messenger: TransactionControllerMessenger;
+}): number;
+/**
+ * Retrieves the incoming transactions polling interval.
+ * Retrieves the number of attempts to wait before automatically marking a transaction as dropped
+ * if it has no receipt status.
+ *
+ * @param chainId - The chain ID.
+ * @param messenger - The controller messenger instance.
+ * @returns The threshold number of attempts, or undefined if the feature is disabled.
+ */
+export declare function getTimeoutAttempts(chainId: Hex, messenger: TransactionControllerMessenger): number | undefined;
+/**
+ * Retrieves whether underpriced dapp-suggested gas fees should be replaced
+ * with the wallet's suggested fees.
+ *
+ * @param chainId - The chain ID.
+ * @param messenger - The controller messenger instance.
+ * @returns Whether the replacement is enabled.
+ */
+export declare function getReplaceUnderpricedDappGasFeesEnabled(chainId: Hex, messenger: TransactionControllerMessenger): boolean;
+/**
+ * Retrieves whether underpriced saved (advanced) gas fee preferences should be
+ * ignored in favour of the wallet's suggested fees.
+ *
+ * @param chainId - The chain ID.
+ * @param messenger - The controller messenger instance.
+ * @returns Whether the replacement is enabled.
+ */
+export declare function getReplaceUnderpricedSavedGasFeesEnabled(chainId: Hex, messenger: TransactionControllerMessenger): boolean;
+export {};
+//# sourceMappingURL=feature-flags.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.d.mts","sourceRoot":"","sources":["../../src/utils/feature-flags.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAG3C,OAAO,KAAK,EAAE,8BAA8B,EAAE,qCAAoC;AAalF;;GAEG;AACH,oBAAY,WAAW;IACrB,OAAO,2BAA2B;IAClC,SAAS,6BAA6B;IACtC,YAAY,+BAA+B;CAC5C;AAED,KAAK,mBAAmB,GAAG;IACzB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,+DAA+D;IAC/D,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE;QACtB;;;;WAIG;QACH,SAAS,CAAC,EAAE,MAAM,CAChB,GAAG,EACH;YACE,qCAAqC;YACrC,OAAO,EAAE,GAAG,CAAC;YAEb,qDAAqD;YACrD,SAAS,EAAE,GAAG,CAAC;SAChB,EAAE,CACJ,CAAC;QAEF,sDAAsD;QACtD,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC;KACzB,CAAC;IAEF;;;OAGG;IACH,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE;QACxB,uDAAuD;QACvD,OAAO,CAAC,EAAE,MAAM,CAAC;QAEjB;;;WAGG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC;QAElB,mCAAmC;QACnC,cAAc,CAAC,EAAE;YACf,CAAC,OAAO,EAAE,GAAG,GAAG;gBACd;;;mBAGG;gBACH,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEd;;;mBAGG;gBACH,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAElB;;;;mBAIG;gBACH,OAAO,CAAC,EAAE,MAAM,CAAC;aAClB,CAAC;SACH,CAAC;KACH,CAAC;IAEF,yEAAyE;IACzE,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,EAAE;QAC3B,uEAAuE;QACvE,cAAc,CAAC,EAAE,MAAM,CAAC;QAExB,uDAAuD;QACvD,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAE5B,sDAAsD;QACtD,uBAAuB,CAAC,EAAE,MAAM,CAAC;QAEjC;;;WAGG;QACH,kBAAkB,CAAC,EAAE;YACnB,2DAA2D;YAC3D,cAAc,CAAC,EAAE;gBACf,CAAC,OAAO,EAAE,GAAG,GAAG;oBACd;;uBAEG;oBACH,SAAS,CAAC,EAAE,MAAM,CAAC;oBAEnB;;;uBAGG;oBACH,QAAQ,CAAC,EAAE,MAAM,CAAC;oBAElB,yDAAyD;oBACzD,UAAU,CAAC,EAAE,MAAM,CAAC;iBACrB,CAAC;aACH,CAAC;YAEF,qEAAqE;YACrE,eAAe,CAAC,EAAE,MAAM,CAAC;YAEzB,uEAAuE;YACvE,iBAAiB,CAAC,EAAE,MAAM,CAAC;SAC5B,CAAC;QAEF,mBAAmB,CAAC,EAAE;YACpB,6CAA6C;YAC7C,sBAAsB,CAAC,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAE7C,kEAAkE;YAClE,uBAAuB,CAAC,EAAE,MAAM,CAAC;SAClC,CAAC;QAEF,wGAAwG;QACxG,mBAAmB,CAAC,EAAE;YACpB,6CAA6C;YAC7C,cAAc,CAAC,EAAE;gBACf,CAAC,OAAO,EAAE,GAAG,GAAG,mBAAmB,CAAC;aACrC,CAAC;YAEF;;;eAGG;YACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;SAC/B,CAAC;QAEF;;;WAGG;QACH,eAAe,CAAC,EAAE;YAChB,qDAAqD;YACrD,cAAc,CAAC,EAAE;gBACf,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,CAAC;aACxB,CAAC;YAEF;;;eAGG;YACH,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;QAEF;;;;;WAKG;QACH,6BAA6B,CAAC,EAAE;YAC9B,uCAAuC;YACvC,cAAc,CAAC,EAAE;gBACf,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC;aACzB,CAAC;YAEF;;;eAGG;YACH,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC;QAEF;;;;;;;WAOG;QACH,8BAA8B,CAAC,EAAE;YAC/B,uCAAuC;YACvC,cAAc,CAAC,EAAE;gBACf,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC;aACzB,CAAC;YAEF;;;eAGG;YACH,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC;KACH,CAAC;CACH,CAAC;AAIF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,8BAA8B,GACxC,GAAG,EAAE,CAGP;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,8BAA8B,EACzC,SAAS,EAAE,GAAG,GACb,GAAG,EAAE,CAiBP;AAED;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,8BAA8B,EACzC,SAAS,EAAE,GAAG,GACb,GAAG,GAAG,SAAS,CAEjB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,8BAA8B,GACxC,MAAM,CAMR;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,8BAA8B,GACxC,MAAM,CAMR;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,8BAA8B,GACxC,MAAM,GAAG,SAAS,CAWpB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,8BAA8B,GACxC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAqB7D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,8BAA8B,GACxC;IACD,sBAAsB,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5C,uBAAuB,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C,CAUA;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,8BAA8B,GACxC;IACD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAmBA;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,OAAO,EACP,WAAW,EACX,iBAAiB,EACjB,SAAS,GACV,EAAE;IACD,OAAO,EAAE,GAAG,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,8BAA8B,CAAC;CAC3C,GAAG,MAAM,CAoBT;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,8BAA8B,GACxC,MAAM,GAAG,SAAS,CAUpB;AAED;;;;;;;GAOG;AACH,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,8BAA8B,GACxC,OAAO,CAWT;AAED;;;;;;;GAOG;AACH,wBAAgB,wCAAwC,CACtD,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,8BAA8B,GACxC,OAAO,CAWT"}

package/dist/utils/{feature-flags.js → feature-flags.mjs}

@@ -1,7 +1,7 @@
-import { createModuleLogger } from '@metamask/utils';
-import { projectLogger } from '../logger.js';
-import { isValidSignature } from './signature.js';
-import { padHexToEvenLength } from './utils.js';
+import { createModuleLogger } from "@metamask/utils";
+import { projectLogger } from "../logger.mjs";
+import { isValidSignature } from "./signature.mjs";
+import { padHexToEvenLength } from "./utils.mjs";
 const DEFAULT_BATCH_SIZE_LIMIT = 10;
 const DEFAULT_ACCELERATED_POLLING_COUNT_MAX = 10;
 const DEFAULT_ACCELERATED_POLLING_INTERVAL_MS = 3 * 1000;
@@ -236,4 +236,4 @@ function getFeatureFlags(messenger) {
         return undefined;
     }
 }
-//# sourceMappingURL=feature-flags.js.map
+//# sourceMappingURL=feature-flags.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.mjs","sourceRoot":"","sources":["../../src/utils/feature-flags.ts"],"names":[],"mappings":"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","sourcesContent":["import { createModuleLogger } from '@metamask/utils';\nimport type { Hex } from '@metamask/utils';\n\nimport { projectLogger } from '../logger.js';\nimport type { TransactionControllerMessenger } from '../TransactionController.js';\nimport { isValidSignature } from './signature.js';\nimport { padHexToEvenLength } from './utils.js';\n\nconst DEFAULT_BATCH_SIZE_LIMIT = 10;\nconst DEFAULT_ACCELERATED_POLLING_COUNT_MAX = 10;\nconst DEFAULT_ACCELERATED_POLLING_INTERVAL_MS = 3 * 1000;\nconst DEFAULT_BLOCK_TIME = 12 * 1000;\nconst DEFAULT_GAS_ESTIMATE_FALLBACK_BLOCK_PERCENT = 35;\nconst DEFAULT_GAS_ESTIMATE_BUFFER = 1;\nconst DEFAULT_SUBMIT_HISTORY_LIMIT = 100;\nconst DEFAULT_TRANSACTION_HISTORY_LIMIT = 40;\n\n/**\n * Feature flags supporting the transaction controller.\n */\nexport enum FeatureFlag {\n  EIP7702 = 'confirmations_eip_7702',\n  GasBuffer = 'confirmations_gas_buffer',\n  Transactions = 'confirmations_transactions',\n}\n\ntype GasEstimateFallback = {\n  /**\n   * The fixed gas estimate fallback for a transaction.\n   */\n  fixed?: number;\n\n  /**\n   * The percentage multiplier gas estimate fallback for a transaction.\n   */\n  percentage?: number;\n\n  /**\n   * The maximum gas limit the fallback can resolve to, representing the chain's\n   * per-transaction gas cap. Clamps the `fixed` or `percentage`-derived fallback\n   * so it can never exceed the gas limit the RPC will accept (e.g. ~33.5M on\n   * Polygon, whereas 35% of its ~140M block gas limit would otherwise be ~49M).\n   */\n  maxGasLimit?: number;\n};\n\nexport type TransactionControllerFeatureFlags = {\n  /** Feature flags to support EIP-7702 / type-4 transactions. */\n  [FeatureFlag.EIP7702]?: {\n    /**\n     * All contracts that support EIP-7702 batch transactions.\n     * Keyed by chain ID.\n     * First entry in each array is the contract that standard EOAs will be upgraded to.\n     */\n    contracts?: Record<\n      Hex,\n      {\n        /** Address of the smart contract. */\n        address: Hex;\n\n        /** Signature to verify the contract is authentic. */\n        signature: Hex;\n      }[]\n    >;\n\n    /** Chains enabled for EIP-7702 batch transactions. */\n    supportedChains?: Hex[];\n  };\n\n  /**\n   * Buffers added to gas limit estimations.\n   * Values are multipliers such as `1.5` meaning 150% of the original gas limit.\n   */\n  [FeatureFlag.GasBuffer]?: {\n    /** Fallback buffer for all chains and transactions. */\n    default?: number;\n\n    /**\n     * Buffer for included network RPCs only and not those added by user.\n     * Takes priority over `default`.\n     */\n    included?: number;\n\n    /** Buffers for specific chains. */\n    perChainConfig?: {\n      [chainId: Hex]: {\n        /**\n         * Buffer for the chain for all transactions.\n         * Takes priority over non-chain `included`.\n         */\n        base?: number;\n\n        /**\n         * Buffer if network RPC is included and not added by user.\n         * Takes priority over `base`.\n         */\n        included?: number;\n\n        /**\n         * Buffer for the chain for EIP-7702 / type 4 transactions only.\n         * Only if `data` included and `to` matches `from`.\n         * Takes priority over `included` and `base`.\n         */\n        eip7702?: number;\n      };\n    };\n  };\n\n  /** Miscellaneous feature flags to support the transaction controller. */\n  [FeatureFlag.Transactions]?: {\n    /** Maximum number of transactions that can be in an external batch. */\n    batchSizeLimit?: number;\n\n    /** Maximum number of entries in the submit history. */\n    submitHistoryLimit?: number;\n\n    /** Maximum number of transactions stored in state. */\n    transactionHistoryLimit?: number;\n\n    /**\n     * Accelerated polling is used to speed up the polling process for\n     * transactions that are not yet confirmed.\n     */\n    acceleratedPolling?: {\n      /** Accelerated polling parameters on a per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: {\n          /**\n           * Block time in milliseconds.\n           */\n          blockTime?: number;\n\n          /**\n           * Maximum number of polling requests that can be made in a row, before\n           * the normal polling resumes.\n           */\n          countMax?: number;\n\n          /** Interval between polling requests in milliseconds. */\n          intervalMs?: number;\n        };\n      };\n\n      /** Default `countMax` in case no chain-specific parameter is set. */\n      defaultCountMax?: number;\n\n      /** Default `intervalMs` in case no chain-specific parameter is set. */\n      defaultIntervalMs?: number;\n    };\n\n    gasFeeRandomisation?: {\n      /** Randomised gas fee digits per chainId. */\n      randomisedGasFeeDigits?: Record<Hex, number>;\n\n      /** Number of digits to preserve for randomised gas fee digits. */\n      preservedNumberOfDigits?: number;\n    };\n\n    /** Gas estimate fallback is used as a fallback in case of failure to obtain the gas estimate values. */\n    gasEstimateFallback?: {\n      /** Gas estimate fallback per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: GasEstimateFallback;\n      };\n\n      /**\n       * Default gas estimate fallback.\n       * This value is used when no specific gas estimate fallback is found for a chain ID.\n       */\n      default?: GasEstimateFallback;\n    };\n\n    /**\n     * Number of attempts to wait before automatically marking a transaction as failed\n     * if it has no receipt status and hash is not found on the network.\n     */\n    timeoutAttempts?: {\n      /** Automatic fail threshold on a per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: number;\n      };\n\n      /**\n       * Default automatic fail threshold.\n       * This value is used when no specific threshold is found for a chain ID.\n       */\n      default?: number;\n    };\n\n    /**\n     * Replacement of underpriced dapp-suggested gas fees.\n     * If enabled, dapp-suggested EIP-1559 fees with a `maxFeePerGas` below the\n     * current low estimate are replaced with the wallet's suggested fees, as\n     * they are unlikely to be included in a block before fee values change.\n     */\n    replaceUnderpricedDappGasFees?: {\n      /** Enablement on a per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: boolean;\n      };\n\n      /**\n       * Default enablement.\n       * This value is used when no specific value is found for a chain ID.\n       */\n      default?: boolean;\n    };\n\n    /**\n     * Replacement of underpriced saved (advanced) gas fee preferences.\n     * If enabled, saved custom fees with a `maxBaseFee` below the current low\n     * estimate are ignored in favour of the wallet's suggested fees, as they\n     * are unlikely to be included in a block before fee values change.\n     * Level-based saved preferences track current estimates and are never\n     * ignored.\n     */\n    replaceUnderpricedSavedGasFees?: {\n      /** Enablement on a per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: boolean;\n      };\n\n      /**\n       * Default enablement.\n       * This value is used when no specific value is found for a chain ID.\n       */\n      default?: boolean;\n    };\n  };\n};\n\nconst log = createModuleLogger(projectLogger, 'feature-flags');\n\n/**\n * Retrieves the supported EIP-7702 chains.\n *\n * @param messenger - The controller messenger instance.\n * @returns The supported chains.\n */\nexport function getEIP7702SupportedChains(\n  messenger: TransactionControllerMessenger,\n): Hex[] {\n  const featureFlags = getFeatureFlags(messenger);\n  return featureFlags?.[FeatureFlag.EIP7702]?.supportedChains ?? [];\n}\n\n/**\n * Retrieves the supported EIP-7702 contract addresses for a given chain ID.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @param publicKey - The public key used to validate the contract authenticity.\n * @returns The supported contract addresses.\n */\nexport function getEIP7702ContractAddresses(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n  publicKey: Hex,\n): Hex[] {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const contracts =\n    featureFlags?.[FeatureFlag.EIP7702]?.contracts?.[\n      chainId.toLowerCase() as Hex\n    ] ?? [];\n\n  return contracts\n    .filter((contract) =>\n      isValidSignature(\n        [contract.address, padHexToEvenLength(chainId) as Hex],\n        contract.signature,\n        publicKey,\n      ),\n    )\n    .map((contract) => contract.address);\n}\n\n/**\n * Retrieves the EIP-7702 upgrade contract address.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @param publicKey - The public key used to validate the contract authenticity.\n * @returns The upgrade contract address.\n */\nexport function getEIP7702UpgradeContractAddress(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n  publicKey: Hex,\n): Hex | undefined {\n  return getEIP7702ContractAddresses(chainId, messenger, publicKey)?.[0];\n}\n\n/**\n * Retrieves the batch size limit.\n * Defaults to 10 if not set.\n *\n * @param messenger - The controller messenger instance.\n * @returns  The batch size limit.\n */\nexport function getBatchSizeLimit(\n  messenger: TransactionControllerMessenger,\n): number {\n  const featureFlags = getFeatureFlags(messenger);\n  return (\n    featureFlags?.[FeatureFlag.Transactions]?.batchSizeLimit ??\n    DEFAULT_BATCH_SIZE_LIMIT\n  );\n}\n\n/**\n * Retrieves the submit history limit.\n * Defaults to 100 if not set.\n *\n * @param messenger - The controller messenger instance.\n * @returns The submit history limit.\n */\nexport function getSubmitHistoryLimit(\n  messenger: TransactionControllerMessenger,\n): number {\n  const featureFlags = getFeatureFlags(messenger);\n  return (\n    featureFlags?.[FeatureFlag.Transactions]?.submitHistoryLimit ??\n    DEFAULT_SUBMIT_HISTORY_LIMIT\n  );\n}\n\n/**\n * Retrieves the transaction history limit.\n * Defaults to 40 if not set.\n *\n * @param messenger - The controller messenger instance.\n * @returns The transaction history limit.\n */\nexport function getTransactionHistoryLimit(\n  messenger: TransactionControllerMessenger,\n): number | undefined {\n  const featureFlags = getFeatureFlags(messenger);\n\n  if (!featureFlags) {\n    return undefined;\n  }\n\n  return (\n    featureFlags[FeatureFlag.Transactions]?.transactionHistoryLimit ??\n    DEFAULT_TRANSACTION_HISTORY_LIMIT\n  );\n}\n\n/**\n * Retrieves the accelerated polling parameters for a given chain ID.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns The accelerated polling parameters: `countMax` and `intervalMs`.\n */\nexport function getAcceleratedPollingParams(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): { blockTime: number; countMax: number; intervalMs: number } {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const acceleratedPollingParams =\n    featureFlags?.[FeatureFlag.Transactions]?.acceleratedPolling;\n\n  const countMax =\n    acceleratedPollingParams?.perChainConfig?.[chainId]?.countMax ??\n    acceleratedPollingParams?.defaultCountMax ??\n    DEFAULT_ACCELERATED_POLLING_COUNT_MAX;\n\n  const intervalMs =\n    acceleratedPollingParams?.perChainConfig?.[chainId]?.intervalMs ??\n    acceleratedPollingParams?.defaultIntervalMs ??\n    DEFAULT_ACCELERATED_POLLING_INTERVAL_MS;\n\n  const blockTime =\n    acceleratedPollingParams?.perChainConfig?.[chainId]?.blockTime ??\n    DEFAULT_BLOCK_TIME;\n\n  return { blockTime, countMax, intervalMs };\n}\n\n/**\n * Retrieves the gas fee randomisation parameters.\n *\n * @param messenger - The controller messenger instance.\n * @returns The gas fee randomisation parameters.\n */\nexport function getGasFeeRandomisation(\n  messenger: TransactionControllerMessenger,\n): {\n  randomisedGasFeeDigits: Record<Hex, number>;\n  preservedNumberOfDigits: number | undefined;\n} {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const gasFeeRandomisation =\n    featureFlags?.[FeatureFlag.Transactions]?.gasFeeRandomisation ?? {};\n\n  return {\n    randomisedGasFeeDigits: gasFeeRandomisation.randomisedGasFeeDigits ?? {},\n    preservedNumberOfDigits: gasFeeRandomisation.preservedNumberOfDigits,\n  };\n}\n\n/**\n * Retrieves the gas estimate fallback for a given chain ID.\n * Defaults to the default gas estimate fallback if not set.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns The gas estimate fallback.\n */\nexport function getGasEstimateFallback(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): {\n  fixed?: number;\n  percentage: number;\n  maxGasLimit?: number;\n} {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const gasEstimateFallbackFlags =\n    featureFlags?.[FeatureFlag.Transactions]?.gasEstimateFallback;\n\n  const chainFlags = gasEstimateFallbackFlags?.perChainConfig?.[chainId];\n\n  const percentage =\n    chainFlags?.percentage ??\n    gasEstimateFallbackFlags?.default?.percentage ??\n    DEFAULT_GAS_ESTIMATE_FALLBACK_BLOCK_PERCENT;\n\n  const fixed = chainFlags?.fixed ?? gasEstimateFallbackFlags?.default?.fixed;\n\n  const maxGasLimit =\n    chainFlags?.maxGasLimit ?? gasEstimateFallbackFlags?.default?.maxGasLimit;\n\n  return { fixed, percentage, maxGasLimit };\n}\n\n/**\n * Retrieves the gas buffers for a given chain ID.\n *\n * @param request - The request object.\n * @param request.chainId - The chain ID.\n * @param request.isCustomRPC - Whether the network RPC is added by the user.\n * @param request.isUpgradeWithData - Whether the transaction is an EIP-7702 upgrade combined with a call.\n * @param request.messenger - The controller messenger instance.\n * @returns The gas buffers.\n */\nexport function getGasEstimateBuffer({\n  chainId,\n  isCustomRPC,\n  isUpgradeWithData,\n  messenger,\n}: {\n  chainId: Hex;\n  isCustomRPC: boolean;\n  isUpgradeWithData: boolean;\n  messenger: TransactionControllerMessenger;\n}): number {\n  const featureFlags = getFeatureFlags(messenger);\n  const gasBufferFlags = featureFlags?.[FeatureFlag.GasBuffer];\n  const chainFlags = gasBufferFlags?.perChainConfig?.[chainId];\n  const chainIncludedRPCBuffer = isCustomRPC ? undefined : chainFlags?.included;\n\n  const defaultIncludedRPCBuffer = isCustomRPC\n    ? undefined\n    : gasBufferFlags?.included;\n\n  const upgradeBuffer = isUpgradeWithData ? chainFlags?.eip7702 : undefined;\n\n  return (\n    upgradeBuffer ??\n    chainIncludedRPCBuffer ??\n    chainFlags?.base ??\n    defaultIncludedRPCBuffer ??\n    gasBufferFlags?.default ??\n    DEFAULT_GAS_ESTIMATE_BUFFER\n  );\n}\n\n/**\n * Retrieves the incoming transactions polling interval.\n * Retrieves the number of attempts to wait before automatically marking a transaction as dropped\n * if it has no receipt status.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns The threshold number of attempts, or undefined if the feature is disabled.\n */\nexport function getTimeoutAttempts(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): number | undefined {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const timeoutAttemptsFlags =\n    featureFlags?.[FeatureFlag.Transactions]?.timeoutAttempts;\n\n  return (\n    timeoutAttemptsFlags?.perChainConfig?.[chainId] ??\n    timeoutAttemptsFlags?.default\n  );\n}\n\n/**\n * Retrieves whether underpriced dapp-suggested gas fees should be replaced\n * with the wallet's suggested fees.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns Whether the replacement is enabled.\n */\nexport function getReplaceUnderpricedDappGasFeesEnabled(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): boolean {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const replaceUnderpricedDappGasFeesFlags =\n    featureFlags?.[FeatureFlag.Transactions]?.replaceUnderpricedDappGasFees;\n\n  return (\n    replaceUnderpricedDappGasFeesFlags?.perChainConfig?.[chainId] ??\n    replaceUnderpricedDappGasFeesFlags?.default ??\n    false\n  );\n}\n\n/**\n * Retrieves whether underpriced saved (advanced) gas fee preferences should be\n * ignored in favour of the wallet's suggested fees.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns Whether the replacement is enabled.\n */\nexport function getReplaceUnderpricedSavedGasFeesEnabled(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): boolean {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const replaceUnderpricedSavedGasFeesFlags =\n    featureFlags?.[FeatureFlag.Transactions]?.replaceUnderpricedSavedGasFees;\n\n  return (\n    replaceUnderpricedSavedGasFeesFlags?.perChainConfig?.[chainId] ??\n    replaceUnderpricedSavedGasFeesFlags?.default ??\n    false\n  );\n}\n\n/**\n * Retrieves the relevant feature flags from the remote feature flag controller.\n *\n * @param messenger - The messenger instance.\n * @returns The feature flags.\n */\nfunction getFeatureFlags(\n  messenger: TransactionControllerMessenger,\n): TransactionControllerFeatureFlags | undefined {\n  try {\n    const featureFlags = messenger.call(\n      'RemoteFeatureFlagController:getState',\n    ).remoteFeatureFlags;\n\n    log('Retrieved feature flags', featureFlags);\n\n    return featureFlags as TransactionControllerFeatureFlags;\n  } catch {\n    log('RemoteFeatureFlagController not available');\n    return undefined;\n  }\n}\n"]}

package/dist/utils/first-time-interaction.cjs

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateFirstTimeInteraction = void 0;
+const utils_1 = require("@metamask/utils");
+const accounts_api_js_1 = require("../api/accounts-api.cjs");
+const logger_js_1 = require("../logger.cjs");
+const recipient_js_1 = require("./recipient.cjs");
+const validation_js_1 = require("./validation.cjs");
+/**
+ * Updates the first-time interaction status for a transaction.
+ *
+ * @param params - The parameters for updating first time interaction.
+ * @param params.existingTransactions - The existing transactions.
+ * @param params.getTransaction - Function to get a transaction by ID.
+ * @param params.isFirstTimeInteractionEnabled - The function to check if first time interaction is enabled.
+ * @param params.trace - The trace callback.
+ * @param params.traceContext - The trace context.
+ * @param params.transactionMeta - The transaction meta object.
+ * @param params.updateTransaction - Function to update transaction internal state.
+ * @returns Promise that resolves when the update is complete.
+ */
+async function updateFirstTimeInteraction({ existingTransactions, getTransaction, isFirstTimeInteractionEnabled, trace, traceContext, transactionMeta, updateTransaction, }) {
+    if (!isFirstTimeInteractionEnabled()) {
+        return;
+    }
+    const { chainId, id: transactionId, txParams: { from }, } = transactionMeta;
+    const recipient = (0, recipient_js_1.getEffectiveRecipient)(transactionMeta);
+    const request = {
+        chainId: (0, utils_1.hexToNumber)(chainId),
+        to: recipient,
+        from,
+    };
+    (0, validation_js_1.validateParamTo)(recipient);
+    const recipientLower = recipient?.toLowerCase();
+    const existingTransaction = existingTransactions.find((tx) => tx.id !== transactionId &&
+        tx.chainId === chainId &&
+        tx.txParams?.from?.toLowerCase() === from?.toLowerCase() &&
+        (0, recipient_js_1.getEffectiveRecipient)(tx)?.toLowerCase() === recipientLower);
+    // Skip API call only if we already have a tx with same from and same effective recipient (e.g. duplicate or pending).
+    // For token transfers (ERC20/ERC721/ERC1155), effective recipient is decoded from data; using txParams.to
+    // would wrongly match any send of the same token contract.
+    if (existingTransaction) {
+        return;
+    }
+    try {
+        const { count } = await trace({ name: 'Account Address Relationship', parentContext: traceContext }, () => (0, accounts_api_js_1.getAccountAddressRelationship)(request));
+        const isFirstTimeInteraction = count === undefined ? undefined : count === 0;
+        const finalTransactionMeta = getTransaction(transactionId);
+        /* istanbul ignore if */
+        if (!finalTransactionMeta) {
+            (0, logger_js_1.projectLogger)('Cannot update first time interaction as transaction not found', transactionId);
+            return;
+        }
+        updateTransaction({
+            transactionId,
+            note: 'TransactionController#updateFirstInteraction - Update first time interaction',
+        }, (txMeta) => {
+            txMeta.isFirstTimeInteraction = isFirstTimeInteraction;
+        });
+        (0, logger_js_1.projectLogger)('Updated first time interaction', transactionId, {
+            isFirstTimeInteraction,
+        });
+    }
+    catch (error) {
+        (0, logger_js_1.projectLogger)('Error fetching account address relationship, skipping first time interaction update', error);
+    }
+}
+exports.updateFirstTimeInteraction = updateFirstTimeInteraction;
+//# sourceMappingURL=first-time-interaction.cjs.map

package/dist/utils/first-time-interaction.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-time-interaction.cjs","sourceRoot":"","sources":["../../src/utils/first-time-interaction.ts"],"names":[],"mappings":";;;AACA,2CAA8C;AAE9C,6DAAuE;AAEvE,6CAAoD;AAEpD,kDAAuD;AACvD,oDAAkD;AAkBlD;;;;;;;;;;;;GAYG;AACI,KAAK,UAAU,0BAA0B,CAAC,EAC/C,oBAAoB,EACpB,cAAc,EACd,6BAA6B,EAC7B,KAAK,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,GACiB;IAClC,IAAI,CAAC,6BAA6B,EAAE,EAAE,CAAC;QACrC,OAAO;IACT,CAAC;IAED,MAAM,EACJ,OAAO,EACP,EAAE,EAAE,aAAa,EACjB,QAAQ,EAAE,EAAE,IAAI,EAAE,GACnB,GAAG,eAAe,CAAC;IAEpB,MAAM,SAAS,GAAG,IAAA,oCAAqB,EAAC,eAAe,CAAC,CAAC;IAEzD,MAAM,OAAO,GAAyC;QACpD,OAAO,EAAE,IAAA,mBAAW,EAAC,OAAO,CAAC;QAC7B,EAAE,EAAE,SAAmB;QACvB,IAAI;KACL,CAAC;IAEF,IAAA,+BAAe,EAAC,SAAS,CAAC,CAAC;IAE3B,MAAM,cAAc,GAAG,SAAS,EAAE,WAAW,EAAE,CAAC;IAChD,MAAM,mBAAmB,GAAG,oBAAoB,CAAC,IAAI,CACnD,CAAC,EAAE,EAAE,EAAE,CACL,EAAE,CAAC,EAAE,KAAK,aAAa;QACvB,EAAE,CAAC,OAAO,KAAK,OAAO;QACtB,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE,WAAW,EAAE;QACxD,IAAA,oCAAqB,EAAC,EAAE,CAAC,EAAE,WAAW,EAAE,KAAK,cAAc,CAC9D,CAAC;IAEF,sHAAsH;IACtH,0GAA0G;IAC1G,2DAA2D;IAC3D,IAAI,mBAAmB,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,KAAK,CAC3B,EAAE,IAAI,EAAE,8BAA8B,EAAE,aAAa,EAAE,YAAY,EAAE,EACrE,GAAG,EAAE,CAAC,IAAA,+CAA6B,EAAC,OAAO,CAAC,CAC7C,CAAC;QAEF,MAAM,sBAAsB,GAC1B,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC;QAEhD,MAAM,oBAAoB,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;QAE3D,wBAAwB;QACxB,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC1B,IAAA,yBAAG,EACD,+DAA+D,EAC/D,aAAa,CACd,CAAC;YACF,OAAO;QACT,CAAC;QAED,iBAAiB,CACf;YACE,aAAa;YACb,IAAI,EAAE,8EAA8E;SACrF,EACD,CAAC,MAAM,EAAE,EAAE;YACT,MAAM,CAAC,sBAAsB,GAAG,sBAAsB,CAAC;QACzD,CAAC,CACF,CAAC;QAEF,IAAA,yBAAG,EAAC,gCAAgC,EAAE,aAAa,EAAE;YACnD,sBAAsB;SACvB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAA,yBAAG,EACD,qFAAqF,EACrF,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC;AApFD,gEAoFC","sourcesContent":["import type { TraceContext, TraceCallback } from '@metamask/controller-utils';\nimport { hexToNumber } from '@metamask/utils';\n\nimport { getAccountAddressRelationship } from '../api/accounts-api.js';\nimport type { GetAccountAddressRelationshipRequest } from '../api/accounts-api.js';\nimport { projectLogger as log } from '../logger.js';\nimport type { TransactionMeta } from '../types.js';\nimport { getEffectiveRecipient } from './recipient.js';\nimport { validateParamTo } from './validation.js';\n\ntype UpdateFirstTimeInteractionRequest = {\n  existingTransactions: TransactionMeta[];\n  getTransaction: (transactionId: string) => TransactionMeta | undefined;\n  isFirstTimeInteractionEnabled: () => boolean;\n  trace: TraceCallback;\n  traceContext?: TraceContext;\n  transactionMeta: TransactionMeta;\n  updateTransaction: (\n    updateParams: {\n      transactionId: string;\n      note: string;\n    },\n    updater: (txMeta: TransactionMeta) => void,\n  ) => void;\n};\n\n/**\n * Updates the first-time interaction status for a transaction.\n *\n * @param params - The parameters for updating first time interaction.\n * @param params.existingTransactions - The existing transactions.\n * @param params.getTransaction - Function to get a transaction by ID.\n * @param params.isFirstTimeInteractionEnabled - The function to check if first time interaction is enabled.\n * @param params.trace - The trace callback.\n * @param params.traceContext - The trace context.\n * @param params.transactionMeta - The transaction meta object.\n * @param params.updateTransaction - Function to update transaction internal state.\n * @returns Promise that resolves when the update is complete.\n */\nexport async function updateFirstTimeInteraction({\n  existingTransactions,\n  getTransaction,\n  isFirstTimeInteractionEnabled,\n  trace,\n  traceContext,\n  transactionMeta,\n  updateTransaction,\n}: UpdateFirstTimeInteractionRequest): Promise<void> {\n  if (!isFirstTimeInteractionEnabled()) {\n    return;\n  }\n\n  const {\n    chainId,\n    id: transactionId,\n    txParams: { from },\n  } = transactionMeta;\n\n  const recipient = getEffectiveRecipient(transactionMeta);\n\n  const request: GetAccountAddressRelationshipRequest = {\n    chainId: hexToNumber(chainId),\n    to: recipient as string,\n    from,\n  };\n\n  validateParamTo(recipient);\n\n  const recipientLower = recipient?.toLowerCase();\n  const existingTransaction = existingTransactions.find(\n    (tx) =>\n      tx.id !== transactionId &&\n      tx.chainId === chainId &&\n      tx.txParams?.from?.toLowerCase() === from?.toLowerCase() &&\n      getEffectiveRecipient(tx)?.toLowerCase() === recipientLower,\n  );\n\n  // Skip API call only if we already have a tx with same from and same effective recipient (e.g. duplicate or pending).\n  // For token transfers (ERC20/ERC721/ERC1155), effective recipient is decoded from data; using txParams.to\n  // would wrongly match any send of the same token contract.\n  if (existingTransaction) {\n    return;\n  }\n\n  try {\n    const { count } = await trace(\n      { name: 'Account Address Relationship', parentContext: traceContext },\n      () => getAccountAddressRelationship(request),\n    );\n\n    const isFirstTimeInteraction =\n      count === undefined ? undefined : count === 0;\n\n    const finalTransactionMeta = getTransaction(transactionId);\n\n    /* istanbul ignore if */\n    if (!finalTransactionMeta) {\n      log(\n        'Cannot update first time interaction as transaction not found',\n        transactionId,\n      );\n      return;\n    }\n\n    updateTransaction(\n      {\n        transactionId,\n        note: 'TransactionController#updateFirstInteraction - Update first time interaction',\n      },\n      (txMeta) => {\n        txMeta.isFirstTimeInteraction = isFirstTimeInteraction;\n      },\n    );\n\n    log('Updated first time interaction', transactionId, {\n      isFirstTimeInteraction,\n    });\n  } catch (error) {\n    log(\n      'Error fetching account address relationship, skipping first time interaction update',\n      error,\n    );\n  }\n}\n"]}

package/dist/utils/{first-time-interaction.d.ts → first-time-interaction.d.cts}

@@ -1,5 +1,5 @@
-import type { TraceContext, TraceCallback } from '@metamask/controller-utils';
-import type { TransactionMeta } from '../types.js';
+import type { TraceContext, TraceCallback } from "@metamask/controller-utils";
+import type { TransactionMeta } from "../types.cjs";
 type UpdateFirstTimeInteractionRequest = {
     existingTransactions: TransactionMeta[];
     getTransaction: (transactionId: string) => TransactionMeta | undefined;
@@ -27,4 +27,4 @@ type UpdateFirstTimeInteractionRequest = {
  */
 export declare function updateFirstTimeInteraction({ existingTransactions, getTransaction, isFirstTimeInteractionEnabled, trace, traceContext, transactionMeta, updateTransaction, }: UpdateFirstTimeInteractionRequest): Promise<void>;
 export {};
-//# sourceMappingURL=first-time-interaction.d.ts.map
+//# sourceMappingURL=first-time-interaction.d.cts.map

package/dist/utils/first-time-interaction.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-time-interaction.d.cts","sourceRoot":"","sources":["../../src/utils/first-time-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,mCAAmC;AAM9E,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAoB;AAInD,KAAK,iCAAiC,GAAG;IACvC,oBAAoB,EAAE,eAAe,EAAE,CAAC;IACxC,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,CAAC;IACvE,6BAA6B,EAAE,MAAM,OAAO,CAAC;IAC7C,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,eAAe,EAAE,eAAe,CAAC;IACjC,iBAAiB,EAAE,CACjB,YAAY,EAAE;QACZ,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;KACd,EACD,OAAO,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,KACvC,IAAI,CAAC;CACX,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAsB,0BAA0B,CAAC,EAC/C,oBAAoB,EACpB,cAAc,EACd,6BAA6B,EAC7B,KAAK,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,GAClB,EAAE,iCAAiC,GAAG,OAAO,CAAC,IAAI,CAAC,CA4EnD"}

package/dist/utils/first-time-interaction.d.mts

@@ -0,0 +1,30 @@
+import type { TraceContext, TraceCallback } from "@metamask/controller-utils";
+import type { TransactionMeta } from "../types.mjs";
+type UpdateFirstTimeInteractionRequest = {
+    existingTransactions: TransactionMeta[];
+    getTransaction: (transactionId: string) => TransactionMeta | undefined;
+    isFirstTimeInteractionEnabled: () => boolean;
+    trace: TraceCallback;
+    traceContext?: TraceContext;
+    transactionMeta: TransactionMeta;
+    updateTransaction: (updateParams: {
+        transactionId: string;
+        note: string;
+    }, updater: (txMeta: TransactionMeta) => void) => void;
+};
+/**
+ * Updates the first-time interaction status for a transaction.
+ *
+ * @param params - The parameters for updating first time interaction.
+ * @param params.existingTransactions - The existing transactions.
+ * @param params.getTransaction - Function to get a transaction by ID.
+ * @param params.isFirstTimeInteractionEnabled - The function to check if first time interaction is enabled.
+ * @param params.trace - The trace callback.
+ * @param params.traceContext - The trace context.
+ * @param params.transactionMeta - The transaction meta object.
+ * @param params.updateTransaction - Function to update transaction internal state.
+ * @returns Promise that resolves when the update is complete.
+ */
+export declare function updateFirstTimeInteraction({ existingTransactions, getTransaction, isFirstTimeInteractionEnabled, trace, traceContext, transactionMeta, updateTransaction, }: UpdateFirstTimeInteractionRequest): Promise<void>;
+export {};
+//# sourceMappingURL=first-time-interaction.d.mts.map

package/dist/utils/first-time-interaction.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-time-interaction.d.mts","sourceRoot":"","sources":["../../src/utils/first-time-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,mCAAmC;AAM9E,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAoB;AAInD,KAAK,iCAAiC,GAAG;IACvC,oBAAoB,EAAE,eAAe,EAAE,CAAC;IACxC,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,CAAC;IACvE,6BAA6B,EAAE,MAAM,OAAO,CAAC;IAC7C,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,eAAe,EAAE,eAAe,CAAC;IACjC,iBAAiB,EAAE,CACjB,YAAY,EAAE;QACZ,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;KACd,EACD,OAAO,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,KACvC,IAAI,CAAC;CACX,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAsB,0BAA0B,CAAC,EAC/C,oBAAoB,EACpB,cAAc,EACd,6BAA6B,EAC7B,KAAK,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,GAClB,EAAE,iCAAiC,GAAG,OAAO,CAAC,IAAI,CAAC,CA4EnD"}

package/dist/utils/{first-time-interaction.js → first-time-interaction.mjs}

@@ -1,8 +1,8 @@
-import { hexToNumber } from '@metamask/utils';
-import { getAccountAddressRelationship } from '../api/accounts-api.js';
-import { projectLogger as log } from '../logger.js';
-import { getEffectiveRecipient } from './recipient.js';
-import { validateParamTo } from './validation.js';
+import { hexToNumber } from "@metamask/utils";
+import { getAccountAddressRelationship } from "../api/accounts-api.mjs";
+import { projectLogger as log } from "../logger.mjs";
+import { getEffectiveRecipient } from "./recipient.mjs";
+import { validateParamTo } from "./validation.mjs";
 /**
  * Updates the first-time interaction status for a transaction.
  *
@@ -62,4 +62,4 @@ export async function updateFirstTimeInteraction({ existingTransactions, getTran
         log('Error fetching account address relationship, skipping first time interaction update', error);
     }
 }
-//# sourceMappingURL=first-time-interaction.js.map
+//# sourceMappingURL=first-time-interaction.mjs.map

package/dist/utils/first-time-interaction.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-time-interaction.mjs","sourceRoot":"","sources":["../../src/utils/first-time-interaction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,wBAAwB;AAE9C,OAAO,EAAE,6BAA6B,EAAE,gCAA+B;AAEvE,OAAO,EAAE,aAAa,IAAI,GAAG,EAAE,sBAAqB;AAEpD,OAAO,EAAE,qBAAqB,EAAE,wBAAuB;AACvD,OAAO,EAAE,eAAe,EAAE,yBAAwB;AAkBlD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,EAC/C,oBAAoB,EACpB,cAAc,EACd,6BAA6B,EAC7B,KAAK,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,GACiB;IAClC,IAAI,CAAC,6BAA6B,EAAE,EAAE,CAAC;QACrC,OAAO;IACT,CAAC;IAED,MAAM,EACJ,OAAO,EACP,EAAE,EAAE,aAAa,EACjB,QAAQ,EAAE,EAAE,IAAI,EAAE,GACnB,GAAG,eAAe,CAAC;IAEpB,MAAM,SAAS,GAAG,qBAAqB,CAAC,eAAe,CAAC,CAAC;IAEzD,MAAM,OAAO,GAAyC;QACpD,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC;QAC7B,EAAE,EAAE,SAAmB;QACvB,IAAI;KACL,CAAC;IAEF,eAAe,CAAC,SAAS,CAAC,CAAC;IAE3B,MAAM,cAAc,GAAG,SAAS,EAAE,WAAW,EAAE,CAAC;IAChD,MAAM,mBAAmB,GAAG,oBAAoB,CAAC,IAAI,CACnD,CAAC,EAAE,EAAE,EAAE,CACL,EAAE,CAAC,EAAE,KAAK,aAAa;QACvB,EAAE,CAAC,OAAO,KAAK,OAAO;QACtB,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE,WAAW,EAAE;QACxD,qBAAqB,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,KAAK,cAAc,CAC9D,CAAC;IAEF,sHAAsH;IACtH,0GAA0G;IAC1G,2DAA2D;IAC3D,IAAI,mBAAmB,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,KAAK,CAC3B,EAAE,IAAI,EAAE,8BAA8B,EAAE,aAAa,EAAE,YAAY,EAAE,EACrE,GAAG,EAAE,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAC7C,CAAC;QAEF,MAAM,sBAAsB,GAC1B,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC;QAEhD,MAAM,oBAAoB,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;QAE3D,wBAAwB;QACxB,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC1B,GAAG,CACD,+DAA+D,EAC/D,aAAa,CACd,CAAC;YACF,OAAO;QACT,CAAC;QAED,iBAAiB,CACf;YACE,aAAa;YACb,IAAI,EAAE,8EAA8E;SACrF,EACD,CAAC,MAAM,EAAE,EAAE;YACT,MAAM,CAAC,sBAAsB,GAAG,sBAAsB,CAAC;QACzD,CAAC,CACF,CAAC;QAEF,GAAG,CAAC,gCAAgC,EAAE,aAAa,EAAE;YACnD,sBAAsB;SACvB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CACD,qFAAqF,EACrF,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import type { TraceContext, TraceCallback } from '@metamask/controller-utils';\nimport { hexToNumber } from '@metamask/utils';\n\nimport { getAccountAddressRelationship } from '../api/accounts-api.js';\nimport type { GetAccountAddressRelationshipRequest } from '../api/accounts-api.js';\nimport { projectLogger as log } from '../logger.js';\nimport type { TransactionMeta } from '../types.js';\nimport { getEffectiveRecipient } from './recipient.js';\nimport { validateParamTo } from './validation.js';\n\ntype UpdateFirstTimeInteractionRequest = {\n  existingTransactions: TransactionMeta[];\n  getTransaction: (transactionId: string) => TransactionMeta | undefined;\n  isFirstTimeInteractionEnabled: () => boolean;\n  trace: TraceCallback;\n  traceContext?: TraceContext;\n  transactionMeta: TransactionMeta;\n  updateTransaction: (\n    updateParams: {\n      transactionId: string;\n      note: string;\n    },\n    updater: (txMeta: TransactionMeta) => void,\n  ) => void;\n};\n\n/**\n * Updates the first-time interaction status for a transaction.\n *\n * @param params - The parameters for updating first time interaction.\n * @param params.existingTransactions - The existing transactions.\n * @param params.getTransaction - Function to get a transaction by ID.\n * @param params.isFirstTimeInteractionEnabled - The function to check if first time interaction is enabled.\n * @param params.trace - The trace callback.\n * @param params.traceContext - The trace context.\n * @param params.transactionMeta - The transaction meta object.\n * @param params.updateTransaction - Function to update transaction internal state.\n * @returns Promise that resolves when the update is complete.\n */\nexport async function updateFirstTimeInteraction({\n  existingTransactions,\n  getTransaction,\n  isFirstTimeInteractionEnabled,\n  trace,\n  traceContext,\n  transactionMeta,\n  updateTransaction,\n}: UpdateFirstTimeInteractionRequest): Promise<void> {\n  if (!isFirstTimeInteractionEnabled()) {\n    return;\n  }\n\n  const {\n    chainId,\n    id: transactionId,\n    txParams: { from },\n  } = transactionMeta;\n\n  const recipient = getEffectiveRecipient(transactionMeta);\n\n  const request: GetAccountAddressRelationshipRequest = {\n    chainId: hexToNumber(chainId),\n    to: recipient as string,\n    from,\n  };\n\n  validateParamTo(recipient);\n\n  const recipientLower = recipient?.toLowerCase();\n  const existingTransaction = existingTransactions.find(\n    (tx) =>\n      tx.id !== transactionId &&\n      tx.chainId === chainId &&\n      tx.txParams?.from?.toLowerCase() === from?.toLowerCase() &&\n      getEffectiveRecipient(tx)?.toLowerCase() === recipientLower,\n  );\n\n  // Skip API call only if we already have a tx with same from and same effective recipient (e.g. duplicate or pending).\n  // For token transfers (ERC20/ERC721/ERC1155), effective recipient is decoded from data; using txParams.to\n  // would wrongly match any send of the same token contract.\n  if (existingTransaction) {\n    return;\n  }\n\n  try {\n    const { count } = await trace(\n      { name: 'Account Address Relationship', parentContext: traceContext },\n      () => getAccountAddressRelationship(request),\n    );\n\n    const isFirstTimeInteraction =\n      count === undefined ? undefined : count === 0;\n\n    const finalTransactionMeta = getTransaction(transactionId);\n\n    /* istanbul ignore if */\n    if (!finalTransactionMeta) {\n      log(\n        'Cannot update first time interaction as transaction not found',\n        transactionId,\n      );\n      return;\n    }\n\n    updateTransaction(\n      {\n        transactionId,\n        note: 'TransactionController#updateFirstInteraction - Update first time interaction',\n      },\n      (txMeta) => {\n        txMeta.isFirstTimeInteraction = isFirstTimeInteraction;\n      },\n    );\n\n    log('Updated first time interaction', transactionId, {\n      isFirstTimeInteraction,\n    });\n  } catch (error) {\n    log(\n      'Error fetching account address relationship, skipping first time interaction update',\n      error,\n    );\n  }\n}\n"]}