@metamask/client-utils 1.0.0

package/dist/mappers/helpers/transactions.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.cjs","sourceRoot":"","sources":["../../../src/mappers/helpers/transactions.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  ERC721,\n  ERC1155,\n  isEqualCaseInsensitive as equalsIgnoreCase,\n} from '@metamask/controller-utils';\nimport type { V1TransactionByHashResponse } from '@metamask/core-backend';\nimport type { TransactionMeta } from '@metamask/transaction-controller';\nimport {\n  TransactionStatus,\n  TransactionType,\n} from '@metamask/transaction-controller';\nimport type { CaipChainId, Hex } from '@metamask/utils';\n\nimport type { Fee, Status, TokenAmount, ValueTransfer } from '../../types';\nimport { nativeTokenAddress } from '../constants';\nimport { formatAddressToAssetId, getNativeAsset } from './caip';\nimport { getKnownTokenMetadata } from './token-metadata';\n\n// Adds optional `isSmartTransaction` to `TransactionMeta`.\nexport type TransactionGroup = {\n  hasCancelled: boolean;\n  hasRetried: boolean;\n  initialTransaction: TransactionMeta & { isSmartTransaction?: boolean };\n  nonce: Hex;\n  primaryTransaction: TransactionMeta;\n  transactions: TransactionMeta[];\n};\n\nconst nativeTokenDecimals = 18;\n\nfunction toNetworkFeeAmount(\n  gasUsed: string | number | undefined,\n  gasPrice: string | number | undefined,\n): string | undefined {\n  if (gasUsed === undefined || gasPrice === undefined) {\n    return undefined;\n  }\n\n  try {\n    return String(BigInt(gasUsed) * BigInt(gasPrice));\n  } catch {\n    return undefined;\n  }\n}\n\nfunction buildBaseNetworkFee(amount: string, chainId: string | number): Fee {\n  const nativeAsset = getNativeAsset(chainId);\n\n  return {\n    type: 'base',\n    amount,\n    ...(nativeAsset?.decimals === undefined\n      ? { decimals: nativeTokenDecimals }\n      : { decimals: nativeAsset.decimals }),\n    ...(nativeAsset?.symbol ? { symbol: nativeAsset.symbol } : {}),\n    ...(nativeAsset?.assetId ? { assetId: nativeAsset.assetId } : {}),\n  };\n}\n\nfunction getNetworkFee(\n  transaction: V1TransactionByHashResponse,\n  chainId: string,\n): Fee | undefined {\n  const amount = toNetworkFeeAmount(\n    transaction.gasUsed,\n    transaction.effectiveGasPrice,\n  );\n\n  return amount ? buildBaseNetworkFee(amount, chainId) : undefined;\n}\n\nexport function getFees(\n  transaction: V1TransactionByHashResponse,\n  chainId: string,\n): Fee[] | undefined {\n  const networkFee = getNetworkFee(transaction, chainId);\n\n  return networkFee ? [networkFee] : undefined;\n}\n\nexport function getLocalTransactionFees(\n  transactionGroup: Pick<TransactionGroup, 'primaryTransaction'>,\n): Fee[] | undefined {\n  const { primaryTransaction } = transactionGroup;\n  const amount = toNetworkFeeAmount(\n    primaryTransaction.txReceipt?.gasUsed,\n    primaryTransaction.txReceipt?.effectiveGasPrice ??\n      primaryTransaction.txParams?.gasPrice,\n  );\n\n  return amount\n    ? [buildBaseNetworkFee(amount, primaryTransaction.chainId)]\n    : undefined;\n}\n\nconst inProgressTransactionStatuses = [\n  TransactionStatus.unapproved,\n  TransactionStatus.approved,\n  TransactionStatus.signed,\n  TransactionStatus.submitted,\n];\n\nconst transactionGroupCancelledStatus = 'cancelled';\n\nconst smartTransactionStatus = {\n  cancelled: 'cancelled',\n  pending: 'pending',\n  success: 'success',\n} as const;\n\nfunction getTransactionStatusKey(\n  transaction: TransactionGroup['primaryTransaction'],\n): string {\n  const { type, status } = transaction;\n  const receiptStatus = transaction.txReceipt?.status;\n\n  if (receiptStatus === '0x0') {\n    return TransactionStatus.failed;\n  }\n\n  if (\n    status === TransactionStatus.confirmed &&\n    type === TransactionType.cancel\n  ) {\n    return transactionGroupCancelledStatus;\n  }\n\n  return transaction.status;\n}\n\nexport function getLocalTransactionStatus({\n  primaryTransaction,\n  initialTransaction,\n}: {\n  primaryTransaction: TransactionGroup['primaryTransaction'];\n  initialTransaction: TransactionGroup['initialTransaction'];\n}): Status {\n  if (initialTransaction.isSmartTransaction) {\n    const smartStatus = initialTransaction.status as string | undefined;\n\n    if (smartStatus === smartTransactionStatus.pending) {\n      return 'pending';\n    }\n\n    if (smartStatus === smartTransactionStatus.success) {\n      return 'success';\n    }\n\n    if (smartStatus === smartTransactionStatus.cancelled) {\n      return 'failed';\n    }\n\n    return 'pending';\n  }\n\n  const statusKey = getTransactionStatusKey(primaryTransaction);\n\n  if (statusKey === TransactionStatus.confirmed) {\n    return 'success';\n  }\n\n  if (\n    statusKey === TransactionStatus.cancelled ||\n    statusKey === transactionGroupCancelledStatus ||\n    statusKey === TransactionStatus.dropped ||\n    statusKey === TransactionStatus.failed ||\n    statusKey === TransactionStatus.rejected\n  ) {\n    return 'failed';\n  }\n\n  if (\n    inProgressTransactionStatuses.includes(\n      statusKey as (typeof inProgressTransactionStatuses)[number],\n    )\n  ) {\n    return 'pending';\n  }\n\n  return 'pending';\n}\n\nexport function isNftStandard(value?: string): boolean {\n  return value === ERC721.toLowerCase() || value === ERC1155.toLowerCase();\n}\n\nexport function getNftPaymentTransfer({\n  side,\n  sentTransfer,\n  receivedTransfer,\n  sentNativeTransfer,\n  nftCounterparty,\n  transactionFrom,\n  transactionTo,\n  subjectAddress,\n}: {\n  side: 'buy' | 'sell';\n  sentTransfer?: ValueTransfer;\n  receivedTransfer?: ValueTransfer;\n  sentNativeTransfer?: ValueTransfer;\n  nftCounterparty: string;\n  transactionFrom?: string;\n  transactionTo?: string;\n  subjectAddress: string;\n}): ValueTransfer | undefined {\n  const isFungible = (transfer?: ValueTransfer): boolean =>\n    Boolean(transfer && !isNftStandard(transfer.transferType));\n\n  if (side === 'buy') {\n    for (const transfer of [sentNativeTransfer, sentTransfer]) {\n      if (!transfer || !isFungible(transfer)) {\n        continue;\n      }\n\n      // Only count a payment that goes to the NFT counterparty (direct sale) or\n      // to the contract being called (marketplace/router). This avoids treating\n      // an unrelated native send in the same transaction as the NFT payment.\n      if (\n        equalsIgnoreCase(transfer.to, nftCounterparty) ||\n        equalsIgnoreCase(transfer.to, transactionTo as string)\n      ) {\n        return transfer;\n      }\n    }\n\n    return undefined;\n  }\n\n  if (!receivedTransfer || !isFungible(receivedTransfer)) {\n    return undefined;\n  }\n\n  if (\n    equalsIgnoreCase(receivedTransfer.from, nftCounterparty) ||\n    (transactionFrom &&\n      !equalsIgnoreCase(transactionFrom, subjectAddress) &&\n      equalsIgnoreCase(receivedTransfer.from, transactionFrom))\n  ) {\n    return receivedTransfer;\n  }\n\n  return undefined;\n}\n\nconst resolveAssetId = (\n  chainId: CaipChainId,\n  {\n    contractAddress,\n    transferType,\n  }: {\n    contractAddress?: string;\n    transferType?: string;\n  },\n): string | undefined => {\n  if (contractAddress) {\n    return formatAddressToAssetId(contractAddress, chainId);\n  }\n\n  if (transferType === 'normal' || transferType === 'internal') {\n    return formatAddressToAssetId(nativeTokenAddress, chainId);\n  }\n\n  return undefined;\n};\n\n/**\n * Resolves the user's primary send and receive legs from indexed value transfers.\n * Prefers a receive whose symbol differs from the sent leg so dust does not win.\n *\n * @param valueTransfers - Indexed value transfers from the Accounts API.\n * @param subjectAddress - The account address to match transfers against.\n * @returns The primary sent and received transfers for the account.\n */\nexport function parseValueTransfers(\n  valueTransfers: ValueTransfer[] | undefined,\n  subjectAddress: string,\n): {\n  sentTransfer: ValueTransfer | undefined;\n  receivedTransfer: ValueTransfer | undefined;\n  sentNativeTransfer: ValueTransfer | undefined;\n  sentNftTransfer: ValueTransfer | undefined;\n  receivedNftTransfer: ValueTransfer | undefined;\n} {\n  const sent = valueTransfers?.filter(({ from }) =>\n    equalsIgnoreCase(from, subjectAddress),\n  );\n  const received = valueTransfers?.filter(({ to }) =>\n    equalsIgnoreCase(to, subjectAddress),\n  );\n\n  const sentTransfer = sent?.[0];\n\n  const receivedTransfer =\n    received?.find(({ symbol }) => symbol !== sentTransfer?.symbol) ??\n    received?.[0];\n\n  const sentNativeTransfer = sent?.find(\n    ({ transferType }) => transferType === 'normal',\n  );\n\n  const sentNftTransfer = sent?.find(({ transferType }) =>\n    isNftStandard(transferType),\n  );\n  const receivedNftTransfer = received?.find(({ transferType }) =>\n    isNftStandard(transferType),\n  );\n\n  return {\n    sentTransfer,\n    receivedTransfer,\n    sentNativeTransfer,\n    sentNftTransfer,\n    receivedNftTransfer,\n  };\n}\n\nexport function getTokenAmountFromTransfer(\n  transfer: ValueTransfer | undefined,\n  direction: TokenAmount['direction'],\n  chainId: CaipChainId,\n): TokenAmount | undefined {\n  if (!transfer) {\n    return undefined;\n  }\n\n  const { transferType, amount } = transfer;\n  const isNftTransfer = isNftStandard(transferType);\n  const symbol = isNftTransfer\n    ? transfer.name || transfer.symbol\n    : transfer.symbol;\n\n  if (!symbol && amount === undefined) {\n    return undefined;\n  }\n\n  const assetId =\n    transfer && !isNftTransfer\n      ? resolveAssetId(chainId, {\n          contractAddress: transfer.contractAddress,\n          transferType: transfer.transferType,\n        })\n      : undefined;\n\n  const hasTransferAmount =\n    !isNftTransfer && amount !== null && amount !== undefined;\n\n  return {\n    direction,\n    ...(hasTransferAmount ? { amount: String(amount) } : {}),\n    ...(transfer.decimal === undefined ? {} : { decimals: transfer.decimal }),\n    ...(symbol ? { symbol } : {}),\n    ...(assetId ? { assetId } : {}),\n  };\n}\n\nexport function getTokenMetadataFromKnownToken(\n  contractAddress: string | undefined,\n  direction: TokenAmount['direction'],\n  chainId: CaipChainId,\n): TokenAmount | undefined {\n  const tokenMetadata = getKnownTokenMetadata(chainId, contractAddress);\n\n  if (!tokenMetadata) {\n    return undefined;\n  }\n\n  return {\n    direction,\n    ...(tokenMetadata.symbol ? { symbol: tokenMetadata.symbol } : {}),\n    ...(tokenMetadata.decimals === undefined\n      ? {}\n      : { decimals: tokenMetadata.decimals }),\n    ...(tokenMetadata.assetId ? { assetId: tokenMetadata.assetId } : {}),\n  };\n}\n\n/**\n * When the transfer omits contractAddress, fall back to the indexed tx `to` field.\n *\n * @param token - Parsed token amount from the value transfer.\n * @param fallbackContractAddress - Indexed transaction `to` address used as ERC-20 fallback.\n * @param transferType - Value transfer type; native (`normal`) transfers skip the fallback.\n * @param chainId - CAIP-2 chain id for asset id encoding.\n * @returns Token amount with `assetId` set when a fallback address applies.\n */\nexport function withFallbackTokenAssetId(\n  token: TokenAmount | undefined,\n  fallbackContractAddress: string | undefined,\n  transferType: string | undefined,\n  chainId: CaipChainId,\n): TokenAmount | undefined {\n  if (\n    !token ||\n    token.assetId ||\n    transferType === 'normal' ||\n    !fallbackContractAddress\n  ) {\n    return token;\n  }\n\n  const assetId = formatAddressToAssetId(fallbackContractAddress, chainId);\n  if (!assetId) {\n    return token;\n  }\n\n  return { ...token, assetId };\n}\n"]}

