@metamask/transaction-pay-controller 22.3.1 → 22.5.0

package/dist/utils/token.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"token.mjs","sourceRoot":"","sources":["../../src/utils/token.ts"],"names":[],"mappings":"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","sourcesContent":["import { Contract } from '@ethersproject/contracts';\nimport { Web3Provider } from '@ethersproject/providers';\nimport { TokensControllerState } from '@metamask/assets-controllers';\nimport { toChecksumHexAddress } from '@metamask/controller-utils';\nimport { abiERC20 } from '@metamask/metamask-eth-abis';\nimport type { CaipAssetType, Hex } from '@metamask/utils';\nimport { hexToBigInt, toCaipAssetType } from '@metamask/utils';\nimport { BigNumber } from 'bignumber.js';\n\nimport {\n  CHAIN_ID_POLYGON,\n  NATIVE_TOKEN_ADDRESS,\n  SLIP44_COIN_TYPE_BY_CHAIN,\n  STABLECOINS,\n} from '../constants';\nimport type { FiatRates, TransactionPayControllerMessenger } from '../types';\nimport { getAssetsUnifyStateFeature } from './feature-flags';\n\n/**\n * Check if two tokens are the same (same address and chain).\n *\n * @param token1 - First token identifier.\n * @param token1.address - Token address.\n * @param token1.chainId - Token chain ID.\n * @param token2 - Second token identifier.\n * @param token2.address - Token address.\n * @param token2.chainId - Token chain ID.\n * @returns True if tokens are the same, false otherwise.\n */\nexport function isSameToken(\n  token1: { address: Hex; chainId: Hex },\n  token2: { address: Hex; chainId: Hex },\n): boolean {\n  return (\n    token1.address.toLowerCase() === token2.address.toLowerCase() &&\n    token1.chainId === token2.chainId\n  );\n}\n\n/**\n * Get the token balance for a specific account and token.\n *\n * @param messenger - Controller messenger.\n * @param account - Address of the account.\n * @param chainId - Id of the chain.\n * @param tokenAddress - Address of the token contract.\n * @returns Raw token balance as a decimal string.\n */\nexport function getTokenBalance(\n  messenger: TransactionPayControllerMessenger,\n  account: Hex,\n  chainId: Hex,\n  tokenAddress: Hex,\n): string {\n  const assetsUnifyStateFeatureEnabled = getAssetsUnifyStateFeature(messenger);\n\n  let tokenBalances;\n  let accountsByChainId;\n  if (assetsUnifyStateFeatureEnabled) {\n    const assetsControllerState = messenger.call(\n      'AssetsController:getStateForTransactionPay',\n    );\n\n    tokenBalances = assetsControllerState?.tokenBalances;\n    accountsByChainId = assetsControllerState?.accountsByChainId;\n  } else {\n    tokenBalances = messenger.call(\n      'TokenBalancesController:getState',\n    )?.tokenBalances;\n    accountsByChainId = messenger.call(\n      'AccountTrackerController:getState',\n    )?.accountsByChainId;\n  }\n\n  const normalizedAccount = account.toLowerCase() as Hex;\n  const normalizedTokenAddress = toChecksumHexAddress(tokenAddress) as Hex;\n  const isNative = normalizedTokenAddress === getNativeToken(chainId);\n\n  const balanceHex =\n    tokenBalances?.[normalizedAccount]?.[chainId]?.[normalizedTokenAddress];\n\n  if (!isNative && balanceHex === undefined) {\n    return '0';\n  }\n\n  if (!isNative && balanceHex) {\n    return new BigNumber(balanceHex, 16).toString(10);\n  }\n\n  const chainAccounts = accountsByChainId?.[chainId];\n\n  const checksumAccount = toChecksumHexAddress(normalizedAccount) as Hex;\n  const nativeBalanceHex = chainAccounts?.[checksumAccount]?.balance as Hex;\n\n  return new BigNumber(nativeBalanceHex ?? '0x0', 16).toString(10);\n}\n\n/**\n * Get the token decimals for a specific token.\n *\n * @param messenger - Controller messenger.\n * @param tokenAddress - Address of the token contract.\n * @param chainId - Id of the chain.\n * @returns The token decimals or undefined if the token is not found.\n */\nexport function getTokenInfo(\n  messenger: TransactionPayControllerMessenger,\n  tokenAddress: Hex,\n  chainId: Hex,\n): { decimals: number; symbol: string } | undefined {\n  const assetsUnifyStateFeatureEnabled = getAssetsUnifyStateFeature(messenger);\n\n  let allTokens: TokensControllerState['allTokens'];\n  if (assetsUnifyStateFeatureEnabled) {\n    allTokens = messenger.call(\n      'AssetsController:getStateForTransactionPay',\n    )?.allTokens;\n  } else {\n    allTokens = messenger.call('TokensController:getState')?.allTokens;\n  }\n\n  const normalizedTokenAddress = tokenAddress.toLowerCase() as Hex;\n\n  const isNative =\n    normalizedTokenAddress === getNativeToken(chainId).toLowerCase();\n\n  const token = Object.values(allTokens?.[chainId] ?? {})\n    .flat()\n    .find(\n      (singleToken) =>\n        singleToken.address.toLowerCase() === normalizedTokenAddress,\n    );\n\n  if (!token && !isNative) {\n    return undefined;\n  }\n\n  if (token && !isNative) {\n    return { decimals: Number(token.decimals), symbol: token.symbol };\n  }\n\n  const ticker = getTicker(chainId, messenger);\n\n  if (!ticker) {\n    return undefined;\n  }\n\n  return { decimals: 18, symbol: ticker };\n}\n\n/**\n * Calculate fiat rates for a specific token.\n *\n * @param messenger - Controller messenger.\n * @param tokenAddress - Address of the token contract.\n * @param chainId - Id of the chain.\n * @returns An object containing the USD and fiat rates, or undefined if rates are not available.\n */\nexport function getTokenFiatRate(\n  messenger: TransactionPayControllerMessenger,\n  tokenAddress: Hex,\n  chainId: Hex,\n): FiatRates | undefined {\n  const assetsUnifyStateFeatureEnabled = getAssetsUnifyStateFeature(messenger);\n\n  let marketData;\n  let currencyRates;\n  if (assetsUnifyStateFeatureEnabled) {\n    const assetsControllerState = messenger.call(\n      'AssetsController:getStateForTransactionPay',\n    );\n\n    marketData = assetsControllerState?.marketData;\n    currencyRates = assetsControllerState?.currencyRates;\n  } else {\n    marketData = messenger.call('TokenRatesController:getState')?.marketData;\n    currencyRates = messenger.call(\n      'CurrencyRateController:getState',\n    )?.currencyRates;\n  }\n\n  const ticker = getTicker(chainId, messenger);\n\n  if (!ticker) {\n    return undefined;\n  }\n\n  const normalizedTokenAddress = toChecksumHexAddress(tokenAddress) as Hex;\n  const isNative = normalizedTokenAddress === getNativeToken(chainId);\n\n  const tokenToNativeRate =\n    marketData?.[chainId]?.[normalizedTokenAddress]?.price;\n\n  if (tokenToNativeRate === undefined && !isNative) {\n    return undefined;\n  }\n\n  const {\n    conversionRate: nativeToFiatRate,\n    usdConversionRate: nativeToUsdRate,\n  } = currencyRates?.[ticker] ?? {\n    conversionRate: null,\n    usdConversionRate: null,\n  };\n\n  if (nativeToFiatRate === null || nativeToUsdRate === null) {\n    return undefined;\n  }\n  const isStablecoin = STABLECOINS[chainId]?.includes(\n    tokenAddress.toLowerCase() as Hex,\n  );\n\n  const usdRate = isStablecoin\n    ? '1'\n    : new BigNumber(tokenToNativeRate ?? 1)\n        .multipliedBy(nativeToUsdRate)\n        .toString(10);\n\n  const fiatRate = new BigNumber(tokenToNativeRate ?? 1)\n    .multipliedBy(nativeToFiatRate)\n    .toString(10);\n\n  return { usdRate, fiatRate };\n}\n\n/**\n * Calculate the human-readable, raw, USD, and fiat representations of a token amount.\n *\n * @param rawInput - Raw token amount (decimal string, hex, or BigNumber).\n * @param decimals - Number of decimals for the token.\n * @param fiatRates - Fiat rates for the token.\n * @returns Object containing the amount in raw, human-readable, USD, and fiat formats.\n */\nexport function computeTokenAmounts(\n  rawInput: BigNumber.Value,\n  decimals: number,\n  fiatRates: FiatRates,\n): {\n  raw: string;\n  human: string;\n  usd: string;\n  fiat: string;\n} {\n  const rawValue = new BigNumber(rawInput);\n  const humanValue = rawValue.shiftedBy(-decimals);\n\n  return {\n    raw: rawValue.toFixed(0),\n    human: humanValue.toString(10),\n    usd: humanValue.multipliedBy(fiatRates.usdRate).toString(10),\n    fiat: humanValue.multipliedBy(fiatRates.fiatRate).toString(10),\n  };\n}\n\n/**\n * Compute a raw token amount from a fiat (USD) amount.\n * This is the inverse of `computeTokenAmounts` — it goes from USD to raw.\n *\n * @param fiatAmount - Amount in fiat/USD.\n * @param decimals - Token decimals.\n * @param usdRate - USD rate for the token (price per one unit of the token).\n * @returns Raw token amount string, or undefined if the conversion produces an invalid result.\n */\nexport function computeRawFromFiatAmount(\n  fiatAmount: BigNumber.Value,\n  decimals: number,\n  usdRate: BigNumber.Value,\n): string | undefined {\n  const rate = new BigNumber(usdRate);\n  if (!rate.isFinite() || !rate.gt(0)) {\n    return undefined;\n  }\n\n  const humanAmount = new BigNumber(fiatAmount).dividedBy(rate);\n  if (!humanAmount.isFinite() || !humanAmount.gt(0)) {\n    return undefined;\n  }\n\n  const raw = humanAmount\n    .shiftedBy(decimals)\n    .decimalPlaces(0, BigNumber.ROUND_DOWN)\n    .toFixed(0);\n\n  return new BigNumber(raw).gt(0) ? raw : undefined;\n}\n\n/**\n * Get the native token address for a given chain ID.\n *\n * @param chainId - Chain ID.\n * @returns - Native token address for the given chain ID.\n */\nexport function getNativeToken(chainId: Hex): Hex {\n  switch (chainId) {\n    case '0x89':\n      return '0x0000000000000000000000000000000000001010';\n    default:\n      return NATIVE_TOKEN_ADDRESS;\n  }\n}\n\n/**\n * Get the live on-chain token balance via an RPC `eth_call` to the ERC-20\n * `balanceOf` function, or `eth_getBalance` for native tokens.\n *\n * Unlike {@link getTokenBalance}, this bypasses the cached state in\n * `TokenBalancesController` and reads directly from the chain.\n *\n * @param messenger - Controller messenger.\n * @param account - Address of the account.\n * @param chainId - Chain ID.\n * @param tokenAddress - Address of the token contract.\n * @returns Raw token balance as a decimal string.\n */\nexport async function getLiveTokenBalance(\n  messenger: TransactionPayControllerMessenger,\n  account: Hex,\n  chainId: Hex,\n  tokenAddress: Hex,\n): Promise<string> {\n  const networkClientId = messenger.call(\n    'NetworkController:findNetworkClientIdByChainId',\n    chainId,\n  );\n\n  const { provider } = messenger.call(\n    'NetworkController:getNetworkClientById',\n    networkClientId,\n  );\n\n  const ethersProvider = new Web3Provider(provider);\n  const isNative =\n    tokenAddress.toLowerCase() === getNativeToken(chainId).toLowerCase();\n\n  if (isNative) {\n    const balance = await ethersProvider.getBalance(account);\n    return balance.toString();\n  }\n\n  const contract = new Contract(tokenAddress, abiERC20, ethersProvider);\n  const balance = await contract.balanceOf(account);\n  return balance.toString();\n}\n\n/**\n * Build a CAIP-19 asset type identifier for an EVM token.\n *\n * For native tokens the SLIP-44 coin type is resolved automatically from\n * a built-in chain→coin-type map, falling back to 60 (ETH).  Callers can\n * override via the optional third parameter.\n *\n * @param chainId - Hex chain ID (e.g. `0x1`).\n * @param tokenAddress - Token contract address, or the native token address.\n * @param slip44CoinType - Optional SLIP-44 coin type override for native tokens.\n * @returns CAIP-19 asset type string.\n */\nexport function buildCaipAssetType(\n  chainId: Hex,\n  tokenAddress: Hex,\n  slip44CoinType?: number,\n): CaipAssetType {\n  const chainReference = String(hexToBigInt(chainId));\n  const isNative =\n    tokenAddress.toLowerCase() === getNativeToken(chainId).toLowerCase();\n\n  if (isNative) {\n    const coinType = slip44CoinType ?? SLIP44_COIN_TYPE_BY_CHAIN[chainId] ?? 60;\n\n    return toCaipAssetType(\n      'eip155',\n      chainReference,\n      'slip44',\n      String(coinType),\n    );\n  }\n\n  return toCaipAssetType('eip155', chainReference, 'erc20', tokenAddress);\n}\n\nfunction getTicker(\n  chainId: Hex,\n  messenger: TransactionPayControllerMessenger,\n): string | undefined {\n  try {\n    const networkClientId = messenger.call(\n      'NetworkController:findNetworkClientIdByChainId',\n      chainId,\n    );\n\n    const networkConfiguration = messenger.call(\n      'NetworkController:getNetworkClientById',\n      networkClientId,\n    );\n\n    return networkConfiguration.configuration.ticker;\n  } catch {\n    return undefined;\n  }\n}\n\nexport enum TokenAddressTarget {\n  Relay = 'relay',\n  MetaMask = 'metamask',\n}\n\n/**\n * Normalize token address formats between MetaMask and Relay for Polygon native\n * token handling.\n *\n * MetaMask uses Polygon's native token contract-like address (`0x...1010`),\n * while Relay expects the zero address for native tokens.\n *\n * @param tokenAddress - Token address to normalize.\n * @param chainId - Chain ID for the token.\n * @param target - Optional target system format.\n * @returns Normalized token address for the target system, or the original\n * address if no target is provided.\n */\nexport function normalizeTokenAddress(\n  tokenAddress: Hex,\n  chainId: Hex,\n  target?: TokenAddressTarget,\n): Hex {\n  if (chainId !== CHAIN_ID_POLYGON) {\n    return tokenAddress;\n  }\n\n  const nativeTokenAddress = getNativeToken(chainId).toLowerCase() as Hex;\n  const normalizedTokenAddress = tokenAddress.toLowerCase();\n\n  if (\n    target === TokenAddressTarget.Relay &&\n    normalizedTokenAddress === nativeTokenAddress\n  ) {\n    return NATIVE_TOKEN_ADDRESS;\n  }\n\n  if (\n    target === TokenAddressTarget.MetaMask &&\n    normalizedTokenAddress === NATIVE_TOKEN_ADDRESS.toLowerCase()\n  ) {\n    return nativeTokenAddress;\n  }\n\n  return tokenAddress;\n}\n"]}
+{"version":3,"file":"token.mjs","sourceRoot":"","sources":["../../src/utils/token.ts"],"names":[],"mappings":"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","sourcesContent":["import { Contract } from '@ethersproject/contracts';\nimport { Web3Provider } from '@ethersproject/providers';\nimport { TokensControllerState } from '@metamask/assets-controllers';\nimport { toChecksumHexAddress } from '@metamask/controller-utils';\nimport { abiERC20 } from '@metamask/metamask-eth-abis';\nimport type { CaipAssetType, Hex } from '@metamask/utils';\nimport { hexToBigInt, toCaipAssetType } from '@metamask/utils';\nimport { BigNumber } from 'bignumber.js';\n\nimport {\n  CHAIN_ID_POLYGON,\n  NATIVE_TOKEN_ADDRESS,\n  SLIP44_COIN_TYPE_BY_CHAIN,\n  STABLECOINS,\n} from '../constants';\nimport type { FiatRates, TransactionPayControllerMessenger } from '../types';\nimport { getAssetsUnifyStateFeature } from './feature-flags';\n\n/**\n * Check if two tokens are the same (same address and chain).\n *\n * @param token1 - First token identifier.\n * @param token1.address - Token address.\n * @param token1.chainId - Token chain ID.\n * @param token2 - Second token identifier.\n * @param token2.address - Token address.\n * @param token2.chainId - Token chain ID.\n * @returns True if tokens are the same, false otherwise.\n */\nexport function isSameToken(\n  token1: { address: Hex; chainId: Hex },\n  token2: { address: Hex; chainId: Hex },\n): boolean {\n  return (\n    token1.address.toLowerCase() === token2.address.toLowerCase() &&\n    token1.chainId === token2.chainId\n  );\n}\n\n/**\n * Get the token balance for a specific account and token.\n *\n * @param messenger - Controller messenger.\n * @param account - Address of the account.\n * @param chainId - Id of the chain.\n * @param tokenAddress - Address of the token contract.\n * @returns Raw token balance as a decimal string.\n */\nexport function getTokenBalance(\n  messenger: TransactionPayControllerMessenger,\n  account: Hex,\n  chainId: Hex,\n  tokenAddress: Hex,\n): string {\n  const assetsUnifyStateFeatureEnabled = getAssetsUnifyStateFeature(messenger);\n\n  let tokenBalances;\n  let accountsByChainId;\n  if (assetsUnifyStateFeatureEnabled) {\n    const assetsControllerState = messenger.call(\n      'AssetsController:getStateForTransactionPay',\n    );\n\n    tokenBalances = assetsControllerState?.tokenBalances;\n    accountsByChainId = assetsControllerState?.accountsByChainId;\n  } else {\n    tokenBalances = messenger.call(\n      'TokenBalancesController:getState',\n    )?.tokenBalances;\n    accountsByChainId = messenger.call(\n      'AccountTrackerController:getState',\n    )?.accountsByChainId;\n  }\n\n  const normalizedAccount = account.toLowerCase() as Hex;\n  const normalizedTokenAddress = toChecksumHexAddress(tokenAddress) as Hex;\n  const isNative = normalizedTokenAddress === getNativeToken(chainId);\n\n  const balanceHex =\n    tokenBalances?.[normalizedAccount]?.[chainId]?.[normalizedTokenAddress];\n\n  if (!isNative && balanceHex === undefined) {\n    return '0';\n  }\n\n  if (!isNative && balanceHex) {\n    return new BigNumber(balanceHex, 16).toString(10);\n  }\n\n  const chainAccounts = accountsByChainId?.[chainId];\n\n  const checksumAccount = toChecksumHexAddress(normalizedAccount) as Hex;\n  const nativeBalanceHex = chainAccounts?.[checksumAccount]?.balance as Hex;\n\n  return new BigNumber(nativeBalanceHex ?? '0x0', 16).toString(10);\n}\n\n/**\n * Get the token decimals for a specific token.\n *\n * @param messenger - Controller messenger.\n * @param tokenAddress - Address of the token contract.\n * @param chainId - Id of the chain.\n * @returns The token decimals or undefined if the token is not found.\n */\nexport function getTokenInfo(\n  messenger: TransactionPayControllerMessenger,\n  tokenAddress: Hex,\n  chainId: Hex,\n): { decimals: number; symbol: string } | undefined {\n  const assetsUnifyStateFeatureEnabled = getAssetsUnifyStateFeature(messenger);\n\n  let allTokens: TokensControllerState['allTokens'];\n  if (assetsUnifyStateFeatureEnabled) {\n    allTokens = messenger.call(\n      'AssetsController:getStateForTransactionPay',\n    )?.allTokens;\n  } else {\n    allTokens = messenger.call('TokensController:getState')?.allTokens;\n  }\n\n  const normalizedTokenAddress = tokenAddress.toLowerCase() as Hex;\n\n  const isNative =\n    normalizedTokenAddress === getNativeToken(chainId).toLowerCase();\n\n  const token = Object.values(allTokens?.[chainId] ?? {})\n    .flat()\n    .find(\n      (singleToken) =>\n        singleToken.address.toLowerCase() === normalizedTokenAddress,\n    );\n\n  if (!token && !isNative) {\n    return undefined;\n  }\n\n  if (token && !isNative) {\n    return { decimals: Number(token.decimals), symbol: token.symbol };\n  }\n\n  const ticker = getTicker(chainId, messenger);\n\n  if (!ticker) {\n    return undefined;\n  }\n\n  return { decimals: 18, symbol: ticker };\n}\n\n/**\n * Calculate fiat rates for a specific token.\n *\n * @param messenger - Controller messenger.\n * @param tokenAddress - Address of the token contract.\n * @param chainId - Id of the chain.\n * @returns An object containing the USD and fiat rates, or undefined if rates are not available.\n */\nexport function getTokenFiatRate(\n  messenger: TransactionPayControllerMessenger,\n  tokenAddress: Hex,\n  chainId: Hex,\n): FiatRates | undefined {\n  const assetsUnifyStateFeatureEnabled = getAssetsUnifyStateFeature(messenger);\n\n  let marketData;\n  let currencyRates;\n  if (assetsUnifyStateFeatureEnabled) {\n    const assetsControllerState = messenger.call(\n      'AssetsController:getStateForTransactionPay',\n    );\n\n    marketData = assetsControllerState?.marketData;\n    currencyRates = assetsControllerState?.currencyRates;\n  } else {\n    marketData = messenger.call('TokenRatesController:getState')?.marketData;\n    currencyRates = messenger.call(\n      'CurrencyRateController:getState',\n    )?.currencyRates;\n  }\n\n  const ticker = getTicker(chainId, messenger);\n\n  if (!ticker) {\n    return undefined;\n  }\n\n  const normalizedTokenAddress = toChecksumHexAddress(tokenAddress) as Hex;\n  const isNative = normalizedTokenAddress === getNativeToken(chainId);\n\n  const tokenToNativeRate =\n    marketData?.[chainId]?.[normalizedTokenAddress]?.price;\n\n  if (tokenToNativeRate === undefined && !isNative) {\n    return undefined;\n  }\n\n  const {\n    conversionRate: nativeToFiatRate,\n    usdConversionRate: nativeToUsdRate,\n  } = currencyRates?.[ticker] ?? {\n    conversionRate: null,\n    usdConversionRate: null,\n  };\n\n  if (nativeToFiatRate === null || nativeToUsdRate === null) {\n    return undefined;\n  }\n  const isStablecoin = STABLECOINS[chainId]?.includes(\n    tokenAddress.toLowerCase() as Hex,\n  );\n\n  const usdRate = isStablecoin\n    ? '1'\n    : new BigNumber(tokenToNativeRate ?? 1)\n        .multipliedBy(nativeToUsdRate)\n        .toString(10);\n\n  const fiatRate = new BigNumber(tokenToNativeRate ?? 1)\n    .multipliedBy(nativeToFiatRate)\n    .toString(10);\n\n  return { usdRate, fiatRate };\n}\n\n/**\n * Calculate the human-readable, raw, USD, and fiat representations of a token amount.\n *\n * @param rawInput - Raw token amount (decimal string, hex, or BigNumber).\n * @param decimals - Number of decimals for the token.\n * @param fiatRates - Fiat rates for the token.\n * @returns Object containing the amount in raw, human-readable, USD, and fiat formats.\n */\nexport function computeTokenAmounts(\n  rawInput: BigNumber.Value,\n  decimals: number,\n  fiatRates: FiatRates,\n): {\n  raw: string;\n  human: string;\n  usd: string;\n  fiat: string;\n} {\n  const rawValue = new BigNumber(rawInput);\n  const humanValue = rawValue.shiftedBy(-decimals);\n\n  return {\n    raw: rawValue.toFixed(0),\n    human: humanValue.toString(10),\n    usd: humanValue.multipliedBy(fiatRates.usdRate).toString(10),\n    fiat: humanValue.multipliedBy(fiatRates.fiatRate).toString(10),\n  };\n}\n\n/**\n * Compute a raw token amount from a fiat (USD) amount.\n * This is the inverse of `computeTokenAmounts` — it goes from USD to raw.\n *\n * @param fiatAmount - Amount in fiat/USD.\n * @param decimals - Token decimals.\n * @param usdRate - USD rate for the token (price per one unit of the token).\n * @returns Raw token amount string, or undefined if the conversion produces an invalid result.\n */\nexport function computeRawFromFiatAmount(\n  fiatAmount: BigNumber.Value,\n  decimals: number,\n  usdRate: BigNumber.Value,\n): string | undefined {\n  const rate = new BigNumber(usdRate);\n  if (!rate.isFinite() || !rate.gt(0)) {\n    return undefined;\n  }\n\n  const humanAmount = new BigNumber(fiatAmount).dividedBy(rate);\n  if (!humanAmount.isFinite() || !humanAmount.gt(0)) {\n    return undefined;\n  }\n\n  const raw = humanAmount\n    .shiftedBy(decimals)\n    .decimalPlaces(0, BigNumber.ROUND_DOWN)\n    .toFixed(0);\n\n  return new BigNumber(raw).gt(0) ? raw : undefined;\n}\n\n/**\n * Get the native token address for a given chain ID.\n *\n * @param chainId - Chain ID.\n * @returns - Native token address for the given chain ID.\n */\nexport function getNativeToken(chainId: Hex): Hex {\n  switch (chainId) {\n    case '0x89':\n      return '0x0000000000000000000000000000000000001010';\n    default:\n      return NATIVE_TOKEN_ADDRESS;\n  }\n}\n\n/**\n * Get the live on-chain token balance via an RPC `eth_call` to the ERC-20\n * `balanceOf` function, or `eth_getBalance` for native tokens.\n *\n * Unlike {@link getTokenBalance}, this bypasses the cached state in\n * `TokenBalancesController` and reads directly from the chain.\n *\n * @param messenger - Controller messenger.\n * @param account - Address of the account.\n * @param chainId - Chain ID.\n * @param tokenAddress - Address of the token contract.\n * @returns Raw token balance as a decimal string.\n */\nexport async function getLiveTokenBalance(\n  messenger: TransactionPayControllerMessenger,\n  account: Hex,\n  chainId: Hex,\n  tokenAddress: Hex,\n): Promise<string> {\n  const networkClientId = messenger.call(\n    'NetworkController:findNetworkClientIdByChainId',\n    chainId,\n  );\n\n  const { provider } = messenger.call(\n    'NetworkController:getNetworkClientById',\n    networkClientId,\n  );\n\n  const ethersProvider = new Web3Provider(provider);\n  const isNative =\n    tokenAddress.toLowerCase() === getNativeToken(chainId).toLowerCase();\n\n  // Use `pending` blockTag to bypass the RPC block-cache middleware so callers\n  // always observe the latest balance instead of a value pinned to the last\n  // polled block.\n  if (isNative) {\n    const balance = await ethersProvider.getBalance(account, 'pending');\n    return balance.toString();\n  }\n\n  const contract = new Contract(tokenAddress, abiERC20, ethersProvider);\n  const balance = await contract.balanceOf(account, { blockTag: 'pending' });\n  return balance.toString();\n}\n\n/**\n * Build a CAIP-19 asset type identifier for an EVM token.\n *\n * For native tokens the SLIP-44 coin type is resolved automatically from\n * a built-in chain→coin-type map, falling back to 60 (ETH).  Callers can\n * override via the optional third parameter.\n *\n * @param chainId - Hex chain ID (e.g. `0x1`).\n * @param tokenAddress - Token contract address, or the native token address.\n * @param slip44CoinType - Optional SLIP-44 coin type override for native tokens.\n * @returns CAIP-19 asset type string.\n */\nexport function buildCaipAssetType(\n  chainId: Hex,\n  tokenAddress: Hex,\n  slip44CoinType?: number,\n): CaipAssetType {\n  const chainReference = String(hexToBigInt(chainId));\n  const isNative =\n    tokenAddress.toLowerCase() === getNativeToken(chainId).toLowerCase();\n\n  if (isNative) {\n    const coinType = slip44CoinType ?? SLIP44_COIN_TYPE_BY_CHAIN[chainId] ?? 60;\n\n    return toCaipAssetType(\n      'eip155',\n      chainReference,\n      'slip44',\n      String(coinType),\n    );\n  }\n\n  return toCaipAssetType('eip155', chainReference, 'erc20', tokenAddress);\n}\n\nfunction getTicker(\n  chainId: Hex,\n  messenger: TransactionPayControllerMessenger,\n): string | undefined {\n  try {\n    const networkClientId = messenger.call(\n      'NetworkController:findNetworkClientIdByChainId',\n      chainId,\n    );\n\n    const networkConfiguration = messenger.call(\n      'NetworkController:getNetworkClientById',\n      networkClientId,\n    );\n\n    return networkConfiguration.configuration.ticker;\n  } catch {\n    return undefined;\n  }\n}\n\nexport enum TokenAddressTarget {\n  Relay = 'relay',\n  MetaMask = 'metamask',\n}\n\n/**\n * Normalize token address formats between MetaMask and Relay for Polygon native\n * token handling.\n *\n * MetaMask uses Polygon's native token contract-like address (`0x...1010`),\n * while Relay expects the zero address for native tokens.\n *\n * @param tokenAddress - Token address to normalize.\n * @param chainId - Chain ID for the token.\n * @param target - Optional target system format.\n * @returns Normalized token address for the target system, or the original\n * address if no target is provided.\n */\nexport function normalizeTokenAddress(\n  tokenAddress: Hex,\n  chainId: Hex,\n  target?: TokenAddressTarget,\n): Hex {\n  if (chainId !== CHAIN_ID_POLYGON) {\n    return tokenAddress;\n  }\n\n  const nativeTokenAddress = getNativeToken(chainId).toLowerCase() as Hex;\n  const normalizedTokenAddress = tokenAddress.toLowerCase();\n\n  if (\n    target === TokenAddressTarget.Relay &&\n    normalizedTokenAddress === nativeTokenAddress\n  ) {\n    return NATIVE_TOKEN_ADDRESS;\n  }\n\n  if (\n    target === TokenAddressTarget.MetaMask &&\n    normalizedTokenAddress === NATIVE_TOKEN_ADDRESS.toLowerCase()\n  ) {\n    return nativeTokenAddress;\n  }\n\n  return tokenAddress;\n}\n"]}

