@metamask-previews/transaction-controller 69.7.0-preview-a302de5c3 → 69.8.0-preview-e12b5ece6

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [69.8.0]
+
+### Added
+
+- Export `getSendRecipients`, which returns user-chosen send payees for a transaction (native `simpleSend` recipients, decoded ERC-20/721/1155 transfer payees including ERC-1155 batch transfers, `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/utils` from `^11.11.0` to `^11.12.0` ([#10076](https://github.com/MetaMask/core/pull/10076))
+
 ## [69.7.0]
 
 ### Added
@@ -2707,7 +2717,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
     All changes listed after this point were applied to this package following the monorepo conversion.
 
-[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/transaction-controller@69.7.0...HEAD
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/transaction-controller@69.8.0...HEAD
+[69.8.0]: https://github.com/MetaMask/core/compare/@metamask/transaction-controller@69.7.0...@metamask/transaction-controller@69.8.0
 [69.7.0]: https://github.com/MetaMask/core/compare/@metamask/transaction-controller@69.6.1...@metamask/transaction-controller@69.7.0
 [69.6.1]: https://github.com/MetaMask/core/compare/@metamask/transaction-controller@69.6.0...@metamask/transaction-controller@69.6.1
 [69.6.0]: https://github.com/MetaMask/core/compare/@metamask/transaction-controller@69.5.2...@metamask/transaction-controller@69.6.0

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 = [
@@ -8,6 +8,7 @@ const TOKEN_TRANSFER_TYPES = [
     types_js_1.TransactionType.tokenMethodTransferFrom,
     types_js_1.TransactionType.tokenMethodSafeTransferFrom,
 ];
+const ERC1155_SAFE_BATCH_TRANSFER_FROM_SELECTOR = '0x2eb2c2d6';
 /**
  * Returns the effective recipient of a transaction.
  * For ERC-20/ERC-721/ERC-1155 token transfer methods, the recipient is decoded
@@ -15,6 +16,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 +33,130 @@ 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
+ * - Decoded `to` for ERC-1155 `safeBatchTransferFrom`
+ * - `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
+ * - Speed-up transactions (`type: retry`), classified using `originalType`,
+ *   since `txParams` are otherwise unchanged from the transaction being sped
+ *   up.
+ * - Cancellations and retries of cancellations return no payees. Their
+ *   original params, nested transactions, and swap-and-send recipient can
+ *   remain on the metadata even though none of those sends executed.
+ * - A native transfer with no calldata to an address that happens to be a
+ *   contract. `determineTransactionType` only returns `simpleSend` when `to`
+ *   is not a contract, so these are typed `contractInteraction` even though
+ *   the user chose that address as a plain payee.
+ *
+ * @param transactionMeta - Transaction meta with txParams and type.
+ * @returns Deduplicated send recipient addresses, possibly empty.
+ */
+function getSendRecipients(transactionMeta) {
+    if (isCancellation(transactionMeta)) {
+        return [];
+    }
+    // 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 originalParams = transactionMeta.txParamsOriginal;
+    const params = originalParams ?? 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,
+        inferTransferType: Boolean(originalParams),
+        to: params?.to,
+        type: getEffectiveType(transactionMeta.type, transactionMeta.originalType),
+    }));
+    addRecipient(transactionMeta.swapAndSendRecipient);
+    for (const nestedTransaction of transactionMeta.nestedTransactions ?? []) {
+        addRecipient(getSendRecipientFromSource(nestedTransaction));
+    }
+    return recipients;
+}
+exports.getSendRecipients = getSendRecipients;
+function isCancellation({ type, originalType, }) {
+    return (type === types_js_1.TransactionType.cancel ||
+        (type === types_js_1.TransactionType.retry && originalType === types_js_1.TransactionType.cancel));
+}
+function getSendRecipientFromSource({ data, inferTransferType, to, type, }) {
+    if (isNativeSendType(type, data)) {
+        return to;
+    }
+    if (!hasCalldata(data)) {
+        return undefined;
+    }
+    // Wrapping can replace the current type while preserving the original
+    // calldata without its original type. Infer only for original params so
+    // ordinary contract interactions remain excluded.
+    const inferredType = inferTransferType
+        ? (0, transaction_type_js_1.decodeTransactionData)(data, {
+            getMethodName: true,
+        })
+        : undefined;
+    if (isTokenTransferType(type) || isTokenTransferType(inferredType)) {
+        return decodeTokenTransferRecipient(data);
+    }
+    if (data.slice(0, 10).toLowerCase() ===
+        ERC1155_SAFE_BATCH_TRANSFER_FROM_SELECTOR) {
+        return decodeTokenTransferRecipient(data);
+    }
+    return undefined;
+}
+function isTokenTransferType(type) {
+    return Boolean(type &&
+        TOKEN_TRANSFER_TYPES.some((transferType) => transferType.toLowerCase() === type.toLowerCase()));
+}
+function isNativeSendType(type, data) {
+    if (type === types_js_1.TransactionType.simpleSend) {
+        return true;
+    }
+    return (!hasCalldata(data) &&
+        (type === undefined || type === types_js_1.TransactionType.contractInteraction));
+}
+/**
+ * Resolves the type used to classify a transaction as a send.
+ *
+ * Speed-up transactions keep the original `txParams`, so they should be
+ * classified by what they originally were, not by `retry`. Cancellations
+ * overwrite `to`/`data` into a self-send, so `originalType` would misclassify
+ * them; `type` is returned unchanged instead.
+ *
+ * @param type - The transaction's own type.
+ * @param originalType - The type before a speed-up replaced it, if any.
+ * @returns The type to use when classifying the transaction as a send.
+ */
+function getEffectiveType(type, originalType) {
+    if (type === types_js_1.TransactionType.retry && originalType) {
+        return originalType;
+    }
+    return type;
+}
+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":";;;AAEA,2CAA8C;AAE9C,gEAA8D;AAE9D,MAAM,oBAAoB,GAAG;IAC3B,0BAAe,CAAC,mBAAmB;IACnC,0BAAe,CAAC,uBAAuB;IACvC,0BAAe,CAAC,2BAA2B;CAC5C,CAAC;AAEF,MAAM,yCAAyC,GAAG,YAAY,CAAC;AAS/D;;;;;;;;;;;;;GAaG;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;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAgB,iBAAiB,CAAC,eAAgC;IAChE,IAAI,cAAc,CAAC,eAAe,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,wEAAwE;IACxE,8EAA8E;IAC9E,6EAA6E;IAC7E,2EAA2E;IAC3E,8BAA8B;IAC9B,MAAM,cAAc,GAAG,eAAe,CAAC,gBAAgB,CAAC;IACxD,MAAM,MAAM,GAAG,cAAc,IAAI,eAAe,CAAC,QAAQ,CAAC;IAC1D,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,YAAY,GAAG,CAAC,OAAgB,EAAQ,EAAE;QAC9C,MAAM,UAAU,GAAG,OAAO,EAAE,WAAW,EAAE,CAAC;QAC1C,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACpD,OAAO;QACT,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACrB,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC,CAAC;IAEF,YAAY,CACV,0BAA0B,CAAC;QACzB,IAAI,EAAE,MAAM,EAAE,IAAI;QAClB,iBAAiB,EAAE,OAAO,CAAC,cAAc,CAAC;QAC1C,EAAE,EAAE,MAAM,EAAE,EAAE;QACd,IAAI,EAAE,gBAAgB,CACpB,eAAe,CAAC,IAAI,EACpB,eAAe,CAAC,YAAY,CAC7B;KACF,CAAC,CACH,CAAC;IACF,YAAY,CAAC,eAAe,CAAC,oBAAoB,CAAC,CAAC;IAEnD,KAAK,MAAM,iBAAiB,IAAI,eAAe,CAAC,kBAAkB,IAAI,EAAE,EAAE,CAAC;QACzE,YAAY,CAAC,0BAA0B,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AA1CD,8CA0CC;AAED,SAAS,cAAc,CAAC,EACtB,IAAI,EACJ,YAAY,GACmC;IAC/C,OAAO,CACL,IAAI,KAAK,0BAAe,CAAC,MAAM;QAC/B,CAAC,IAAI,KAAK,0BAAe,CAAC,KAAK,IAAI,YAAY,KAAK,0BAAe,CAAC,MAAM,CAAC,CAC5E,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CAAC,EAClC,IAAI,EACJ,iBAAiB,EACjB,EAAE,EACF,IAAI,GACgB;IACpB,IAAI,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,sEAAsE;IACtE,wEAAwE;IACxE,kDAAkD;IAClD,MAAM,YAAY,GAAG,iBAAiB;QACpC,CAAC,CAAE,IAAA,2CAAqB,EAAC,IAAI,EAAE;YAC3B,aAAa,EAAE,IAAI;SACpB,CAAwB;QAC3B,CAAC,CAAC,SAAS,CAAC;IAEd,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC,YAAY,CAAC,EAAE,CAAC;QACnE,OAAO,4BAA4B,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,IACE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE;QAC/B,yCAAyC,EACzC,CAAC;QACD,OAAO,4BAA4B,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAa;IACxC,OAAO,OAAO,CACZ,IAAI;QACJ,oBAAoB,CAAC,IAAI,CACvB,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CACpE,CACF,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,IAAiC,EACjC,IAAa;IAEb,IAAI,IAAI,KAAK,0BAAe,CAAC,UAAU,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,CAAC,WAAW,CAAC,IAAI,CAAC;QAClB,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,0BAAe,CAAC,mBAAmB,CAAC,CACrE,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,gBAAgB,CACvB,IAAiC,EACjC,YAAyC;IAEzC,IAAI,IAAI,KAAK,0BAAe,CAAC,KAAK,IAAI,YAAY,EAAE,CAAC;QACnD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,IAAa;IAChC,OAAO,OAAO,CAAC,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,4BAA4B,CAAC,IAAY;IAChD,MAAM,MAAM,GAAG,IAAA,2CAAqB,EAAC,IAAI,CAE5B,CAAC;IACd,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,MAAM,EAAE,IAAI,EAAE,EAAE,CAAuB,CAAC;AACvE,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\nconst ERC1155_SAFE_BATCH_TRANSFER_FROM_SELECTOR = '0x2eb2c2d6';\n\ntype SendRecipientSource = {\n  data?: string;\n  inferTransferType?: boolean;\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 * - Decoded `to` for ERC-1155 `safeBatchTransferFrom`\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 * - Speed-up transactions (`type: retry`), classified using `originalType`,\n *   since `txParams` are otherwise unchanged from the transaction being sped\n *   up.\n * - Cancellations and retries of cancellations return no payees. Their\n *   original params, nested transactions, and swap-and-send recipient can\n *   remain on the metadata even though none of those sends executed.\n * - A native transfer with no calldata to an address that happens to be a\n *   contract. `determineTransactionType` only returns `simpleSend` when `to`\n *   is not a contract, so these are typed `contractInteraction` even though\n *   the user chose that address as a plain payee.\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  if (isCancellation(transactionMeta)) {\n    return [];\n  }\n\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 originalParams = transactionMeta.txParamsOriginal;\n  const params = originalParams ?? 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      inferTransferType: Boolean(originalParams),\n      to: params?.to,\n      type: getEffectiveType(\n        transactionMeta.type,\n        transactionMeta.originalType,\n      ),\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 isCancellation({\n  type,\n  originalType,\n}: Pick<TransactionMeta, 'type' | 'originalType'>): boolean {\n  return (\n    type === TransactionType.cancel ||\n    (type === TransactionType.retry && originalType === TransactionType.cancel)\n  );\n}\n\nfunction getSendRecipientFromSource({\n  data,\n  inferTransferType,\n  to,\n  type,\n}: SendRecipientSource): string | undefined {\n  if (isNativeSendType(type, data)) {\n    return to;\n  }\n\n  if (!hasCalldata(data)) {\n    return undefined;\n  }\n\n  // Wrapping can replace the current type while preserving the original\n  // calldata without its original type. Infer only for original params so\n  // ordinary contract interactions remain excluded.\n  const inferredType = inferTransferType\n    ? (decodeTransactionData(data, {\n        getMethodName: true,\n      }) as string | undefined)\n    : undefined;\n\n  if (isTokenTransferType(type) || isTokenTransferType(inferredType)) {\n    return decodeTokenTransferRecipient(data);\n  }\n\n  if (\n    data.slice(0, 10).toLowerCase() ===\n    ERC1155_SAFE_BATCH_TRANSFER_FROM_SELECTOR\n  ) {\n    return decodeTokenTransferRecipient(data);\n  }\n\n  return undefined;\n}\n\nfunction isTokenTransferType(type?: string): boolean {\n  return Boolean(\n    type &&\n    TOKEN_TRANSFER_TYPES.some(\n      (transferType) => transferType.toLowerCase() === type.toLowerCase(),\n    ),\n  );\n}\n\nfunction isNativeSendType(\n  type: TransactionType | undefined,\n  data?: string,\n): boolean {\n  if (type === TransactionType.simpleSend) {\n    return true;\n  }\n\n  return (\n    !hasCalldata(data) &&\n    (type === undefined || type === TransactionType.contractInteraction)\n  );\n}\n\n/**\n * Resolves the type used to classify a transaction as a send.\n *\n * Speed-up transactions keep the original `txParams`, so they should be\n * classified by what they originally were, not by `retry`. Cancellations\n * overwrite `to`/`data` into a self-send, so `originalType` would misclassify\n * them; `type` is returned unchanged instead.\n *\n * @param type - The transaction's own type.\n * @param originalType - The type before a speed-up replaced it, if any.\n * @returns The type to use when classifying the transaction as a send.\n */\nfunction getEffectiveType(\n  type: TransactionType | undefined,\n  originalType: TransactionType | undefined,\n): TransactionType | undefined {\n  if (type === TransactionType.retry && originalType) {\n    return originalType;\n  }\n\n  return type;\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,41 @@ 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
+ * - Decoded `to` for ERC-1155 `safeBatchTransferFrom`
+ * - `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
+ * - Speed-up transactions (`type: retry`), classified using `originalType`,
+ *   since `txParams` are otherwise unchanged from the transaction being sped
+ *   up.
+ * - Cancellations and retries of cancellations return no payees. Their
+ *   original params, nested transactions, and swap-and-send recipient can
+ *   remain on the metadata even though none of those sends executed.
+ * - A native transfer with no calldata to an address that happens to be a
+ *   contract. `determineTransactionType` only returns `simpleSend` when `to`
+ *   is not a contract, so these are typed `contractInteraction` even though
+ *   the user chose that address as a plain payee.
+ *
+ * @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;AAkBnD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,eAAe,GAC/B,MAAM,GAAG,SAAS,CAUpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,eAAe,GAAG,MAAM,EAAE,CA0C5E"}

package/dist/utils/recipient.d.mts

@@ -6,8 +6,41 @@ 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
+ * - Decoded `to` for ERC-1155 `safeBatchTransferFrom`
+ * - `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
+ * - Speed-up transactions (`type: retry`), classified using `originalType`,
+ *   since `txParams` are otherwise unchanged from the transaction being sped
+ *   up.
+ * - Cancellations and retries of cancellations return no payees. Their
+ *   original params, nested transactions, and swap-and-send recipient can
+ *   remain on the metadata even though none of those sends executed.
+ * - A native transfer with no calldata to an address that happens to be a
+ *   contract. `determineTransactionType` only returns `simpleSend` when `to`
+ *   is not a contract, so these are typed `contractInteraction` even though
+ *   the user chose that address as a plain payee.
+ *
+ * @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;AAkBnD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,eAAe,GAC/B,MAAM,GAAG,SAAS,CAUpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,eAAe,GAAG,MAAM,EAAE,CA0C5E"}

package/dist/utils/recipient.mjs

@@ -5,6 +5,7 @@ const TOKEN_TRANSFER_TYPES = [
     TransactionType.tokenMethodTransferFrom,
     TransactionType.tokenMethodSafeTransferFrom,
 ];
+const ERC1155_SAFE_BATCH_TRANSFER_FROM_SELECTOR = '0x2eb2c2d6';
 /**
  * Returns the effective recipient of a transaction.
  * For ERC-20/ERC-721/ERC-1155 token transfer methods, the recipient is decoded
@@ -12,6 +13,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 +29,129 @@ 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
+ * - Decoded `to` for ERC-1155 `safeBatchTransferFrom`
+ * - `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
+ * - Speed-up transactions (`type: retry`), classified using `originalType`,
+ *   since `txParams` are otherwise unchanged from the transaction being sped
+ *   up.
+ * - Cancellations and retries of cancellations return no payees. Their
+ *   original params, nested transactions, and swap-and-send recipient can
+ *   remain on the metadata even though none of those sends executed.
+ * - A native transfer with no calldata to an address that happens to be a
+ *   contract. `determineTransactionType` only returns `simpleSend` when `to`
+ *   is not a contract, so these are typed `contractInteraction` even though
+ *   the user chose that address as a plain payee.
+ *
+ * @param transactionMeta - Transaction meta with txParams and type.
+ * @returns Deduplicated send recipient addresses, possibly empty.
+ */
+export function getSendRecipients(transactionMeta) {
+    if (isCancellation(transactionMeta)) {
+        return [];
+    }
+    // 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 originalParams = transactionMeta.txParamsOriginal;
+    const params = originalParams ?? 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,
+        inferTransferType: Boolean(originalParams),
+        to: params?.to,
+        type: getEffectiveType(transactionMeta.type, transactionMeta.originalType),
+    }));
+    addRecipient(transactionMeta.swapAndSendRecipient);
+    for (const nestedTransaction of transactionMeta.nestedTransactions ?? []) {
+        addRecipient(getSendRecipientFromSource(nestedTransaction));
+    }
+    return recipients;
+}
+function isCancellation({ type, originalType, }) {
+    return (type === TransactionType.cancel ||
+        (type === TransactionType.retry && originalType === TransactionType.cancel));
+}
+function getSendRecipientFromSource({ data, inferTransferType, to, type, }) {
+    if (isNativeSendType(type, data)) {
+        return to;
+    }
+    if (!hasCalldata(data)) {
+        return undefined;
+    }
+    // Wrapping can replace the current type while preserving the original
+    // calldata without its original type. Infer only for original params so
+    // ordinary contract interactions remain excluded.
+    const inferredType = inferTransferType
+        ? decodeTransactionData(data, {
+            getMethodName: true,
+        })
+        : undefined;
+    if (isTokenTransferType(type) || isTokenTransferType(inferredType)) {
+        return decodeTokenTransferRecipient(data);
+    }
+    if (data.slice(0, 10).toLowerCase() ===
+        ERC1155_SAFE_BATCH_TRANSFER_FROM_SELECTOR) {
+        return decodeTokenTransferRecipient(data);
+    }
+    return undefined;
+}
+function isTokenTransferType(type) {
+    return Boolean(type &&
+        TOKEN_TRANSFER_TYPES.some((transferType) => transferType.toLowerCase() === type.toLowerCase()));
+}
+function isNativeSendType(type, data) {
+    if (type === TransactionType.simpleSend) {
+        return true;
+    }
+    return (!hasCalldata(data) &&
+        (type === undefined || type === TransactionType.contractInteraction));
+}
+/**
+ * Resolves the type used to classify a transaction as a send.
+ *
+ * Speed-up transactions keep the original `txParams`, so they should be
+ * classified by what they originally were, not by `retry`. Cancellations
+ * overwrite `to`/`data` into a self-send, so `originalType` would misclassify
+ * them; `type` is returned unchanged instead.
+ *
+ * @param type - The transaction's own type.
+ * @param originalType - The type before a speed-up replaced it, if any.
+ * @returns The type to use when classifying the transaction as a send.
+ */
+function getEffectiveType(type, originalType) {
+    if (type === TransactionType.retry && originalType) {
+        return originalType;
+    }
+    return type;
+}
+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\nconst ERC1155_SAFE_BATCH_TRANSFER_FROM_SELECTOR = '0x2eb2c2d6';\n\ntype SendRecipientSource = {\n  data?: string;\n  inferTransferType?: boolean;\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 * - Decoded `to` for ERC-1155 `safeBatchTransferFrom`\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 * - Speed-up transactions (`type: retry`), classified using `originalType`,\n *   since `txParams` are otherwise unchanged from the transaction being sped\n *   up.\n * - Cancellations and retries of cancellations return no payees. Their\n *   original params, nested transactions, and swap-and-send recipient can\n *   remain on the metadata even though none of those sends executed.\n * - A native transfer with no calldata to an address that happens to be a\n *   contract. `determineTransactionType` only returns `simpleSend` when `to`\n *   is not a contract, so these are typed `contractInteraction` even though\n *   the user chose that address as a plain payee.\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  if (isCancellation(transactionMeta)) {\n    return [];\n  }\n\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 originalParams = transactionMeta.txParamsOriginal;\n  const params = originalParams ?? 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      inferTransferType: Boolean(originalParams),\n      to: params?.to,\n      type: getEffectiveType(\n        transactionMeta.type,\n        transactionMeta.originalType,\n      ),\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 isCancellation({\n  type,\n  originalType,\n}: Pick<TransactionMeta, 'type' | 'originalType'>): boolean {\n  return (\n    type === TransactionType.cancel ||\n    (type === TransactionType.retry && originalType === TransactionType.cancel)\n  );\n}\n\nfunction getSendRecipientFromSource({\n  data,\n  inferTransferType,\n  to,\n  type,\n}: SendRecipientSource): string | undefined {\n  if (isNativeSendType(type, data)) {\n    return to;\n  }\n\n  if (!hasCalldata(data)) {\n    return undefined;\n  }\n\n  // Wrapping can replace the current type while preserving the original\n  // calldata without its original type. Infer only for original params so\n  // ordinary contract interactions remain excluded.\n  const inferredType = inferTransferType\n    ? (decodeTransactionData(data, {\n        getMethodName: true,\n      }) as string | undefined)\n    : undefined;\n\n  if (isTokenTransferType(type) || isTokenTransferType(inferredType)) {\n    return decodeTokenTransferRecipient(data);\n  }\n\n  if (\n    data.slice(0, 10).toLowerCase() ===\n    ERC1155_SAFE_BATCH_TRANSFER_FROM_SELECTOR\n  ) {\n    return decodeTokenTransferRecipient(data);\n  }\n\n  return undefined;\n}\n\nfunction isTokenTransferType(type?: string): boolean {\n  return Boolean(\n    type &&\n    TOKEN_TRANSFER_TYPES.some(\n      (transferType) => transferType.toLowerCase() === type.toLowerCase(),\n    ),\n  );\n}\n\nfunction isNativeSendType(\n  type: TransactionType | undefined,\n  data?: string,\n): boolean {\n  if (type === TransactionType.simpleSend) {\n    return true;\n  }\n\n  return (\n    !hasCalldata(data) &&\n    (type === undefined || type === TransactionType.contractInteraction)\n  );\n}\n\n/**\n * Resolves the type used to classify a transaction as a send.\n *\n * Speed-up transactions keep the original `txParams`, so they should be\n * classified by what they originally were, not by `retry`. Cancellations\n * overwrite `to`/`data` into a self-send, so `originalType` would misclassify\n * them; `type` is returned unchanged instead.\n *\n * @param type - The transaction's own type.\n * @param originalType - The type before a speed-up replaced it, if any.\n * @returns The type to use when classifying the transaction as a send.\n */\nfunction getEffectiveType(\n  type: TransactionType | undefined,\n  originalType: TransactionType | undefined,\n): TransactionType | undefined {\n  if (type === TransactionType.retry && originalType) {\n    return originalType;\n  }\n\n  return type;\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.7.0-preview-a302de5c3",
+  "version": "69.8.0-preview-e12b5ece6",
   "description": "Stores transactions alongside their periodically updated statuses and manages interactions such as approval and cancellation",
   "keywords": [
     "Ethereum",
@@ -74,7 +74,7 @@
     "@metamask/nonce-tracker": "^6.0.0",
     "@metamask/remote-feature-flag-controller": "^6.1.0",
     "@metamask/rpc-errors": "^7.0.2",
-    "@metamask/utils": "^11.11.0",
+    "@metamask/utils": "^11.12.0",
     "async-mutex": "^0.5.0",
     "bignumber.js": "^9.1.2",
     "bn.js": "^5.2.1",