package/dist/mappers/helpers/transactions.d.cts

@@ -0,0 +1,59 @@
+import type { V1TransactionByHashResponse } from "@metamask/core-backend";
+import type { TransactionMeta } from "@metamask/transaction-controller";
+import type { CaipChainId, Hex } from "@metamask/utils";
+import type { Fee, Status, TokenAmount, ValueTransfer } from "../../types.cjs";
+export type TransactionGroup = {
+    hasCancelled: boolean;
+    hasRetried: boolean;
+    initialTransaction: TransactionMeta & {
+        isSmartTransaction?: boolean;
+    };
+    nonce: Hex;
+    primaryTransaction: TransactionMeta;
+    transactions: TransactionMeta[];
+};
+export declare function getFees(transaction: V1TransactionByHashResponse, chainId: string): Fee[] | undefined;
+export declare function getLocalTransactionFees(transactionGroup: Pick<TransactionGroup, 'primaryTransaction'>): Fee[] | undefined;
+export declare function getLocalTransactionStatus({ primaryTransaction, initialTransaction, }: {
+    primaryTransaction: TransactionGroup['primaryTransaction'];
+    initialTransaction: TransactionGroup['initialTransaction'];
+}): Status;
+export declare function isNftStandard(value?: string): boolean;
+export declare function getNftPaymentTransfer({ side, sentTransfer, receivedTransfer, sentNativeTransfer, nftCounterparty, transactionFrom, transactionTo, subjectAddress, }: {
+    side: 'buy' | 'sell';
+    sentTransfer?: ValueTransfer;
+    receivedTransfer?: ValueTransfer;
+    sentNativeTransfer?: ValueTransfer;
+    nftCounterparty: string;
+    transactionFrom?: string;
+    transactionTo?: string;
+    subjectAddress: string;
+}): ValueTransfer | undefined;
+/**
+ * Resolves the user's primary send and receive legs from indexed value transfers.
+ * Prefers a receive whose symbol differs from the sent leg so dust does not win.
+ *
+ * @param valueTransfers - Indexed value transfers from the Accounts API.
+ * @param subjectAddress - The account address to match transfers against.
+ * @returns The primary sent and received transfers for the account.
+ */
+export declare function parseValueTransfers(valueTransfers: ValueTransfer[] | undefined, subjectAddress: string): {
+    sentTransfer: ValueTransfer | undefined;
+    receivedTransfer: ValueTransfer | undefined;
+    sentNativeTransfer: ValueTransfer | undefined;
+    sentNftTransfer: ValueTransfer | undefined;
+    receivedNftTransfer: ValueTransfer | undefined;
+};
+export declare function getTokenAmountFromTransfer(transfer: ValueTransfer | undefined, direction: TokenAmount['direction'], chainId: CaipChainId): TokenAmount | undefined;
+export declare function getTokenMetadataFromKnownToken(contractAddress: string | undefined, direction: TokenAmount['direction'], chainId: CaipChainId): TokenAmount | undefined;
+/**
+ * When the transfer omits contractAddress, fall back to the indexed tx `to` field.
+ *
+ * @param token - Parsed token amount from the value transfer.
+ * @param fallbackContractAddress - Indexed transaction `to` address used as ERC-20 fallback.
+ * @param transferType - Value transfer type; native (`normal`) transfers skip the fallback.
+ * @param chainId - CAIP-2 chain id for asset id encoding.
+ * @returns Token amount with `assetId` set when a fallback address applies.
+ */
+export declare function withFallbackTokenAssetId(token: TokenAmount | undefined, fallbackContractAddress: string | undefined, transferType: string | undefined, chainId: CaipChainId): TokenAmount | undefined;
+//# sourceMappingURL=transactions.d.cts.map