package/dist/utils/transaction.cjs

@@ -1,12 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isPredictWithdrawTransaction = exports.collectTransactionIds = exports.updateTransaction = exports.waitForTransactionConfirmed = exports.subscribeAssetChanges = exports.subscribeTransactionChanges = exports.getTransaction = exports.FINALIZED_STATUSES = void 0;
+exports.getTransferredAmountFromTxHash = exports.isPredictWithdrawTransaction = exports.collectTransactionIds = exports.updateTransaction = exports.waitForTransactionConfirmed = exports.subscribeAssetChanges = exports.subscribeTransactionChanges = exports.getTransaction = exports.FINALIZED_STATUSES = void 0;
+const abi_1 = require("@ethersproject/abi");
+const providers_1 = require("@ethersproject/providers");
+const metamask_eth_abis_1 = require("@metamask/metamask-eth-abis");
 const transaction_controller_1 = require("@metamask/transaction-controller");
 const utils_1 = require("@metamask/utils");
+const bignumber_js_1 = require("bignumber.js");
 const lodash_1 = require("lodash");
 const logger_1 = require("../logger.cjs");
 const feature_flags_1 = require("./feature-flags.cjs");
 const required_tokens_1 = require("./required-tokens.cjs");
+const token_1 = require("./token.cjs");
 const log = (0, utils_1.createModuleLogger)(logger_1.projectLogger, 'transaction');
 exports.FINALIZED_STATUSES = [
     transaction_controller_1.TransactionStatus.confirmed,
@@ -202,4 +207,135 @@ function onTransactionFinalized(transaction, removeTransactionData) {
     log('Transaction finalized', { transaction });
     removeTransactionData(transaction.id);
 }
+const erc20Interface = new abi_1.Interface(metamask_eth_abis_1.abiERC20);
+const ERC20_TRANSFER_EVENT_TOPIC = erc20Interface.getEventTopic('Transfer');
+/**
+ * Reads the transferred token amount from a completed on-chain transaction.
+ *
+ * For native tokens the amount is resolved via `debug_traceTransaction`
+ * (internal-call aware), falling back to the top-level `tx.value`.
+ * For ERC-20 tokens the amount is decoded from `Transfer` event logs
+ * in the transaction receipt.
+ *
+ * @param options - The options.
+ * @param options.messenger - Controller messenger for network access.
+ * @param options.txHash - Transaction hash of the completed on-chain transaction.
+ * @param options.chainId - Chain ID where the transaction was executed.
+ * @param options.tokenAddress - Address of the transferred token.
+ * @param options.walletAddress - Recipient wallet address to filter transfers to.
+ * @returns The raw (atomic) transferred amount as a decimal string,
+ * or `undefined` if the amount cannot be determined.
+ */
+async function getTransferredAmountFromTxHash({ messenger, txHash, chainId, tokenAddress, walletAddress, }) {
+    const provider = getEthersProvider(messenger, chainId);
+    const isNative = tokenAddress.toLowerCase() === (0, token_1.getNativeToken)(chainId).toLowerCase();
+    if (isNative) {
+        return await getNativeTransferAmount(provider, txHash, walletAddress);
+    }
+    return await getErc20TransferAmount(provider, txHash, tokenAddress, walletAddress);
+}
+exports.getTransferredAmountFromTxHash = getTransferredAmountFromTxHash;
+/**
+ * Resolves the native token amount received by a wallet from a transaction.
+ *
+ * 1. Attempts `debug_traceTransaction` with `callTracer` to walk internal
+ *    calls and sum all native value transfers targeting `walletAddress`.
+ * 2. Falls back to the top-level `tx.value` when the wallet is the direct
+ *    recipient and the trace RPC is unavailable or errors.
+ *
+ * @param provider - Ethers Web3Provider.
+ * @param txHash - Transaction hash.
+ * @param walletAddress - Recipient wallet address.
+ * @returns Raw amount as a decimal string, or `undefined`.
+ */
+async function getNativeTransferAmount(provider, txHash, walletAddress) {
+    try {
+        const trace = await provider.send('debug_traceTransaction', [
+            txHash,
+            { tracer: 'callTracer' },
+        ]);
+        const amount = sumNativeValueFromTrace(trace, walletAddress);
+        if (amount.gt(0)) {
+            return amount.toFixed(0);
+        }
+    }
+    catch {
+        // debug_traceTransaction not supported — fall through to tx.value
+    }
+    const tx = await provider.getTransaction(txHash);
+    if (!tx) {
+        return undefined;
+    }
+    if (tx.to?.toLowerCase() !== walletAddress.toLowerCase()) {
+        return undefined;
+    }
+    return positiveOrUndefined(tx.value.toString());
+}
+/**
+ * Resolves the ERC-20 token amount received by a wallet from a transaction
+ * by decoding `Transfer` event logs from the transaction receipt.
+ *
+ * @param provider - Ethers Web3Provider.
+ * @param txHash - Transaction hash.
+ * @param tokenAddress - ERC-20 token contract address.
+ * @param walletAddress - Recipient wallet address.
+ * @returns Raw amount as a decimal string, or `undefined`.
+ */
+async function getErc20TransferAmount(provider, txHash, tokenAddress, walletAddress) {
+    const receipt = await provider.getTransactionReceipt(txHash);
+    if (!receipt) {
+        return undefined;
+    }
+    let total = new bignumber_js_1.BigNumber(0);
+    for (const txLog of receipt.logs) {
+        if (txLog.address.toLowerCase() !== tokenAddress.toLowerCase()) {
+            continue;
+        }
+        if (!txLog.topics[0] || txLog.topics[0] !== ERC20_TRANSFER_EVENT_TOPIC) {
+            continue;
+        }
+        try {
+            const parsed = erc20Interface.parseLog(txLog);
+            const to = parsed.args[1].toLowerCase();
+            if (to !== walletAddress.toLowerCase()) {
+                continue;
+            }
+            total = total.plus(parsed.args[2].toString());
+        }
+        catch {
+            continue;
+        }
+    }
+    return positiveOrUndefined(total.toFixed(0));
+}
+/**
+ * Recursively walks a `callTracer` result and sums native value
+ * transferred to a specific address.
+ *
+ * @param trace - Call trace node.
+ * @param walletAddress - Target address to accumulate value for.
+ * @returns Accumulated native value as BigNumber.
+ */
+function sumNativeValueFromTrace(trace, walletAddress) {
+    let total = new bignumber_js_1.BigNumber(0);
+    if (trace.to?.toLowerCase() === walletAddress.toLowerCase() &&
+        trace.value &&
+        trace.value !== '0x0') {
+        total = total.plus(new bignumber_js_1.BigNumber(trace.value));
+    }
+    if (trace.calls) {
+        for (const child of trace.calls) {
+            total = total.plus(sumNativeValueFromTrace(child, walletAddress));
+        }
+    }
+    return total;
+}
+function getEthersProvider(messenger, chainId) {
+    const networkClientId = messenger.call('NetworkController:findNetworkClientIdByChainId', chainId);
+    const { provider } = messenger.call('NetworkController:getNetworkClientById', networkClientId);
+    return new providers_1.Web3Provider(provider);
+}
+function positiveOrUndefined(amount) {
+    return new bignumber_js_1.BigNumber(amount).gt(0) ? amount : undefined;
+}
 //# sourceMappingURL=transaction.cjs.map

package/dist/utils/transaction.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.cjs","sourceRoot":"","sources":["../../src/utils/transaction.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  TransactionStatus,\n  TransactionType,\n} from '@metamask/transaction-controller';\nimport type { TransactionMeta } from '@metamask/transaction-controller';\nimport type { Hex } from '@metamask/utils';\nimport { createModuleLogger } from '@metamask/utils';\nimport type { Patch } from 'immer';\nimport { cloneDeep } from 'lodash';\n\nimport { projectLogger } from '../logger';\nimport type {\n  TransactionPayControllerMessenger,\n  TransactionPayControllerState,\n  UpdateTransactionDataCallback,\n} from '../types';\nimport { getAssetsUnifyStateFeature } from './feature-flags';\nimport { parseRequiredTokens } from './required-tokens';\n\nconst log = createModuleLogger(projectLogger, 'transaction');\n\nexport const FINALIZED_STATUSES = [\n  TransactionStatus.confirmed,\n  TransactionStatus.dropped,\n  TransactionStatus.failed,\n];\n\n/**\n * Retrieve transaction metadata by ID.\n *\n * @param transactionId - ID of the transaction to retrieve.\n * @param messenger - Controller messenger.\n * @returns The transaction metadata or undefined if not found.\n */\nexport function getTransaction(\n  transactionId: string,\n  messenger: TransactionPayControllerMessenger,\n): TransactionMeta | undefined {\n  const transactionControllerState = messenger.call(\n    'TransactionController:getState',\n  );\n\n  return transactionControllerState.transactions.find(\n    (tx) => tx.id === transactionId,\n  );\n}\n\n/**\n * Subscribe to transaction changes and update the transaction data accordingly.\n *\n * @param messenger - Controller messenger.\n * @param updateTransactionData - Callback to update transaction data.\n * @param removeTransactionData - Callback to remove transaction data.\n */\nexport function subscribeTransactionChanges(\n  messenger: TransactionPayControllerMessenger,\n  updateTransactionData: UpdateTransactionDataCallback,\n  removeTransactionData: (transactionId: string) => void,\n): void {\n  messenger.subscribe(\n    'TransactionController:stateChange',\n    (\n      transactions: TransactionMeta[],\n      previousTransactions: TransactionMeta[] | undefined,\n    ) => {\n      const newTransactions = transactions.filter(\n        (tx) => !previousTransactions?.find((prevTx) => prevTx.id === tx.id),\n      );\n\n      const updatedTransactions = transactions.filter((tx) => {\n        const previousTransaction = previousTransactions?.find(\n          (prevTx) => prevTx.id === tx.id,\n        );\n\n        return (\n          previousTransaction &&\n          previousTransaction?.txParams.data !== tx.txParams.data\n        );\n      });\n\n      const finalizedTransactions = transactions.filter((tx) => {\n        const previousTransaction = previousTransactions?.find(\n          (prevTx) => prevTx.id === tx.id,\n        );\n\n        return (\n          previousTransaction &&\n          !FINALIZED_STATUSES.includes(previousTransaction.status) &&\n          FINALIZED_STATUSES.includes(tx.status)\n        );\n      });\n\n      const deletedTransactions = (previousTransactions ?? []).filter(\n        (prevTx) => !transactions.find((tx) => tx.id === prevTx.id),\n      );\n\n      [...finalizedTransactions, ...deletedTransactions].forEach((tx) =>\n        onTransactionFinalized(tx, removeTransactionData),\n      );\n\n      [...newTransactions, ...updatedTransactions].forEach((tx) =>\n        onTransactionChange(tx, messenger, updateTransactionData),\n      );\n    },\n    (state) => state.transactions,\n  );\n}\n\n/**\n * Subscribe to asset state changes and re-parse required tokens for\n * in-flight transactions whose tokens have not yet resolved.\n *\n * @param messenger - Controller messenger.\n * @param getControllerState - Callback returning the current controller state.\n * @param updateTransactionData - Callback to update transaction data.\n */\nexport function subscribeAssetChanges(\n  messenger: TransactionPayControllerMessenger,\n  getControllerState: () => TransactionPayControllerState,\n  updateTransactionData: UpdateTransactionDataCallback,\n): void {\n  const buildHandler =\n    (source: string) =>\n    (_state: unknown, patches: Patch[] | undefined): void => {\n      const { transactionData } = getControllerState();\n\n      for (const [transactionId, data] of Object.entries(transactionData)) {\n        if (data.tokens.length > 0) {\n          continue;\n        }\n\n        const transaction = getTransaction(transactionId, messenger);\n\n        if (!transaction || FINALIZED_STATUSES.includes(transaction.status)) {\n          continue;\n        }\n\n        log('Asset data changed', { transactionId, source, patches });\n\n        onTransactionChange(transaction, messenger, updateTransactionData);\n      }\n    };\n\n  if (getAssetsUnifyStateFeature(messenger)) {\n    messenger.subscribe(\n      'AssetsController:stateChange',\n      buildHandler('AssetsController'),\n    );\n    return;\n  }\n\n  messenger.subscribe(\n    'TokensController:stateChange',\n    buildHandler('TokensController'),\n  );\n  messenger.subscribe(\n    'TokenRatesController:stateChange',\n    buildHandler('TokenRatesController'),\n  );\n  messenger.subscribe(\n    'CurrencyRateController:stateChange',\n    buildHandler('CurrencyRateController'),\n  );\n}\n\n/**\n * Wait for a transaction to be confirmed or fail.\n *\n * @param transactionId - ID of the transaction to wait for.\n * @param messenger - Controller messenger.\n * @returns A promise that resolves when the transaction is confirmed or rejects if it fails.\n */\nexport function waitForTransactionConfirmed(\n  transactionId: string,\n  messenger: TransactionPayControllerMessenger,\n): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    const isConfirmed = (tx?: TransactionMeta, fn?: () => void): boolean => {\n      log('Checking transaction status', tx?.status, tx?.type);\n\n      if (tx?.status === TransactionStatus.confirmed) {\n        fn?.();\n        resolve();\n        return true;\n      }\n\n      if (\n        [TransactionStatus.dropped, TransactionStatus.failed].includes(\n          tx?.status as TransactionStatus,\n        )\n      ) {\n        fn?.();\n        reject(\n          new Error(`Transaction failed - ${tx?.type} - ${tx?.error?.message}`),\n        );\n        return true;\n      }\n\n      return false;\n    };\n\n    const initialState = messenger.call('TransactionController:getState');\n\n    const initialTx = initialState.transactions.find(\n      (singleTransaction) => singleTransaction.id === transactionId,\n    );\n\n    if (isConfirmed(initialTx)) {\n      return;\n    }\n\n    const handler = (tx?: TransactionMeta): void => {\n      const unsubscribe = (): void =>\n        messenger.unsubscribe('TransactionController:stateChange', handler);\n\n      isConfirmed(tx, unsubscribe);\n    };\n\n    messenger.subscribe('TransactionController:stateChange', handler, (state) =>\n      state.transactions.find((tx) => tx.id === transactionId),\n    );\n  });\n}\n\n/**\n * Update a transaction by applying a function to its draft.\n *\n * @param request - Request object.\n * @param request.transactionId - ID of the transaction to update.\n * @param request.messenger - Controller messenger.\n * @param request.note - Note describing the update.\n * @param fn - Function that applies updates to the transaction draft.\n */\nexport function updateTransaction(\n  {\n    transactionId,\n    messenger,\n    note,\n  }: {\n    transactionId: string;\n    messenger: TransactionPayControllerMessenger;\n    note: string;\n  },\n  fn: (draft: TransactionMeta) => void,\n): void {\n  const transaction = getTransaction(transactionId, messenger as never);\n\n  if (!transaction) {\n    throw new Error(`Transaction not found: ${transactionId}`);\n  }\n\n  const newTransaction = cloneDeep(transaction);\n\n  fn(newTransaction);\n\n  messenger.call(\n    'TransactionController:updateTransaction',\n    newTransaction,\n    note,\n  );\n}\n\n/**\n * Collect all new transactions until `end` is called.\n *\n * @param chainId - The chain ID to filter transactions by.\n * @param from - The address to filter transactions by.\n * @param messenger - The controller messenger.\n * @param onTransaction - Callback called with each matching transaction ID.\n * @returns An object with an `end` method to stop collecting transactions.\n */\nexport function collectTransactionIds(\n  chainId: Hex,\n  from: Hex,\n  messenger: TransactionPayControllerMessenger,\n  onTransaction: (transactionId: string) => void,\n): { end: () => void } {\n  const listener = (tx: TransactionMeta): void => {\n    if (\n      tx.chainId !== chainId ||\n      tx.txParams.from.toLowerCase() !== from.toLowerCase()\n    ) {\n      return;\n    }\n\n    onTransaction(tx.id);\n  };\n\n  messenger.subscribe(\n    'TransactionController:unapprovedTransactionAdded',\n    listener,\n  );\n\n  const end = (): void => {\n    messenger.unsubscribe(\n      'TransactionController:unapprovedTransactionAdded',\n      listener,\n    );\n  };\n\n  return { end };\n}\n\n/**\n * Check whether a transaction is a Predict withdrawal.\n *\n * Returns `true` when the transaction's own type is `predictWithdraw`, or\n * when any of its nested transactions has that type.\n *\n * @param transaction - Transaction metadata.\n * @returns `true` when the transaction is a Predict withdrawal.\n */\nexport function isPredictWithdrawTransaction(\n  transaction: TransactionMeta,\n): boolean {\n  return (\n    transaction.type === TransactionType.predictWithdraw ||\n    (transaction.nestedTransactions?.some(\n      (nt) => nt.type === TransactionType.predictWithdraw,\n    ) ??\n      false)\n  );\n}\n\n/**\n * Handle a transaction change by updating its associated data.\n *\n * @param transaction - Transaction metadata.\n * @param messenger - Controller messenger.\n * @param updateTransactionData - Callback to update transaction data.\n */\nfunction onTransactionChange(\n  transaction: TransactionMeta,\n  messenger: TransactionPayControllerMessenger,\n  updateTransactionData: UpdateTransactionDataCallback,\n): void {\n  const tokens = parseRequiredTokens(transaction, messenger);\n\n  log('Transaction changed', { transaction, tokens });\n\n  updateTransactionData(transaction.id, (data) => {\n    data.tokens = tokens;\n  });\n}\n\n/**\n * Handle a finalized transaction by removing its associated data.\n *\n * @param transaction - Transaction metadata.\n * @param removeTransactionData - Callback to remove transaction data.\n */\nfunction onTransactionFinalized(\n  transaction: TransactionMeta,\n  removeTransactionData: (transactionId: string) => void,\n): void {\n  log('Transaction finalized', { transaction });\n  removeTransactionData(transaction.id);\n}\n"]}
+{"version":3,"file":"transaction.cjs","sourceRoot":"","sources":["../../src/utils/transaction.ts"],"names":[],"mappings":"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","sourcesContent":["import { Interface } from '@ethersproject/abi';\nimport { Web3Provider } from '@ethersproject/providers';\nimport { abiERC20 } from '@metamask/metamask-eth-abis';\nimport {\n  TransactionStatus,\n  TransactionType,\n} from '@metamask/transaction-controller';\nimport type { TransactionMeta } from '@metamask/transaction-controller';\nimport type { Hex } from '@metamask/utils';\nimport { createModuleLogger } from '@metamask/utils';\nimport { BigNumber } from 'bignumber.js';\nimport type { Patch } from 'immer';\nimport { cloneDeep } from 'lodash';\n\nimport { projectLogger } from '../logger';\nimport type {\n  TransactionPayControllerMessenger,\n  TransactionPayControllerState,\n  UpdateTransactionDataCallback,\n} from '../types';\nimport { getAssetsUnifyStateFeature } from './feature-flags';\nimport { parseRequiredTokens } from './required-tokens';\nimport { getNativeToken } from './token';\n\nconst log = createModuleLogger(projectLogger, 'transaction');\n\nexport const FINALIZED_STATUSES = [\n  TransactionStatus.confirmed,\n  TransactionStatus.dropped,\n  TransactionStatus.failed,\n];\n\n/**\n * Retrieve transaction metadata by ID.\n *\n * @param transactionId - ID of the transaction to retrieve.\n * @param messenger - Controller messenger.\n * @returns The transaction metadata or undefined if not found.\n */\nexport function getTransaction(\n  transactionId: string,\n  messenger: TransactionPayControllerMessenger,\n): TransactionMeta | undefined {\n  const transactionControllerState = messenger.call(\n    'TransactionController:getState',\n  );\n\n  return transactionControllerState.transactions.find(\n    (tx) => tx.id === transactionId,\n  );\n}\n\n/**\n * Subscribe to transaction changes and update the transaction data accordingly.\n *\n * @param messenger - Controller messenger.\n * @param updateTransactionData - Callback to update transaction data.\n * @param removeTransactionData - Callback to remove transaction data.\n */\nexport function subscribeTransactionChanges(\n  messenger: TransactionPayControllerMessenger,\n  updateTransactionData: UpdateTransactionDataCallback,\n  removeTransactionData: (transactionId: string) => void,\n): void {\n  messenger.subscribe(\n    'TransactionController:stateChange',\n    (\n      transactions: TransactionMeta[],\n      previousTransactions: TransactionMeta[] | undefined,\n    ) => {\n      const newTransactions = transactions.filter(\n        (tx) => !previousTransactions?.find((prevTx) => prevTx.id === tx.id),\n      );\n\n      const updatedTransactions = transactions.filter((tx) => {\n        const previousTransaction = previousTransactions?.find(\n          (prevTx) => prevTx.id === tx.id,\n        );\n\n        return (\n          previousTransaction &&\n          previousTransaction?.txParams.data !== tx.txParams.data\n        );\n      });\n\n      const finalizedTransactions = transactions.filter((tx) => {\n        const previousTransaction = previousTransactions?.find(\n          (prevTx) => prevTx.id === tx.id,\n        );\n\n        return (\n          previousTransaction &&\n          !FINALIZED_STATUSES.includes(previousTransaction.status) &&\n          FINALIZED_STATUSES.includes(tx.status)\n        );\n      });\n\n      const deletedTransactions = (previousTransactions ?? []).filter(\n        (prevTx) => !transactions.find((tx) => tx.id === prevTx.id),\n      );\n\n      [...finalizedTransactions, ...deletedTransactions].forEach((tx) =>\n        onTransactionFinalized(tx, removeTransactionData),\n      );\n\n      [...newTransactions, ...updatedTransactions].forEach((tx) =>\n        onTransactionChange(tx, messenger, updateTransactionData),\n      );\n    },\n    (state) => state.transactions,\n  );\n}\n\n/**\n * Subscribe to asset state changes and re-parse required tokens for\n * in-flight transactions whose tokens have not yet resolved.\n *\n * @param messenger - Controller messenger.\n * @param getControllerState - Callback returning the current controller state.\n * @param updateTransactionData - Callback to update transaction data.\n */\nexport function subscribeAssetChanges(\n  messenger: TransactionPayControllerMessenger,\n  getControllerState: () => TransactionPayControllerState,\n  updateTransactionData: UpdateTransactionDataCallback,\n): void {\n  const buildHandler =\n    (source: string) =>\n    (_state: unknown, patches: Patch[] | undefined): void => {\n      const { transactionData } = getControllerState();\n\n      for (const [transactionId, data] of Object.entries(transactionData)) {\n        if (data.tokens.length > 0) {\n          continue;\n        }\n\n        const transaction = getTransaction(transactionId, messenger);\n\n        if (!transaction || FINALIZED_STATUSES.includes(transaction.status)) {\n          continue;\n        }\n\n        log('Asset data changed', { transactionId, source, patches });\n\n        onTransactionChange(transaction, messenger, updateTransactionData);\n      }\n    };\n\n  if (getAssetsUnifyStateFeature(messenger)) {\n    messenger.subscribe(\n      'AssetsController:stateChange',\n      buildHandler('AssetsController'),\n    );\n    return;\n  }\n\n  messenger.subscribe(\n    'TokensController:stateChange',\n    buildHandler('TokensController'),\n  );\n  messenger.subscribe(\n    'TokenRatesController:stateChange',\n    buildHandler('TokenRatesController'),\n  );\n  messenger.subscribe(\n    'CurrencyRateController:stateChange',\n    buildHandler('CurrencyRateController'),\n  );\n}\n\n/**\n * Wait for a transaction to be confirmed or fail.\n *\n * @param transactionId - ID of the transaction to wait for.\n * @param messenger - Controller messenger.\n * @returns A promise that resolves when the transaction is confirmed or rejects if it fails.\n */\nexport function waitForTransactionConfirmed(\n  transactionId: string,\n  messenger: TransactionPayControllerMessenger,\n): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    const isConfirmed = (tx?: TransactionMeta, fn?: () => void): boolean => {\n      log('Checking transaction status', tx?.status, tx?.type);\n\n      if (tx?.status === TransactionStatus.confirmed) {\n        fn?.();\n        resolve();\n        return true;\n      }\n\n      if (\n        [TransactionStatus.dropped, TransactionStatus.failed].includes(\n          tx?.status as TransactionStatus,\n        )\n      ) {\n        fn?.();\n        reject(\n          new Error(`Transaction failed - ${tx?.type} - ${tx?.error?.message}`),\n        );\n        return true;\n      }\n\n      return false;\n    };\n\n    const initialState = messenger.call('TransactionController:getState');\n\n    const initialTx = initialState.transactions.find(\n      (singleTransaction) => singleTransaction.id === transactionId,\n    );\n\n    if (isConfirmed(initialTx)) {\n      return;\n    }\n\n    const handler = (tx?: TransactionMeta): void => {\n      const unsubscribe = (): void =>\n        messenger.unsubscribe('TransactionController:stateChange', handler);\n\n      isConfirmed(tx, unsubscribe);\n    };\n\n    messenger.subscribe('TransactionController:stateChange', handler, (state) =>\n      state.transactions.find((tx) => tx.id === transactionId),\n    );\n  });\n}\n\n/**\n * Update a transaction by applying a function to its draft.\n *\n * @param request - Request object.\n * @param request.transactionId - ID of the transaction to update.\n * @param request.messenger - Controller messenger.\n * @param request.note - Note describing the update.\n * @param fn - Function that applies updates to the transaction draft.\n */\nexport function updateTransaction(\n  {\n    transactionId,\n    messenger,\n    note,\n  }: {\n    transactionId: string;\n    messenger: TransactionPayControllerMessenger;\n    note: string;\n  },\n  fn: (draft: TransactionMeta) => void,\n): void {\n  const transaction = getTransaction(transactionId, messenger as never);\n\n  if (!transaction) {\n    throw new Error(`Transaction not found: ${transactionId}`);\n  }\n\n  const newTransaction = cloneDeep(transaction);\n\n  fn(newTransaction);\n\n  messenger.call(\n    'TransactionController:updateTransaction',\n    newTransaction,\n    note,\n  );\n}\n\n/**\n * Collect all new transactions until `end` is called.\n *\n * @param chainId - The chain ID to filter transactions by.\n * @param from - The address to filter transactions by.\n * @param messenger - The controller messenger.\n * @param onTransaction - Callback called with each matching transaction ID.\n * @returns An object with an `end` method to stop collecting transactions.\n */\nexport function collectTransactionIds(\n  chainId: Hex,\n  from: Hex,\n  messenger: TransactionPayControllerMessenger,\n  onTransaction: (transactionId: string) => void,\n): { end: () => void } {\n  const listener = (tx: TransactionMeta): void => {\n    if (\n      tx.chainId !== chainId ||\n      tx.txParams.from.toLowerCase() !== from.toLowerCase()\n    ) {\n      return;\n    }\n\n    onTransaction(tx.id);\n  };\n\n  messenger.subscribe(\n    'TransactionController:unapprovedTransactionAdded',\n    listener,\n  );\n\n  const end = (): void => {\n    messenger.unsubscribe(\n      'TransactionController:unapprovedTransactionAdded',\n      listener,\n    );\n  };\n\n  return { end };\n}\n\n/**\n * Check whether a transaction is a Predict withdrawal.\n *\n * Returns `true` when the transaction's own type is `predictWithdraw`, or\n * when any of its nested transactions has that type.\n *\n * @param transaction - Transaction metadata.\n * @returns `true` when the transaction is a Predict withdrawal.\n */\nexport function isPredictWithdrawTransaction(\n  transaction: TransactionMeta,\n): boolean {\n  return (\n    transaction.type === TransactionType.predictWithdraw ||\n    (transaction.nestedTransactions?.some(\n      (nt) => nt.type === TransactionType.predictWithdraw,\n    ) ??\n      false)\n  );\n}\n\n/**\n * Handle a transaction change by updating its associated data.\n *\n * @param transaction - Transaction metadata.\n * @param messenger - Controller messenger.\n * @param updateTransactionData - Callback to update transaction data.\n */\nfunction onTransactionChange(\n  transaction: TransactionMeta,\n  messenger: TransactionPayControllerMessenger,\n  updateTransactionData: UpdateTransactionDataCallback,\n): void {\n  const tokens = parseRequiredTokens(transaction, messenger);\n\n  log('Transaction changed', { transaction, tokens });\n\n  updateTransactionData(transaction.id, (data) => {\n    data.tokens = tokens;\n  });\n}\n\n/**\n * Handle a finalized transaction by removing its associated data.\n *\n * @param transaction - Transaction metadata.\n * @param removeTransactionData - Callback to remove transaction data.\n */\nfunction onTransactionFinalized(\n  transaction: TransactionMeta,\n  removeTransactionData: (transactionId: string) => void,\n): void {\n  log('Transaction finalized', { transaction });\n  removeTransactionData(transaction.id);\n}\n\nconst erc20Interface = new Interface(abiERC20);\n\nconst ERC20_TRANSFER_EVENT_TOPIC = erc20Interface.getEventTopic('Transfer');\n\n/**\n * Reads the transferred token amount from a completed on-chain transaction.\n *\n * For native tokens the amount is resolved via `debug_traceTransaction`\n * (internal-call aware), falling back to the top-level `tx.value`.\n * For ERC-20 tokens the amount is decoded from `Transfer` event logs\n * in the transaction receipt.\n *\n * @param options - The options.\n * @param options.messenger - Controller messenger for network access.\n * @param options.txHash - Transaction hash of the completed on-chain transaction.\n * @param options.chainId - Chain ID where the transaction was executed.\n * @param options.tokenAddress - Address of the transferred token.\n * @param options.walletAddress - Recipient wallet address to filter transfers to.\n * @returns The raw (atomic) transferred amount as a decimal string,\n * or `undefined` if the amount cannot be determined.\n */\nexport async function getTransferredAmountFromTxHash({\n  messenger,\n  txHash,\n  chainId,\n  tokenAddress,\n  walletAddress,\n}: {\n  messenger: TransactionPayControllerMessenger;\n  txHash: string;\n  chainId: Hex;\n  tokenAddress: Hex;\n  walletAddress: Hex;\n}): Promise<string | undefined> {\n  const provider = getEthersProvider(messenger, chainId);\n\n  const isNative =\n    tokenAddress.toLowerCase() === getNativeToken(chainId).toLowerCase();\n\n  if (isNative) {\n    return await getNativeTransferAmount(provider, txHash, walletAddress);\n  }\n\n  return await getErc20TransferAmount(\n    provider,\n    txHash,\n    tokenAddress,\n    walletAddress,\n  );\n}\n\n/**\n * Resolves the native token amount received by a wallet from a transaction.\n *\n * 1. Attempts `debug_traceTransaction` with `callTracer` to walk internal\n *    calls and sum all native value transfers targeting `walletAddress`.\n * 2. Falls back to the top-level `tx.value` when the wallet is the direct\n *    recipient and the trace RPC is unavailable or errors.\n *\n * @param provider - Ethers Web3Provider.\n * @param txHash - Transaction hash.\n * @param walletAddress - Recipient wallet address.\n * @returns Raw amount as a decimal string, or `undefined`.\n */\nasync function getNativeTransferAmount(\n  provider: Web3Provider,\n  txHash: string,\n  walletAddress: Hex,\n): Promise<string | undefined> {\n  try {\n    const trace = await provider.send('debug_traceTransaction', [\n      txHash,\n      { tracer: 'callTracer' },\n    ]);\n\n    const amount = sumNativeValueFromTrace(trace, walletAddress);\n    if (amount.gt(0)) {\n      return amount.toFixed(0);\n    }\n  } catch {\n    // debug_traceTransaction not supported — fall through to tx.value\n  }\n\n  const tx = await provider.getTransaction(txHash);\n  if (!tx) {\n    return undefined;\n  }\n\n  if (tx.to?.toLowerCase() !== walletAddress.toLowerCase()) {\n    return undefined;\n  }\n\n  return positiveOrUndefined(tx.value.toString());\n}\n\n/**\n * Resolves the ERC-20 token amount received by a wallet from a transaction\n * by decoding `Transfer` event logs from the transaction receipt.\n *\n * @param provider - Ethers Web3Provider.\n * @param txHash - Transaction hash.\n * @param tokenAddress - ERC-20 token contract address.\n * @param walletAddress - Recipient wallet address.\n * @returns Raw amount as a decimal string, or `undefined`.\n */\nasync function getErc20TransferAmount(\n  provider: Web3Provider,\n  txHash: string,\n  tokenAddress: Hex,\n  walletAddress: Hex,\n): Promise<string | undefined> {\n  const receipt = await provider.getTransactionReceipt(txHash);\n\n  if (!receipt) {\n    return undefined;\n  }\n\n  let total = new BigNumber(0);\n\n  for (const txLog of receipt.logs) {\n    if (txLog.address.toLowerCase() !== tokenAddress.toLowerCase()) {\n      continue;\n    }\n\n    if (!txLog.topics[0] || txLog.topics[0] !== ERC20_TRANSFER_EVENT_TOPIC) {\n      continue;\n    }\n\n    try {\n      const parsed = erc20Interface.parseLog(txLog);\n      const to = (parsed.args[1] as string).toLowerCase();\n\n      if (to !== walletAddress.toLowerCase()) {\n        continue;\n      }\n\n      total = total.plus(parsed.args[2].toString());\n    } catch {\n      continue;\n    }\n  }\n\n  return positiveOrUndefined(total.toFixed(0));\n}\n\ntype CallTrace = {\n  to?: string;\n  value?: string;\n  calls?: CallTrace[];\n};\n\n/**\n * Recursively walks a `callTracer` result and sums native value\n * transferred to a specific address.\n *\n * @param trace - Call trace node.\n * @param walletAddress - Target address to accumulate value for.\n * @returns Accumulated native value as BigNumber.\n */\nfunction sumNativeValueFromTrace(\n  trace: CallTrace,\n  walletAddress: Hex,\n): BigNumber {\n  let total = new BigNumber(0);\n\n  if (\n    trace.to?.toLowerCase() === walletAddress.toLowerCase() &&\n    trace.value &&\n    trace.value !== '0x0'\n  ) {\n    total = total.plus(new BigNumber(trace.value));\n  }\n\n  if (trace.calls) {\n    for (const child of trace.calls) {\n      total = total.plus(sumNativeValueFromTrace(child, walletAddress));\n    }\n  }\n\n  return total;\n}\n\nfunction getEthersProvider(\n  messenger: TransactionPayControllerMessenger,\n  chainId: Hex,\n): Web3Provider {\n  const networkClientId = messenger.call(\n    'NetworkController:findNetworkClientIdByChainId',\n    chainId,\n  );\n\n  const { provider } = messenger.call(\n    'NetworkController:getNetworkClientById',\n    networkClientId,\n  );\n\n  return new Web3Provider(provider);\n}\n\nfunction positiveOrUndefined(amount: string): string | undefined {\n  return new BigNumber(amount).gt(0) ? amount : undefined;\n}\n"]}

