@metamask-previews/transaction-controller 69.6.1-preview-99421bfe4 → 69.6.1-preview-878689a26

package/CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Export `getSendRecipients`, which returns user-chosen send payees for a transaction (native `simpleSend` recipients, decoded ERC-20/721/1155 transfer payees, `swapAndSendRecipient`, and nested batch sends) and omits protocol addresses such as token, Permit2, and router contracts ([#9943](https://github.com/MetaMask/core/pull/9943))
+
 ### Changed
 
 - Bump `@metamask/remote-feature-flag-controller` from `^6.0.0` to `^6.1.0` ([#9980](https://github.com/MetaMask/core/pull/9980))

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.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;
+exports.generateBatchId = exports.getAccountAddressRelationship = exports.HARDFORK = exports.CHAIN_IDS = exports.getSendRecipients = 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; } });
@@ -29,6 +29,7 @@ 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; } });
+Object.defineProperty(exports, "getSendRecipients", { enumerable: true, get: function () { return recipient_js_1.getSendRecipients; } });
 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,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"]}
+{"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,sDAAgF;AAAvE,qHAAA,qBAAqB,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AACjD,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, getSendRecipients } 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,7 +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 { getEffectiveRecipient, getSendRecipients } 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,7 +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 { getEffectiveRecipient, getSendRecipients } 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,7 +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 { getEffectiveRecipient, getSendRecipients } 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,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"]}
+{"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,iBAAiB,EAAE,8BAA6B;AAChF,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, getSendRecipients } 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/recipient.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getEffectiveRecipient = void 0;
+exports.getSendRecipients = exports.getEffectiveRecipient = void 0;
 const types_js_1 = require("../types.cjs");
 const transaction_type_js_1 = require("./transaction-type.cjs");
 const TOKEN_TRANSFER_TYPES = [
@@ -15,6 +15,10 @@ const TOKEN_TRANSFER_TYPES = [
  * address receiving the tokens. For all other transaction types, `txParams.to`
  * is returned as-is.
  *
+ * Address poisoning should use {@link getSendRecipients} instead. This helper
+ * is for first-time interaction and similar "who are we calling" checks, where
+ * the contract `to` is the right address for approves and contract calls.
+ *
  * @param transactionMeta - Transaction meta with txParams and type.
  * @returns Effective recipient address, or undefined.
  */
@@ -28,4 +32,70 @@ function getEffectiveRecipient(transactionMeta) {
     return to;
 }
 exports.getEffectiveRecipient = getEffectiveRecipient;
+/**
+ * Returns user-chosen send payees for a transaction.
+ *
+ * Address poisoning compares a candidate against prior recipients the user
+ * actually sent to. Protocol addresses (token, Permit2, router, spender) are
+ * dapp-supplied and must not be treated as payees.
+ *
+ * Included:
+ * - `simpleSend` `to`, preferring `txParamsOriginal` when present
+ * - Decoded `to` / `_to` for ERC-20/721/1155 transfer methods
+ * - `swapAndSendRecipient` whenever set (only ever a user-entered payee)
+ * - Nested batch calls that themselves are sends or token transfers
+ * - Untyped transactions with no calldata, treated as legacy native sends
+ *
+ * @param transactionMeta - Transaction meta with txParams and type.
+ * @returns Deduplicated send recipient addresses, possibly empty.
+ */
+function getSendRecipients(transactionMeta) {
+    // Swap the whole params object rather than falling back field by field.
+    // `txParamsOriginal` is a `cloneDeep` snapshot of the pre-wrapping params, so
+    // its `to` and `data` always describe the same call. Mixing an original `to`
+    // with a wrapped `data` would misread an untyped transaction as a contract
+    // call and drop a real payee.
+    const params = transactionMeta.txParamsOriginal ?? transactionMeta.txParams;
+    const recipients = [];
+    const seen = new Set();
+    const addRecipient = (address) => {
+        const normalized = address?.toLowerCase();
+        if (!address || !normalized || seen.has(normalized)) {
+            return;
+        }
+        seen.add(normalized);
+        recipients.push(address);
+    };
+    addRecipient(getSendRecipientFromSource({
+        data: params?.data,
+        to: params?.to,
+        type: transactionMeta.type,
+    }));
+    addRecipient(transactionMeta.swapAndSendRecipient);
+    for (const nestedTransaction of transactionMeta.nestedTransactions ?? []) {
+        addRecipient(getSendRecipientFromSource(nestedTransaction));
+    }
+    return recipients;
+}
+exports.getSendRecipients = getSendRecipients;
+function getSendRecipientFromSource({ data, to, type, }) {
+    if (isNativeSendType(type, data)) {
+        return to;
+    }
+    if (type && TOKEN_TRANSFER_TYPES.includes(type) && hasCalldata(data)) {
+        return decodeTokenTransferRecipient(data);
+    }
+    return undefined;
+}
+function isNativeSendType(type, data) {
+    return (type === types_js_1.TransactionType.simpleSend ||
+        (type === undefined && !hasCalldata(data)));
+}
+function hasCalldata(data) {
+    return Boolean(data && data !== '0x');
+}
+function decodeTokenTransferRecipient(data) {
+    const parsed = (0, transaction_type_js_1.decodeTransactionData)(data);
+    return (parsed?.args?._to ?? parsed?.args?.to);
+}
 //# sourceMappingURL=recipient.cjs.map

package/dist/utils/recipient.cjs.map

@@ -1 +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"]}
+{"version":3,"file":"recipient.cjs","sourceRoot":"","sources":["../../src/utils/recipient.ts"],"names":[],"mappings":"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","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\ntype SendRecipientSource = {\n  data?: string;\n  to?: string;\n  type?: TransactionType;\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 * Address poisoning should use {@link getSendRecipients} instead. This helper\n * is for first-time interaction and similar \"who are we calling\" checks, where\n * the contract `to` is the right address for approves and contract calls.\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\n/**\n * Returns user-chosen send payees for a transaction.\n *\n * Address poisoning compares a candidate against prior recipients the user\n * actually sent to. Protocol addresses (token, Permit2, router, spender) are\n * dapp-supplied and must not be treated as payees.\n *\n * Included:\n * - `simpleSend` `to`, preferring `txParamsOriginal` when present\n * - Decoded `to` / `_to` for ERC-20/721/1155 transfer methods\n * - `swapAndSendRecipient` whenever set (only ever a user-entered payee)\n * - Nested batch calls that themselves are sends or token transfers\n * - Untyped transactions with no calldata, treated as legacy native sends\n *\n * @param transactionMeta - Transaction meta with txParams and type.\n * @returns Deduplicated send recipient addresses, possibly empty.\n */\nexport function getSendRecipients(transactionMeta: TransactionMeta): string[] {\n  // Swap the whole params object rather than falling back field by field.\n  // `txParamsOriginal` is a `cloneDeep` snapshot of the pre-wrapping params, so\n  // its `to` and `data` always describe the same call. Mixing an original `to`\n  // with a wrapped `data` would misread an untyped transaction as a contract\n  // call and drop a real payee.\n  const params = transactionMeta.txParamsOriginal ?? transactionMeta.txParams;\n  const recipients: string[] = [];\n  const seen = new Set<string>();\n\n  const addRecipient = (address?: string): void => {\n    const normalized = address?.toLowerCase();\n    if (!address || !normalized || seen.has(normalized)) {\n      return;\n    }\n    seen.add(normalized);\n    recipients.push(address);\n  };\n\n  addRecipient(\n    getSendRecipientFromSource({\n      data: params?.data,\n      to: params?.to,\n      type: transactionMeta.type,\n    }),\n  );\n  addRecipient(transactionMeta.swapAndSendRecipient);\n\n  for (const nestedTransaction of transactionMeta.nestedTransactions ?? []) {\n    addRecipient(getSendRecipientFromSource(nestedTransaction));\n  }\n\n  return recipients;\n}\n\nfunction getSendRecipientFromSource({\n  data,\n  to,\n  type,\n}: SendRecipientSource): string | undefined {\n  if (isNativeSendType(type, data)) {\n    return to;\n  }\n\n  if (type && TOKEN_TRANSFER_TYPES.includes(type) && hasCalldata(data)) {\n    return decodeTokenTransferRecipient(data);\n  }\n\n  return undefined;\n}\n\nfunction isNativeSendType(\n  type: TransactionType | undefined,\n  data?: string,\n): boolean {\n  return (\n    type === TransactionType.simpleSend ||\n    (type === undefined && !hasCalldata(data))\n  );\n}\n\nfunction hasCalldata(data?: string): data is string {\n  return Boolean(data && data !== '0x');\n}\n\nfunction decodeTokenTransferRecipient(data: string): string | undefined {\n  const parsed = decodeTransactionData(data) as\n    | TransactionDescription\n    | undefined;\n  return (parsed?.args?._to ?? parsed?.args?.to) as string | undefined;\n}\n"]}

package/dist/utils/recipient.d.cts

@@ -6,8 +6,30 @@ import type { TransactionMeta } from "../types.cjs";
  * address receiving the tokens. For all other transaction types, `txParams.to`
  * is returned as-is.
  *
+ * Address poisoning should use {@link getSendRecipients} instead. This helper
+ * is for first-time interaction and similar "who are we calling" checks, where
+ * the contract `to` is the right address for approves and contract calls.
+ *
  * @param transactionMeta - Transaction meta with txParams and type.
  * @returns Effective recipient address, or undefined.
  */
 export declare function getEffectiveRecipient(transactionMeta: TransactionMeta): string | undefined;
+/**
+ * Returns user-chosen send payees for a transaction.
+ *
+ * Address poisoning compares a candidate against prior recipients the user
+ * actually sent to. Protocol addresses (token, Permit2, router, spender) are
+ * dapp-supplied and must not be treated as payees.
+ *
+ * Included:
+ * - `simpleSend` `to`, preferring `txParamsOriginal` when present
+ * - Decoded `to` / `_to` for ERC-20/721/1155 transfer methods
+ * - `swapAndSendRecipient` whenever set (only ever a user-entered payee)
+ * - Nested batch calls that themselves are sends or token transfers
+ * - Untyped transactions with no calldata, treated as legacy native sends
+ *
+ * @param transactionMeta - Transaction meta with txParams and type.
+ * @returns Deduplicated send recipient addresses, possibly empty.
+ */
+export declare function getSendRecipients(transactionMeta: TransactionMeta): string[];
 //# sourceMappingURL=recipient.d.cts.map

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

@@ -1 +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"}
+{"version":3,"file":"recipient.d.cts","sourceRoot":"","sources":["../../src/utils/recipient.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAoB;AAenD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,eAAe,GAC/B,MAAM,GAAG,SAAS,CAUpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,eAAe,GAAG,MAAM,EAAE,CAiC5E"}

package/dist/utils/recipient.d.mts

@@ -6,8 +6,30 @@ import type { TransactionMeta } from "../types.mjs";
  * address receiving the tokens. For all other transaction types, `txParams.to`
  * is returned as-is.
  *
+ * Address poisoning should use {@link getSendRecipients} instead. This helper
+ * is for first-time interaction and similar "who are we calling" checks, where
+ * the contract `to` is the right address for approves and contract calls.
+ *
  * @param transactionMeta - Transaction meta with txParams and type.
  * @returns Effective recipient address, or undefined.
  */
 export declare function getEffectiveRecipient(transactionMeta: TransactionMeta): string | undefined;
+/**
+ * Returns user-chosen send payees for a transaction.
+ *
+ * Address poisoning compares a candidate against prior recipients the user
+ * actually sent to. Protocol addresses (token, Permit2, router, spender) are
+ * dapp-supplied and must not be treated as payees.
+ *
+ * Included:
+ * - `simpleSend` `to`, preferring `txParamsOriginal` when present
+ * - Decoded `to` / `_to` for ERC-20/721/1155 transfer methods
+ * - `swapAndSendRecipient` whenever set (only ever a user-entered payee)
+ * - Nested batch calls that themselves are sends or token transfers
+ * - Untyped transactions with no calldata, treated as legacy native sends
+ *
+ * @param transactionMeta - Transaction meta with txParams and type.
+ * @returns Deduplicated send recipient addresses, possibly empty.
+ */
+export declare function getSendRecipients(transactionMeta: TransactionMeta): string[];
 //# sourceMappingURL=recipient.d.mts.map

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

@@ -1 +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"}
+{"version":3,"file":"recipient.d.mts","sourceRoot":"","sources":["../../src/utils/recipient.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAoB;AAenD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,eAAe,GAC/B,MAAM,GAAG,SAAS,CAUpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,eAAe,GAAG,MAAM,EAAE,CAiC5E"}

package/dist/utils/recipient.mjs

@@ -12,6 +12,10 @@ const TOKEN_TRANSFER_TYPES = [
  * address receiving the tokens. For all other transaction types, `txParams.to`
  * is returned as-is.
  *
+ * Address poisoning should use {@link getSendRecipients} instead. This helper
+ * is for first-time interaction and similar "who are we calling" checks, where
+ * the contract `to` is the right address for approves and contract calls.
+ *
  * @param transactionMeta - Transaction meta with txParams and type.
  * @returns Effective recipient address, or undefined.
  */
@@ -24,4 +28,69 @@ export function getEffectiveRecipient(transactionMeta) {
     }
     return to;
 }
+/**
+ * Returns user-chosen send payees for a transaction.
+ *
+ * Address poisoning compares a candidate against prior recipients the user
+ * actually sent to. Protocol addresses (token, Permit2, router, spender) are
+ * dapp-supplied and must not be treated as payees.
+ *
+ * Included:
+ * - `simpleSend` `to`, preferring `txParamsOriginal` when present
+ * - Decoded `to` / `_to` for ERC-20/721/1155 transfer methods
+ * - `swapAndSendRecipient` whenever set (only ever a user-entered payee)
+ * - Nested batch calls that themselves are sends or token transfers
+ * - Untyped transactions with no calldata, treated as legacy native sends
+ *
+ * @param transactionMeta - Transaction meta with txParams and type.
+ * @returns Deduplicated send recipient addresses, possibly empty.
+ */
+export function getSendRecipients(transactionMeta) {
+    // Swap the whole params object rather than falling back field by field.
+    // `txParamsOriginal` is a `cloneDeep` snapshot of the pre-wrapping params, so
+    // its `to` and `data` always describe the same call. Mixing an original `to`
+    // with a wrapped `data` would misread an untyped transaction as a contract
+    // call and drop a real payee.
+    const params = transactionMeta.txParamsOriginal ?? transactionMeta.txParams;
+    const recipients = [];
+    const seen = new Set();
+    const addRecipient = (address) => {
+        const normalized = address?.toLowerCase();
+        if (!address || !normalized || seen.has(normalized)) {
+            return;
+        }
+        seen.add(normalized);
+        recipients.push(address);
+    };
+    addRecipient(getSendRecipientFromSource({
+        data: params?.data,
+        to: params?.to,
+        type: transactionMeta.type,
+    }));
+    addRecipient(transactionMeta.swapAndSendRecipient);
+    for (const nestedTransaction of transactionMeta.nestedTransactions ?? []) {
+        addRecipient(getSendRecipientFromSource(nestedTransaction));
+    }
+    return recipients;
+}
+function getSendRecipientFromSource({ data, to, type, }) {
+    if (isNativeSendType(type, data)) {
+        return to;
+    }
+    if (type && TOKEN_TRANSFER_TYPES.includes(type) && hasCalldata(data)) {
+        return decodeTokenTransferRecipient(data);
+    }
+    return undefined;
+}
+function isNativeSendType(type, data) {
+    return (type === TransactionType.simpleSend ||
+        (type === undefined && !hasCalldata(data)));
+}
+function hasCalldata(data) {
+    return Boolean(data && data !== '0x');
+}
+function decodeTokenTransferRecipient(data) {
+    const parsed = decodeTransactionData(data);
+    return (parsed?.args?._to ?? parsed?.args?.to);
+}
 //# sourceMappingURL=recipient.mjs.map

package/dist/utils/recipient.mjs.map

@@ -1 +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"]}
+{"version":3,"file":"recipient.mjs","sourceRoot":"","sources":["../../src/utils/recipient.ts"],"names":[],"mappings":"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","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\ntype SendRecipientSource = {\n  data?: string;\n  to?: string;\n  type?: TransactionType;\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 * Address poisoning should use {@link getSendRecipients} instead. This helper\n * is for first-time interaction and similar \"who are we calling\" checks, where\n * the contract `to` is the right address for approves and contract calls.\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\n/**\n * Returns user-chosen send payees for a transaction.\n *\n * Address poisoning compares a candidate against prior recipients the user\n * actually sent to. Protocol addresses (token, Permit2, router, spender) are\n * dapp-supplied and must not be treated as payees.\n *\n * Included:\n * - `simpleSend` `to`, preferring `txParamsOriginal` when present\n * - Decoded `to` / `_to` for ERC-20/721/1155 transfer methods\n * - `swapAndSendRecipient` whenever set (only ever a user-entered payee)\n * - Nested batch calls that themselves are sends or token transfers\n * - Untyped transactions with no calldata, treated as legacy native sends\n *\n * @param transactionMeta - Transaction meta with txParams and type.\n * @returns Deduplicated send recipient addresses, possibly empty.\n */\nexport function getSendRecipients(transactionMeta: TransactionMeta): string[] {\n  // Swap the whole params object rather than falling back field by field.\n  // `txParamsOriginal` is a `cloneDeep` snapshot of the pre-wrapping params, so\n  // its `to` and `data` always describe the same call. Mixing an original `to`\n  // with a wrapped `data` would misread an untyped transaction as a contract\n  // call and drop a real payee.\n  const params = transactionMeta.txParamsOriginal ?? transactionMeta.txParams;\n  const recipients: string[] = [];\n  const seen = new Set<string>();\n\n  const addRecipient = (address?: string): void => {\n    const normalized = address?.toLowerCase();\n    if (!address || !normalized || seen.has(normalized)) {\n      return;\n    }\n    seen.add(normalized);\n    recipients.push(address);\n  };\n\n  addRecipient(\n    getSendRecipientFromSource({\n      data: params?.data,\n      to: params?.to,\n      type: transactionMeta.type,\n    }),\n  );\n  addRecipient(transactionMeta.swapAndSendRecipient);\n\n  for (const nestedTransaction of transactionMeta.nestedTransactions ?? []) {\n    addRecipient(getSendRecipientFromSource(nestedTransaction));\n  }\n\n  return recipients;\n}\n\nfunction getSendRecipientFromSource({\n  data,\n  to,\n  type,\n}: SendRecipientSource): string | undefined {\n  if (isNativeSendType(type, data)) {\n    return to;\n  }\n\n  if (type && TOKEN_TRANSFER_TYPES.includes(type) && hasCalldata(data)) {\n    return decodeTokenTransferRecipient(data);\n  }\n\n  return undefined;\n}\n\nfunction isNativeSendType(\n  type: TransactionType | undefined,\n  data?: string,\n): boolean {\n  return (\n    type === TransactionType.simpleSend ||\n    (type === undefined && !hasCalldata(data))\n  );\n}\n\nfunction hasCalldata(data?: string): data is string {\n  return Boolean(data && data !== '0x');\n}\n\nfunction decodeTokenTransferRecipient(data: string): string | undefined {\n  const parsed = decodeTransactionData(data) as\n    | TransactionDescription\n    | undefined;\n  return (parsed?.args?._to ?? parsed?.args?.to) as string | undefined;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/transaction-controller",
-  "version": "69.6.1-preview-99421bfe4",
+  "version": "69.6.1-preview-878689a26",
   "description": "Stores transactions alongside their periodically updated statuses and manages interactions such as approval and cancellation",
   "keywords": [
     "Ethereum",