package/dist/mappers/helpers/transactions.d.cts.map

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

package/dist/mappers/helpers/transactions.d.mts

@@ -0,0 +1,59 @@
+import type { V1TransactionByHashResponse } from "@metamask/core-backend";
+import type { TransactionMeta } from "@metamask/transaction-controller";
+import type { CaipChainId, Hex } from "@metamask/utils";
+import type { Fee, Status, TokenAmount, ValueTransfer } from "../../types.mjs";
+export type TransactionGroup = {
+    hasCancelled: boolean;
+    hasRetried: boolean;
+    initialTransaction: TransactionMeta & {
+        isSmartTransaction?: boolean;
+    };
+    nonce: Hex;
+    primaryTransaction: TransactionMeta;
+    transactions: TransactionMeta[];
+};
+export declare function getFees(transaction: V1TransactionByHashResponse, chainId: string): Fee[] | undefined;
+export declare function getLocalTransactionFees(transactionGroup: Pick<TransactionGroup, 'primaryTransaction'>): Fee[] | undefined;
+export declare function getLocalTransactionStatus({ primaryTransaction, initialTransaction, }: {
+    primaryTransaction: TransactionGroup['primaryTransaction'];
+    initialTransaction: TransactionGroup['initialTransaction'];
+}): Status;
+export declare function isNftStandard(value?: string): boolean;
+export declare function getNftPaymentTransfer({ side, sentTransfer, receivedTransfer, sentNativeTransfer, nftCounterparty, transactionFrom, transactionTo, subjectAddress, }: {
+    side: 'buy' | 'sell';
+    sentTransfer?: ValueTransfer;
+    receivedTransfer?: ValueTransfer;
+    sentNativeTransfer?: ValueTransfer;
+    nftCounterparty: string;
+    transactionFrom?: string;
+    transactionTo?: string;
+    subjectAddress: string;
+}): ValueTransfer | undefined;
+/**
+ * Resolves the user's primary send and receive legs from indexed value transfers.
+ * Prefers a receive whose symbol differs from the sent leg so dust does not win.
+ *
+ * @param valueTransfers - Indexed value transfers from the Accounts API.
+ * @param subjectAddress - The account address to match transfers against.
+ * @returns The primary sent and received transfers for the account.
+ */
+export declare function parseValueTransfers(valueTransfers: ValueTransfer[] | undefined, subjectAddress: string): {
+    sentTransfer: ValueTransfer | undefined;
+    receivedTransfer: ValueTransfer | undefined;
+    sentNativeTransfer: ValueTransfer | undefined;
+    sentNftTransfer: ValueTransfer | undefined;
+    receivedNftTransfer: ValueTransfer | undefined;
+};
+export declare function getTokenAmountFromTransfer(transfer: ValueTransfer | undefined, direction: TokenAmount['direction'], chainId: CaipChainId): TokenAmount | undefined;
+export declare function getTokenMetadataFromKnownToken(contractAddress: string | undefined, direction: TokenAmount['direction'], chainId: CaipChainId): TokenAmount | undefined;
+/**
+ * When the transfer omits contractAddress, fall back to the indexed tx `to` field.
+ *
+ * @param token - Parsed token amount from the value transfer.
+ * @param fallbackContractAddress - Indexed transaction `to` address used as ERC-20 fallback.
+ * @param transferType - Value transfer type; native (`normal`) transfers skip the fallback.
+ * @param chainId - CAIP-2 chain id for asset id encoding.
+ * @returns Token amount with `assetId` set when a fallback address applies.
+ */
+export declare function withFallbackTokenAssetId(token: TokenAmount | undefined, fallbackContractAddress: string | undefined, transferType: string | undefined, chainId: CaipChainId): TokenAmount | undefined;
+//# sourceMappingURL=transactions.d.mts.map

