@metamask/client-utils 1.0.0

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

@@ -0,0 +1,15 @@
+import type { Transaction as KeyringTransaction } from "@metamask/keyring-api";
+import type { ActivityItem } from "../types.mjs";
+/**
+ * Maps a keyring transaction into the shared activity item shape.
+ *
+ * @param options - The mapping options.
+ * @param options.transaction - The keyring transaction to map.
+ * @param options.subjectAddress - Account address used for send/receive attribution.
+ * @returns The normalized activity item.
+ */
+export declare function mapKeyringTransaction({ transaction, subjectAddress, }: {
+    transaction: KeyringTransaction;
+    subjectAddress?: string;
+}): ActivityItem;
+//# sourceMappingURL=keyring-transaction-mapper.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyring-transaction-mapper.d.mts","sourceRoot":"","sources":["../../src/mappers/keyring-transaction-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,IAAI,kBAAkB,EAAE,8BAA8B;AAM/E,OAAO,KAAK,EAAO,YAAY,EAAuB,qBAAiB;AA2EvE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,WAAW,EACX,cAAc,GACf,EAAE;IACD,WAAW,EAAE,kBAAkB,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,YAAY,CA6Ff"}

package/dist/mappers/keyring-transaction-mapper.mjs

@@ -0,0 +1,139 @@
+import { TransactionStatus, TransactionType as KeyringTransactionType } from "@metamask/keyring-api";
+function mapStatus(status) {
+    switch (status) {
+        case TransactionStatus.Confirmed:
+            return 'success';
+        case TransactionStatus.Failed:
+            return 'failed';
+        case TransactionStatus.Submitted:
+        case TransactionStatus.Unconfirmed:
+        default:
+            return 'pending';
+    }
+}
+function getAddress(movements) {
+    return movements[0]?.address ?? '';
+}
+function hasFungibleAsset(movement) {
+    return movement.asset?.fungible === true;
+}
+function getToken(movements, direction) {
+    const movement = movements.find(hasFungibleAsset);
+    if (!movement) {
+        return undefined;
+    }
+    return {
+        amount: movement.asset.amount,
+        symbol: movement.asset.unit,
+        assetId: movement.asset.type,
+        direction,
+    };
+}
+function getFee(fee) {
+    const { asset } = fee;
+    if (!asset.fungible) {
+        return undefined;
+    }
+    return {
+        type: fee.type,
+        amount: asset.amount,
+        symbol: asset.unit,
+        assetId: asset.type,
+    };
+}
+function getFees(transaction) {
+    return transaction.fees.flatMap((fee) => {
+        const mappedFee = getFee(fee);
+        return mappedFee ? [mappedFee] : [];
+    });
+}
+const approveAmountMaxIntegerDigits = 15;
+/**
+ * Maps a keyring transaction into the shared activity item shape.
+ *
+ * @param options - The mapping options.
+ * @param options.transaction - The keyring transaction to map.
+ * @param options.subjectAddress - Account address used for send/receive attribution.
+ * @returns The normalized activity item.
+ */
+export function mapKeyringTransaction({ transaction, subjectAddress, }) {
+    const { type, id } = transaction;
+    const status = mapStatus(transaction.status);
+    const timestamp = transaction.timestamp ? transaction.timestamp * 1000 : 0;
+    const chainId = transaction.chain;
+    const from = type === KeyringTransactionType.Send && subjectAddress
+        ? subjectAddress
+        : getAddress(transaction.from);
+    const to = type === KeyringTransactionType.Receive && subjectAddress
+        ? subjectAddress
+        : getAddress(transaction.to);
+    const fees = getFees(transaction);
+    const common = { chainId, status, timestamp, hash: id };
+    switch (type) {
+        case KeyringTransactionType.Send: {
+            const fromToken = getToken(transaction.from, 'out');
+            const token = !fromToken && chainId.startsWith('bip122:')
+                ? getToken(transaction.to, 'out')
+                : fromToken;
+            return {
+                type: 'send',
+                ...common,
+                data: {
+                    from,
+                    to,
+                    token,
+                    fees,
+                },
+            };
+        }
+        case KeyringTransactionType.Receive:
+            return {
+                type: 'receive',
+                ...common,
+                data: {
+                    from,
+                    to,
+                    token: getToken(transaction.to, 'in'),
+                    fees,
+                },
+            };
+        case KeyringTransactionType.Swap:
+            return {
+                type: 'swap',
+                ...common,
+                data: {
+                    from,
+                    destinationToken: getToken(transaction.to, 'in'),
+                    sourceToken: getToken(transaction.from, 'out'),
+                    fees,
+                },
+            };
+        case KeyringTransactionType.TokenApprove: {
+            const rawToken = getToken(transaction.from, 'out');
+            const isUnlimited = rawToken?.amount !== undefined &&
+                rawToken.amount.split('.')[0].length > approveAmountMaxIntegerDigits;
+            return {
+                type: 'approveSpendingCap',
+                ...common,
+                data: {
+                    from,
+                    token: rawToken
+                        ? { ...rawToken, amount: isUnlimited ? undefined : rawToken.amount }
+                        : rawToken,
+                    fees,
+                },
+            };
+        }
+        default:
+            return {
+                type: 'contractInteraction',
+                ...common,
+                data: {
+                    from,
+                    to,
+                    fees,
+                },
+            };
+    }
+}
+//# sourceMappingURL=keyring-transaction-mapper.mjs.map

