@metamask-previews/client-utils 0.0.0-preview-b3fa32653 → 0.0.0-preview-ee508d7c1

package/CHANGELOG.md

@@ -10,5 +10,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 - Initial release of the `@metamask/client-utils` package for functions and utilities shared across MetaMask clients (extension and mobile) ([#9375](https://github.com/MetaMask/core/pull/9375))
+- Add transaction activity mappers and shared activity types ([#9376](https://github.com/MetaMask/core/pull/9376))
+  - `mapApiTransaction` for mapping EVM API transactions to activity items
+  - `mapKeyringTransaction` for mapping keyring transactions to activity items
+  - `mapLocalTransaction` for mapping local transaction groups to activity items
+  - Shared activity types (`ActivityItem`, `ActivityKind`, `Status`, etc.)
+
+### Changed
+
+- Bump `@metamask/transaction-controller` from `^68.2.2` to `^68.3.0` ([#9421](https://github.com/MetaMask/core/pull/9421))
+- Bump `@metamask/keyring-api` from `^23.3.0` to `^23.5.0` ([#9390](https://github.com/MetaMask/core/pull/9390))
 
 [Unreleased]: https://github.com/MetaMask/core/

package/dist/index.cjs

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-function greeter(name) {
-    return `Hello, ${name}!`;
-}
-exports.default = greeter;
+exports.mapLocalTransaction = exports.mapKeyringTransaction = exports.mapApiTransaction = void 0;
+var api_transaction_mapper_1 = require("./mappers/api-transaction-mapper.cjs");
+Object.defineProperty(exports, "mapApiTransaction", { enumerable: true, get: function () { return api_transaction_mapper_1.mapApiTransaction; } });
+var keyring_transaction_mapper_1 = require("./mappers/keyring-transaction-mapper.cjs");
+Object.defineProperty(exports, "mapKeyringTransaction", { enumerable: true, get: function () { return keyring_transaction_mapper_1.mapKeyringTransaction; } });
+var local_transaction_mapper_1 = require("./mappers/local-transaction-mapper.cjs");
+Object.defineProperty(exports, "mapLocalTransaction", { enumerable: true, get: function () { return local_transaction_mapper_1.mapLocalTransaction; } });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAAA,SAAwB,OAAO,CAAC,IAAY;IAC1C,OAAO,UAAU,IAAI,GAAG,CAAC;AAC3B,CAAC;AAFD,0BAEC","sourcesContent":["export default function greeter(name: string): string {\n  return `Hello, ${name}!`;\n}\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+EAAqE;AAA5D,2HAAA,iBAAiB,OAAA;AAC1B,uFAA6E;AAApE,mIAAA,qBAAqB,OAAA;AAC9B,mFAAyE;AAAhE,+HAAA,mBAAmB,OAAA","sourcesContent":["export { mapApiTransaction } from './mappers/api-transaction-mapper';\nexport { mapKeyringTransaction } from './mappers/keyring-transaction-mapper';\nexport { mapLocalTransaction } from './mappers/local-transaction-mapper';\n\nexport type * from './types';\n"]}

package/dist/index.d.cts

@@ -1,2 +1,5 @@
-export default function greeter(name: string): string;
+export { mapApiTransaction } from "./mappers/api-transaction-mapper.cjs";
+export { mapKeyringTransaction } from "./mappers/keyring-transaction-mapper.cjs";
+export { mapLocalTransaction } from "./mappers/local-transaction-mapper.cjs";
+export type * from "./types.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,OAAO,EAAE,qBAAqB,EAAE,iDAA6C;AAC7E,OAAO,EAAE,mBAAmB,EAAE,+CAA2C;AAEzE,iCAA6B"}

package/dist/index.d.mts

@@ -1,2 +1,5 @@
-export default function greeter(name: string): string;
+export { mapApiTransaction } from "./mappers/api-transaction-mapper.mjs";
+export { mapKeyringTransaction } from "./mappers/keyring-transaction-mapper.mjs";
+export { mapLocalTransaction } from "./mappers/local-transaction-mapper.mjs";
+export type * from "./types.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,OAAO,EAAE,qBAAqB,EAAE,iDAA6C;AAC7E,OAAO,EAAE,mBAAmB,EAAE,+CAA2C;AAEzE,iCAA6B"}

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export default function greeter(name) {
-    return `Hello, ${name}!`;
-}
+export { mapApiTransaction } from "./mappers/api-transaction-mapper.mjs";
+export { mapKeyringTransaction } from "./mappers/keyring-transaction-mapper.mjs";
+export { mapLocalTransaction } from "./mappers/local-transaction-mapper.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,IAAY;IAC1C,OAAO,UAAU,IAAI,GAAG,CAAC;AAC3B,CAAC","sourcesContent":["export default function greeter(name: string): string {\n  return `Hello, ${name}!`;\n}\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,OAAO,EAAE,qBAAqB,EAAE,iDAA6C;AAC7E,OAAO,EAAE,mBAAmB,EAAE,+CAA2C","sourcesContent":["export { mapApiTransaction } from './mappers/api-transaction-mapper';\nexport { mapKeyringTransaction } from './mappers/keyring-transaction-mapper';\nexport { mapLocalTransaction } from './mappers/local-transaction-mapper';\n\nexport type * from './types';\n"]}

package/dist/mappers/api-transaction-mapper.cjs

@@ -0,0 +1,300 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapApiTransaction = void 0;
+const controller_utils_1 = require("@metamask/controller-utils");
+const utils_1 = require("@metamask/utils");
+const constants_1 = require("./constants.cjs");
+const caip_1 = require("./helpers/caip.cjs");
+const transactions_1 = require("./helpers/transactions.cjs");
+/**
+ * Maps an indexed API transaction into the shared activity item shape.
+ *
+ * @param options - The mapping options.
+ * @param options.transaction - The indexed API transaction to map.
+ * @param options.subjectAddress - The account the activity is being mapped for.
+ * @returns The normalized activity item.
+ */
+function mapApiTransaction({ transaction, subjectAddress, }) {
+    const { hash, transactionCategory, valueTransfers, from, methodId } = transaction;
+    const normalizedMethodId = methodId?.toLowerCase() ?? '';
+    const status = transaction.isError ? 'failed' : 'success';
+    const timestamp = new Date(transaction.timestamp).getTime();
+    const chainId = (0, utils_1.toCaipChainId)(utils_1.KnownCaipNamespace.Eip155, transaction.chainId.toString());
+    const getToken = (transfer, direction) => (0, transactions_1.getTokenAmountFromTransfer)(transfer, direction, chainId);
+    const { sentTransfer, receivedTransfer, sentNativeTransfer, sentNftTransfer, receivedNftTransfer, } = (0, transactions_1.parseValueTransfers)(valueTransfers, subjectAddress);
+    const common = { chainId, status, timestamp, hash };
+    if (transactionCategory === 'SWAP' || transactionCategory === 'EXCHANGE') {
+        return {
+            type: 'swap',
+            ...common,
+            data: {
+                sourceToken: getToken(sentTransfer, 'out'),
+                destinationToken: getToken(receivedTransfer, 'in'),
+                fees: (0, transactions_1.getFees)(transaction, chainId),
+                from,
+            },
+        };
+    }
+    if (transactionCategory === 'APPROVE') {
+        // Note: Categorize REVOKE in the backend
+        const direction = receivedTransfer && !sentTransfer ? 'in' : 'out';
+        const valueTransferContractAddress = valueTransfers?.find(({ contractAddress, transferType }) => contractAddress &&
+            transferType !== 'normal' &&
+            transferType !== 'internal')?.contractAddress;
+        const contractAddress = ((0, controller_utils_1.isValidHexAddress)(transaction.to, { allowNonPrefixed: false })
+            ? transaction.to
+            : undefined) ??
+            (valueTransferContractAddress &&
+                (0, controller_utils_1.isValidHexAddress)(valueTransferContractAddress, {
+                    allowNonPrefixed: false,
+                })
+                ? valueTransferContractAddress
+                : undefined);
+        const assetId = contractAddress
+            ? (0, caip_1.formatAddressToAssetId)(contractAddress, chainId)
+            : undefined;
+        const token = (0, transactions_1.getTokenMetadataFromKnownToken)(contractAddress, direction, chainId) ??
+            (assetId ? { direction, assetId } : undefined);
+        return {
+            type: 'approveSpendingCap',
+            ...common,
+            data: {
+                from,
+                token,
+                fees: (0, transactions_1.getFees)(transaction, chainId),
+            },
+        };
+    }
+    // Note: Categorize NFT in the backend
+    if (sentNftTransfer || receivedNftTransfer) {
+        const isNftExchange = transactionCategory === 'NFT_EXCHANGE';
+        if (receivedNftTransfer) {
+            if (receivedNftTransfer.from === constants_1.nativeTokenAddress) {
+                return {
+                    type: 'nftMint',
+                    ...common,
+                    data: {
+                        from: receivedNftTransfer.from,
+                        to: receivedNftTransfer.to,
+                        token: getToken(receivedNftTransfer, 'in'),
+                    },
+                };
+            }
+            const purchasePaymentTransfer = (0, transactions_1.getNftPaymentTransfer)({
+                side: 'buy',
+                sentTransfer,
+                sentNativeTransfer,
+                nftCounterparty: receivedNftTransfer.from,
+                transactionTo: transaction.to,
+                subjectAddress,
+            });
+            if (isNftExchange || purchasePaymentTransfer) {
+                return {
+                    type: 'nftBuy',
+                    ...common,
+                    data: {
+                        from: receivedNftTransfer.from,
+                        to: receivedNftTransfer.to,
+                        token: getToken(receivedNftTransfer, 'in'),
+                        paymentToken: getToken(purchasePaymentTransfer, 'out'),
+                    },
+                };
+            }
+            return {
+                type: 'receive',
+                ...common,
+                data: {
+                    from: receivedNftTransfer.from,
+                    to: receivedNftTransfer.to,
+                    token: getToken(receivedNftTransfer, 'in'),
+                },
+            };
+        }
+        if (sentNftTransfer) {
+            const saleProceedsTransfer = (0, transactions_1.getNftPaymentTransfer)({
+                side: 'sell',
+                receivedTransfer,
+                nftCounterparty: sentNftTransfer.to,
+                transactionFrom: from,
+                subjectAddress,
+            });
+            if (isNftExchange || saleProceedsTransfer) {
+                return {
+                    type: 'nftSell',
+                    ...common,
+                    data: {
+                        from: sentNftTransfer.from,
+                        to: sentNftTransfer.to,
+                        token: getToken(sentNftTransfer, 'out'),
+                        paymentToken: getToken(saleProceedsTransfer, 'in'),
+                    },
+                };
+            }
+            return {
+                type: 'send',
+                ...common,
+                data: {
+                    from: sentNftTransfer.from,
+                    to: sentNftTransfer.to,
+                    token: getToken(sentNftTransfer, 'out'),
+                },
+            };
+        }
+    }
+    const hasNativeTransferWithoutMethod = transactionCategory === 'CONTRACT_CALL' &&
+        !methodId &&
+        valueTransfers?.some(({ transferType }) => transferType === 'normal');
+    if (transactionCategory === 'TRANSFER' ||
+        transactionCategory === 'STANDARD' ||
+        hasNativeTransferWithoutMethod) {
+        const isReceive = Boolean(receivedTransfer && !sentTransfer) ||
+            ((0, controller_utils_1.isEqualCaseInsensitive)(transaction.to, subjectAddress) &&
+                !(0, controller_utils_1.isEqualCaseInsensitive)(from, subjectAddress));
+        const transfer = isReceive ? receivedTransfer : sentTransfer;
+        const direction = isReceive ? 'in' : 'out';
+        const nativeAsset = (0, caip_1.getNativeAsset)(chainId);
+        const nativeToken = transactionCategory === 'STANDARD' && nativeAsset
+            ? {
+                ...nativeAsset,
+                amount: transaction.value,
+                direction,
+            }
+            : undefined;
+        return {
+            type: isReceive ? 'receive' : 'send',
+            ...common,
+            data: {
+                from: transfer?.from ?? from,
+                to: transfer?.to ?? transaction.to,
+                token: (0, transactions_1.withFallbackTokenAssetId)(getToken(transfer, direction), transaction.to, transfer?.transferType, chainId) ?? nativeToken,
+                fees: (0, transactions_1.getFees)(transaction, chainId),
+            },
+        };
+    }
+    if (transactionCategory === 'CLAIM_BONUS') {
+        return {
+            type: 'claimMusdBonus',
+            ...common,
+            data: {
+                from,
+                token: getToken(receivedTransfer, 'in'),
+            },
+        };
+    }
+    if (transactionCategory === 'CLAIM') {
+        return {
+            type: 'claim',
+            ...common,
+            data: {
+                from,
+                token: getToken(receivedTransfer ?? sentTransfer, receivedTransfer ? 'in' : 'out'),
+            },
+        };
+    }
+    if (transactionCategory === 'BRIDGE_WITHDRAW') {
+        return {
+            type: 'bridge',
+            ...common,
+            data: {
+                from,
+                sourceToken: getToken(sentTransfer, 'out'),
+                fees: (0, transactions_1.getFees)(transaction, chainId),
+            },
+        };
+    }
+    if (transactionCategory === 'WITHDRAW' &&
+        constants_1.withdrawMethodIds.has(normalizedMethodId)) {
+        return {
+            type: 'lendingWithdrawal',
+            ...common,
+            data: {
+                from,
+                sourceToken: getToken(sentTransfer, 'out'),
+                destinationToken: getToken(receivedTransfer, 'in'),
+                fees: (0, transactions_1.getFees)(transaction, chainId),
+            },
+        };
+    }
+    // Note: Categorize Deposit/Stake in the backend
+    if (sentTransfer && constants_1.supplyMethodIds.has(normalizedMethodId)) {
+        return {
+            type: 'lendingDeposit',
+            ...common,
+            data: {
+                from,
+                sourceToken: getToken(sentTransfer, 'out'),
+                destinationToken: getToken(receivedTransfer, 'in'),
+                fees: (0, transactions_1.getFees)(transaction, chainId),
+            },
+        };
+    }
+    const wrappedNativeAddress = constants_1.swapsWrappedTokensAddresses[`0x${transaction.chainId.toString(16)}`];
+    if (receivedTransfer &&
+        constants_1.wrapMethodIds.has(normalizedMethodId) &&
+        wrappedNativeAddress &&
+        (0, controller_utils_1.isEqualCaseInsensitive)(transaction.to, wrappedNativeAddress)) {
+        return {
+            type: 'wrap',
+            ...common,
+            data: {
+                from,
+                sourceToken: getToken(sentTransfer, 'out'),
+                destinationToken: getToken(receivedTransfer, 'in'),
+                fees: (0, transactions_1.getFees)(transaction, chainId),
+            },
+        };
+    }
+    if (transactionCategory === 'UNWRAP') {
+        return {
+            type: 'unwrap',
+            ...common,
+            data: {
+                from,
+                sourceToken: getToken(sentTransfer, 'out'),
+                destinationToken: getToken(receivedTransfer, 'in'),
+                fees: (0, transactions_1.getFees)(transaction, chainId),
+            },
+        };
+    }
+    // Note: Categorize these Swaps in the backend
+    if (transactionCategory === 'CONTRACT_CALL' &&
+        sentTransfer?.symbol &&
+        receivedTransfer?.symbol &&
+        sentTransfer.symbol !== receivedTransfer.symbol) {
+        return {
+            type: 'swap',
+            ...common,
+            data: {
+                from,
+                sourceToken: getToken(sentTransfer, 'out'),
+                destinationToken: getToken(receivedTransfer, 'in'),
+                fees: (0, transactions_1.getFees)(transaction, chainId),
+            },
+        };
+    }
+    if (transactionCategory === 'DEPOSIT') {
+        return {
+            type: 'deposit',
+            ...common,
+            data: {
+                from,
+                token: getToken(sentTransfer, 'out'),
+            },
+        };
+    }
+    const token = getToken(sentTransfer ?? receivedTransfer, sentTransfer ? 'out' : 'in');
+    return {
+        type: 'contractInteraction',
+        ...common,
+        data: {
+            methodId,
+            from,
+            to: transaction.to,
+            transactionCategory,
+            transactionProtocol: transaction.transactionProtocol,
+            ...(token ? { token } : {}),
+        },
+    };
+}
+exports.mapApiTransaction = mapApiTransaction;
+//# sourceMappingURL=api-transaction-mapper.cjs.map

package/dist/mappers/api-transaction-mapper.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-transaction-mapper.cjs","sourceRoot":"","sources":["../../src/mappers/api-transaction-mapper.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  isEqualCaseInsensitive as equalsIgnoreCase,\n  isValidHexAddress,\n} from '@metamask/controller-utils';\nimport type { V1TransactionByHashResponse } from '@metamask/core-backend';\nimport { KnownCaipNamespace, toCaipChainId } from '@metamask/utils';\n\nimport type {\n  ActivityItem,\n  Status,\n  TokenAmount,\n  ValueTransfer,\n} from '../types';\nimport {\n  nativeTokenAddress,\n  supplyMethodIds,\n  swapsWrappedTokensAddresses,\n  withdrawMethodIds,\n  wrapMethodIds,\n} from './constants';\nimport { formatAddressToAssetId, getNativeAsset } from './helpers/caip';\nimport {\n  getFees,\n  getNftPaymentTransfer,\n  getTokenAmountFromTransfer,\n  getTokenMetadataFromKnownToken,\n  parseValueTransfers,\n  withFallbackTokenAssetId,\n} from './helpers/transactions';\n\n/**\n * Maps an indexed API transaction into the shared activity item shape.\n *\n * @param options - The mapping options.\n * @param options.transaction - The indexed API transaction to map.\n * @param options.subjectAddress - The account the activity is being mapped for.\n * @returns The normalized activity item.\n */\nexport function mapApiTransaction({\n  transaction,\n  subjectAddress,\n}: {\n  transaction: V1TransactionByHashResponse;\n  subjectAddress: string;\n}): ActivityItem {\n  const { hash, transactionCategory, valueTransfers, from, methodId } =\n    transaction;\n  const normalizedMethodId = methodId?.toLowerCase() ?? '';\n  const status: Status = transaction.isError ? 'failed' : 'success';\n  const timestamp = new Date(transaction.timestamp).getTime();\n  const chainId = toCaipChainId(\n    KnownCaipNamespace.Eip155,\n    transaction.chainId.toString(),\n  );\n  const getToken = (\n    transfer: ValueTransfer | undefined,\n    direction: TokenAmount['direction'],\n  ): TokenAmount | undefined =>\n    getTokenAmountFromTransfer(transfer, direction, chainId);\n\n  const {\n    sentTransfer,\n    receivedTransfer,\n    sentNativeTransfer,\n    sentNftTransfer,\n    receivedNftTransfer,\n  } = parseValueTransfers(valueTransfers, subjectAddress);\n\n  const common = { chainId, status, timestamp, hash };\n\n  if (transactionCategory === 'SWAP' || transactionCategory === 'EXCHANGE') {\n    return {\n      type: 'swap',\n      ...common,\n      data: {\n        sourceToken: getToken(sentTransfer, 'out'),\n        destinationToken: getToken(receivedTransfer, 'in'),\n        fees: getFees(transaction, chainId),\n        from,\n      },\n    };\n  }\n\n  if (transactionCategory === 'APPROVE') {\n    // Note: Categorize REVOKE in the backend\n    const direction = receivedTransfer && !sentTransfer ? 'in' : 'out';\n    const valueTransferContractAddress = valueTransfers?.find(\n      ({ contractAddress, transferType }) =>\n        contractAddress &&\n        transferType !== 'normal' &&\n        transferType !== 'internal',\n    )?.contractAddress;\n    const contractAddress =\n      (isValidHexAddress(transaction.to, { allowNonPrefixed: false })\n        ? transaction.to\n        : undefined) ??\n      (valueTransferContractAddress &&\n      isValidHexAddress(valueTransferContractAddress, {\n        allowNonPrefixed: false,\n      })\n        ? valueTransferContractAddress\n        : undefined);\n    const assetId = contractAddress\n      ? formatAddressToAssetId(contractAddress, chainId)\n      : undefined;\n    const token =\n      getTokenMetadataFromKnownToken(contractAddress, direction, chainId) ??\n      (assetId ? { direction, assetId } : undefined);\n\n    return {\n      type: 'approveSpendingCap',\n      ...common,\n      data: {\n        from,\n        token,\n        fees: getFees(transaction, chainId),\n      },\n    };\n  }\n\n  // Note: Categorize NFT in the backend\n  if (sentNftTransfer || receivedNftTransfer) {\n    const isNftExchange = transactionCategory === 'NFT_EXCHANGE';\n\n    if (receivedNftTransfer) {\n      if (receivedNftTransfer.from === nativeTokenAddress) {\n        return {\n          type: 'nftMint',\n          ...common,\n          data: {\n            from: receivedNftTransfer.from,\n            to: receivedNftTransfer.to,\n            token: getToken(receivedNftTransfer, 'in'),\n          },\n        };\n      }\n\n      const purchasePaymentTransfer = getNftPaymentTransfer({\n        side: 'buy',\n        sentTransfer,\n        sentNativeTransfer,\n        nftCounterparty: receivedNftTransfer.from,\n        transactionTo: transaction.to,\n        subjectAddress,\n      });\n\n      if (isNftExchange || purchasePaymentTransfer) {\n        return {\n          type: 'nftBuy',\n          ...common,\n          data: {\n            from: receivedNftTransfer.from,\n            to: receivedNftTransfer.to,\n            token: getToken(receivedNftTransfer, 'in'),\n            paymentToken: getToken(purchasePaymentTransfer, 'out'),\n          },\n        };\n      }\n\n      return {\n        type: 'receive',\n        ...common,\n        data: {\n          from: receivedNftTransfer.from,\n          to: receivedNftTransfer.to,\n          token: getToken(receivedNftTransfer, 'in'),\n        },\n      };\n    }\n\n    if (sentNftTransfer) {\n      const saleProceedsTransfer = getNftPaymentTransfer({\n        side: 'sell',\n        receivedTransfer,\n        nftCounterparty: sentNftTransfer.to,\n        transactionFrom: from,\n        subjectAddress,\n      });\n\n      if (isNftExchange || saleProceedsTransfer) {\n        return {\n          type: 'nftSell',\n          ...common,\n          data: {\n            from: sentNftTransfer.from,\n            to: sentNftTransfer.to,\n            token: getToken(sentNftTransfer, 'out'),\n            paymentToken: getToken(saleProceedsTransfer, 'in'),\n          },\n        };\n      }\n\n      return {\n        type: 'send',\n        ...common,\n        data: {\n          from: sentNftTransfer.from,\n          to: sentNftTransfer.to,\n          token: getToken(sentNftTransfer, 'out'),\n        },\n      };\n    }\n  }\n\n  const hasNativeTransferWithoutMethod =\n    transactionCategory === 'CONTRACT_CALL' &&\n    !methodId &&\n    valueTransfers?.some(({ transferType }) => transferType === 'normal');\n\n  if (\n    transactionCategory === 'TRANSFER' ||\n    transactionCategory === 'STANDARD' ||\n    hasNativeTransferWithoutMethod\n  ) {\n    const isReceive =\n      Boolean(receivedTransfer && !sentTransfer) ||\n      (equalsIgnoreCase(transaction.to, subjectAddress) &&\n        !equalsIgnoreCase(from, subjectAddress));\n\n    const transfer = isReceive ? receivedTransfer : sentTransfer;\n    const direction = isReceive ? 'in' : 'out';\n    const nativeAsset = getNativeAsset(chainId);\n    const nativeToken =\n      transactionCategory === 'STANDARD' && nativeAsset\n        ? ({\n            ...nativeAsset,\n            amount: transaction.value,\n            direction,\n          } as TokenAmount)\n        : undefined;\n\n    return {\n      type: isReceive ? 'receive' : 'send',\n      ...common,\n      data: {\n        from: transfer?.from ?? from,\n        to: transfer?.to ?? transaction.to,\n        token:\n          withFallbackTokenAssetId(\n            getToken(transfer, direction),\n            transaction.to,\n            transfer?.transferType,\n            chainId,\n          ) ?? nativeToken,\n        fees: getFees(transaction, chainId),\n      },\n    };\n  }\n\n  if (transactionCategory === 'CLAIM_BONUS') {\n    return {\n      type: 'claimMusdBonus',\n      ...common,\n      data: {\n        from,\n        token: getToken(receivedTransfer, 'in'),\n      },\n    };\n  }\n\n  if (transactionCategory === 'CLAIM') {\n    return {\n      type: 'claim',\n      ...common,\n      data: {\n        from,\n        token: getToken(\n          receivedTransfer ?? sentTransfer,\n          receivedTransfer ? 'in' : 'out',\n        ),\n      },\n    };\n  }\n\n  if (transactionCategory === 'BRIDGE_WITHDRAW') {\n    return {\n      type: 'bridge',\n      ...common,\n      data: {\n        from,\n        sourceToken: getToken(sentTransfer, 'out'),\n        fees: getFees(transaction, chainId),\n      },\n    };\n  }\n\n  if (\n    transactionCategory === 'WITHDRAW' &&\n    withdrawMethodIds.has(normalizedMethodId)\n  ) {\n    return {\n      type: 'lendingWithdrawal',\n      ...common,\n      data: {\n        from,\n        sourceToken: getToken(sentTransfer, 'out'),\n        destinationToken: getToken(receivedTransfer, 'in'),\n        fees: getFees(transaction, chainId),\n      },\n    };\n  }\n\n  // Note: Categorize Deposit/Stake in the backend\n  if (sentTransfer && supplyMethodIds.has(normalizedMethodId)) {\n    return {\n      type: 'lendingDeposit',\n      ...common,\n      data: {\n        from,\n        sourceToken: getToken(sentTransfer, 'out'),\n        destinationToken: getToken(receivedTransfer, 'in'),\n        fees: getFees(transaction, chainId),\n      },\n    };\n  }\n\n  const wrappedNativeAddress =\n    swapsWrappedTokensAddresses[\n      `0x${transaction.chainId.toString(\n        16,\n      )}` as keyof typeof swapsWrappedTokensAddresses\n    ];\n\n  if (\n    receivedTransfer &&\n    wrapMethodIds.has(normalizedMethodId) &&\n    wrappedNativeAddress &&\n    equalsIgnoreCase(transaction.to, wrappedNativeAddress)\n  ) {\n    return {\n      type: 'wrap',\n      ...common,\n      data: {\n        from,\n        sourceToken: getToken(sentTransfer, 'out'),\n        destinationToken: getToken(receivedTransfer, 'in'),\n        fees: getFees(transaction, chainId),\n      },\n    };\n  }\n\n  if (transactionCategory === 'UNWRAP') {\n    return {\n      type: 'unwrap',\n      ...common,\n      data: {\n        from,\n        sourceToken: getToken(sentTransfer, 'out'),\n        destinationToken: getToken(receivedTransfer, 'in'),\n        fees: getFees(transaction, chainId),\n      },\n    };\n  }\n\n  // Note: Categorize these Swaps in the backend\n  if (\n    transactionCategory === 'CONTRACT_CALL' &&\n    sentTransfer?.symbol &&\n    receivedTransfer?.symbol &&\n    sentTransfer.symbol !== receivedTransfer.symbol\n  ) {\n    return {\n      type: 'swap',\n      ...common,\n      data: {\n        from,\n        sourceToken: getToken(sentTransfer, 'out'),\n        destinationToken: getToken(receivedTransfer, 'in'),\n        fees: getFees(transaction, chainId),\n      },\n    };\n  }\n\n  if (transactionCategory === 'DEPOSIT') {\n    return {\n      type: 'deposit',\n      ...common,\n      data: {\n        from,\n        token: getToken(sentTransfer, 'out'),\n      },\n    };\n  }\n\n  const token = getToken(\n    sentTransfer ?? receivedTransfer,\n    sentTransfer ? 'out' : 'in',\n  );\n\n  return {\n    type: 'contractInteraction',\n    ...common,\n    data: {\n      methodId,\n      from,\n      to: transaction.to,\n      transactionCategory,\n      transactionProtocol: transaction.transactionProtocol,\n      ...(token ? { token } : {}),\n    },\n  };\n}\n"]}

package/dist/mappers/api-transaction-mapper.d.cts

@@ -0,0 +1,15 @@
+import type { V1TransactionByHashResponse } from "@metamask/core-backend";
+import type { ActivityItem } from "../types.cjs";
+/**
+ * Maps an indexed API transaction into the shared activity item shape.
+ *
+ * @param options - The mapping options.
+ * @param options.transaction - The indexed API transaction to map.
+ * @param options.subjectAddress - The account the activity is being mapped for.
+ * @returns The normalized activity item.
+ */
+export declare function mapApiTransaction({ transaction, subjectAddress, }: {
+    transaction: V1TransactionByHashResponse;
+    subjectAddress: string;
+}): ActivityItem;
+//# sourceMappingURL=api-transaction-mapper.d.cts.map

package/dist/mappers/api-transaction-mapper.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-transaction-mapper.d.cts","sourceRoot":"","sources":["../../src/mappers/api-transaction-mapper.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,2BAA2B,EAAE,+BAA+B;AAG1E,OAAO,KAAK,EACV,YAAY,EAIb,qBAAiB;AAkBlB;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,WAAW,EACX,cAAc,GACf,EAAE;IACD,WAAW,EAAE,2BAA2B,CAAC;IACzC,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,YAAY,CAqWf"}

package/dist/mappers/api-transaction-mapper.d.mts

@@ -0,0 +1,15 @@
+import type { V1TransactionByHashResponse } from "@metamask/core-backend";
+import type { ActivityItem } from "../types.mjs";
+/**
+ * Maps an indexed API transaction into the shared activity item shape.
+ *
+ * @param options - The mapping options.
+ * @param options.transaction - The indexed API transaction to map.
+ * @param options.subjectAddress - The account the activity is being mapped for.
+ * @returns The normalized activity item.
+ */
+export declare function mapApiTransaction({ transaction, subjectAddress, }: {
+    transaction: V1TransactionByHashResponse;
+    subjectAddress: string;
+}): ActivityItem;
+//# sourceMappingURL=api-transaction-mapper.d.mts.map

package/dist/mappers/api-transaction-mapper.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-transaction-mapper.d.mts","sourceRoot":"","sources":["../../src/mappers/api-transaction-mapper.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,2BAA2B,EAAE,+BAA+B;AAG1E,OAAO,KAAK,EACV,YAAY,EAIb,qBAAiB;AAkBlB;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,WAAW,EACX,cAAc,GACf,EAAE;IACD,WAAW,EAAE,2BAA2B,CAAC;IACzC,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,YAAY,CAqWf"}