package/dist/mappers/helpers/transactions.d.mts.map

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

package/dist/mappers/helpers/transactions.mjs

@@ -0,0 +1,228 @@
+import { ERC721, ERC1155, isEqualCaseInsensitive as equalsIgnoreCase } from "@metamask/controller-utils";
+import { TransactionStatus, TransactionType } from "@metamask/transaction-controller";
+import { nativeTokenAddress } from "../constants.mjs";
+import { formatAddressToAssetId, getNativeAsset } from "./caip.mjs";
+import { getKnownTokenMetadata } from "./token-metadata.mjs";
+const nativeTokenDecimals = 18;
+function toNetworkFeeAmount(gasUsed, gasPrice) {
+    if (gasUsed === undefined || gasPrice === undefined) {
+        return undefined;
+    }
+    try {
+        return String(BigInt(gasUsed) * BigInt(gasPrice));
+    }
+    catch {
+        return undefined;
+    }
+}
+function buildBaseNetworkFee(amount, chainId) {
+    const nativeAsset = getNativeAsset(chainId);
+    return {
+        type: 'base',
+        amount,
+        ...(nativeAsset?.decimals === undefined
+            ? { decimals: nativeTokenDecimals }
+            : { decimals: nativeAsset.decimals }),
+        ...(nativeAsset?.symbol ? { symbol: nativeAsset.symbol } : {}),
+        ...(nativeAsset?.assetId ? { assetId: nativeAsset.assetId } : {}),
+    };
+}
+function getNetworkFee(transaction, chainId) {
+    const amount = toNetworkFeeAmount(transaction.gasUsed, transaction.effectiveGasPrice);
+    return amount ? buildBaseNetworkFee(amount, chainId) : undefined;
+}
+export function getFees(transaction, chainId) {
+    const networkFee = getNetworkFee(transaction, chainId);
+    return networkFee ? [networkFee] : undefined;
+}
+export function getLocalTransactionFees(transactionGroup) {
+    const { primaryTransaction } = transactionGroup;
+    const amount = toNetworkFeeAmount(primaryTransaction.txReceipt?.gasUsed, primaryTransaction.txReceipt?.effectiveGasPrice ??
+        primaryTransaction.txParams?.gasPrice);
+    return amount
+        ? [buildBaseNetworkFee(amount, primaryTransaction.chainId)]
+        : undefined;
+}
+const inProgressTransactionStatuses = [
+    TransactionStatus.unapproved,
+    TransactionStatus.approved,
+    TransactionStatus.signed,
+    TransactionStatus.submitted,
+];
+const transactionGroupCancelledStatus = 'cancelled';
+const smartTransactionStatus = {
+    cancelled: 'cancelled',
+    pending: 'pending',
+    success: 'success',
+};
+function getTransactionStatusKey(transaction) {
+    const { type, status } = transaction;
+    const receiptStatus = transaction.txReceipt?.status;
+    if (receiptStatus === '0x0') {
+        return TransactionStatus.failed;
+    }
+    if (status === TransactionStatus.confirmed &&
+        type === TransactionType.cancel) {
+        return transactionGroupCancelledStatus;
+    }
+    return transaction.status;
+}
+export function getLocalTransactionStatus({ primaryTransaction, initialTransaction, }) {
+    if (initialTransaction.isSmartTransaction) {
+        const smartStatus = initialTransaction.status;
+        if (smartStatus === smartTransactionStatus.pending) {
+            return 'pending';
+        }
+        if (smartStatus === smartTransactionStatus.success) {
+            return 'success';
+        }
+        if (smartStatus === smartTransactionStatus.cancelled) {
+            return 'failed';
+        }
+        return 'pending';
+    }
+    const statusKey = getTransactionStatusKey(primaryTransaction);
+    if (statusKey === TransactionStatus.confirmed) {
+        return 'success';
+    }
+    if (statusKey === TransactionStatus.cancelled ||
+        statusKey === transactionGroupCancelledStatus ||
+        statusKey === TransactionStatus.dropped ||
+        statusKey === TransactionStatus.failed ||
+        statusKey === TransactionStatus.rejected) {
+        return 'failed';
+    }
+    if (inProgressTransactionStatuses.includes(statusKey)) {
+        return 'pending';
+    }
+    return 'pending';
+}
+export function isNftStandard(value) {
+    return value === ERC721.toLowerCase() || value === ERC1155.toLowerCase();
+}
+export function getNftPaymentTransfer({ side, sentTransfer, receivedTransfer, sentNativeTransfer, nftCounterparty, transactionFrom, transactionTo, subjectAddress, }) {
+    const isFungible = (transfer) => Boolean(transfer && !isNftStandard(transfer.transferType));
+    if (side === 'buy') {
+        for (const transfer of [sentNativeTransfer, sentTransfer]) {
+            if (!transfer || !isFungible(transfer)) {
+                continue;
+            }
+            // Only count a payment that goes to the NFT counterparty (direct sale) or
+            // to the contract being called (marketplace/router). This avoids treating
+            // an unrelated native send in the same transaction as the NFT payment.
+            if (equalsIgnoreCase(transfer.to, nftCounterparty) ||
+                equalsIgnoreCase(transfer.to, transactionTo)) {
+                return transfer;
+            }
+        }
+        return undefined;
+    }
+    if (!receivedTransfer || !isFungible(receivedTransfer)) {
+        return undefined;
+    }
+    if (equalsIgnoreCase(receivedTransfer.from, nftCounterparty) ||
+        (transactionFrom &&
+            !equalsIgnoreCase(transactionFrom, subjectAddress) &&
+            equalsIgnoreCase(receivedTransfer.from, transactionFrom))) {
+        return receivedTransfer;
+    }
+    return undefined;
+}
+const resolveAssetId = (chainId, { contractAddress, transferType, }) => {
+    if (contractAddress) {
+        return formatAddressToAssetId(contractAddress, chainId);
+    }
+    if (transferType === 'normal' || transferType === 'internal') {
+        return formatAddressToAssetId(nativeTokenAddress, chainId);
+    }
+    return undefined;
+};
+/**
+ * Resolves the user's primary send and receive legs from indexed value transfers.
+ * Prefers a receive whose symbol differs from the sent leg so dust does not win.
+ *
+ * @param valueTransfers - Indexed value transfers from the Accounts API.
+ * @param subjectAddress - The account address to match transfers against.
+ * @returns The primary sent and received transfers for the account.
+ */
+export function parseValueTransfers(valueTransfers, subjectAddress) {
+    const sent = valueTransfers?.filter(({ from }) => equalsIgnoreCase(from, subjectAddress));
+    const received = valueTransfers?.filter(({ to }) => equalsIgnoreCase(to, subjectAddress));
+    const sentTransfer = sent?.[0];
+    const receivedTransfer = received?.find(({ symbol }) => symbol !== sentTransfer?.symbol) ??
+        received?.[0];
+    const sentNativeTransfer = sent?.find(({ transferType }) => transferType === 'normal');
+    const sentNftTransfer = sent?.find(({ transferType }) => isNftStandard(transferType));
+    const receivedNftTransfer = received?.find(({ transferType }) => isNftStandard(transferType));
+    return {
+        sentTransfer,
+        receivedTransfer,
+        sentNativeTransfer,
+        sentNftTransfer,
+        receivedNftTransfer,
+    };
+}
+export function getTokenAmountFromTransfer(transfer, direction, chainId) {
+    if (!transfer) {
+        return undefined;
+    }
+    const { transferType, amount } = transfer;
+    const isNftTransfer = isNftStandard(transferType);
+    const symbol = isNftTransfer
+        ? transfer.name || transfer.symbol
+        : transfer.symbol;
+    if (!symbol && amount === undefined) {
+        return undefined;
+    }
+    const assetId = transfer && !isNftTransfer
+        ? resolveAssetId(chainId, {
+            contractAddress: transfer.contractAddress,
+            transferType: transfer.transferType,
+        })
+        : undefined;
+    const hasTransferAmount = !isNftTransfer && amount !== null && amount !== undefined;
+    return {
+        direction,
+        ...(hasTransferAmount ? { amount: String(amount) } : {}),
+        ...(transfer.decimal === undefined ? {} : { decimals: transfer.decimal }),
+        ...(symbol ? { symbol } : {}),
+        ...(assetId ? { assetId } : {}),
+    };
+}
+export function getTokenMetadataFromKnownToken(contractAddress, direction, chainId) {
+    const tokenMetadata = getKnownTokenMetadata(chainId, contractAddress);
+    if (!tokenMetadata) {
+        return undefined;
+    }
+    return {
+        direction,
+        ...(tokenMetadata.symbol ? { symbol: tokenMetadata.symbol } : {}),
+        ...(tokenMetadata.decimals === undefined
+            ? {}
+            : { decimals: tokenMetadata.decimals }),
+        ...(tokenMetadata.assetId ? { assetId: tokenMetadata.assetId } : {}),
+    };
+}
+/**
+ * When the transfer omits contractAddress, fall back to the indexed tx `to` field.
+ *
+ * @param token - Parsed token amount from the value transfer.
+ * @param fallbackContractAddress - Indexed transaction `to` address used as ERC-20 fallback.
+ * @param transferType - Value transfer type; native (`normal`) transfers skip the fallback.
+ * @param chainId - CAIP-2 chain id for asset id encoding.
+ * @returns Token amount with `assetId` set when a fallback address applies.
+ */
+export function withFallbackTokenAssetId(token, fallbackContractAddress, transferType, chainId) {
+    if (!token ||
+        token.assetId ||
+        transferType === 'normal' ||
+        !fallbackContractAddress) {
+        return token;
+    }
+    const assetId = formatAddressToAssetId(fallbackContractAddress, chainId);
+    if (!assetId) {
+        return token;
+    }
+    return { ...token, assetId };
+}
+//# sourceMappingURL=transactions.mjs.map