package/dist/mappers/keyring-transaction-mapper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyring-transaction-mapper.mjs","sourceRoot":"","sources":["../../src/mappers/keyring-transaction-mapper.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Transaction as KeyringTransaction } from '@metamask/keyring-api';\nimport {\n  TransactionStatus,\n  TransactionType as KeyringTransactionType,\n} from '@metamask/keyring-api';\n\nimport type { Fee, ActivityItem, Status, TokenAmount } from '../types';\n\ntype Movement = KeyringTransaction['from'][number];\ntype KeyringFee = KeyringTransaction['fees'][number];\ntype FungibleAsset = Extract<\n  NonNullable<Movement['asset']>,\n  { fungible: true }\n>;\n\nfunction mapStatus(status: KeyringTransaction['status']): Status {\n  switch (status) {\n    case TransactionStatus.Confirmed:\n      return 'success';\n    case TransactionStatus.Failed:\n      return 'failed';\n    case TransactionStatus.Submitted:\n    case TransactionStatus.Unconfirmed:\n    default:\n      return 'pending';\n  }\n}\n\nfunction getAddress(movements: Movement[]): string {\n  return movements[0]?.address ?? '';\n}\n\nfunction hasFungibleAsset(\n  movement: Movement,\n): movement is Movement & { asset: FungibleAsset } {\n  return movement.asset?.fungible === true;\n}\n\nfunction getToken(\n  movements: Movement[],\n  direction: TokenAmount['direction'],\n): TokenAmount | undefined {\n  const movement = movements.find(hasFungibleAsset);\n\n  if (!movement) {\n    return undefined;\n  }\n\n  return {\n    amount: movement.asset.amount,\n    symbol: movement.asset.unit,\n    assetId: movement.asset.type,\n    direction,\n  };\n}\n\nfunction getFee(fee: KeyringFee): Fee | undefined {\n  const { asset } = fee;\n\n  if (!asset.fungible) {\n    return undefined;\n  }\n\n  return {\n    type: fee.type,\n    amount: asset.amount,\n    symbol: asset.unit,\n    assetId: asset.type,\n  };\n}\n\nfunction getFees(transaction: KeyringTransaction): Fee[] {\n  return transaction.fees.flatMap((fee) => {\n    const mappedFee = getFee(fee);\n\n    return mappedFee ? [mappedFee] : [];\n  });\n}\n\nconst approveAmountMaxIntegerDigits = 15;\n\n/**\n * Maps a keyring transaction into the shared activity item shape.\n *\n * @param options - The mapping options.\n * @param options.transaction - The keyring transaction to map.\n * @param options.subjectAddress - Account address used for send/receive attribution.\n * @returns The normalized activity item.\n */\nexport function mapKeyringTransaction({\n  transaction,\n  subjectAddress,\n}: {\n  transaction: KeyringTransaction;\n  subjectAddress?: string;\n}): ActivityItem {\n  const { type, id } = transaction;\n  const status = mapStatus(transaction.status);\n  const timestamp = transaction.timestamp ? transaction.timestamp * 1000 : 0;\n  const chainId = transaction.chain;\n\n  const from =\n    type === KeyringTransactionType.Send && subjectAddress\n      ? subjectAddress\n      : getAddress(transaction.from);\n\n  const to =\n    type === KeyringTransactionType.Receive && subjectAddress\n      ? subjectAddress\n      : getAddress(transaction.to);\n\n  const fees = getFees(transaction);\n  const common = { chainId, status, timestamp, hash: id };\n\n  switch (type) {\n    case KeyringTransactionType.Send: {\n      const fromToken = getToken(transaction.from, 'out');\n      const token =\n        !fromToken && chainId.startsWith('bip122:')\n          ? getToken(transaction.to, 'out')\n          : fromToken;\n\n      return {\n        type: 'send',\n        ...common,\n        data: {\n          from,\n          to,\n          token,\n          fees,\n        },\n      };\n    }\n\n    case KeyringTransactionType.Receive:\n      return {\n        type: 'receive',\n        ...common,\n        data: {\n          from,\n          to,\n          token: getToken(transaction.to, 'in'),\n          fees,\n        },\n      };\n\n    case KeyringTransactionType.Swap:\n      return {\n        type: 'swap',\n        ...common,\n        data: {\n          from,\n          destinationToken: getToken(transaction.to, 'in'),\n          sourceToken: getToken(transaction.from, 'out'),\n          fees,\n        },\n      };\n\n    case KeyringTransactionType.TokenApprove: {\n      const rawToken = getToken(transaction.from, 'out');\n      const isUnlimited =\n        rawToken?.amount !== undefined &&\n        rawToken.amount.split('.')[0].length > approveAmountMaxIntegerDigits;\n\n      return {\n        type: 'approveSpendingCap',\n        ...common,\n        data: {\n          from,\n          token: rawToken\n            ? { ...rawToken, amount: isUnlimited ? undefined : rawToken.amount }\n            : rawToken,\n          fees,\n        },\n      };\n    }\n\n    default:\n      return {\n        type: 'contractInteraction',\n        ...common,\n        data: {\n          from,\n          to,\n          fees,\n        },\n      };\n  }\n}\n"]}

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