package/dist/utils/transaction.d.cts

@@ -72,4 +72,28 @@ export declare function collectTransactionIds(chainId: Hex, from: Hex, messenger
  * @returns `true` when the transaction is a Predict withdrawal.
  */
 export declare function isPredictWithdrawTransaction(transaction: TransactionMeta): boolean;
+/**
+ * Reads the transferred token amount from a completed on-chain transaction.
+ *
+ * For native tokens the amount is resolved via `debug_traceTransaction`
+ * (internal-call aware), falling back to the top-level `tx.value`.
+ * For ERC-20 tokens the amount is decoded from `Transfer` event logs
+ * in the transaction receipt.
+ *
+ * @param options - The options.
+ * @param options.messenger - Controller messenger for network access.
+ * @param options.txHash - Transaction hash of the completed on-chain transaction.
+ * @param options.chainId - Chain ID where the transaction was executed.
+ * @param options.tokenAddress - Address of the transferred token.
+ * @param options.walletAddress - Recipient wallet address to filter transfers to.
+ * @returns The raw (atomic) transferred amount as a decimal string,
+ * or `undefined` if the amount cannot be determined.
+ */
+export declare function getTransferredAmountFromTxHash({ messenger, txHash, chainId, tokenAddress, walletAddress, }: {
+    messenger: TransactionPayControllerMessenger;
+    txHash: string;
+    chainId: Hex;
+    tokenAddress: Hex;
+    walletAddress: Hex;
+}): Promise<string | undefined>;
 //# sourceMappingURL=transaction.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"transaction.d.cts","sourceRoot":"","sources":["../../src/utils/transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EAElB,yCAAyC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AACxE,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAM3C,OAAO,KAAK,EACV,iCAAiC,EACjC,6BAA6B,EAC7B,6BAA6B,EAC9B,qBAAiB;AAMlB,eAAO,MAAM,kBAAkB,qBAI9B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,iCAAiC,GAC3C,eAAe,GAAG,SAAS,CAQ7B;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,iCAAiC,EAC5C,qBAAqB,EAAE,6BAA6B,EACpD,qBAAqB,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,GACrD,IAAI,CAgDN;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,iCAAiC,EAC5C,kBAAkB,EAAE,MAAM,6BAA6B,EACvD,qBAAqB,EAAE,6BAA6B,GACnD,IAAI,CA2CN;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,iCAAiC,GAC3C,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,EACE,aAAa,EACb,SAAS,EACT,IAAI,GACL,EAAE;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,iCAAiC,CAAC;IAC7C,IAAI,EAAE,MAAM,CAAC;CACd,EACD,EAAE,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GACnC,IAAI,CAgBN;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,GAAG,EACZ,IAAI,EAAE,GAAG,EACT,SAAS,EAAE,iCAAiC,EAC5C,aAAa,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,GAC7C;IAAE,GAAG,EAAE,MAAM,IAAI,CAAA;CAAE,CAyBrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,eAAe,GAC3B,OAAO,CAQT"}
+{"version":3,"file":"transaction.d.cts","sourceRoot":"","sources":["../../src/utils/transaction.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,iBAAiB,EAElB,yCAAyC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AACxE,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAO3C,OAAO,KAAK,EACV,iCAAiC,EACjC,6BAA6B,EAC7B,6BAA6B,EAC9B,qBAAiB;AAOlB,eAAO,MAAM,kBAAkB,qBAI9B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,iCAAiC,GAC3C,eAAe,GAAG,SAAS,CAQ7B;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,iCAAiC,EAC5C,qBAAqB,EAAE,6BAA6B,EACpD,qBAAqB,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,GACrD,IAAI,CAgDN;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,iCAAiC,EAC5C,kBAAkB,EAAE,MAAM,6BAA6B,EACvD,qBAAqB,EAAE,6BAA6B,GACnD,IAAI,CA2CN;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,iCAAiC,GAC3C,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,EACE,aAAa,EACb,SAAS,EACT,IAAI,GACL,EAAE;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,iCAAiC,CAAC;IAC7C,IAAI,EAAE,MAAM,CAAC;CACd,EACD,EAAE,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GACnC,IAAI,CAgBN;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,GAAG,EACZ,IAAI,EAAE,GAAG,EACT,SAAS,EAAE,iCAAiC,EAC5C,aAAa,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,GAC7C;IAAE,GAAG,EAAE,MAAM,IAAI,CAAA;CAAE,CAyBrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,eAAe,GAC3B,OAAO,CAQT;AAyCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,8BAA8B,CAAC,EACnD,SAAS,EACT,MAAM,EACN,OAAO,EACP,YAAY,EACZ,aAAa,GACd,EAAE;IACD,SAAS,EAAE,iCAAiC,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,GAAG,CAAC;IACb,YAAY,EAAE,GAAG,CAAC;IAClB,aAAa,EAAE,GAAG,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB9B"}

package/dist/utils/transaction.d.mts

@@ -72,4 +72,28 @@ export declare function collectTransactionIds(chainId: Hex, from: Hex, messenger
  * @returns `true` when the transaction is a Predict withdrawal.
  */
 export declare function isPredictWithdrawTransaction(transaction: TransactionMeta): boolean;
+/**
+ * Reads the transferred token amount from a completed on-chain transaction.
+ *
+ * For native tokens the amount is resolved via `debug_traceTransaction`
+ * (internal-call aware), falling back to the top-level `tx.value`.
+ * For ERC-20 tokens the amount is decoded from `Transfer` event logs
+ * in the transaction receipt.
+ *
+ * @param options - The options.
+ * @param options.messenger - Controller messenger for network access.
+ * @param options.txHash - Transaction hash of the completed on-chain transaction.
+ * @param options.chainId - Chain ID where the transaction was executed.
+ * @param options.tokenAddress - Address of the transferred token.
+ * @param options.walletAddress - Recipient wallet address to filter transfers to.
+ * @returns The raw (atomic) transferred amount as a decimal string,
+ * or `undefined` if the amount cannot be determined.
+ */
+export declare function getTransferredAmountFromTxHash({ messenger, txHash, chainId, tokenAddress, walletAddress, }: {
+    messenger: TransactionPayControllerMessenger;
+    txHash: string;
+    chainId: Hex;
+    tokenAddress: Hex;
+    walletAddress: Hex;
+}): Promise<string | undefined>;
 //# sourceMappingURL=transaction.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"transaction.d.mts","sourceRoot":"","sources":["../../src/utils/transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EAElB,yCAAyC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AACxE,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAM3C,OAAO,KAAK,EACV,iCAAiC,EACjC,6BAA6B,EAC7B,6BAA6B,EAC9B,qBAAiB;AAMlB,eAAO,MAAM,kBAAkB,qBAI9B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,iCAAiC,GAC3C,eAAe,GAAG,SAAS,CAQ7B;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,iCAAiC,EAC5C,qBAAqB,EAAE,6BAA6B,EACpD,qBAAqB,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,GACrD,IAAI,CAgDN;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,iCAAiC,EAC5C,kBAAkB,EAAE,MAAM,6BAA6B,EACvD,qBAAqB,EAAE,6BAA6B,GACnD,IAAI,CA2CN;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,iCAAiC,GAC3C,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,EACE,aAAa,EACb,SAAS,EACT,IAAI,GACL,EAAE;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,iCAAiC,CAAC;IAC7C,IAAI,EAAE,MAAM,CAAC;CACd,EACD,EAAE,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GACnC,IAAI,CAgBN;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,GAAG,EACZ,IAAI,EAAE,GAAG,EACT,SAAS,EAAE,iCAAiC,EAC5C,aAAa,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,GAC7C;IAAE,GAAG,EAAE,MAAM,IAAI,CAAA;CAAE,CAyBrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,eAAe,GAC3B,OAAO,CAQT"}
+{"version":3,"file":"transaction.d.mts","sourceRoot":"","sources":["../../src/utils/transaction.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,iBAAiB,EAElB,yCAAyC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AACxE,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAO3C,OAAO,KAAK,EACV,iCAAiC,EACjC,6BAA6B,EAC7B,6BAA6B,EAC9B,qBAAiB;AAOlB,eAAO,MAAM,kBAAkB,qBAI9B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,iCAAiC,GAC3C,eAAe,GAAG,SAAS,CAQ7B;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,iCAAiC,EAC5C,qBAAqB,EAAE,6BAA6B,EACpD,qBAAqB,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,GACrD,IAAI,CAgDN;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,iCAAiC,EAC5C,kBAAkB,EAAE,MAAM,6BAA6B,EACvD,qBAAqB,EAAE,6BAA6B,GACnD,IAAI,CA2CN;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,iCAAiC,GAC3C,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,EACE,aAAa,EACb,SAAS,EACT,IAAI,GACL,EAAE;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,iCAAiC,CAAC;IAC7C,IAAI,EAAE,MAAM,CAAC;CACd,EACD,EAAE,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GACnC,IAAI,CAgBN;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,GAAG,EACZ,IAAI,EAAE,GAAG,EACT,SAAS,EAAE,iCAAiC,EAC5C,aAAa,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,GAC7C;IAAE,GAAG,EAAE,MAAM,IAAI,CAAA;CAAE,CAyBrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,eAAe,GAC3B,OAAO,CAQT;AAyCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,8BAA8B,CAAC,EACnD,SAAS,EACT,MAAM,EACN,OAAO,EACP,YAAY,EACZ,aAAa,GACd,EAAE;IACD,SAAS,EAAE,iCAAiC,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,GAAG,CAAC;IACb,YAAY,EAAE,GAAG,CAAC;IAClB,aAAa,EAAE,GAAG,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB9B"}

package/dist/utils/transaction.mjs

@@ -1,10 +1,15 @@
+import { Interface } from "@ethersproject/abi";
+import { Web3Provider } from "@ethersproject/providers";
+import { abiERC20 } from "@metamask/metamask-eth-abis";
 import { TransactionStatus, TransactionType } from "@metamask/transaction-controller";
 import { createModuleLogger } from "@metamask/utils";
+import { BigNumber } from "bignumber.js";
 import $lodash from "lodash";
 const { cloneDeep } = $lodash;
 import { projectLogger } from "../logger.mjs";
 import { getAssetsUnifyStateFeature } from "./feature-flags.mjs";
 import { parseRequiredTokens } from "./required-tokens.mjs";
+import { getNativeToken } from "./token.mjs";
 const log = createModuleLogger(projectLogger, 'transaction');
 export const FINALIZED_STATUSES = [
     TransactionStatus.confirmed,
@@ -193,4 +198,134 @@ function onTransactionFinalized(transaction, removeTransactionData) {
     log('Transaction finalized', { transaction });
     removeTransactionData(transaction.id);
 }
+const erc20Interface = new Interface(abiERC20);
+const ERC20_TRANSFER_EVENT_TOPIC = erc20Interface.getEventTopic('Transfer');
+/**
+ * Reads the transferred token amount from a completed on-chain transaction.
+ *
+ * For native tokens the amount is resolved via `debug_traceTransaction`
+ * (internal-call aware), falling back to the top-level `tx.value`.
+ * For ERC-20 tokens the amount is decoded from `Transfer` event logs
+ * in the transaction receipt.
+ *
+ * @param options - The options.
+ * @param options.messenger - Controller messenger for network access.
+ * @param options.txHash - Transaction hash of the completed on-chain transaction.
+ * @param options.chainId - Chain ID where the transaction was executed.
+ * @param options.tokenAddress - Address of the transferred token.
+ * @param options.walletAddress - Recipient wallet address to filter transfers to.
+ * @returns The raw (atomic) transferred amount as a decimal string,
+ * or `undefined` if the amount cannot be determined.
+ */
+export async function getTransferredAmountFromTxHash({ messenger, txHash, chainId, tokenAddress, walletAddress, }) {
+    const provider = getEthersProvider(messenger, chainId);
+    const isNative = tokenAddress.toLowerCase() === getNativeToken(chainId).toLowerCase();
+    if (isNative) {
+        return await getNativeTransferAmount(provider, txHash, walletAddress);
+    }
+    return await getErc20TransferAmount(provider, txHash, tokenAddress, walletAddress);
+}
+/**
+ * Resolves the native token amount received by a wallet from a transaction.
+ *
+ * 1. Attempts `debug_traceTransaction` with `callTracer` to walk internal
+ *    calls and sum all native value transfers targeting `walletAddress`.
+ * 2. Falls back to the top-level `tx.value` when the wallet is the direct
+ *    recipient and the trace RPC is unavailable or errors.
+ *
+ * @param provider - Ethers Web3Provider.
+ * @param txHash - Transaction hash.
+ * @param walletAddress - Recipient wallet address.
+ * @returns Raw amount as a decimal string, or `undefined`.
+ */
+async function getNativeTransferAmount(provider, txHash, walletAddress) {
+    try {
+        const trace = await provider.send('debug_traceTransaction', [
+            txHash,
+            { tracer: 'callTracer' },
+        ]);
+        const amount = sumNativeValueFromTrace(trace, walletAddress);
+        if (amount.gt(0)) {
+            return amount.toFixed(0);
+        }
+    }
+    catch {
+        // debug_traceTransaction not supported — fall through to tx.value
+    }
+    const tx = await provider.getTransaction(txHash);
+    if (!tx) {
+        return undefined;
+    }
+    if (tx.to?.toLowerCase() !== walletAddress.toLowerCase()) {
+        return undefined;
+    }
+    return positiveOrUndefined(tx.value.toString());
+}
+/**
+ * Resolves the ERC-20 token amount received by a wallet from a transaction
+ * by decoding `Transfer` event logs from the transaction receipt.
+ *
+ * @param provider - Ethers Web3Provider.
+ * @param txHash - Transaction hash.
+ * @param tokenAddress - ERC-20 token contract address.
+ * @param walletAddress - Recipient wallet address.
+ * @returns Raw amount as a decimal string, or `undefined`.
+ */
+async function getErc20TransferAmount(provider, txHash, tokenAddress, walletAddress) {
+    const receipt = await provider.getTransactionReceipt(txHash);
+    if (!receipt) {
+        return undefined;
+    }
+    let total = new BigNumber(0);
+    for (const txLog of receipt.logs) {
+        if (txLog.address.toLowerCase() !== tokenAddress.toLowerCase()) {
+            continue;
+        }
+        if (!txLog.topics[0] || txLog.topics[0] !== ERC20_TRANSFER_EVENT_TOPIC) {
+            continue;
+        }
+        try {
+            const parsed = erc20Interface.parseLog(txLog);
+            const to = parsed.args[1].toLowerCase();
+            if (to !== walletAddress.toLowerCase()) {
+                continue;
+            }
+            total = total.plus(parsed.args[2].toString());
+        }
+        catch {
+            continue;
+        }
+    }
+    return positiveOrUndefined(total.toFixed(0));
+}
+/**
+ * Recursively walks a `callTracer` result and sums native value
+ * transferred to a specific address.
+ *
+ * @param trace - Call trace node.
+ * @param walletAddress - Target address to accumulate value for.
+ * @returns Accumulated native value as BigNumber.
+ */
+function sumNativeValueFromTrace(trace, walletAddress) {
+    let total = new BigNumber(0);
+    if (trace.to?.toLowerCase() === walletAddress.toLowerCase() &&
+        trace.value &&
+        trace.value !== '0x0') {
+        total = total.plus(new BigNumber(trace.value));
+    }
+    if (trace.calls) {
+        for (const child of trace.calls) {
+            total = total.plus(sumNativeValueFromTrace(child, walletAddress));
+        }
+    }
+    return total;
+}
+function getEthersProvider(messenger, chainId) {
+    const networkClientId = messenger.call('NetworkController:findNetworkClientIdByChainId', chainId);
+    const { provider } = messenger.call('NetworkController:getNetworkClientById', networkClientId);
+    return new Web3Provider(provider);
+}
+function positiveOrUndefined(amount) {
+    return new BigNumber(amount).gt(0) ? amount : undefined;
+}
 //# sourceMappingURL=transaction.mjs.map