package/dist/mappers/helpers/transactions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.mjs","sourceRoot":"","sources":["../../../src/mappers/helpers/transactions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,OAAO,EACP,sBAAsB,IAAI,gBAAgB,EAC3C,mCAAmC;AAGpC,OAAO,EACL,iBAAiB,EACjB,eAAe,EAChB,yCAAyC;AAI1C,OAAO,EAAE,kBAAkB,EAAE,yBAAqB;AAClD,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,mBAAe;AAChE,OAAO,EAAE,qBAAqB,EAAE,6BAAyB;AAYzD,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,SAAS,kBAAkB,CACzB,OAAoC,EACpC,QAAqC;IAErC,IAAI,OAAO,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACpD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAc,EAAE,OAAwB;IACnE,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAE5C,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,MAAM;QACN,GAAG,CAAC,WAAW,EAAE,QAAQ,KAAK,SAAS;YACrC,CAAC,CAAC,EAAE,QAAQ,EAAE,mBAAmB,EAAE;YACnC,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,CAAC;QACvC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,WAAwC,EACxC,OAAe;IAEf,MAAM,MAAM,GAAG,kBAAkB,CAC/B,WAAW,CAAC,OAAO,EACnB,WAAW,CAAC,iBAAiB,CAC9B,CAAC;IAEF,OAAO,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,WAAwC,EACxC,OAAe;IAEf,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAEvD,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,gBAA8D;IAE9D,MAAM,EAAE,kBAAkB,EAAE,GAAG,gBAAgB,CAAC;IAChD,MAAM,MAAM,GAAG,kBAAkB,CAC/B,kBAAkB,CAAC,SAAS,EAAE,OAAO,EACrC,kBAAkB,CAAC,SAAS,EAAE,iBAAiB;QAC7C,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CACxC,CAAC;IAEF,OAAO,MAAM;QACX,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC3D,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,MAAM,6BAA6B,GAAG;IACpC,iBAAiB,CAAC,UAAU;IAC5B,iBAAiB,CAAC,QAAQ;IAC1B,iBAAiB,CAAC,MAAM;IACxB,iBAAiB,CAAC,SAAS;CAC5B,CAAC;AAEF,MAAM,+BAA+B,GAAG,WAAW,CAAC;AAEpD,MAAM,sBAAsB,GAAG;IAC7B,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACV,CAAC;AAEX,SAAS,uBAAuB,CAC9B,WAAmD;IAEnD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC;IACrC,MAAM,aAAa,GAAG,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC;IAEpD,IAAI,aAAa,KAAK,KAAK,EAAE,CAAC;QAC5B,OAAO,iBAAiB,CAAC,MAAM,CAAC;IAClC,CAAC;IAED,IACE,MAAM,KAAK,iBAAiB,CAAC,SAAS;QACtC,IAAI,KAAK,eAAe,CAAC,MAAM,EAC/B,CAAC;QACD,OAAO,+BAA+B,CAAC;IACzC,CAAC;IAED,OAAO,WAAW,CAAC,MAAM,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,EACxC,kBAAkB,EAClB,kBAAkB,GAInB;IACC,IAAI,kBAAkB,CAAC,kBAAkB,EAAE,CAAC;QAC1C,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAA4B,CAAC;QAEpE,IAAI,WAAW,KAAK,sBAAsB,CAAC,OAAO,EAAE,CAAC;YACnD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,WAAW,KAAK,sBAAsB,CAAC,OAAO,EAAE,CAAC;YACnD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,WAAW,KAAK,sBAAsB,CAAC,SAAS,EAAE,CAAC;YACrD,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,uBAAuB,CAAC,kBAAkB,CAAC,CAAC;IAE9D,IAAI,SAAS,KAAK,iBAAiB,CAAC,SAAS,EAAE,CAAC;QAC9C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IACE,SAAS,KAAK,iBAAiB,CAAC,SAAS;QACzC,SAAS,KAAK,+BAA+B;QAC7C,SAAS,KAAK,iBAAiB,CAAC,OAAO;QACvC,SAAS,KAAK,iBAAiB,CAAC,MAAM;QACtC,SAAS,KAAK,iBAAiB,CAAC,QAAQ,EACxC,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IACE,6BAA6B,CAAC,QAAQ,CACpC,SAA2D,CAC5D,EACD,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,KAAK,KAAK,MAAM,CAAC,WAAW,EAAE,IAAI,KAAK,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,EACpC,IAAI,EACJ,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,aAAa,EACb,cAAc,GAUf;IACC,MAAM,UAAU,GAAG,CAAC,QAAwB,EAAW,EAAE,CACvD,OAAO,CAAC,QAAQ,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;IAE7D,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,KAAK,MAAM,QAAQ,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC,EAAE,CAAC;YAC1D,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvC,SAAS;YACX,CAAC;YAED,0EAA0E;YAC1E,0EAA0E;YAC1E,uEAAuE;YACvE,IACE,gBAAgB,CAAC,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAC;gBAC9C,gBAAgB,CAAC,QAAQ,CAAC,EAAE,EAAE,aAAuB,CAAC,EACtD,CAAC;gBACD,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,gBAAgB,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACvD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IACE,gBAAgB,CAAC,gBAAgB,CAAC,IAAI,EAAE,eAAe,CAAC;QACxD,CAAC,eAAe;YACd,CAAC,gBAAgB,CAAC,eAAe,EAAE,cAAc,CAAC;YAClD,gBAAgB,CAAC,gBAAgB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,EAC3D,CAAC;QACD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,cAAc,GAAG,CACrB,OAAoB,EACpB,EACE,eAAe,EACf,YAAY,GAIb,EACmB,EAAE;IACtB,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,sBAAsB,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,YAAY,KAAK,QAAQ,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;QAC7D,OAAO,sBAAsB,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,cAA2C,EAC3C,cAAsB;IAQtB,MAAM,IAAI,GAAG,cAAc,EAAE,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAC/C,gBAAgB,CAAC,IAAI,EAAE,cAAc,CAAC,CACvC,CAAC;IACF,MAAM,QAAQ,GAAG,cAAc,EAAE,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CACjD,gBAAgB,CAAC,EAAE,EAAE,cAAc,CAAC,CACrC,CAAC;IAEF,MAAM,YAAY,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAE/B,MAAM,gBAAgB,GACpB,QAAQ,EAAE,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,KAAK,YAAY,EAAE,MAAM,CAAC;QAC/D,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IAEhB,MAAM,kBAAkB,GAAG,IAAI,EAAE,IAAI,CACnC,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,YAAY,KAAK,QAAQ,CAChD,CAAC;IAEF,MAAM,eAAe,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CACtD,aAAa,CAAC,YAAY,CAAC,CAC5B,CAAC;IACF,MAAM,mBAAmB,GAAG,QAAQ,EAAE,IAAI,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAC9D,aAAa,CAAC,YAAY,CAAC,CAC5B,CAAC;IAEF,OAAO;QACL,YAAY;QACZ,gBAAgB;QAChB,kBAAkB;QAClB,eAAe;QACf,mBAAmB;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,QAAmC,EACnC,SAAmC,EACnC,OAAoB;IAEpB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;IAC1C,MAAM,aAAa,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,aAAa;QAC1B,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,MAAM;QAClC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;IAEpB,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GACX,QAAQ,IAAI,CAAC,aAAa;QACxB,CAAC,CAAC,cAAc,CAAC,OAAO,EAAE;YACtB,eAAe,EAAE,QAAQ,CAAC,eAAe;YACzC,YAAY,EAAE,QAAQ,CAAC,YAAY;SACpC,CAAC;QACJ,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,iBAAiB,GACrB,CAAC,aAAa,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,CAAC;IAE5D,OAAO;QACL,SAAS;QACT,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;QACzE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,eAAmC,EACnC,SAAmC,EACnC,OAAoB;IAEpB,MAAM,aAAa,GAAG,qBAAqB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAEtE,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,SAAS;QACT,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,aAAa,CAAC,QAAQ,KAAK,SAAS;YACtC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE,CAAC;QACzC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrE,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAA8B,EAC9B,uBAA2C,EAC3C,YAAgC,EAChC,OAAoB;IAEpB,IACE,CAAC,KAAK;QACN,KAAK,CAAC,OAAO;QACb,YAAY,KAAK,QAAQ;QACzB,CAAC,uBAAuB,EACxB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,sBAAsB,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;IACzE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC","sourcesContent":["import {\n  ERC721,\n  ERC1155,\n  isEqualCaseInsensitive as equalsIgnoreCase,\n} from '@metamask/controller-utils';\nimport type { V1TransactionByHashResponse } from '@metamask/core-backend';\nimport type { TransactionMeta } from '@metamask/transaction-controller';\nimport {\n  TransactionStatus,\n  TransactionType,\n} from '@metamask/transaction-controller';\nimport type { CaipChainId, Hex } from '@metamask/utils';\n\nimport type { Fee, Status, TokenAmount, ValueTransfer } from '../../types';\nimport { nativeTokenAddress } from '../constants';\nimport { formatAddressToAssetId, getNativeAsset } from './caip';\nimport { getKnownTokenMetadata } from './token-metadata';\n\n// Adds optional `isSmartTransaction` to `TransactionMeta`.\nexport type TransactionGroup = {\n  hasCancelled: boolean;\n  hasRetried: boolean;\n  initialTransaction: TransactionMeta & { isSmartTransaction?: boolean };\n  nonce: Hex;\n  primaryTransaction: TransactionMeta;\n  transactions: TransactionMeta[];\n};\n\nconst nativeTokenDecimals = 18;\n\nfunction toNetworkFeeAmount(\n  gasUsed: string | number | undefined,\n  gasPrice: string | number | undefined,\n): string | undefined {\n  if (gasUsed === undefined || gasPrice === undefined) {\n    return undefined;\n  }\n\n  try {\n    return String(BigInt(gasUsed) * BigInt(gasPrice));\n  } catch {\n    return undefined;\n  }\n}\n\nfunction buildBaseNetworkFee(amount: string, chainId: string | number): Fee {\n  const nativeAsset = getNativeAsset(chainId);\n\n  return {\n    type: 'base',\n    amount,\n    ...(nativeAsset?.decimals === undefined\n      ? { decimals: nativeTokenDecimals }\n      : { decimals: nativeAsset.decimals }),\n    ...(nativeAsset?.symbol ? { symbol: nativeAsset.symbol } : {}),\n    ...(nativeAsset?.assetId ? { assetId: nativeAsset.assetId } : {}),\n  };\n}\n\nfunction getNetworkFee(\n  transaction: V1TransactionByHashResponse,\n  chainId: string,\n): Fee | undefined {\n  const amount = toNetworkFeeAmount(\n    transaction.gasUsed,\n    transaction.effectiveGasPrice,\n  );\n\n  return amount ? buildBaseNetworkFee(amount, chainId) : undefined;\n}\n\nexport function getFees(\n  transaction: V1TransactionByHashResponse,\n  chainId: string,\n): Fee[] | undefined {\n  const networkFee = getNetworkFee(transaction, chainId);\n\n  return networkFee ? [networkFee] : undefined;\n}\n\nexport function getLocalTransactionFees(\n  transactionGroup: Pick<TransactionGroup, 'primaryTransaction'>,\n): Fee[] | undefined {\n  const { primaryTransaction } = transactionGroup;\n  const amount = toNetworkFeeAmount(\n    primaryTransaction.txReceipt?.gasUsed,\n    primaryTransaction.txReceipt?.effectiveGasPrice ??\n      primaryTransaction.txParams?.gasPrice,\n  );\n\n  return amount\n    ? [buildBaseNetworkFee(amount, primaryTransaction.chainId)]\n    : undefined;\n}\n\nconst inProgressTransactionStatuses = [\n  TransactionStatus.unapproved,\n  TransactionStatus.approved,\n  TransactionStatus.signed,\n  TransactionStatus.submitted,\n];\n\nconst transactionGroupCancelledStatus = 'cancelled';\n\nconst smartTransactionStatus = {\n  cancelled: 'cancelled',\n  pending: 'pending',\n  success: 'success',\n} as const;\n\nfunction getTransactionStatusKey(\n  transaction: TransactionGroup['primaryTransaction'],\n): string {\n  const { type, status } = transaction;\n  const receiptStatus = transaction.txReceipt?.status;\n\n  if (receiptStatus === '0x0') {\n    return TransactionStatus.failed;\n  }\n\n  if (\n    status === TransactionStatus.confirmed &&\n    type === TransactionType.cancel\n  ) {\n    return transactionGroupCancelledStatus;\n  }\n\n  return transaction.status;\n}\n\nexport function getLocalTransactionStatus({\n  primaryTransaction,\n  initialTransaction,\n}: {\n  primaryTransaction: TransactionGroup['primaryTransaction'];\n  initialTransaction: TransactionGroup['initialTransaction'];\n}): Status {\n  if (initialTransaction.isSmartTransaction) {\n    const smartStatus = initialTransaction.status as string | undefined;\n\n    if (smartStatus === smartTransactionStatus.pending) {\n      return 'pending';\n    }\n\n    if (smartStatus === smartTransactionStatus.success) {\n      return 'success';\n    }\n\n    if (smartStatus === smartTransactionStatus.cancelled) {\n      return 'failed';\n    }\n\n    return 'pending';\n  }\n\n  const statusKey = getTransactionStatusKey(primaryTransaction);\n\n  if (statusKey === TransactionStatus.confirmed) {\n    return 'success';\n  }\n\n  if (\n    statusKey === TransactionStatus.cancelled ||\n    statusKey === transactionGroupCancelledStatus ||\n    statusKey === TransactionStatus.dropped ||\n    statusKey === TransactionStatus.failed ||\n    statusKey === TransactionStatus.rejected\n  ) {\n    return 'failed';\n  }\n\n  if (\n    inProgressTransactionStatuses.includes(\n      statusKey as (typeof inProgressTransactionStatuses)[number],\n    )\n  ) {\n    return 'pending';\n  }\n\n  return 'pending';\n}\n\nexport function isNftStandard(value?: string): boolean {\n  return value === ERC721.toLowerCase() || value === ERC1155.toLowerCase();\n}\n\nexport function getNftPaymentTransfer({\n  side,\n  sentTransfer,\n  receivedTransfer,\n  sentNativeTransfer,\n  nftCounterparty,\n  transactionFrom,\n  transactionTo,\n  subjectAddress,\n}: {\n  side: 'buy' | 'sell';\n  sentTransfer?: ValueTransfer;\n  receivedTransfer?: ValueTransfer;\n  sentNativeTransfer?: ValueTransfer;\n  nftCounterparty: string;\n  transactionFrom?: string;\n  transactionTo?: string;\n  subjectAddress: string;\n}): ValueTransfer | undefined {\n  const isFungible = (transfer?: ValueTransfer): boolean =>\n    Boolean(transfer && !isNftStandard(transfer.transferType));\n\n  if (side === 'buy') {\n    for (const transfer of [sentNativeTransfer, sentTransfer]) {\n      if (!transfer || !isFungible(transfer)) {\n        continue;\n      }\n\n      // Only count a payment that goes to the NFT counterparty (direct sale) or\n      // to the contract being called (marketplace/router). This avoids treating\n      // an unrelated native send in the same transaction as the NFT payment.\n      if (\n        equalsIgnoreCase(transfer.to, nftCounterparty) ||\n        equalsIgnoreCase(transfer.to, transactionTo as string)\n      ) {\n        return transfer;\n      }\n    }\n\n    return undefined;\n  }\n\n  if (!receivedTransfer || !isFungible(receivedTransfer)) {\n    return undefined;\n  }\n\n  if (\n    equalsIgnoreCase(receivedTransfer.from, nftCounterparty) ||\n    (transactionFrom &&\n      !equalsIgnoreCase(transactionFrom, subjectAddress) &&\n      equalsIgnoreCase(receivedTransfer.from, transactionFrom))\n  ) {\n    return receivedTransfer;\n  }\n\n  return undefined;\n}\n\nconst resolveAssetId = (\n  chainId: CaipChainId,\n  {\n    contractAddress,\n    transferType,\n  }: {\n    contractAddress?: string;\n    transferType?: string;\n  },\n): string | undefined => {\n  if (contractAddress) {\n    return formatAddressToAssetId(contractAddress, chainId);\n  }\n\n  if (transferType === 'normal' || transferType === 'internal') {\n    return formatAddressToAssetId(nativeTokenAddress, chainId);\n  }\n\n  return undefined;\n};\n\n/**\n * Resolves the user's primary send and receive legs from indexed value transfers.\n * Prefers a receive whose symbol differs from the sent leg so dust does not win.\n *\n * @param valueTransfers - Indexed value transfers from the Accounts API.\n * @param subjectAddress - The account address to match transfers against.\n * @returns The primary sent and received transfers for the account.\n */\nexport function parseValueTransfers(\n  valueTransfers: ValueTransfer[] | undefined,\n  subjectAddress: string,\n): {\n  sentTransfer: ValueTransfer | undefined;\n  receivedTransfer: ValueTransfer | undefined;\n  sentNativeTransfer: ValueTransfer | undefined;\n  sentNftTransfer: ValueTransfer | undefined;\n  receivedNftTransfer: ValueTransfer | undefined;\n} {\n  const sent = valueTransfers?.filter(({ from }) =>\n    equalsIgnoreCase(from, subjectAddress),\n  );\n  const received = valueTransfers?.filter(({ to }) =>\n    equalsIgnoreCase(to, subjectAddress),\n  );\n\n  const sentTransfer = sent?.[0];\n\n  const receivedTransfer =\n    received?.find(({ symbol }) => symbol !== sentTransfer?.symbol) ??\n    received?.[0];\n\n  const sentNativeTransfer = sent?.find(\n    ({ transferType }) => transferType === 'normal',\n  );\n\n  const sentNftTransfer = sent?.find(({ transferType }) =>\n    isNftStandard(transferType),\n  );\n  const receivedNftTransfer = received?.find(({ transferType }) =>\n    isNftStandard(transferType),\n  );\n\n  return {\n    sentTransfer,\n    receivedTransfer,\n    sentNativeTransfer,\n    sentNftTransfer,\n    receivedNftTransfer,\n  };\n}\n\nexport function getTokenAmountFromTransfer(\n  transfer: ValueTransfer | undefined,\n  direction: TokenAmount['direction'],\n  chainId: CaipChainId,\n): TokenAmount | undefined {\n  if (!transfer) {\n    return undefined;\n  }\n\n  const { transferType, amount } = transfer;\n  const isNftTransfer = isNftStandard(transferType);\n  const symbol = isNftTransfer\n    ? transfer.name || transfer.symbol\n    : transfer.symbol;\n\n  if (!symbol && amount === undefined) {\n    return undefined;\n  }\n\n  const assetId =\n    transfer && !isNftTransfer\n      ? resolveAssetId(chainId, {\n          contractAddress: transfer.contractAddress,\n          transferType: transfer.transferType,\n        })\n      : undefined;\n\n  const hasTransferAmount =\n    !isNftTransfer && amount !== null && amount !== undefined;\n\n  return {\n    direction,\n    ...(hasTransferAmount ? { amount: String(amount) } : {}),\n    ...(transfer.decimal === undefined ? {} : { decimals: transfer.decimal }),\n    ...(symbol ? { symbol } : {}),\n    ...(assetId ? { assetId } : {}),\n  };\n}\n\nexport function getTokenMetadataFromKnownToken(\n  contractAddress: string | undefined,\n  direction: TokenAmount['direction'],\n  chainId: CaipChainId,\n): TokenAmount | undefined {\n  const tokenMetadata = getKnownTokenMetadata(chainId, contractAddress);\n\n  if (!tokenMetadata) {\n    return undefined;\n  }\n\n  return {\n    direction,\n    ...(tokenMetadata.symbol ? { symbol: tokenMetadata.symbol } : {}),\n    ...(tokenMetadata.decimals === undefined\n      ? {}\n      : { decimals: tokenMetadata.decimals }),\n    ...(tokenMetadata.assetId ? { assetId: tokenMetadata.assetId } : {}),\n  };\n}\n\n/**\n * When the transfer omits contractAddress, fall back to the indexed tx `to` field.\n *\n * @param token - Parsed token amount from the value transfer.\n * @param fallbackContractAddress - Indexed transaction `to` address used as ERC-20 fallback.\n * @param transferType - Value transfer type; native (`normal`) transfers skip the fallback.\n * @param chainId - CAIP-2 chain id for asset id encoding.\n * @returns Token amount with `assetId` set when a fallback address applies.\n */\nexport function withFallbackTokenAssetId(\n  token: TokenAmount | undefined,\n  fallbackContractAddress: string | undefined,\n  transferType: string | undefined,\n  chainId: CaipChainId,\n): TokenAmount | undefined {\n  if (\n    !token ||\n    token.assetId ||\n    transferType === 'normal' ||\n    !fallbackContractAddress\n  ) {\n    return token;\n  }\n\n  const assetId = formatAddressToAssetId(fallbackContractAddress, chainId);\n  if (!assetId) {\n    return token;\n  }\n\n  return { ...token, assetId };\n}\n"]}

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

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapKeyringTransaction = void 0;
+const keyring_api_1 = require("@metamask/keyring-api");
+function mapStatus(status) {
+    switch (status) {
+        case keyring_api_1.TransactionStatus.Confirmed:
+            return 'success';
+        case keyring_api_1.TransactionStatus.Failed:
+            return 'failed';
+        case keyring_api_1.TransactionStatus.Submitted:
+        case keyring_api_1.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.
+ */
+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 === keyring_api_1.TransactionType.Send && subjectAddress
+        ? subjectAddress
+        : getAddress(transaction.from);
+    const to = type === keyring_api_1.TransactionType.Receive && subjectAddress
+        ? subjectAddress
+        : getAddress(transaction.to);
+    const fees = getFees(transaction);
+    const common = { chainId, status, timestamp, hash: id };
+    switch (type) {
+        case keyring_api_1.TransactionType.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 keyring_api_1.TransactionType.Receive:
+            return {
+                type: 'receive',
+                ...common,
+                data: {
+                    from,
+                    to,
+                    token: getToken(transaction.to, 'in'),
+                    fees,
+                },
+            };
+        case keyring_api_1.TransactionType.Swap:
+            return {
+                type: 'swap',
+                ...common,
+                data: {
+                    from,
+                    destinationToken: getToken(transaction.to, 'in'),
+                    sourceToken: getToken(transaction.from, 'out'),
+                    fees,
+                },
+            };
+        case keyring_api_1.TransactionType.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,
+                },
+            };
+    }
+}
+exports.mapKeyringTransaction = mapKeyringTransaction;
+//# sourceMappingURL=keyring-transaction-mapper.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyring-transaction-mapper.cjs","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/keyring-transaction-mapper.d.cts

@@ -0,0 +1,15 @@
+import type { Transaction as KeyringTransaction } from "@metamask/keyring-api";
+import type { ActivityItem } from "../types.cjs";
+/**
+ * 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.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyring-transaction-mapper.d.cts","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"}