@@ -0,0 +1,420 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapLocalTransaction = void 0;
+const controller_utils_1 = require("@metamask/controller-utils");
+const transaction_controller_1 = require("@metamask/transaction-controller");
+const utils_1 = require("@metamask/utils");
+const constants_1 = require("./constants.cjs");
+const caip_1 = require("./helpers/caip.cjs");
+const token_metadata_1 = require("./helpers/token-metadata.cjs");
+const transactions_1 = require("./helpers/transactions.cjs");
+const evmNativeDecimals = 18;
+/**
+ * Maps a local TransactionController group into the shared activity item shape.
+ *
+ * @param transactionGroup - The transaction group to map, optionally enriched by the client.
+ * @returns The normalized activity item.
+ */
+function mapLocalTransaction(transactionGroup) {
+    const fees = transactionGroup.fees ?? (0, transactions_1.getLocalTransactionFees)(transactionGroup);
+    const { initialTransaction, primaryTransaction } = transactionGroup;
+    const { transferInformation, type: transactionType, simulationData, txReceipt, metamaskPay, txParams: { from = '', to = '', data: txData, value: txValue } = {}, } = initialTransaction;
+    const { time: primaryTime, hash: primaryHash, id: primaryId, } = primaryTransaction;
+    const methodId = txData?.slice(0, 10);
+    // Permit2 approvals use the Permit2 contract as `to`, not the approved token.
+    // Keep this mapper thin: still classify the activity as an approve, but omit
+    // the token rather than surfacing the wrong one — the API mapper provides
+    // accurate token data.
+    const isPermit2Approve = methodId === constants_1.permit2ApproveMethodId;
+    const tokenContractAddress = isPermit2Approve
+        ? undefined
+        : (transferInformation?.contractAddress ?? (to || undefined));
+    const chainId = (0, utils_1.toCaipChainId)(utils_1.KnownCaipNamespace.Eip155, Number.parseInt(initialTransaction.chainId, 16).toString());
+    const nativeAsset = (0, caip_1.getNativeAsset)(initialTransaction.chainId);
+    const nativeSymbol = transactionGroup.nativeAssetSymbol ?? nativeAsset?.symbol;
+    const getNativeToken = (transaction, direction) => {
+        if (nativeSymbol === undefined) {
+            return undefined;
+        }
+        return {
+            direction,
+            symbol: nativeSymbol,
+            ...(transaction.txParams.value
+                ? { amount: transaction.txParams.value }
+                : {}),
+            ...(nativeAsset?.assetId ? { assetId: nativeAsset.assetId } : {}),
+            decimals: nativeAsset?.decimals ?? evmNativeDecimals,
+        };
+    };
+    const getContractTokenFromTransaction = ({ contractAddress, direction, transaction, }) => {
+        if (!contractAddress) {
+            return undefined;
+        }
+        const symbol = transaction.transferInformation?.symbol ??
+            transactionGroup.contractTokenMetadata?.symbol;
+        const decimals = transaction.transferInformation?.decimals ??
+            transactionGroup.contractTokenMetadata?.decimals;
+        const amount = transaction.transferInformation?.amount;
+        const assetId = (0, caip_1.formatAddressToAssetId)(contractAddress, chainId);
+        return {
+            direction,
+            ...(symbol ? { symbol } : {}),
+            ...(assetId ? { assetId } : {}),
+            ...(amount ? { amount } : {}),
+            ...(decimals === undefined ? {} : { decimals }),
+        };
+    };
+    const getContractTokenWithKnownMetadata = ({ amount, contractAddress, direction, transaction, }) => {
+        if (!contractAddress) {
+            return undefined;
+        }
+        const tokenMetadata = (0, token_metadata_1.getKnownTokenMetadata)(chainId, contractAddress);
+        const isWrappedNativeToken = (0, controller_utils_1.isEqualCaseInsensitive)(contractAddress, constants_1.swapsWrappedTokensAddresses[initialTransaction.chainId] || '');
+        const wrappedNativeTokenDecimals = isWrappedNativeToken
+            ? (nativeAsset?.decimals ?? evmNativeDecimals)
+            : undefined;
+        const decimals = transaction.transferInformation?.amount === undefined
+            ? (tokenMetadata?.decimals ??
+                transactionGroup.contractTokenMetadata?.decimals ??
+                wrappedNativeTokenDecimals)
+            : transaction.transferInformation.decimals;
+        const tokenAmount = transaction.transferInformation?.amount ?? amount;
+        const symbol = transaction.transferInformation?.symbol ??
+            tokenMetadata?.symbol ??
+            transactionGroup.contractTokenMetadata?.symbol;
+        const assetId = (0, caip_1.formatAddressToAssetId)(contractAddress, chainId);
+        return {
+            direction,
+            ...(symbol ? { symbol } : {}),
+            ...(assetId ? { assetId } : {}),
+            ...(tokenAmount ? { amount: tokenAmount } : {}),
+            ...(decimals === undefined ? {} : { decimals }),
+        };
+    };
+    const status = transactionGroup.activityStatus ??
+        (0, transactions_1.getLocalTransactionStatus)({
+            primaryTransaction,
+            initialTransaction,
+        });
+    const timestamp = primaryTime ?? initialTransaction.time;
+    const hash = primaryHash ?? initialTransaction.hash ?? primaryId;
+    const common = { chainId, status, timestamp, hash };
+    switch (transactionType) {
+        case transaction_controller_1.TransactionType.simpleSend: {
+            return {
+                type: 'send',
+                ...common,
+                data: {
+                    from,
+                    to,
+                    token: getNativeToken(initialTransaction, 'out'),
+                },
+            };
+        }
+        case transaction_controller_1.TransactionType.swap:
+        case transaction_controller_1.TransactionType.swapAndSend:
+        case transaction_controller_1.TransactionType.bridge: {
+            const { sourceToken, destinationToken } = transactionGroup;
+            return {
+                type: transactionType === transaction_controller_1.TransactionType.bridge ? 'bridge' : 'swap',
+                ...common,
+                data: {
+                    from,
+                    sourceToken,
+                    destinationToken,
+                    fees,
+                },
+            };
+        }
+        case transaction_controller_1.TransactionType.tokenMethodSafeTransferFrom:
+        case transaction_controller_1.TransactionType.tokenMethodTransfer:
+        case transaction_controller_1.TransactionType.tokenMethodTransferFrom: {
+            return {
+                type: 'send',
+                ...common,
+                data: {
+                    from,
+                    to,
+                    token: getContractTokenFromTransaction({
+                        transaction: initialTransaction,
+                        direction: 'out',
+                        contractAddress: tokenContractAddress,
+                    }),
+                },
+            };
+        }
+        case transaction_controller_1.TransactionType.lendingDeposit:
+        case transaction_controller_1.TransactionType.stakingDeposit:
+            return {
+                type: transactionType === transaction_controller_1.TransactionType.stakingDeposit
+                    ? 'deposit'
+                    : 'lendingDeposit',
+                ...common,
+                data: {
+                    from,
+                },
+            };
+        case transaction_controller_1.TransactionType.incoming: {
+            return {
+                type: 'receive',
+                ...common,
+                data: {
+                    from,
+                    to,
+                    token: transferInformation?.contractAddress
+                        ? getContractTokenFromTransaction({
+                            transaction: initialTransaction,
+                            direction: 'in',
+                            contractAddress: transferInformation.contractAddress,
+                        })
+                        : getNativeToken(initialTransaction, 'in'),
+                },
+            };
+        }
+        case transaction_controller_1.TransactionType.musdClaim:
+            return {
+                type: 'claimMusdBonus',
+                ...common,
+                data: {
+                    from,
+                },
+            };
+        case transaction_controller_1.TransactionType.musdConversion: {
+            let conversionAmount;
+            if (txData && txData.length >= 138) {
+                try {
+                    conversionAmount = BigInt(`0x${txData.slice(74, 138)}`).toString();
+                }
+                catch {
+                    conversionAmount = undefined;
+                }
+            }
+            return {
+                type: 'convert',
+                ...common,
+                data: {
+                    from,
+                    sourceToken: transactionGroup.sourceToken,
+                    destinationToken: getContractTokenWithKnownMetadata({
+                        amount: conversionAmount,
+                        transaction: initialTransaction,
+                        direction: 'in',
+                        contractAddress: to,
+                    }),
+                },
+            };
+        }
+        case transaction_controller_1.TransactionType.bridgeApproval:
+        case transaction_controller_1.TransactionType.shieldSubscriptionApprove:
+        case transaction_controller_1.TransactionType.swapApproval:
+        case transaction_controller_1.TransactionType.tokenMethodSetApprovalForAll:
+        case transaction_controller_1.TransactionType.tokenMethodApprove:
+        case transaction_controller_1.TransactionType.tokenMethodIncreaseAllowance: {
+            const approvalToken = getContractTokenFromTransaction({
+                transaction: initialTransaction,
+                direction: 'out',
+                contractAddress: tokenContractAddress,
+            });
+            return {
+                type: transactionType === transaction_controller_1.TransactionType.tokenMethodIncreaseAllowance
+                    ? 'increaseSpendingCap'
+                    : 'approveSpendingCap',
+                ...common,
+                data: {
+                    from,
+                    token: approvalToken,
+                },
+            };
+        }
+        case transaction_controller_1.TransactionType.perpsDeposit:
+        case transaction_controller_1.TransactionType.perpsDepositAndOrder:
+        case transaction_controller_1.TransactionType.perpsWithdraw: {
+            const token = to
+                ? {
+                    direction: 'out',
+                    assetId: (0, caip_1.formatAddressToAssetId)(to, chainId),
+                }
+                : undefined;
+            const fiat = metamaskPay?.targetFiat
+                ? { amount: metamaskPay.targetFiat }
+                : undefined;
+            const networkFee = typeof metamaskPay?.networkFeeFiat === 'string'
+                ? { amount: metamaskPay.networkFeeFiat }
+                : undefined;
+            return {
+                type: transactionType === transaction_controller_1.TransactionType.perpsWithdraw
+                    ? 'perpsWithdraw'
+                    : 'perpsAddFunds',
+                ...common,
+                data: {
+                    from,
+                    token,
+                    fiat,
+                    networkFee,
+                },
+            };
+        }
+        default: {
+            const isSupplyContractInteraction = transactionType === transaction_controller_1.TransactionType.contractInteraction &&
+                methodId &&
+                constants_1.supplyMethodIds.has(methodId.toLowerCase());
+            const isWithdrawContractInteraction = transactionType === transaction_controller_1.TransactionType.contractInteraction &&
+                methodId &&
+                constants_1.withdrawMethodIds.has(methodId.toLowerCase());
+            let hasNativeValue = false;
+            try {
+                hasNativeValue = BigInt(txValue ?? '0') > 0n;
+            }
+            catch {
+                hasNativeValue = false;
+            }
+            // Confirm an outflow before labelling a supply, mirroring the API mapper's
+            // `sentTransfer` guard: native stakes (e.g. Lido) decrease the native
+            // balance, while ERC-20 supplies (e.g. Aave) show a token decrease.
+            const isSupply = isSupplyContractInteraction &&
+                (simulationData?.nativeBalanceChange?.isDecrease === true ||
+                    simulationData?.tokenBalanceChanges?.some(({ isDecrease, standard }) => isDecrease && standard === 'erc20') === true);
+            const incomingNftBalanceChange = transactionType === transaction_controller_1.TransactionType.contractInteraction &&
+                simulationData?.tokenBalanceChanges?.find(({ isDecrease, standard }) => !isDecrease && (0, transactions_1.isNftStandard)(standard));
+            if (incomingNftBalanceChange && hasNativeValue) {
+                // Keep this mapper thin: classify the activity as an NFT buy and let the
+                // API mapper provide the token/payment details.
+                return {
+                    type: 'nftBuy',
+                    ...common,
+                    data: {
+                        from,
+                    },
+                };
+            }
+            if (isSupply) {
+                return {
+                    type: 'lendingDeposit',
+                    ...common,
+                    data: {
+                        from,
+                    },
+                };
+            }
+            // lending withdrawal - applies to Earn features only
+            if (isWithdrawContractInteraction) {
+                const fromAddress = from.toLowerCase();
+                const receivedTokenLog = (txReceipt?.logs ?? []).find(({ topics: [eventTopic, , logTo] = [] }) => {
+                    const toAddress = logTo
+                        ? `0x${logTo.slice(-40)}`.toLowerCase()
+                        : undefined;
+                    return (eventTopic?.toLowerCase() === constants_1.tokenTransferLogTopicHash &&
+                        toAddress === fromAddress);
+                });
+                let receivedAmount;
+                if (receivedTokenLog) {
+                    try {
+                        receivedAmount = BigInt(String(receivedTokenLog.data)).toString();
+                    }
+                    catch {
+                        receivedAmount = undefined;
+                    }
+                }
+                const destinationToken = receivedTokenLog
+                    ? getContractTokenWithKnownMetadata({
+                        amount: receivedAmount,
+                        transaction: initialTransaction,
+                        direction: 'in',
+                        contractAddress: receivedTokenLog.address,
+                    })
+                    : undefined;
+                return {
+                    type: 'lendingWithdrawal',
+                    ...common,
+                    data: {
+                        from,
+                        destinationToken,
+                    },
+                };
+            }
+            // wrap and unwrap
+            if (transactionType === transaction_controller_1.TransactionType.contractInteraction && methodId) {
+                const wrappedTokenAddress = constants_1.swapsWrappedTokensAddresses[initialTransaction.chainId];
+                if (wrappedTokenAddress && (0, controller_utils_1.isEqualCaseInsensitive)(to, wrappedTokenAddress)) {
+                    const normalizedMethodId = methodId.toLowerCase();
+                    if (constants_1.wrapMethodIds.has(normalizedMethodId)) {
+                        try {
+                            if (txValue && BigInt(txValue) > 0n) {
+                                return {
+                                    type: 'wrap',
+                                    ...common,
+                                    data: {
+                                        from,
+                                        sourceToken: getNativeToken(initialTransaction, 'out'),
+                                        destinationToken: getContractTokenWithKnownMetadata({
+                                            amount: txValue,
+                                            transaction: initialTransaction,
+                                            direction: 'in',
+                                            contractAddress: wrappedTokenAddress,
+                                        }),
+                                    },
+                                };
+                            }
+                        }
+                        catch {
+                            // Invalid native value — fall through.
+                        }
+                    }
+                    if (constants_1.unwrapMethodIds.has(normalizedMethodId)) {
+                        let unwrapAmount;
+                        if (txData && txData.length >= 74) {
+                            try {
+                                unwrapAmount = BigInt(`0x${txData.slice(10, 74)}`).toString();
+                            }
+                            catch {
+                                unwrapAmount = undefined;
+                            }
+                        }
+                        const nativeToken = getNativeToken(initialTransaction, 'in');
+                        return {
+                            type: 'unwrap',
+                            ...common,
+                            data: {
+                                from,
+                                sourceToken: getContractTokenWithKnownMetadata({
+                                    amount: unwrapAmount,
+                                    transaction: initialTransaction,
+                                    direction: 'out',
+                                    contractAddress: wrappedTokenAddress,
+                                }),
+                                destinationToken: nativeToken && unwrapAmount
+                                    ? { ...nativeToken, amount: unwrapAmount }
+                                    : nativeToken,
+                            },
+                        };
+                    }
+                }
+            }
+            const token = (() => {
+                if (txValue === undefined || txValue === '') {
+                    return undefined;
+                }
+                try {
+                    return BigInt(txValue) > 0n
+                        ? getNativeToken(initialTransaction, 'out')
+                        : undefined;
+                }
+                catch {
+                    return undefined;
+                }
+            })();
+            return {
+                type: 'contractInteraction',
+                ...common,
+                data: {
+                    from,
+                    to,
+                    ...(token ? { token } : {}),
+                    methodId,
+                },
+            };
+        }
+    }
+}
+exports.mapLocalTransaction = mapLocalTransaction;
+//# sourceMappingURL=local-transaction-mapper.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"local-transaction-mapper.cjs","sourceRoot":"","sources":["../../src/mappers/local-transaction-mapper.ts"],"names":[],"mappings":"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","sourcesContent":["import { isEqualCaseInsensitive as equalsIgnoreCase } from '@metamask/controller-utils';\nimport { TransactionType } from '@metamask/transaction-controller';\nimport { KnownCaipNamespace, toCaipChainId } from '@metamask/utils';\n\nimport type { Fee, ActivityItem, TokenAmount } from '../types';\nimport {\n  permit2ApproveMethodId,\n  swapsWrappedTokensAddresses,\n  supplyMethodIds,\n  tokenTransferLogTopicHash,\n  unwrapMethodIds,\n  withdrawMethodIds,\n  wrapMethodIds,\n} from './constants';\nimport { formatAddressToAssetId, getNativeAsset } from './helpers/caip';\nimport { getKnownTokenMetadata } from './helpers/token-metadata';\nimport {\n  getLocalTransactionFees,\n  getLocalTransactionStatus,\n  isNftStandard,\n} from './helpers/transactions';\nimport type { TransactionGroup } from './helpers/transactions';\n\nconst evmNativeDecimals = 18;\n\n/**\n * Maps a local TransactionController group into the shared activity item shape.\n *\n * @param transactionGroup - The transaction group to map, optionally enriched by the client.\n * @returns The normalized activity item.\n */\nexport function mapLocalTransaction(\n  transactionGroup: TransactionGroup & {\n    sourceToken?: TokenAmount;\n    destinationToken?: TokenAmount;\n    nativeAssetSymbol?: string;\n    contractTokenMetadata?: { symbol?: string; decimals?: number };\n    activityStatus?: ActivityItem['status'];\n    fees?: Fee[];\n  },\n): ActivityItem {\n  const fees =\n    transactionGroup.fees ?? getLocalTransactionFees(transactionGroup);\n  const { initialTransaction, primaryTransaction } = transactionGroup;\n  const {\n    transferInformation,\n    type: transactionType,\n    simulationData,\n    txReceipt,\n    metamaskPay,\n    txParams: { from = '', to = '', data: txData, value: txValue } = {},\n  } = initialTransaction;\n  const {\n    time: primaryTime,\n    hash: primaryHash,\n    id: primaryId,\n  } = primaryTransaction;\n  const methodId = txData?.slice(0, 10);\n  // Permit2 approvals use the Permit2 contract as `to`, not the approved token.\n  // Keep this mapper thin: still classify the activity as an approve, but omit\n  // the token rather than surfacing the wrong one — the API mapper provides\n  // accurate token data.\n  const isPermit2Approve = methodId === permit2ApproveMethodId;\n  const tokenContractAddress = isPermit2Approve\n    ? undefined\n    : (transferInformation?.contractAddress ?? (to || undefined));\n  const chainId = toCaipChainId(\n    KnownCaipNamespace.Eip155,\n    Number.parseInt(initialTransaction.chainId, 16).toString(),\n  );\n  const nativeAsset = getNativeAsset(initialTransaction.chainId);\n  const nativeSymbol =\n    transactionGroup.nativeAssetSymbol ?? nativeAsset?.symbol;\n\n  const getNativeToken = (\n    transaction: TransactionGroup['initialTransaction'],\n    direction: TokenAmount['direction'],\n  ): TokenAmount | undefined => {\n    if (nativeSymbol === undefined) {\n      return undefined;\n    }\n\n    return {\n      direction,\n      symbol: nativeSymbol,\n      ...(transaction.txParams.value\n        ? { amount: transaction.txParams.value }\n        : {}),\n      ...(nativeAsset?.assetId ? { assetId: nativeAsset.assetId } : {}),\n      decimals: nativeAsset?.decimals ?? evmNativeDecimals,\n    };\n  };\n\n  const getContractTokenFromTransaction = ({\n    contractAddress,\n    direction,\n    transaction,\n  }: {\n    contractAddress?: string;\n    direction: TokenAmount['direction'];\n    transaction: TransactionGroup['initialTransaction'];\n  }): TokenAmount | undefined => {\n    if (!contractAddress) {\n      return undefined;\n    }\n\n    const symbol =\n      transaction.transferInformation?.symbol ??\n      transactionGroup.contractTokenMetadata?.symbol;\n    const decimals =\n      transaction.transferInformation?.decimals ??\n      transactionGroup.contractTokenMetadata?.decimals;\n    const amount = transaction.transferInformation?.amount;\n    const assetId = formatAddressToAssetId(contractAddress, chainId);\n\n    return {\n      direction,\n      ...(symbol ? { symbol } : {}),\n      ...(assetId ? { assetId } : {}),\n      ...(amount ? { amount } : {}),\n      ...(decimals === undefined ? {} : { decimals }),\n    };\n  };\n\n  const getContractTokenWithKnownMetadata = ({\n    amount,\n    contractAddress,\n    direction,\n    transaction,\n  }: {\n    amount?: string;\n    contractAddress?: string;\n    direction: TokenAmount['direction'];\n    transaction: TransactionGroup['initialTransaction'];\n  }): TokenAmount | undefined => {\n    if (!contractAddress) {\n      return undefined;\n    }\n\n    const tokenMetadata = getKnownTokenMetadata(chainId, contractAddress);\n\n    const isWrappedNativeToken = equalsIgnoreCase(\n      contractAddress,\n      swapsWrappedTokensAddresses[\n        initialTransaction.chainId as keyof typeof swapsWrappedTokensAddresses\n      ] || '',\n    );\n    const wrappedNativeTokenDecimals = isWrappedNativeToken\n      ? (nativeAsset?.decimals ?? evmNativeDecimals)\n      : undefined;\n\n    const decimals =\n      transaction.transferInformation?.amount === undefined\n        ? (tokenMetadata?.decimals ??\n          transactionGroup.contractTokenMetadata?.decimals ??\n          wrappedNativeTokenDecimals)\n        : transaction.transferInformation.decimals;\n    const tokenAmount = transaction.transferInformation?.amount ?? amount;\n    const symbol =\n      transaction.transferInformation?.symbol ??\n      tokenMetadata?.symbol ??\n      transactionGroup.contractTokenMetadata?.symbol;\n    const assetId = formatAddressToAssetId(contractAddress, chainId);\n\n    return {\n      direction,\n      ...(symbol ? { symbol } : {}),\n      ...(assetId ? { assetId } : {}),\n      ...(tokenAmount ? { amount: tokenAmount } : {}),\n      ...(decimals === undefined ? {} : { decimals }),\n    };\n  };\n\n  const status =\n    transactionGroup.activityStatus ??\n    getLocalTransactionStatus({\n      primaryTransaction,\n      initialTransaction,\n    });\n  const timestamp = primaryTime ?? initialTransaction.time;\n  const hash = primaryHash ?? initialTransaction.hash ?? primaryId;\n  const common = { chainId, status, timestamp, hash };\n\n  switch (transactionType) {\n    case TransactionType.simpleSend: {\n      return {\n        type: 'send',\n        ...common,\n        data: {\n          from,\n          to,\n          token: getNativeToken(initialTransaction, 'out'),\n        },\n      };\n    }\n\n    case TransactionType.swap:\n    case TransactionType.swapAndSend:\n    case TransactionType.bridge: {\n      const { sourceToken, destinationToken } = transactionGroup;\n\n      return {\n        type: transactionType === TransactionType.bridge ? 'bridge' : 'swap',\n        ...common,\n        data: {\n          from,\n          sourceToken,\n          destinationToken,\n          fees,\n        },\n      };\n    }\n\n    case TransactionType.tokenMethodSafeTransferFrom:\n    case TransactionType.tokenMethodTransfer:\n    case TransactionType.tokenMethodTransferFrom: {\n      return {\n        type: 'send',\n        ...common,\n        data: {\n          from,\n          to,\n          token: getContractTokenFromTransaction({\n            transaction: initialTransaction,\n            direction: 'out',\n            contractAddress: tokenContractAddress,\n          }),\n        },\n      };\n    }\n\n    case TransactionType.lendingDeposit:\n    case TransactionType.stakingDeposit:\n      return {\n        type:\n          transactionType === TransactionType.stakingDeposit\n            ? 'deposit'\n            : 'lendingDeposit',\n        ...common,\n        data: {\n          from,\n        },\n      };\n\n    case TransactionType.incoming: {\n      return {\n        type: 'receive',\n        ...common,\n        data: {\n          from,\n          to,\n          token: transferInformation?.contractAddress\n            ? getContractTokenFromTransaction({\n                transaction: initialTransaction,\n                direction: 'in',\n                contractAddress: transferInformation.contractAddress,\n              })\n            : getNativeToken(initialTransaction, 'in'),\n        },\n      };\n    }\n    case TransactionType.musdClaim:\n      return {\n        type: 'claimMusdBonus',\n        ...common,\n        data: {\n          from,\n        },\n      };\n\n    case TransactionType.musdConversion: {\n      let conversionAmount: string | undefined;\n\n      if (txData && txData.length >= 138) {\n        try {\n          conversionAmount = BigInt(`0x${txData.slice(74, 138)}`).toString();\n        } catch {\n          conversionAmount = undefined;\n        }\n      }\n\n      return {\n        type: 'convert',\n        ...common,\n        data: {\n          from,\n          sourceToken: transactionGroup.sourceToken,\n          destinationToken: getContractTokenWithKnownMetadata({\n            amount: conversionAmount,\n            transaction: initialTransaction,\n            direction: 'in',\n            contractAddress: to,\n          }),\n        },\n      };\n    }\n\n    case TransactionType.bridgeApproval:\n    case TransactionType.shieldSubscriptionApprove:\n    case TransactionType.swapApproval:\n    case TransactionType.tokenMethodSetApprovalForAll:\n    case TransactionType.tokenMethodApprove:\n    case TransactionType.tokenMethodIncreaseAllowance: {\n      const approvalToken = getContractTokenFromTransaction({\n        transaction: initialTransaction,\n        direction: 'out',\n        contractAddress: tokenContractAddress,\n      });\n\n      return {\n        type:\n          transactionType === TransactionType.tokenMethodIncreaseAllowance\n            ? 'increaseSpendingCap'\n            : 'approveSpendingCap',\n        ...common,\n        data: {\n          from,\n          token: approvalToken,\n        },\n      };\n    }\n\n    case TransactionType.perpsDeposit:\n    case TransactionType.perpsDepositAndOrder:\n    case TransactionType.perpsWithdraw: {\n      const token = to\n        ? {\n            direction: 'out' as const,\n            assetId: formatAddressToAssetId(to, chainId),\n          }\n        : undefined;\n\n      const fiat = metamaskPay?.targetFiat\n        ? { amount: metamaskPay.targetFiat }\n        : undefined;\n      const networkFee =\n        typeof metamaskPay?.networkFeeFiat === 'string'\n          ? { amount: metamaskPay.networkFeeFiat }\n          : undefined;\n\n      return {\n        type:\n          transactionType === TransactionType.perpsWithdraw\n            ? 'perpsWithdraw'\n            : 'perpsAddFunds',\n        ...common,\n        data: {\n          from,\n          token,\n          fiat,\n          networkFee,\n        },\n      };\n    }\n\n    default: {\n      const isSupplyContractInteraction =\n        transactionType === TransactionType.contractInteraction &&\n        methodId &&\n        supplyMethodIds.has(methodId.toLowerCase());\n      const isWithdrawContractInteraction =\n        transactionType === TransactionType.contractInteraction &&\n        methodId &&\n        withdrawMethodIds.has(methodId.toLowerCase());\n\n      let hasNativeValue = false;\n\n      try {\n        hasNativeValue = BigInt(txValue ?? '0') > 0n;\n      } catch {\n        hasNativeValue = false;\n      }\n\n      // Confirm an outflow before labelling a supply, mirroring the API mapper's\n      // `sentTransfer` guard: native stakes (e.g. Lido) decrease the native\n      // balance, while ERC-20 supplies (e.g. Aave) show a token decrease.\n      const isSupply =\n        isSupplyContractInteraction &&\n        (simulationData?.nativeBalanceChange?.isDecrease === true ||\n          simulationData?.tokenBalanceChanges?.some(\n            ({ isDecrease, standard }) => isDecrease && standard === 'erc20',\n          ) === true);\n      const incomingNftBalanceChange =\n        transactionType === TransactionType.contractInteraction &&\n        simulationData?.tokenBalanceChanges?.find(\n          ({ isDecrease, standard }) => !isDecrease && isNftStandard(standard),\n        );\n\n      if (incomingNftBalanceChange && hasNativeValue) {\n        // Keep this mapper thin: classify the activity as an NFT buy and let the\n        // API mapper provide the token/payment details.\n        return {\n          type: 'nftBuy',\n          ...common,\n          data: {\n            from,\n          },\n        };\n      }\n\n      if (isSupply) {\n        return {\n          type: 'lendingDeposit',\n          ...common,\n          data: {\n            from,\n          },\n        };\n      }\n\n      // lending withdrawal - applies to Earn features only\n      if (isWithdrawContractInteraction) {\n        const fromAddress = from.toLowerCase();\n        const receivedTokenLog = (txReceipt?.logs ?? []).find(\n          ({ topics: [eventTopic, , logTo] = [] }) => {\n            const toAddress = logTo\n              ? `0x${logTo.slice(-40)}`.toLowerCase()\n              : undefined;\n\n            return (\n              eventTopic?.toLowerCase() === tokenTransferLogTopicHash &&\n              toAddress === fromAddress\n            );\n          },\n        );\n        let receivedAmount: string | undefined;\n\n        if (receivedTokenLog) {\n          try {\n            receivedAmount = BigInt(String(receivedTokenLog.data)).toString();\n          } catch {\n            receivedAmount = undefined;\n          }\n        }\n\n        const destinationToken = receivedTokenLog\n          ? getContractTokenWithKnownMetadata({\n              amount: receivedAmount,\n              transaction: initialTransaction,\n              direction: 'in',\n              contractAddress: receivedTokenLog.address,\n            })\n          : undefined;\n\n        return {\n          type: 'lendingWithdrawal',\n          ...common,\n          data: {\n            from,\n            destinationToken,\n          },\n        };\n      }\n\n      // wrap and unwrap\n      if (transactionType === TransactionType.contractInteraction && methodId) {\n        const wrappedTokenAddress =\n          swapsWrappedTokensAddresses[\n            initialTransaction.chainId as keyof typeof swapsWrappedTokensAddresses\n          ];\n\n        if (wrappedTokenAddress && equalsIgnoreCase(to, wrappedTokenAddress)) {\n          const normalizedMethodId = methodId.toLowerCase();\n\n          if (wrapMethodIds.has(normalizedMethodId)) {\n            try {\n              if (txValue && BigInt(txValue) > 0n) {\n                return {\n                  type: 'wrap',\n                  ...common,\n                  data: {\n                    from,\n                    sourceToken: getNativeToken(initialTransaction, 'out'),\n                    destinationToken: getContractTokenWithKnownMetadata({\n                      amount: txValue,\n                      transaction: initialTransaction,\n                      direction: 'in',\n                      contractAddress: wrappedTokenAddress,\n                    }),\n                  },\n                };\n              }\n            } catch {\n              // Invalid native value — fall through.\n            }\n          }\n\n          if (unwrapMethodIds.has(normalizedMethodId)) {\n            let unwrapAmount: string | undefined;\n\n            if (txData && txData.length >= 74) {\n              try {\n                unwrapAmount = BigInt(`0x${txData.slice(10, 74)}`).toString();\n              } catch {\n                unwrapAmount = undefined;\n              }\n            }\n\n            const nativeToken = getNativeToken(initialTransaction, 'in');\n\n            return {\n              type: 'unwrap',\n              ...common,\n              data: {\n                from,\n                sourceToken: getContractTokenWithKnownMetadata({\n                  amount: unwrapAmount,\n                  transaction: initialTransaction,\n                  direction: 'out',\n                  contractAddress: wrappedTokenAddress,\n                }),\n                destinationToken:\n                  nativeToken && unwrapAmount\n                    ? { ...nativeToken, amount: unwrapAmount }\n                    : nativeToken,\n              },\n            };\n          }\n        }\n      }\n\n      const token = ((): TokenAmount | undefined => {\n        if (txValue === undefined || txValue === '') {\n          return undefined;\n        }\n\n        try {\n          return BigInt(txValue) > 0n\n            ? getNativeToken(initialTransaction, 'out')\n            : undefined;\n        } catch {\n          return undefined;\n        }\n      })();\n\n      return {\n        type: 'contractInteraction',\n        ...common,\n        data: {\n          from,\n          to,\n          ...(token ? { token } : {}),\n          methodId,\n        },\n      };\n    }\n  }\n}\n"]}