@metamask-previews/transaction-controller 69.3.0-preview-2296abeaf → 69.3.0-preview-5da60b6

package/CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Export `getEffectiveRecipient` utility that returns the actual recipient of a transaction, decoding it from calldata for ERC-20/ERC-721/ERC-1155 token transfer methods where `txParams.to` is the token contract ([#9699](https://github.com/MetaMask/core/pull/9699))
+
 ## [69.3.0]
 
 ### Added

package/dist/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateBatchId = exports.getAccountAddressRelationship = exports.HARDFORK = exports.CHAIN_IDS = exports.hasTransactionType = exports.normalizeTransactionParams = exports.isEIP1559Transaction = exports.updateEIP7702BatchData = exports.generateEIP7702BatchTransaction = exports.decodeAuthorizationSignature = exports.mergeGasFeeEstimates = exports.WalletDevice = exports.UserFeeLevel = exports.TransactionType = exports.TransactionStatus = exports.TransactionEnvelopeType = exports.TransactionContainerType = exports.SimulationTokenStandard = exports.SimulationErrorCode = exports.GasFeeEstimateType = exports.GasFeeEstimateLevel = exports.TransactionController = exports.SPEED_UP_RATE = exports.CANCEL_RATE = void 0;
+exports.generateBatchId = exports.getAccountAddressRelationship = exports.HARDFORK = exports.CHAIN_IDS = exports.getEffectiveRecipient = exports.hasTransactionType = exports.normalizeTransactionParams = exports.isEIP1559Transaction = exports.updateEIP7702BatchData = exports.generateEIP7702BatchTransaction = exports.decodeAuthorizationSignature = exports.mergeGasFeeEstimates = exports.WalletDevice = exports.UserFeeLevel = exports.TransactionType = exports.TransactionStatus = exports.TransactionEnvelopeType = exports.TransactionContainerType = exports.SimulationTokenStandard = exports.SimulationErrorCode = exports.GasFeeEstimateType = exports.GasFeeEstimateLevel = exports.TransactionController = exports.SPEED_UP_RATE = exports.CANCEL_RATE = void 0;
 var TransactionController_js_1 = require("./TransactionController.cjs");
 Object.defineProperty(exports, "CANCEL_RATE", { enumerable: true, get: function () { return TransactionController_js_1.CANCEL_RATE; } });
 Object.defineProperty(exports, "SPEED_UP_RATE", { enumerable: true, get: function () { return TransactionController_js_1.SPEED_UP_RATE; } });
@@ -27,6 +27,8 @@ Object.defineProperty(exports, "isEIP1559Transaction", { enumerable: true, get:
 Object.defineProperty(exports, "normalizeTransactionParams", { enumerable: true, get: function () { return utils_js_1.normalizeTransactionParams; } });
 var transaction_type_js_1 = require("./utils/transaction-type.cjs");
 Object.defineProperty(exports, "hasTransactionType", { enumerable: true, get: function () { return transaction_type_js_1.hasTransactionType; } });
+var recipient_js_1 = require("./utils/recipient.cjs");
+Object.defineProperty(exports, "getEffectiveRecipient", { enumerable: true, get: function () { return recipient_js_1.getEffectiveRecipient; } });
 var constants_js_1 = require("./constants.cjs");
 Object.defineProperty(exports, "CHAIN_IDS", { enumerable: true, get: function () { return constants_js_1.CHAIN_IDS; } });
 var prepare_js_1 = require("./utils/prepare.cjs");

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AA4DA,wEAIoC;AAHlC,uHAAA,WAAW,OAAA;AACX,yHAAA,aAAa,OAAA;AACb,iIAAA,qBAAqB,OAAA;AAyDvB,wCAWoB;AAVlB,+GAAA,mBAAmB,OAAA;AACnB,8GAAA,kBAAkB,OAAA;AAClB,+GAAA,mBAAmB,OAAA;AACnB,mHAAA,uBAAuB,OAAA;AACvB,oHAAA,wBAAwB,OAAA;AACxB,mHAAA,uBAAuB,OAAA;AACvB,6GAAA,iBAAiB,OAAA;AACjB,2GAAA,eAAe,OAAA;AACf,wGAAA,YAAY,OAAA;AACZ,wGAAA,YAAY,OAAA;AAEd,oDAA2D;AAAlD,mHAAA,oBAAoB,OAAA;AAC7B,kDAI4B;AAH1B,0HAAA,4BAA4B,OAAA;AAC5B,6HAAA,+BAA+B,OAAA;AAC/B,oHAAA,sBAAsB,OAAA;AAExB,8CAG0B;AAFxB,gHAAA,oBAAoB,OAAA;AACpB,sHAAA,0BAA0B,OAAA;AAE5B,oEAAiE;AAAxD,yHAAA,kBAAkB,OAAA;AAC3B,gDAA2C;AAAlC,yGAAA,SAAS,OAAA;AAClB,kDAA8C;AAArC,sGAAA,QAAQ,OAAA;AACjB,0DAAsE;AAA7D,gIAAA,6BAA6B,OAAA;AAKtC,8CAAmD;AAA1C,2GAAA,eAAe,OAAA","sourcesContent":["export type {\n  MethodData,\n  Result,\n  TransactionControllerActions,\n  TransactionControllerEvents,\n  TransactionControllerGetStateAction,\n  TransactionControllerPostTransactionBalanceUpdatedEvent,\n  TransactionControllerSpeedupTransactionAddedEvent,\n  TransactionControllerState,\n  TransactionControllerStateChangeEvent,\n  TransactionControllerTransactionApprovedEvent,\n  TransactionControllerTransactionConfirmedEvent,\n  TransactionControllerTransactionDroppedEvent,\n  TransactionControllerTransactionFailedEvent,\n  TransactionControllerTransactionFinishedEvent,\n  TransactionControllerTransactionNewSwapApprovalEvent,\n  TransactionControllerTransactionNewSwapEvent,\n  TransactionControllerTransactionPublishingSkipped,\n  TransactionControllerTransactionRejectedEvent,\n  TransactionControllerTransactionStatusUpdatedEvent,\n  TransactionControllerTransactionSubmittedEvent,\n  TransactionControllerUnapprovedTransactionAddedEvent,\n  TransactionControllerMessenger,\n  TransactionControllerOptions,\n} from './TransactionController.js';\nexport type {\n  TransactionControllerAddTransactionAction,\n  TransactionControllerAddTransactionBatchAction,\n  TransactionControllerConfirmExternalTransactionAction,\n  TransactionControllerEmulateNewTransactionAction,\n  TransactionControllerEmulateTransactionUpdateAction,\n  TransactionControllerEstimateGasAction,\n  TransactionControllerEstimateGasBatchAction,\n  TransactionControllerGetGasFeeTokensAction,\n  TransactionControllerGetNonceLockAction,\n  TransactionControllerGetTransactionsAction,\n  TransactionControllerUpdateCustodialTransactionAction,\n  TransactionControllerUpdateTransactionAction,\n  TransactionControllerUpdateTransactionMetadataAction,\n  TransactionControllerHandleMethodDataAction,\n  TransactionControllerIsAtomicBatchSupportedAction,\n  TransactionControllerStopTransactionAction,\n  TransactionControllerSpeedUpTransactionAction,\n  TransactionControllerEstimateGasBufferedAction,\n  TransactionControllerUpdateEditableParamsAction,\n  TransactionControllerSetTransactionActiveAction,\n  TransactionControllerApproveTransactionsWithSameNonceAction,\n  TransactionControllerEstimateGasFeeAction,\n  TransactionControllerFailTransactionAction,\n  TransactionControllerGetLayer1GasFeeAction,\n  TransactionControllerClearUnapprovedTransactionsAction,\n  TransactionControllerAbortTransactionSigningAction,\n  TransactionControllerUpdateAtomicBatchDataAction,\n  TransactionControllerWipeTransactionsAction,\n  TransactionControllerUpdateSecurityAlertResponseAction,\n  TransactionControllerUpdateTransactionGasFeesAction,\n  TransactionControllerUpdatePreviousGasParamsAction,\n  TransactionControllerUpdateSelectedGasFeeTokenAction,\n  TransactionControllerUpdateRequiredTransactionIdsAction,\n} from './TransactionController-method-action-types.js';\nexport {\n  CANCEL_RATE,\n  SPEED_UP_RATE,\n  TransactionController,\n} from './TransactionController.js';\nexport type {\n  AddTransactionOptions,\n  AfterAddHook,\n  Authorization,\n  AuthorizationList,\n  BatchTransaction,\n  BatchTransactionParams,\n  BeforeSignHook,\n  DappSuggestedGasFees,\n  DefaultGasEstimates,\n  FeeMarketEIP1559Values,\n  FeeMarketGasFeeEstimateForLevel,\n  FeeMarketGasFeeEstimates,\n  GasFeeEstimates,\n  GasFeeToken,\n  GasPriceGasFeeEstimates,\n  GasPriceValue,\n  GetGasFeeTokensRequest,\n  GetSimulationConfig,\n  InferTransactionTypeResult,\n  IsAtomicBatchSupportedRequest,\n  IsAtomicBatchSupportedResult,\n  IsAtomicBatchSupportedResultEntry,\n  LegacyGasFeeEstimates,\n  Log,\n  MetamaskPayMetadata,\n  NestedTransactionMetadata,\n  NestedTransactionUpdate,\n  PublishBatchHook,\n  PublishBatchHookRequest,\n  PublishBatchHookResult,\n  PublishBatchHookTransaction,\n  PublishHook,\n  PublishHookResult,\n  RequiredAsset,\n  SavedGasFees,\n  SecurityAlertResponse,\n  SendFlowHistoryEntry,\n  SimulationBalanceChange,\n  SimulationData,\n  SimulationError,\n  SimulationToken,\n  SimulationTokenBalanceChange,\n  TransactionBatchMeta,\n  TransactionBatchRequest,\n  TransactionBatchResult,\n  TransactionBatchSingleRequest,\n  TransactionError,\n  TransactionHistory,\n  TransactionHistoryEntry,\n  TransactionMeta,\n  TransactionParams,\n  TransactionReceipt,\n  ValidateSecurityRequest,\n} from './types.js';\nexport {\n  GasFeeEstimateLevel,\n  GasFeeEstimateType,\n  SimulationErrorCode,\n  SimulationTokenStandard,\n  TransactionContainerType,\n  TransactionEnvelopeType,\n  TransactionStatus,\n  TransactionType,\n  UserFeeLevel,\n  WalletDevice,\n} from './types.js';\nexport { mergeGasFeeEstimates } from './utils/gas-flow.js';\nexport {\n  decodeAuthorizationSignature,\n  generateEIP7702BatchTransaction,\n  updateEIP7702BatchData,\n} from './utils/eip7702.js';\nexport {\n  isEIP1559Transaction,\n  normalizeTransactionParams,\n} from './utils/utils.js';\nexport { hasTransactionType } from './utils/transaction-type.js';\nexport { CHAIN_IDS } from './constants.js';\nexport { HARDFORK } from './utils/prepare.js';\nexport { getAccountAddressRelationship } from './api/accounts-api.js';\nexport type {\n  GetAccountAddressRelationshipRequest,\n  AccountAddressRelationshipResult,\n} from './api/accounts-api.js';\nexport { generateBatchId } from './utils/batch.js';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AA4DA,wEAIoC;AAHlC,uHAAA,WAAW,OAAA;AACX,yHAAA,aAAa,OAAA;AACb,iIAAA,qBAAqB,OAAA;AAyDvB,wCAWoB;AAVlB,+GAAA,mBAAmB,OAAA;AACnB,8GAAA,kBAAkB,OAAA;AAClB,+GAAA,mBAAmB,OAAA;AACnB,mHAAA,uBAAuB,OAAA;AACvB,oHAAA,wBAAwB,OAAA;AACxB,mHAAA,uBAAuB,OAAA;AACvB,6GAAA,iBAAiB,OAAA;AACjB,2GAAA,eAAe,OAAA;AACf,wGAAA,YAAY,OAAA;AACZ,wGAAA,YAAY,OAAA;AAEd,oDAA2D;AAAlD,mHAAA,oBAAoB,OAAA;AAC7B,kDAI4B;AAH1B,0HAAA,4BAA4B,OAAA;AAC5B,6HAAA,+BAA+B,OAAA;AAC/B,oHAAA,sBAAsB,OAAA;AAExB,8CAG0B;AAFxB,gHAAA,oBAAoB,OAAA;AACpB,sHAAA,0BAA0B,OAAA;AAE5B,oEAAiE;AAAxD,yHAAA,kBAAkB,OAAA;AAC3B,sDAA6D;AAApD,qHAAA,qBAAqB,OAAA;AAC9B,gDAA2C;AAAlC,yGAAA,SAAS,OAAA;AAClB,kDAA8C;AAArC,sGAAA,QAAQ,OAAA;AACjB,0DAAsE;AAA7D,gIAAA,6BAA6B,OAAA;AAKtC,8CAAmD;AAA1C,2GAAA,eAAe,OAAA","sourcesContent":["export type {\n  MethodData,\n  Result,\n  TransactionControllerActions,\n  TransactionControllerEvents,\n  TransactionControllerGetStateAction,\n  TransactionControllerPostTransactionBalanceUpdatedEvent,\n  TransactionControllerSpeedupTransactionAddedEvent,\n  TransactionControllerState,\n  TransactionControllerStateChangeEvent,\n  TransactionControllerTransactionApprovedEvent,\n  TransactionControllerTransactionConfirmedEvent,\n  TransactionControllerTransactionDroppedEvent,\n  TransactionControllerTransactionFailedEvent,\n  TransactionControllerTransactionFinishedEvent,\n  TransactionControllerTransactionNewSwapApprovalEvent,\n  TransactionControllerTransactionNewSwapEvent,\n  TransactionControllerTransactionPublishingSkipped,\n  TransactionControllerTransactionRejectedEvent,\n  TransactionControllerTransactionStatusUpdatedEvent,\n  TransactionControllerTransactionSubmittedEvent,\n  TransactionControllerUnapprovedTransactionAddedEvent,\n  TransactionControllerMessenger,\n  TransactionControllerOptions,\n} from './TransactionController.js';\nexport type {\n  TransactionControllerAddTransactionAction,\n  TransactionControllerAddTransactionBatchAction,\n  TransactionControllerConfirmExternalTransactionAction,\n  TransactionControllerEmulateNewTransactionAction,\n  TransactionControllerEmulateTransactionUpdateAction,\n  TransactionControllerEstimateGasAction,\n  TransactionControllerEstimateGasBatchAction,\n  TransactionControllerGetGasFeeTokensAction,\n  TransactionControllerGetNonceLockAction,\n  TransactionControllerGetTransactionsAction,\n  TransactionControllerUpdateCustodialTransactionAction,\n  TransactionControllerUpdateTransactionAction,\n  TransactionControllerUpdateTransactionMetadataAction,\n  TransactionControllerHandleMethodDataAction,\n  TransactionControllerIsAtomicBatchSupportedAction,\n  TransactionControllerStopTransactionAction,\n  TransactionControllerSpeedUpTransactionAction,\n  TransactionControllerEstimateGasBufferedAction,\n  TransactionControllerUpdateEditableParamsAction,\n  TransactionControllerSetTransactionActiveAction,\n  TransactionControllerApproveTransactionsWithSameNonceAction,\n  TransactionControllerEstimateGasFeeAction,\n  TransactionControllerFailTransactionAction,\n  TransactionControllerGetLayer1GasFeeAction,\n  TransactionControllerClearUnapprovedTransactionsAction,\n  TransactionControllerAbortTransactionSigningAction,\n  TransactionControllerUpdateAtomicBatchDataAction,\n  TransactionControllerWipeTransactionsAction,\n  TransactionControllerUpdateSecurityAlertResponseAction,\n  TransactionControllerUpdateTransactionGasFeesAction,\n  TransactionControllerUpdatePreviousGasParamsAction,\n  TransactionControllerUpdateSelectedGasFeeTokenAction,\n  TransactionControllerUpdateRequiredTransactionIdsAction,\n} from './TransactionController-method-action-types.js';\nexport {\n  CANCEL_RATE,\n  SPEED_UP_RATE,\n  TransactionController,\n} from './TransactionController.js';\nexport type {\n  AddTransactionOptions,\n  AfterAddHook,\n  Authorization,\n  AuthorizationList,\n  BatchTransaction,\n  BatchTransactionParams,\n  BeforeSignHook,\n  DappSuggestedGasFees,\n  DefaultGasEstimates,\n  FeeMarketEIP1559Values,\n  FeeMarketGasFeeEstimateForLevel,\n  FeeMarketGasFeeEstimates,\n  GasFeeEstimates,\n  GasFeeToken,\n  GasPriceGasFeeEstimates,\n  GasPriceValue,\n  GetGasFeeTokensRequest,\n  GetSimulationConfig,\n  InferTransactionTypeResult,\n  IsAtomicBatchSupportedRequest,\n  IsAtomicBatchSupportedResult,\n  IsAtomicBatchSupportedResultEntry,\n  LegacyGasFeeEstimates,\n  Log,\n  MetamaskPayMetadata,\n  NestedTransactionMetadata,\n  NestedTransactionUpdate,\n  PublishBatchHook,\n  PublishBatchHookRequest,\n  PublishBatchHookResult,\n  PublishBatchHookTransaction,\n  PublishHook,\n  PublishHookResult,\n  RequiredAsset,\n  SavedGasFees,\n  SecurityAlertResponse,\n  SendFlowHistoryEntry,\n  SimulationBalanceChange,\n  SimulationData,\n  SimulationError,\n  SimulationToken,\n  SimulationTokenBalanceChange,\n  TransactionBatchMeta,\n  TransactionBatchRequest,\n  TransactionBatchResult,\n  TransactionBatchSingleRequest,\n  TransactionError,\n  TransactionHistory,\n  TransactionHistoryEntry,\n  TransactionMeta,\n  TransactionParams,\n  TransactionReceipt,\n  ValidateSecurityRequest,\n} from './types.js';\nexport {\n  GasFeeEstimateLevel,\n  GasFeeEstimateType,\n  SimulationErrorCode,\n  SimulationTokenStandard,\n  TransactionContainerType,\n  TransactionEnvelopeType,\n  TransactionStatus,\n  TransactionType,\n  UserFeeLevel,\n  WalletDevice,\n} from './types.js';\nexport { mergeGasFeeEstimates } from './utils/gas-flow.js';\nexport {\n  decodeAuthorizationSignature,\n  generateEIP7702BatchTransaction,\n  updateEIP7702BatchData,\n} from './utils/eip7702.js';\nexport {\n  isEIP1559Transaction,\n  normalizeTransactionParams,\n} from './utils/utils.js';\nexport { hasTransactionType } from './utils/transaction-type.js';\nexport { getEffectiveRecipient } from './utils/recipient.js';\nexport { CHAIN_IDS } from './constants.js';\nexport { HARDFORK } from './utils/prepare.js';\nexport { getAccountAddressRelationship } from './api/accounts-api.js';\nexport type {\n  GetAccountAddressRelationshipRequest,\n  AccountAddressRelationshipResult,\n} from './api/accounts-api.js';\nexport { generateBatchId } from './utils/batch.js';\n"]}

package/dist/index.d.cts

@@ -7,6 +7,7 @@ export { mergeGasFeeEstimates } from "./utils/gas-flow.cjs";
 export { decodeAuthorizationSignature, generateEIP7702BatchTransaction, updateEIP7702BatchData, } from "./utils/eip7702.cjs";
 export { isEIP1559Transaction, normalizeTransactionParams, } from "./utils/utils.cjs";
 export { hasTransactionType } from "./utils/transaction-type.cjs";
+export { getEffectiveRecipient } from "./utils/recipient.cjs";
 export { CHAIN_IDS } from "./constants.cjs";
 export { HARDFORK } from "./utils/prepare.cjs";
 export { getAccountAddressRelationship } from "./api/accounts-api.cjs";

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.d.mts

@@ -7,6 +7,7 @@ export { mergeGasFeeEstimates } from "./utils/gas-flow.mjs";
 export { decodeAuthorizationSignature, generateEIP7702BatchTransaction, updateEIP7702BatchData, } from "./utils/eip7702.mjs";
 export { isEIP1559Transaction, normalizeTransactionParams, } from "./utils/utils.mjs";
 export { hasTransactionType } from "./utils/transaction-type.mjs";
+export { getEffectiveRecipient } from "./utils/recipient.mjs";
 export { CHAIN_IDS } from "./constants.mjs";
 export { HARDFORK } from "./utils/prepare.mjs";
 export { getAccountAddressRelationship } from "./api/accounts-api.mjs";

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.mjs

@@ -4,6 +4,7 @@ export { mergeGasFeeEstimates } from "./utils/gas-flow.mjs";
 export { decodeAuthorizationSignature, generateEIP7702BatchTransaction, updateEIP7702BatchData } from "./utils/eip7702.mjs";
 export { isEIP1559Transaction, normalizeTransactionParams } from "./utils/utils.mjs";
 export { hasTransactionType } from "./utils/transaction-type.mjs";
+export { getEffectiveRecipient } from "./utils/recipient.mjs";
 export { CHAIN_IDS } from "./constants.mjs";
 export { HARDFORK } from "./utils/prepare.mjs";
 export { getAccountAddressRelationship } from "./api/accounts-api.mjs";

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA4DA,OAAO,EACL,WAAW,EACX,aAAa,EACb,qBAAqB,EACtB,oCAAmC;AAwDpC,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,YAAY,EACb,oBAAmB;AACpB,OAAO,EAAE,oBAAoB,EAAE,6BAA4B;AAC3D,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAC/B,sBAAsB,EACvB,4BAA2B;AAC5B,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC3B,0BAAyB;AAC1B,OAAO,EAAE,kBAAkB,EAAE,qCAAoC;AACjE,OAAO,EAAE,SAAS,EAAE,wBAAuB;AAC3C,OAAO,EAAE,QAAQ,EAAE,4BAA2B;AAC9C,OAAO,EAAE,6BAA6B,EAAE,+BAA8B;AAKtE,OAAO,EAAE,eAAe,EAAE,0BAAyB","sourcesContent":["export type {\n  MethodData,\n  Result,\n  TransactionControllerActions,\n  TransactionControllerEvents,\n  TransactionControllerGetStateAction,\n  TransactionControllerPostTransactionBalanceUpdatedEvent,\n  TransactionControllerSpeedupTransactionAddedEvent,\n  TransactionControllerState,\n  TransactionControllerStateChangeEvent,\n  TransactionControllerTransactionApprovedEvent,\n  TransactionControllerTransactionConfirmedEvent,\n  TransactionControllerTransactionDroppedEvent,\n  TransactionControllerTransactionFailedEvent,\n  TransactionControllerTransactionFinishedEvent,\n  TransactionControllerTransactionNewSwapApprovalEvent,\n  TransactionControllerTransactionNewSwapEvent,\n  TransactionControllerTransactionPublishingSkipped,\n  TransactionControllerTransactionRejectedEvent,\n  TransactionControllerTransactionStatusUpdatedEvent,\n  TransactionControllerTransactionSubmittedEvent,\n  TransactionControllerUnapprovedTransactionAddedEvent,\n  TransactionControllerMessenger,\n  TransactionControllerOptions,\n} from './TransactionController.js';\nexport type {\n  TransactionControllerAddTransactionAction,\n  TransactionControllerAddTransactionBatchAction,\n  TransactionControllerConfirmExternalTransactionAction,\n  TransactionControllerEmulateNewTransactionAction,\n  TransactionControllerEmulateTransactionUpdateAction,\n  TransactionControllerEstimateGasAction,\n  TransactionControllerEstimateGasBatchAction,\n  TransactionControllerGetGasFeeTokensAction,\n  TransactionControllerGetNonceLockAction,\n  TransactionControllerGetTransactionsAction,\n  TransactionControllerUpdateCustodialTransactionAction,\n  TransactionControllerUpdateTransactionAction,\n  TransactionControllerUpdateTransactionMetadataAction,\n  TransactionControllerHandleMethodDataAction,\n  TransactionControllerIsAtomicBatchSupportedAction,\n  TransactionControllerStopTransactionAction,\n  TransactionControllerSpeedUpTransactionAction,\n  TransactionControllerEstimateGasBufferedAction,\n  TransactionControllerUpdateEditableParamsAction,\n  TransactionControllerSetTransactionActiveAction,\n  TransactionControllerApproveTransactionsWithSameNonceAction,\n  TransactionControllerEstimateGasFeeAction,\n  TransactionControllerFailTransactionAction,\n  TransactionControllerGetLayer1GasFeeAction,\n  TransactionControllerClearUnapprovedTransactionsAction,\n  TransactionControllerAbortTransactionSigningAction,\n  TransactionControllerUpdateAtomicBatchDataAction,\n  TransactionControllerWipeTransactionsAction,\n  TransactionControllerUpdateSecurityAlertResponseAction,\n  TransactionControllerUpdateTransactionGasFeesAction,\n  TransactionControllerUpdatePreviousGasParamsAction,\n  TransactionControllerUpdateSelectedGasFeeTokenAction,\n  TransactionControllerUpdateRequiredTransactionIdsAction,\n} from './TransactionController-method-action-types.js';\nexport {\n  CANCEL_RATE,\n  SPEED_UP_RATE,\n  TransactionController,\n} from './TransactionController.js';\nexport type {\n  AddTransactionOptions,\n  AfterAddHook,\n  Authorization,\n  AuthorizationList,\n  BatchTransaction,\n  BatchTransactionParams,\n  BeforeSignHook,\n  DappSuggestedGasFees,\n  DefaultGasEstimates,\n  FeeMarketEIP1559Values,\n  FeeMarketGasFeeEstimateForLevel,\n  FeeMarketGasFeeEstimates,\n  GasFeeEstimates,\n  GasFeeToken,\n  GasPriceGasFeeEstimates,\n  GasPriceValue,\n  GetGasFeeTokensRequest,\n  GetSimulationConfig,\n  InferTransactionTypeResult,\n  IsAtomicBatchSupportedRequest,\n  IsAtomicBatchSupportedResult,\n  IsAtomicBatchSupportedResultEntry,\n  LegacyGasFeeEstimates,\n  Log,\n  MetamaskPayMetadata,\n  NestedTransactionMetadata,\n  NestedTransactionUpdate,\n  PublishBatchHook,\n  PublishBatchHookRequest,\n  PublishBatchHookResult,\n  PublishBatchHookTransaction,\n  PublishHook,\n  PublishHookResult,\n  RequiredAsset,\n  SavedGasFees,\n  SecurityAlertResponse,\n  SendFlowHistoryEntry,\n  SimulationBalanceChange,\n  SimulationData,\n  SimulationError,\n  SimulationToken,\n  SimulationTokenBalanceChange,\n  TransactionBatchMeta,\n  TransactionBatchRequest,\n  TransactionBatchResult,\n  TransactionBatchSingleRequest,\n  TransactionError,\n  TransactionHistory,\n  TransactionHistoryEntry,\n  TransactionMeta,\n  TransactionParams,\n  TransactionReceipt,\n  ValidateSecurityRequest,\n} from './types.js';\nexport {\n  GasFeeEstimateLevel,\n  GasFeeEstimateType,\n  SimulationErrorCode,\n  SimulationTokenStandard,\n  TransactionContainerType,\n  TransactionEnvelopeType,\n  TransactionStatus,\n  TransactionType,\n  UserFeeLevel,\n  WalletDevice,\n} from './types.js';\nexport { mergeGasFeeEstimates } from './utils/gas-flow.js';\nexport {\n  decodeAuthorizationSignature,\n  generateEIP7702BatchTransaction,\n  updateEIP7702BatchData,\n} from './utils/eip7702.js';\nexport {\n  isEIP1559Transaction,\n  normalizeTransactionParams,\n} from './utils/utils.js';\nexport { hasTransactionType } from './utils/transaction-type.js';\nexport { CHAIN_IDS } from './constants.js';\nexport { HARDFORK } from './utils/prepare.js';\nexport { getAccountAddressRelationship } from './api/accounts-api.js';\nexport type {\n  GetAccountAddressRelationshipRequest,\n  AccountAddressRelationshipResult,\n} from './api/accounts-api.js';\nexport { generateBatchId } from './utils/batch.js';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA4DA,OAAO,EACL,WAAW,EACX,aAAa,EACb,qBAAqB,EACtB,oCAAmC;AAwDpC,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,YAAY,EACb,oBAAmB;AACpB,OAAO,EAAE,oBAAoB,EAAE,6BAA4B;AAC3D,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAC/B,sBAAsB,EACvB,4BAA2B;AAC5B,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC3B,0BAAyB;AAC1B,OAAO,EAAE,kBAAkB,EAAE,qCAAoC;AACjE,OAAO,EAAE,qBAAqB,EAAE,8BAA6B;AAC7D,OAAO,EAAE,SAAS,EAAE,wBAAuB;AAC3C,OAAO,EAAE,QAAQ,EAAE,4BAA2B;AAC9C,OAAO,EAAE,6BAA6B,EAAE,+BAA8B;AAKtE,OAAO,EAAE,eAAe,EAAE,0BAAyB","sourcesContent":["export type {\n  MethodData,\n  Result,\n  TransactionControllerActions,\n  TransactionControllerEvents,\n  TransactionControllerGetStateAction,\n  TransactionControllerPostTransactionBalanceUpdatedEvent,\n  TransactionControllerSpeedupTransactionAddedEvent,\n  TransactionControllerState,\n  TransactionControllerStateChangeEvent,\n  TransactionControllerTransactionApprovedEvent,\n  TransactionControllerTransactionConfirmedEvent,\n  TransactionControllerTransactionDroppedEvent,\n  TransactionControllerTransactionFailedEvent,\n  TransactionControllerTransactionFinishedEvent,\n  TransactionControllerTransactionNewSwapApprovalEvent,\n  TransactionControllerTransactionNewSwapEvent,\n  TransactionControllerTransactionPublishingSkipped,\n  TransactionControllerTransactionRejectedEvent,\n  TransactionControllerTransactionStatusUpdatedEvent,\n  TransactionControllerTransactionSubmittedEvent,\n  TransactionControllerUnapprovedTransactionAddedEvent,\n  TransactionControllerMessenger,\n  TransactionControllerOptions,\n} from './TransactionController.js';\nexport type {\n  TransactionControllerAddTransactionAction,\n  TransactionControllerAddTransactionBatchAction,\n  TransactionControllerConfirmExternalTransactionAction,\n  TransactionControllerEmulateNewTransactionAction,\n  TransactionControllerEmulateTransactionUpdateAction,\n  TransactionControllerEstimateGasAction,\n  TransactionControllerEstimateGasBatchAction,\n  TransactionControllerGetGasFeeTokensAction,\n  TransactionControllerGetNonceLockAction,\n  TransactionControllerGetTransactionsAction,\n  TransactionControllerUpdateCustodialTransactionAction,\n  TransactionControllerUpdateTransactionAction,\n  TransactionControllerUpdateTransactionMetadataAction,\n  TransactionControllerHandleMethodDataAction,\n  TransactionControllerIsAtomicBatchSupportedAction,\n  TransactionControllerStopTransactionAction,\n  TransactionControllerSpeedUpTransactionAction,\n  TransactionControllerEstimateGasBufferedAction,\n  TransactionControllerUpdateEditableParamsAction,\n  TransactionControllerSetTransactionActiveAction,\n  TransactionControllerApproveTransactionsWithSameNonceAction,\n  TransactionControllerEstimateGasFeeAction,\n  TransactionControllerFailTransactionAction,\n  TransactionControllerGetLayer1GasFeeAction,\n  TransactionControllerClearUnapprovedTransactionsAction,\n  TransactionControllerAbortTransactionSigningAction,\n  TransactionControllerUpdateAtomicBatchDataAction,\n  TransactionControllerWipeTransactionsAction,\n  TransactionControllerUpdateSecurityAlertResponseAction,\n  TransactionControllerUpdateTransactionGasFeesAction,\n  TransactionControllerUpdatePreviousGasParamsAction,\n  TransactionControllerUpdateSelectedGasFeeTokenAction,\n  TransactionControllerUpdateRequiredTransactionIdsAction,\n} from './TransactionController-method-action-types.js';\nexport {\n  CANCEL_RATE,\n  SPEED_UP_RATE,\n  TransactionController,\n} from './TransactionController.js';\nexport type {\n  AddTransactionOptions,\n  AfterAddHook,\n  Authorization,\n  AuthorizationList,\n  BatchTransaction,\n  BatchTransactionParams,\n  BeforeSignHook,\n  DappSuggestedGasFees,\n  DefaultGasEstimates,\n  FeeMarketEIP1559Values,\n  FeeMarketGasFeeEstimateForLevel,\n  FeeMarketGasFeeEstimates,\n  GasFeeEstimates,\n  GasFeeToken,\n  GasPriceGasFeeEstimates,\n  GasPriceValue,\n  GetGasFeeTokensRequest,\n  GetSimulationConfig,\n  InferTransactionTypeResult,\n  IsAtomicBatchSupportedRequest,\n  IsAtomicBatchSupportedResult,\n  IsAtomicBatchSupportedResultEntry,\n  LegacyGasFeeEstimates,\n  Log,\n  MetamaskPayMetadata,\n  NestedTransactionMetadata,\n  NestedTransactionUpdate,\n  PublishBatchHook,\n  PublishBatchHookRequest,\n  PublishBatchHookResult,\n  PublishBatchHookTransaction,\n  PublishHook,\n  PublishHookResult,\n  RequiredAsset,\n  SavedGasFees,\n  SecurityAlertResponse,\n  SendFlowHistoryEntry,\n  SimulationBalanceChange,\n  SimulationData,\n  SimulationError,\n  SimulationToken,\n  SimulationTokenBalanceChange,\n  TransactionBatchMeta,\n  TransactionBatchRequest,\n  TransactionBatchResult,\n  TransactionBatchSingleRequest,\n  TransactionError,\n  TransactionHistory,\n  TransactionHistoryEntry,\n  TransactionMeta,\n  TransactionParams,\n  TransactionReceipt,\n  ValidateSecurityRequest,\n} from './types.js';\nexport {\n  GasFeeEstimateLevel,\n  GasFeeEstimateType,\n  SimulationErrorCode,\n  SimulationTokenStandard,\n  TransactionContainerType,\n  TransactionEnvelopeType,\n  TransactionStatus,\n  TransactionType,\n  UserFeeLevel,\n  WalletDevice,\n} from './types.js';\nexport { mergeGasFeeEstimates } from './utils/gas-flow.js';\nexport {\n  decodeAuthorizationSignature,\n  generateEIP7702BatchTransaction,\n  updateEIP7702BatchData,\n} from './utils/eip7702.js';\nexport {\n  isEIP1559Transaction,\n  normalizeTransactionParams,\n} from './utils/utils.js';\nexport { hasTransactionType } from './utils/transaction-type.js';\nexport { getEffectiveRecipient } from './utils/recipient.js';\nexport { CHAIN_IDS } from './constants.js';\nexport { HARDFORK } from './utils/prepare.js';\nexport { getAccountAddressRelationship } from './api/accounts-api.js';\nexport type {\n  GetAccountAddressRelationshipRequest,\n  AccountAddressRelationshipResult,\n} from './api/accounts-api.js';\nexport { generateBatchId } from './utils/batch.js';\n"]}

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

@@ -4,30 +4,8 @@ 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 types_js_1 = require("../types.cjs");
-const transaction_type_js_1 = require("./transaction-type.cjs");
+const recipient_js_1 = require("./recipient.cjs");
 const validation_js_1 = require("./validation.cjs");
-const TOKEN_TRANSFER_TYPES = [
-    types_js_1.TransactionType.tokenMethodTransfer,
-    types_js_1.TransactionType.tokenMethodTransferFrom,
-    types_js_1.TransactionType.tokenMethodSafeTransferFrom,
-];
-/**
- * Returns the effective recipient for first-time-interaction checks (decoded from data for token transfers).
- * Used when comparing existing transactions so we match by actual recipient, not txParams.to (the token
- * contract for ERC20/ERC721/ERC1155 transfer methods).
- *
- * @param tx - Transaction meta with txParams and type
- * @returns Effective recipient address, or undefined
- */
-function getEffectiveRecipient(tx) {
-    const { data, to } = tx?.txParams ?? {};
-    if (data && TOKEN_TRANSFER_TYPES.includes(tx?.type)) {
-        const parsed = (0, transaction_type_js_1.decodeTransactionData)(data);
-        return (parsed?.args?._to ?? parsed?.args?.to ?? to);
-    }
-    return to;
-}
 /**
  * Updates the first-time interaction status for a transaction.
  *
@@ -46,7 +24,7 @@ async function updateFirstTimeInteraction({ existingTransactions, getTransaction
         return;
     }
     const { chainId, id: transactionId, txParams: { from }, } = transactionMeta;
-    const recipient = getEffectiveRecipient(transactionMeta);
+    const recipient = (0, recipient_js_1.getEffectiveRecipient)(transactionMeta);
     const request = {
         chainId: (0, utils_1.hexToNumber)(chainId),
         to: recipient,
@@ -57,7 +35,7 @@ async function updateFirstTimeInteraction({ existingTransactions, getTransaction
     const existingTransaction = existingTransactions.find((tx) => tx.id !== transactionId &&
         tx.chainId === chainId &&
         tx.txParams?.from?.toLowerCase() === from?.toLowerCase() &&
-        getEffectiveRecipient(tx)?.toLowerCase() === recipientLower);
+        (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.

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

@@ -1 +1 @@
-{"version":3,"file":"first-time-interaction.cjs","sourceRoot":"","sources":["../../src/utils/first-time-interaction.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TransactionDescription } from '@ethersproject/abi';\nimport 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 { TransactionType } from '../types.js';\nimport type { TransactionMeta } from '../types.js';\nimport { decodeTransactionData } from './transaction-type.js';\nimport { validateParamTo } from './validation.js';\n\nconst TOKEN_TRANSFER_TYPES = [\n  TransactionType.tokenMethodTransfer,\n  TransactionType.tokenMethodTransferFrom,\n  TransactionType.tokenMethodSafeTransferFrom,\n];\n\n/**\n * Returns the effective recipient for first-time-interaction checks (decoded from data for token transfers).\n * Used when comparing existing transactions so we match by actual recipient, not txParams.to (the token\n * contract for ERC20/ERC721/ERC1155 transfer methods).\n *\n * @param tx - Transaction meta with txParams and type\n * @returns Effective recipient address, or undefined\n */\nfunction getEffectiveRecipient(tx: TransactionMeta): string | undefined {\n  const { data, to } = tx?.txParams ?? {};\n  if (data && TOKEN_TRANSFER_TYPES.includes(tx?.type as TransactionType)) {\n    const parsed = decodeTransactionData(data) as TransactionDescription;\n    return (parsed?.args?._to ?? parsed?.args?.to ?? to) as string | undefined;\n  }\n  return to;\n}\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"]}
+{"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.cts.map

@@ -1 +1 @@
-{"version":3,"file":"first-time-interaction.d.cts","sourceRoot":"","sources":["../../src/utils/first-time-interaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,mCAAmC;AAO9E,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAoB;AA2BnD,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"}
+{"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.map

@@ -1 +1 @@
-{"version":3,"file":"first-time-interaction.d.mts","sourceRoot":"","sources":["../../src/utils/first-time-interaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,mCAAmC;AAO9E,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAoB;AA2BnD,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"}
+{"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.mjs

@@ -1,30 +1,8 @@
 import { hexToNumber } from "@metamask/utils";
 import { getAccountAddressRelationship } from "../api/accounts-api.mjs";
 import { projectLogger as log } from "../logger.mjs";
-import { TransactionType } from "../types.mjs";
-import { decodeTransactionData } from "./transaction-type.mjs";
+import { getEffectiveRecipient } from "./recipient.mjs";
 import { validateParamTo } from "./validation.mjs";
-const TOKEN_TRANSFER_TYPES = [
-    TransactionType.tokenMethodTransfer,
-    TransactionType.tokenMethodTransferFrom,
-    TransactionType.tokenMethodSafeTransferFrom,
-];
-/**
- * Returns the effective recipient for first-time-interaction checks (decoded from data for token transfers).
- * Used when comparing existing transactions so we match by actual recipient, not txParams.to (the token
- * contract for ERC20/ERC721/ERC1155 transfer methods).
- *
- * @param tx - Transaction meta with txParams and type
- * @returns Effective recipient address, or undefined
- */
-function getEffectiveRecipient(tx) {
-    const { data, to } = tx?.txParams ?? {};
-    if (data && TOKEN_TRANSFER_TYPES.includes(tx?.type)) {
-        const parsed = decodeTransactionData(data);
-        return (parsed?.args?._to ?? parsed?.args?.to ?? to);
-    }
-    return to;
-}
 /**
  * Updates the first-time interaction status for a transaction.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"first-time-interaction.mjs","sourceRoot":"","sources":["../../src/utils/first-time-interaction.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TransactionDescription } from '@ethersproject/abi';\nimport 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 { TransactionType } from '../types.js';\nimport type { TransactionMeta } from '../types.js';\nimport { decodeTransactionData } from './transaction-type.js';\nimport { validateParamTo } from './validation.js';\n\nconst TOKEN_TRANSFER_TYPES = [\n  TransactionType.tokenMethodTransfer,\n  TransactionType.tokenMethodTransferFrom,\n  TransactionType.tokenMethodSafeTransferFrom,\n];\n\n/**\n * Returns the effective recipient for first-time-interaction checks (decoded from data for token transfers).\n * Used when comparing existing transactions so we match by actual recipient, not txParams.to (the token\n * contract for ERC20/ERC721/ERC1155 transfer methods).\n *\n * @param tx - Transaction meta with txParams and type\n * @returns Effective recipient address, or undefined\n */\nfunction getEffectiveRecipient(tx: TransactionMeta): string | undefined {\n  const { data, to } = tx?.txParams ?? {};\n  if (data && TOKEN_TRANSFER_TYPES.includes(tx?.type as TransactionType)) {\n    const parsed = decodeTransactionData(data) as TransactionDescription;\n    return (parsed?.args?._to ?? parsed?.args?.to ?? to) as string | undefined;\n  }\n  return to;\n}\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"]}
+{"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"]}

package/dist/utils/recipient.cjs

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEffectiveRecipient = void 0;
+const types_js_1 = require("../types.cjs");
+const transaction_type_js_1 = require("./transaction-type.cjs");
+const TOKEN_TRANSFER_TYPES = [
+    types_js_1.TransactionType.tokenMethodTransfer,
+    types_js_1.TransactionType.tokenMethodTransferFrom,
+    types_js_1.TransactionType.tokenMethodSafeTransferFrom,
+];
+/**
+ * Returns the effective recipient of a transaction.
+ * For ERC-20/ERC-721/ERC-1155 token transfer methods, the recipient is decoded
+ * from the calldata since `txParams.to` is the token contract rather than the
+ * address receiving the tokens. For all other transaction types, `txParams.to`
+ * is returned as-is.
+ *
+ * @param transactionMeta - Transaction meta with txParams and type.
+ * @returns Effective recipient address, or undefined.
+ */
+function getEffectiveRecipient(transactionMeta) {
+    const { data, to } = transactionMeta?.txParams ?? {};
+    if (data &&
+        TOKEN_TRANSFER_TYPES.includes(transactionMeta?.type)) {
+        const parsed = (0, transaction_type_js_1.decodeTransactionData)(data);
+        return (parsed?.args?._to ?? parsed?.args?.to ?? to);
+    }
+    return to;
+}
+exports.getEffectiveRecipient = getEffectiveRecipient;
+//# sourceMappingURL=recipient.cjs.map

package/dist/utils/recipient.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipient.cjs","sourceRoot":"","sources":["../../src/utils/recipient.ts"],"names":[],"mappings":";;;AAEA,2CAA8C;AAE9C,gEAA8D;AAE9D,MAAM,oBAAoB,GAAG;IAC3B,0BAAe,CAAC,mBAAmB;IACnC,0BAAe,CAAC,uBAAuB;IACvC,0BAAe,CAAC,2BAA2B;CAC5C,CAAC;AAEF;;;;;;;;;GASG;AACH,SAAgB,qBAAqB,CACnC,eAAgC;IAEhC,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,eAAe,EAAE,QAAQ,IAAI,EAAE,CAAC;IACrD,IACE,IAAI;QACJ,oBAAoB,CAAC,QAAQ,CAAC,eAAe,EAAE,IAAuB,CAAC,EACvE,CAAC;QACD,MAAM,MAAM,GAAG,IAAA,2CAAqB,EAAC,IAAI,CAA2B,CAAC;QACrE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAuB,CAAC;IAC7E,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAZD,sDAYC","sourcesContent":["import type { TransactionDescription } from '@ethersproject/abi';\n\nimport { TransactionType } from '../types.js';\nimport type { TransactionMeta } from '../types.js';\nimport { decodeTransactionData } from './transaction-type.js';\n\nconst TOKEN_TRANSFER_TYPES = [\n  TransactionType.tokenMethodTransfer,\n  TransactionType.tokenMethodTransferFrom,\n  TransactionType.tokenMethodSafeTransferFrom,\n];\n\n/**\n * Returns the effective recipient of a transaction.\n * For ERC-20/ERC-721/ERC-1155 token transfer methods, the recipient is decoded\n * from the calldata since `txParams.to` is the token contract rather than the\n * address receiving the tokens. For all other transaction types, `txParams.to`\n * is returned as-is.\n *\n * @param transactionMeta - Transaction meta with txParams and type.\n * @returns Effective recipient address, or undefined.\n */\nexport function getEffectiveRecipient(\n  transactionMeta: TransactionMeta,\n): string | undefined {\n  const { data, to } = transactionMeta?.txParams ?? {};\n  if (\n    data &&\n    TOKEN_TRANSFER_TYPES.includes(transactionMeta?.type as TransactionType)\n  ) {\n    const parsed = decodeTransactionData(data) as TransactionDescription;\n    return (parsed?.args?._to ?? parsed?.args?.to ?? to) as string | undefined;\n  }\n  return to;\n}\n"]}

package/dist/utils/recipient.d.cts

@@ -0,0 +1,13 @@
+import type { TransactionMeta } from "../types.cjs";
+/**
+ * Returns the effective recipient of a transaction.
+ * For ERC-20/ERC-721/ERC-1155 token transfer methods, the recipient is decoded
+ * from the calldata since `txParams.to` is the token contract rather than the
+ * address receiving the tokens. For all other transaction types, `txParams.to`
+ * is returned as-is.
+ *
+ * @param transactionMeta - Transaction meta with txParams and type.
+ * @returns Effective recipient address, or undefined.
+ */
+export declare function getEffectiveRecipient(transactionMeta: TransactionMeta): string | undefined;
+//# sourceMappingURL=recipient.d.cts.map

package/dist/utils/recipient.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipient.d.cts","sourceRoot":"","sources":["../../src/utils/recipient.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAoB;AASnD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,eAAe,GAC/B,MAAM,GAAG,SAAS,CAUpB"}

package/dist/utils/recipient.d.mts

@@ -0,0 +1,13 @@
+import type { TransactionMeta } from "../types.mjs";
+/**
+ * Returns the effective recipient of a transaction.
+ * For ERC-20/ERC-721/ERC-1155 token transfer methods, the recipient is decoded
+ * from the calldata since `txParams.to` is the token contract rather than the
+ * address receiving the tokens. For all other transaction types, `txParams.to`
+ * is returned as-is.
+ *
+ * @param transactionMeta - Transaction meta with txParams and type.
+ * @returns Effective recipient address, or undefined.
+ */
+export declare function getEffectiveRecipient(transactionMeta: TransactionMeta): string | undefined;
+//# sourceMappingURL=recipient.d.mts.map

package/dist/utils/recipient.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipient.d.mts","sourceRoot":"","sources":["../../src/utils/recipient.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAoB;AASnD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,eAAe,GAC/B,MAAM,GAAG,SAAS,CAUpB"}

package/dist/utils/recipient.mjs

@@ -0,0 +1,27 @@
+import { TransactionType } from "../types.mjs";
+import { decodeTransactionData } from "./transaction-type.mjs";
+const TOKEN_TRANSFER_TYPES = [
+    TransactionType.tokenMethodTransfer,
+    TransactionType.tokenMethodTransferFrom,
+    TransactionType.tokenMethodSafeTransferFrom,
+];
+/**
+ * Returns the effective recipient of a transaction.
+ * For ERC-20/ERC-721/ERC-1155 token transfer methods, the recipient is decoded
+ * from the calldata since `txParams.to` is the token contract rather than the
+ * address receiving the tokens. For all other transaction types, `txParams.to`
+ * is returned as-is.
+ *
+ * @param transactionMeta - Transaction meta with txParams and type.
+ * @returns Effective recipient address, or undefined.
+ */
+export function getEffectiveRecipient(transactionMeta) {
+    const { data, to } = transactionMeta?.txParams ?? {};
+    if (data &&
+        TOKEN_TRANSFER_TYPES.includes(transactionMeta?.type)) {
+        const parsed = decodeTransactionData(data);
+        return (parsed?.args?._to ?? parsed?.args?.to ?? to);
+    }
+    return to;
+}
+//# sourceMappingURL=recipient.mjs.map

package/dist/utils/recipient.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipient.mjs","sourceRoot":"","sources":["../../src/utils/recipient.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,qBAAoB;AAE9C,OAAO,EAAE,qBAAqB,EAAE,+BAA8B;AAE9D,MAAM,oBAAoB,GAAG;IAC3B,eAAe,CAAC,mBAAmB;IACnC,eAAe,CAAC,uBAAuB;IACvC,eAAe,CAAC,2BAA2B;CAC5C,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,eAAgC;IAEhC,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,eAAe,EAAE,QAAQ,IAAI,EAAE,CAAC;IACrD,IACE,IAAI;QACJ,oBAAoB,CAAC,QAAQ,CAAC,eAAe,EAAE,IAAuB,CAAC,EACvE,CAAC;QACD,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAA2B,CAAC;QACrE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAuB,CAAC;IAC7E,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC","sourcesContent":["import type { TransactionDescription } from '@ethersproject/abi';\n\nimport { TransactionType } from '../types.js';\nimport type { TransactionMeta } from '../types.js';\nimport { decodeTransactionData } from './transaction-type.js';\n\nconst TOKEN_TRANSFER_TYPES = [\n  TransactionType.tokenMethodTransfer,\n  TransactionType.tokenMethodTransferFrom,\n  TransactionType.tokenMethodSafeTransferFrom,\n];\n\n/**\n * Returns the effective recipient of a transaction.\n * For ERC-20/ERC-721/ERC-1155 token transfer methods, the recipient is decoded\n * from the calldata since `txParams.to` is the token contract rather than the\n * address receiving the tokens. For all other transaction types, `txParams.to`\n * is returned as-is.\n *\n * @param transactionMeta - Transaction meta with txParams and type.\n * @returns Effective recipient address, or undefined.\n */\nexport function getEffectiveRecipient(\n  transactionMeta: TransactionMeta,\n): string | undefined {\n  const { data, to } = transactionMeta?.txParams ?? {};\n  if (\n    data &&\n    TOKEN_TRANSFER_TYPES.includes(transactionMeta?.type as TransactionType)\n  ) {\n    const parsed = decodeTransactionData(data) as TransactionDescription;\n    return (parsed?.args?._to ?? parsed?.args?.to ?? to) as string | undefined;\n  }\n  return to;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/transaction-controller",
-  "version": "69.3.0-preview-2296abeaf",
+  "version": "69.3.0-preview-5da60b6",
   "description": "Stores transactions alongside their periodically updated statuses and manages interactions such as approval and cancellation",
   "keywords": [
     "Ethereum",