@metamask/transaction-pay-controller 23.12.0 → 23.13.0

package/dist/strategy/fiat/fiat-submit.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"fiat-submit.cjs","sourceRoot":"","sources":["../../../src/strategy/fiat/fiat-submit.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  RampsOrder,\n  RampsOrderCryptoCurrency,\n} from '@metamask/ramps-controller';\nimport { RampsOrderStatus } from '@metamask/ramps-controller';\nimport type { Hex } from '@metamask/utils';\nimport { createModuleLogger } from '@metamask/utils';\n\nimport { projectLogger } from '../../logger';\nimport type {\n  PayStrategy,\n  PayStrategyExecuteRequest,\n  TransactionPayFiatOptions,\n  TransactionPayControllerMessenger,\n} from '../../types';\nimport {\n  getFiatOrderPollIntervalMs,\n  getFiatOrderPollTimeoutMs,\n} from '../../utils/feature-flags';\nimport { buildCaipAssetType } from '../../utils/token';\nimport { updateTransaction } from '../../utils/transaction';\nimport type { TransactionPayFiatAsset } from './constants';\nimport { MUSD_MONAD_FIAT_ASSET } from './constants';\nimport {\n  isDirectMusdMoneyAccountQuote,\n  submitDirectMusdVaultDeposit,\n} from './fiat-direct-musd';\nimport { submitSimpleRelay } from './fiat-submit-simple';\nimport { submitWithTransactionData } from './fiat-submit-with-transaction-data';\nimport { fundFiatOrderFromTestSource } from './fiat-test-funding';\nimport type { FiatQuote } from './types';\nimport {\n  deriveFiatAssetForFiatPayment,\n  extractProviderCode,\n  resolveSourceAmountRaw,\n} from './utils';\n\nconst log = createModuleLogger(projectLogger, 'fiat-submit');\n\nconst TERMINAL_FAILURE_STATUSES: RampsOrderStatus[] = [\n  RampsOrderStatus.Cancelled,\n  RampsOrderStatus.Failed,\n  RampsOrderStatus.IdExpired,\n];\n\n/**\n * Submits fiat strategy quotes by polling the on-ramp order until completion,\n * then re-quoting and submitting the relay leg with the settled crypto amount.\n *\n * @param request - Strategy execute request containing fiat quotes, messenger, and transaction metadata.\n * @param request.messenger - Controller messenger for cross-controller calls.\n * @param request.quotes - Fiat quotes to execute (exactly one expected).\n * @param request.transaction - Original transaction metadata.\n * @param request.isSmartTransaction - Callback to check smart transaction eligibility.\n * @returns An object containing the relay transaction hash if available.\n */\nexport async function submitFiatQuotes(\n  request: PayStrategyExecuteRequest<FiatQuote>,\n): ReturnType<PayStrategy<FiatQuote>['execute']> {\n  const { messenger, transaction } = request;\n  const transactionId = transaction.id;\n  const state = messenger.call('TransactionPayController:getState');\n  const transactionData = state.transactionData[transactionId];\n\n  const walletAddress = getWalletAddress({\n    quotes: request.quotes,\n    transaction,\n    accountOverride: transactionData?.accountOverride,\n  });\n\n  const fiatPayment = transactionData?.fiatPayment;\n  const orderId = fiatPayment?.orderId;\n\n  if (!orderId) {\n    throw new Error('Missing order ID for fiat submission');\n  }\n\n  const providerCode = extractProviderCode(fiatPayment?.rampsQuote?.provider);\n\n  if (!providerCode) {\n    throw new Error('Missing provider code for fiat submission');\n  }\n\n  updateTransaction(\n    {\n      transactionId,\n      messenger,\n      note: 'Persist fiat order metadata',\n    },\n    (tx) => {\n      tx.metamaskPay ??= {};\n      tx.metamaskPay.fiat = { orderId, provider: providerCode };\n    },\n  );\n\n  log('Starting fiat order polling', {\n    orderId,\n    providerCode,\n    transactionId,\n  });\n\n  const fiatQuote = request.quotes[0];\n\n  if (!fiatQuote) {\n    throw new Error('Missing fiat quote for relay submission');\n  }\n\n  const fiatOptions = getFiatOptions(messenger);\n\n  const order = fiatOptions?.testFundingSource\n    ? await fundFiatOrderFromTestSource({\n        fiat: fiatOptions,\n        messenger,\n        quote: fiatQuote,\n        transaction,\n      })\n    : await waitForOrderCompletion({\n        messenger,\n        orderCode: orderId,\n        providerCode,\n        transactionId,\n        walletAddress,\n      });\n\n  log('Fiat order completed', {\n    cryptoAmount: order.cryptoAmount,\n    orderId,\n    transactionId,\n  });\n\n  return await submitRelayAfterFiatCompletion({ order, request });\n}\n\nfunction getFiatOptions(\n  messenger: TransactionPayControllerMessenger,\n): TransactionPayFiatOptions | undefined {\n  try {\n    return messenger.call('TransactionPayController:getFiatOptions');\n  } catch (error) {\n    log('Failed to retrieve fiat options', error);\n    return undefined;\n  }\n}\n\n/**\n * Validates that the completed order's crypto asset matches the expected fiat asset.\n *\n * @param options - The validation options.\n * @param options.expectedAsset - The expected fiat asset derived from the transaction type.\n * @param options.orderCrypto - The crypto currency information from the completed order.\n * @param options.transactionId - Transaction ID for error reporting.\n */\nfunction validateOrderAsset({\n  expectedAsset,\n  orderCrypto,\n  transactionId,\n}: {\n  expectedAsset: TransactionPayFiatAsset;\n  orderCrypto: RampsOrderCryptoCurrency | undefined;\n  transactionId: string;\n}): void {\n  const orderAssetId = orderCrypto?.assetId?.toLowerCase();\n  const expectedAssetId = buildCaipAssetType(\n    expectedAsset.chainId,\n    expectedAsset.address,\n  ).toLowerCase();\n  const expectedChainId = expectedAssetId.split('/')[0];\n  const orderChainId = orderCrypto?.chainId?.toLowerCase();\n\n  if (orderAssetId && orderAssetId !== expectedAssetId) {\n    throw new Error(\n      `Fiat order asset mismatch for transaction ${transactionId}: ` +\n        `expected ${expectedAssetId}, got ${orderAssetId}`,\n    );\n  }\n\n  if (orderChainId && orderChainId !== expectedChainId) {\n    throw new Error(\n      `Fiat order chain mismatch for transaction ${transactionId}: ` +\n        `expected ${expectedChainId}, got ${orderChainId}`,\n    );\n  }\n}\n\n/**\n * Polls the on-ramp order until it reaches a terminal status.\n *\n * @param options - The polling options.\n * @param options.messenger - Controller messenger for calling `RampsController:getOrder`.\n * @param options.orderCode - The order identifier within the provider.\n * @param options.providerCode - The on-ramp provider code (e.g. \"transak\").\n * @param options.transactionId - Transaction ID for logging.\n * @param options.walletAddress - Wallet address associated with the order.\n * @returns The completed order data.\n */\nasync function waitForOrderCompletion({\n  messenger,\n  orderCode,\n  providerCode,\n  transactionId,\n  walletAddress,\n}: {\n  messenger: TransactionPayControllerMessenger;\n  orderCode: string;\n  providerCode: string;\n  transactionId: string;\n  walletAddress: string;\n}): Promise<RampsOrder> {\n  const pollIntervalMs = getFiatOrderPollIntervalMs(messenger);\n  const pollTimeoutMs = getFiatOrderPollTimeoutMs(messenger);\n  const startTime = Date.now();\n  let lastStatus: string | undefined;\n\n  while (true) {\n    let order: RampsOrder | undefined;\n\n    try {\n      order = await messenger.call(\n        'RampsController:getOrder',\n        providerCode,\n        orderCode,\n        walletAddress,\n      );\n    } catch (error) {\n      log('Order polling network error', error);\n    }\n\n    if (order) {\n      lastStatus = order.status;\n\n      log('Polled fiat order', {\n        orderStatus: order.status,\n        providerCode,\n        transactionId,\n      });\n\n      if (order.status === RampsOrderStatus.Completed) {\n        return order;\n      }\n\n      if (TERMINAL_FAILURE_STATUSES.includes(order.status)) {\n        throw new Error(`Fiat order ${order.status.toLowerCase()}`);\n      }\n    }\n\n    if (Date.now() - startTime >= pollTimeoutMs) {\n      throw new Error(\n        `Fiat order polling timed out (last status: ${lastStatus})`,\n      );\n    }\n\n    await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));\n  }\n}\n\n/**\n * Re-quotes and submits the relay leg using the settled amount from a completed fiat order.\n *\n * @param options - The submission options.\n * @param options.order - The completed on-ramp order containing the settled crypto amount.\n * @param options.request - The original fiat strategy execute request.\n * @returns An object containing the relay transaction hash if available.\n */\nasync function submitRelayAfterFiatCompletion({\n  order,\n  request,\n}: {\n  order: RampsOrder;\n  request: PayStrategyExecuteRequest<FiatQuote>;\n}): Promise<{ transactionHash?: Hex }> {\n  const { messenger, quotes, transaction } = request;\n  const transactionId = transaction.id;\n\n  if (quotes.length > 1) {\n    throw new Error('Multiple fiat quotes are not supported for submission');\n  }\n\n  const fiatQuote = quotes[0];\n  const isDirectMusd = isDirectMusdMoneyAccountQuote(fiatQuote);\n\n  if (isDirectMusd) {\n    validateOrderAsset({\n      expectedAsset: MUSD_MONAD_FIAT_ASSET,\n      orderCrypto: order.cryptoCurrency,\n      transactionId,\n    });\n\n    const sourceAmountRaw = await resolveSourceAmountRaw({\n      messenger,\n      order,\n      fiatAsset: MUSD_MONAD_FIAT_ASSET,\n      walletAddress: transaction.txParams.from as Hex,\n    });\n\n    return await submitDirectMusdVaultDeposit({\n      request,\n      sourceAmountRaw,\n      transaction,\n    });\n  }\n\n  const fiatAsset = deriveFiatAssetForFiatPayment(transaction, messenger);\n\n  validateOrderAsset({\n    expectedAsset: fiatAsset,\n    orderCrypto: order.cryptoCurrency,\n    transactionId,\n  });\n\n  const baseRequest = fiatQuote.request;\n\n  const sourceAmountRaw = await resolveSourceAmountRaw({\n    messenger,\n    order,\n    fiatAsset,\n    walletAddress: baseRequest.from,\n  });\n\n  if (!fiatQuote.original.relayQuote) {\n    throw new Error('Missing Relay quote for fiat submission');\n  }\n\n  const hasNestedCalldata = (transaction.nestedTransactions?.length ?? 0) >= 2;\n\n  // Transactions with nested calldata (e.g. moneyAccountDeposit with\n  // approve + deposit) need a three-phase flow: discovery quote to learn\n  // the target amount, calldata re-encoding, then a delegation quote.\n  // Simple deposits (Perps, Predict) skip straight to a single EXACT_INPUT\n  // relay quote — cheaper fees, no leftover dust, one fewer request.\n  if (hasNestedCalldata) {\n    return await submitWithTransactionData({\n      baseRequest,\n      request,\n      sourceAmountRaw,\n      transaction,\n    });\n  }\n\n  return await submitSimpleRelay({\n    baseRequest,\n    request,\n    sourceAmountRaw,\n    transaction,\n  });\n}\n\nfunction getWalletAddress({\n  quotes,\n  transaction,\n  accountOverride,\n}: {\n  quotes: PayStrategyExecuteRequest<FiatQuote>['quotes'];\n  transaction: PayStrategyExecuteRequest<FiatQuote>['transaction'];\n  accountOverride: Hex | undefined;\n}): Hex {\n  const address = isDirectMusdMoneyAccountQuote(quotes[0])\n    ? transaction.txParams.from\n    : (accountOverride ?? transaction.txParams.from);\n\n  if (!address) {\n    throw new Error('Missing wallet address for fiat submission');\n  }\n\n  return address as Hex;\n}\n"]}
+{"version":3,"file":"fiat-submit.cjs","sourceRoot":"","sources":["../../../src/strategy/fiat/fiat-submit.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RampsOrder } from '@metamask/ramps-controller';\nimport { RampsOrderStatus } from '@metamask/ramps-controller';\nimport type { Hex } from '@metamask/utils';\nimport { createModuleLogger } from '@metamask/utils';\n\nimport { projectLogger } from '../../logger';\nimport type {\n  PayStrategy,\n  PayStrategyExecuteRequest,\n  TransactionPayFiatOptions,\n  TransactionPayControllerMessenger,\n} from '../../types';\nimport { prefixError } from '../../utils/error-prefix';\nimport {\n  getFiatOrderPollIntervalMs,\n  getFiatOrderPollTimeoutMs,\n} from '../../utils/feature-flags';\nimport { updateTransaction } from '../../utils/transaction';\nimport {\n  isDirectMusdMoneyAccountQuote,\n  submitDirectMusdAfterFiatCompletion,\n} from './fiat-direct-musd';\nimport { submitSimpleRelay } from './fiat-submit-simple';\nimport { submitWithTransactionData } from './fiat-submit-with-transaction-data';\nimport { fundFiatOrderFromTestSource } from './fiat-test-funding';\nimport type { FiatQuote } from './types';\nimport {\n  deriveFiatAssetForFiatPayment,\n  extractProviderCode,\n  resolveSourceAmountRaw,\n  validateOrderAsset,\n} from './utils';\n\nconst log = createModuleLogger(projectLogger, 'fiat-submit');\nconst POST_RAMP_ERROR_PREFIX = 'Post-Ramp: ';\n\nconst TERMINAL_FAILURE_STATUSES: RampsOrderStatus[] = [\n  RampsOrderStatus.Cancelled,\n  RampsOrderStatus.Failed,\n  RampsOrderStatus.IdExpired,\n];\n\n/**\n * Submits fiat strategy quotes by polling the on-ramp order until completion,\n * then re-quoting and submitting the relay leg with the settled crypto amount.\n *\n * @param request - Strategy execute request containing fiat quotes, messenger, and transaction metadata.\n * @param request.messenger - Controller messenger for cross-controller calls.\n * @param request.quotes - Fiat quotes to execute (exactly one expected).\n * @param request.transaction - Original transaction metadata.\n * @param request.isSmartTransaction - Callback to check smart transaction eligibility.\n * @returns An object containing the relay transaction hash if available.\n */\nexport async function submitFiatQuotes(\n  request: PayStrategyExecuteRequest<FiatQuote>,\n): ReturnType<PayStrategy<FiatQuote>['execute']> {\n  const { messenger, transaction } = request;\n  const transactionId = transaction.id;\n  const state = messenger.call('TransactionPayController:getState');\n  const transactionData = state.transactionData[transactionId];\n\n  const walletAddress = getWalletAddress({\n    quotes: request.quotes,\n    transaction,\n    accountOverride: transactionData?.accountOverride,\n  });\n\n  const fiatPayment = transactionData?.fiatPayment;\n  const orderId = fiatPayment?.orderId;\n\n  if (!orderId) {\n    throw new Error('Missing order ID');\n  }\n\n  const providerCode = extractProviderCode(fiatPayment?.rampsQuote?.provider);\n\n  if (!providerCode) {\n    throw new Error('Missing provider code');\n  }\n\n  updateTransaction(\n    {\n      transactionId,\n      messenger,\n      note: 'Persist fiat order metadata',\n    },\n    (tx) => {\n      tx.metamaskPay ??= {};\n      tx.metamaskPay.fiat = { orderId, provider: providerCode };\n    },\n  );\n\n  log('Starting fiat order polling', {\n    orderId,\n    providerCode,\n    transactionId,\n  });\n\n  const fiatQuote = request.quotes[0];\n\n  if (!fiatQuote) {\n    throw new Error('Missing quote');\n  }\n\n  const fiatOptions = getFiatOptions(messenger);\n\n  const order = fiatOptions?.testFundingSource\n    ? await fundFiatOrderFromTestSource({\n        fiat: fiatOptions,\n        messenger,\n        quote: fiatQuote,\n        transaction,\n      })\n    : await waitForOrderCompletion({\n        messenger,\n        orderCode: orderId,\n        providerCode,\n        transactionId,\n        walletAddress,\n      });\n\n  log('Fiat order completed', {\n    cryptoAmount: order.cryptoAmount,\n    orderId,\n    transactionId,\n  });\n\n  try {\n    const result = await submitRelayAfterFiatCompletion({ order, request });\n\n    if (result.transactionHash === undefined) {\n      throw new Error('Missing transaction hash');\n    }\n\n    return result;\n  } catch (error) {\n    throw prefixError(error, POST_RAMP_ERROR_PREFIX);\n  }\n}\n\nfunction getFiatOptions(\n  messenger: TransactionPayControllerMessenger,\n): TransactionPayFiatOptions | undefined {\n  try {\n    return messenger.call('TransactionPayController:getFiatOptions');\n  } catch (error) {\n    log('Failed to retrieve fiat options', error);\n    return undefined;\n  }\n}\n\n/**\n * Polls the on-ramp order until it reaches a terminal status.\n *\n * @param options - The polling options.\n * @param options.messenger - Controller messenger for calling `RampsController:getOrder`.\n * @param options.orderCode - The order identifier within the provider.\n * @param options.providerCode - The on-ramp provider code (e.g. \"transak\").\n * @param options.transactionId - Transaction ID for logging.\n * @param options.walletAddress - Wallet address associated with the order.\n * @returns The completed order data.\n */\nasync function waitForOrderCompletion({\n  messenger,\n  orderCode,\n  providerCode,\n  transactionId,\n  walletAddress,\n}: {\n  messenger: TransactionPayControllerMessenger;\n  orderCode: string;\n  providerCode: string;\n  transactionId: string;\n  walletAddress: string;\n}): Promise<RampsOrder> {\n  const pollIntervalMs = getFiatOrderPollIntervalMs(messenger);\n  const pollTimeoutMs = getFiatOrderPollTimeoutMs(messenger);\n  const startTime = Date.now();\n  let lastStatus: string | undefined;\n\n  while (true) {\n    let order: RampsOrder | undefined;\n\n    try {\n      order = await messenger.call(\n        'RampsController:getOrder',\n        providerCode,\n        orderCode,\n        walletAddress,\n      );\n    } catch (error) {\n      log('Order polling network error', error);\n    }\n\n    if (order) {\n      lastStatus = order.status;\n\n      log('Polled fiat order', {\n        orderStatus: order.status,\n        providerCode,\n        transactionId,\n      });\n\n      if (order.status === RampsOrderStatus.Completed) {\n        return order;\n      }\n\n      if (TERMINAL_FAILURE_STATUSES.includes(order.status)) {\n        throw new Error(`Fiat order ${order.status.toLowerCase()}`);\n      }\n    }\n\n    if (Date.now() - startTime >= pollTimeoutMs) {\n      throw new Error(\n        `Fiat order polling timed out (last status: ${lastStatus})`,\n      );\n    }\n\n    await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));\n  }\n}\n\n/**\n * Re-quotes and submits the relay leg using the settled amount from a completed fiat order.\n *\n * @param options - The submission options.\n * @param options.order - The completed on-ramp order containing the settled crypto amount.\n * @param options.request - The original fiat strategy execute request.\n * @returns An object containing the relay transaction hash if available.\n */\nasync function submitRelayAfterFiatCompletion({\n  order,\n  request,\n}: {\n  order: RampsOrder;\n  request: PayStrategyExecuteRequest<FiatQuote>;\n}): Promise<{ transactionHash?: Hex }> {\n  const { messenger, quotes, transaction } = request;\n  const transactionId = transaction.id;\n\n  if (quotes.length > 1) {\n    throw new Error('Multiple fiat quotes are not supported for submission');\n  }\n\n  const fiatQuote = quotes[0];\n  const isDirectMusd = isDirectMusdMoneyAccountQuote(fiatQuote);\n\n  if (isDirectMusd) {\n    return await submitDirectMusdAfterFiatCompletion({ order, request });\n  }\n\n  const fiatAsset = deriveFiatAssetForFiatPayment(transaction, messenger);\n\n  validateOrderAsset({\n    expectedAsset: fiatAsset,\n    orderCrypto: order.cryptoCurrency,\n    transactionId,\n  });\n\n  const baseRequest = fiatQuote.request;\n\n  const sourceAmountRaw = await resolveSourceAmountRaw({\n    messenger,\n    order,\n    fiatAsset,\n    walletAddress: baseRequest.from,\n  });\n\n  if (!fiatQuote.original.relayQuote) {\n    throw new Error('Missing Relay quote');\n  }\n\n  const hasNestedCalldata = (transaction.nestedTransactions?.length ?? 0) >= 2;\n\n  // Transactions with nested calldata (e.g. moneyAccountDeposit with\n  // approve + deposit) need a three-phase flow: discovery quote to learn\n  // the target amount, calldata re-encoding, then a delegation quote.\n  // Simple deposits (Perps, Predict) skip straight to a single EXACT_INPUT\n  // relay quote — cheaper fees, no leftover dust, one fewer request.\n  if (hasNestedCalldata) {\n    return await submitWithTransactionData({\n      baseRequest,\n      request,\n      sourceAmountRaw,\n      transaction,\n    });\n  }\n\n  return await submitSimpleRelay({\n    baseRequest,\n    request,\n    sourceAmountRaw,\n    transaction,\n  });\n}\n\nfunction getWalletAddress({\n  quotes,\n  transaction,\n  accountOverride,\n}: {\n  quotes: PayStrategyExecuteRequest<FiatQuote>['quotes'];\n  transaction: PayStrategyExecuteRequest<FiatQuote>['transaction'];\n  accountOverride: Hex | undefined;\n}): Hex {\n  const address = isDirectMusdMoneyAccountQuote(quotes[0])\n    ? transaction.txParams.from\n    : (accountOverride ?? transaction.txParams.from);\n\n  if (!address) {\n    throw new Error('Missing wallet address');\n  }\n\n  return address as Hex;\n}\n"]}

package/dist/strategy/fiat/fiat-submit.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"fiat-submit.d.cts","sourceRoot":"","sources":["../../../src/strategy/fiat/fiat-submit.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,WAAW,EACX,yBAAyB,EAG1B,wBAAoB;AAgBrB,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAgB;AAezC;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,yBAAyB,CAAC,SAAS,CAAC,GAC5C,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAyE/C"}
+{"version":3,"file":"fiat-submit.d.cts","sourceRoot":"","sources":["../../../src/strategy/fiat/fiat-submit.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,WAAW,EACX,yBAAyB,EAG1B,wBAAoB;AAcrB,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAgB;AAiBzC;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,yBAAyB,CAAC,SAAS,CAAC,GAC5C,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAmF/C"}

package/dist/strategy/fiat/fiat-submit.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"fiat-submit.d.mts","sourceRoot":"","sources":["../../../src/strategy/fiat/fiat-submit.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,WAAW,EACX,yBAAyB,EAG1B,wBAAoB;AAgBrB,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAgB;AAezC;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,yBAAyB,CAAC,SAAS,CAAC,GAC5C,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAyE/C"}
+{"version":3,"file":"fiat-submit.d.mts","sourceRoot":"","sources":["../../../src/strategy/fiat/fiat-submit.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,WAAW,EACX,yBAAyB,EAG1B,wBAAoB;AAcrB,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAgB;AAiBzC;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,yBAAyB,CAAC,SAAS,CAAC,GAC5C,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAmF/C"}

package/dist/strategy/fiat/fiat-submit.mjs

@@ -1,16 +1,16 @@
 import { RampsOrderStatus } from "@metamask/ramps-controller";
 import { createModuleLogger } from "@metamask/utils";
 import { projectLogger } from "../../logger.mjs";
+import { prefixError } from "../../utils/error-prefix.mjs";
 import { getFiatOrderPollIntervalMs, getFiatOrderPollTimeoutMs } from "../../utils/feature-flags.mjs";
-import { buildCaipAssetType } from "../../utils/token.mjs";
 import { updateTransaction } from "../../utils/transaction.mjs";
-import { MUSD_MONAD_FIAT_ASSET } from "./constants.mjs";
-import { isDirectMusdMoneyAccountQuote, submitDirectMusdVaultDeposit } from "./fiat-direct-musd.mjs";
+import { isDirectMusdMoneyAccountQuote, submitDirectMusdAfterFiatCompletion } from "./fiat-direct-musd.mjs";
 import { submitSimpleRelay } from "./fiat-submit-simple.mjs";
 import { submitWithTransactionData } from "./fiat-submit-with-transaction-data.mjs";
 import { fundFiatOrderFromTestSource } from "./fiat-test-funding.mjs";
-import { deriveFiatAssetForFiatPayment, extractProviderCode, resolveSourceAmountRaw } from "./utils.mjs";
+import { deriveFiatAssetForFiatPayment, extractProviderCode, resolveSourceAmountRaw, validateOrderAsset } from "./utils.mjs";
 const log = createModuleLogger(projectLogger, 'fiat-submit');
+const POST_RAMP_ERROR_PREFIX = 'Post-Ramp: ';
 const TERMINAL_FAILURE_STATUSES = [
     RampsOrderStatus.Cancelled,
     RampsOrderStatus.Failed,
@@ -40,11 +40,11 @@ export async function submitFiatQuotes(request) {
     const fiatPayment = transactionData?.fiatPayment;
     const orderId = fiatPayment?.orderId;
     if (!orderId) {
-        throw new Error('Missing order ID for fiat submission');
+        throw new Error('Missing order ID');
     }
     const providerCode = extractProviderCode(fiatPayment?.rampsQuote?.provider);
     if (!providerCode) {
-        throw new Error('Missing provider code for fiat submission');
+        throw new Error('Missing provider code');
     }
     updateTransaction({
         transactionId,
@@ -61,7 +61,7 @@ export async function submitFiatQuotes(request) {
     });
     const fiatQuote = request.quotes[0];
     if (!fiatQuote) {
-        throw new Error('Missing fiat quote for relay submission');
+        throw new Error('Missing quote');
     }
     const fiatOptions = getFiatOptions(messenger);
     const order = fiatOptions?.testFundingSource
@@ -83,7 +83,16 @@ export async function submitFiatQuotes(request) {
         orderId,
         transactionId,
     });
-    return await submitRelayAfterFiatCompletion({ order, request });
+    try {
+        const result = await submitRelayAfterFiatCompletion({ order, request });
+        if (result.transactionHash === undefined) {
+            throw new Error('Missing transaction hash');
+        }
+        return result;
+    }
+    catch (error) {
+        throw prefixError(error, POST_RAMP_ERROR_PREFIX);
+    }
 }
 function getFiatOptions(messenger) {
     try {
@@ -94,28 +103,6 @@ function getFiatOptions(messenger) {
         return undefined;
     }
 }
-/**
- * Validates that the completed order's crypto asset matches the expected fiat asset.
- *
- * @param options - The validation options.
- * @param options.expectedAsset - The expected fiat asset derived from the transaction type.
- * @param options.orderCrypto - The crypto currency information from the completed order.
- * @param options.transactionId - Transaction ID for error reporting.
- */
-function validateOrderAsset({ expectedAsset, orderCrypto, transactionId, }) {
-    const orderAssetId = orderCrypto?.assetId?.toLowerCase();
-    const expectedAssetId = buildCaipAssetType(expectedAsset.chainId, expectedAsset.address).toLowerCase();
-    const expectedChainId = expectedAssetId.split('/')[0];
-    const orderChainId = orderCrypto?.chainId?.toLowerCase();
-    if (orderAssetId && orderAssetId !== expectedAssetId) {
-        throw new Error(`Fiat order asset mismatch for transaction ${transactionId}: ` +
-            `expected ${expectedAssetId}, got ${orderAssetId}`);
-    }
-    if (orderChainId && orderChainId !== expectedChainId) {
-        throw new Error(`Fiat order chain mismatch for transaction ${transactionId}: ` +
-            `expected ${expectedChainId}, got ${orderChainId}`);
-    }
-}
 /**
  * Polls the on-ramp order until it reaches a terminal status.
  *
@@ -177,22 +164,7 @@ async function submitRelayAfterFiatCompletion({ order, request, }) {
     const fiatQuote = quotes[0];
     const isDirectMusd = isDirectMusdMoneyAccountQuote(fiatQuote);
     if (isDirectMusd) {
-        validateOrderAsset({
-            expectedAsset: MUSD_MONAD_FIAT_ASSET,
-            orderCrypto: order.cryptoCurrency,
-            transactionId,
-        });
-        const sourceAmountRaw = await resolveSourceAmountRaw({
-            messenger,
-            order,
-            fiatAsset: MUSD_MONAD_FIAT_ASSET,
-            walletAddress: transaction.txParams.from,
-        });
-        return await submitDirectMusdVaultDeposit({
-            request,
-            sourceAmountRaw,
-            transaction,
-        });
+        return await submitDirectMusdAfterFiatCompletion({ order, request });
     }
     const fiatAsset = deriveFiatAssetForFiatPayment(transaction, messenger);
     validateOrderAsset({
@@ -208,7 +180,7 @@ async function submitRelayAfterFiatCompletion({ order, request, }) {
         walletAddress: baseRequest.from,
     });
     if (!fiatQuote.original.relayQuote) {
-        throw new Error('Missing Relay quote for fiat submission');
+        throw new Error('Missing Relay quote');
     }
     const hasNestedCalldata = (transaction.nestedTransactions?.length ?? 0) >= 2;
     // Transactions with nested calldata (e.g. moneyAccountDeposit with
@@ -236,7 +208,7 @@ function getWalletAddress({ quotes, transaction, accountOverride, }) {
         ? transaction.txParams.from
         : (accountOverride ?? transaction.txParams.from);
     if (!address) {
-        throw new Error('Missing wallet address for fiat submission');
+        throw new Error('Missing wallet address');
     }
     return address;
 }

package/dist/strategy/fiat/fiat-submit.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"fiat-submit.mjs","sourceRoot":"","sources":["../../../src/strategy/fiat/fiat-submit.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  RampsOrder,\n  RampsOrderCryptoCurrency,\n} from '@metamask/ramps-controller';\nimport { RampsOrderStatus } from '@metamask/ramps-controller';\nimport type { Hex } from '@metamask/utils';\nimport { createModuleLogger } from '@metamask/utils';\n\nimport { projectLogger } from '../../logger';\nimport type {\n  PayStrategy,\n  PayStrategyExecuteRequest,\n  TransactionPayFiatOptions,\n  TransactionPayControllerMessenger,\n} from '../../types';\nimport {\n  getFiatOrderPollIntervalMs,\n  getFiatOrderPollTimeoutMs,\n} from '../../utils/feature-flags';\nimport { buildCaipAssetType } from '../../utils/token';\nimport { updateTransaction } from '../../utils/transaction';\nimport type { TransactionPayFiatAsset } from './constants';\nimport { MUSD_MONAD_FIAT_ASSET } from './constants';\nimport {\n  isDirectMusdMoneyAccountQuote,\n  submitDirectMusdVaultDeposit,\n} from './fiat-direct-musd';\nimport { submitSimpleRelay } from './fiat-submit-simple';\nimport { submitWithTransactionData } from './fiat-submit-with-transaction-data';\nimport { fundFiatOrderFromTestSource } from './fiat-test-funding';\nimport type { FiatQuote } from './types';\nimport {\n  deriveFiatAssetForFiatPayment,\n  extractProviderCode,\n  resolveSourceAmountRaw,\n} from './utils';\n\nconst log = createModuleLogger(projectLogger, 'fiat-submit');\n\nconst TERMINAL_FAILURE_STATUSES: RampsOrderStatus[] = [\n  RampsOrderStatus.Cancelled,\n  RampsOrderStatus.Failed,\n  RampsOrderStatus.IdExpired,\n];\n\n/**\n * Submits fiat strategy quotes by polling the on-ramp order until completion,\n * then re-quoting and submitting the relay leg with the settled crypto amount.\n *\n * @param request - Strategy execute request containing fiat quotes, messenger, and transaction metadata.\n * @param request.messenger - Controller messenger for cross-controller calls.\n * @param request.quotes - Fiat quotes to execute (exactly one expected).\n * @param request.transaction - Original transaction metadata.\n * @param request.isSmartTransaction - Callback to check smart transaction eligibility.\n * @returns An object containing the relay transaction hash if available.\n */\nexport async function submitFiatQuotes(\n  request: PayStrategyExecuteRequest<FiatQuote>,\n): ReturnType<PayStrategy<FiatQuote>['execute']> {\n  const { messenger, transaction } = request;\n  const transactionId = transaction.id;\n  const state = messenger.call('TransactionPayController:getState');\n  const transactionData = state.transactionData[transactionId];\n\n  const walletAddress = getWalletAddress({\n    quotes: request.quotes,\n    transaction,\n    accountOverride: transactionData?.accountOverride,\n  });\n\n  const fiatPayment = transactionData?.fiatPayment;\n  const orderId = fiatPayment?.orderId;\n\n  if (!orderId) {\n    throw new Error('Missing order ID for fiat submission');\n  }\n\n  const providerCode = extractProviderCode(fiatPayment?.rampsQuote?.provider);\n\n  if (!providerCode) {\n    throw new Error('Missing provider code for fiat submission');\n  }\n\n  updateTransaction(\n    {\n      transactionId,\n      messenger,\n      note: 'Persist fiat order metadata',\n    },\n    (tx) => {\n      tx.metamaskPay ??= {};\n      tx.metamaskPay.fiat = { orderId, provider: providerCode };\n    },\n  );\n\n  log('Starting fiat order polling', {\n    orderId,\n    providerCode,\n    transactionId,\n  });\n\n  const fiatQuote = request.quotes[0];\n\n  if (!fiatQuote) {\n    throw new Error('Missing fiat quote for relay submission');\n  }\n\n  const fiatOptions = getFiatOptions(messenger);\n\n  const order = fiatOptions?.testFundingSource\n    ? await fundFiatOrderFromTestSource({\n        fiat: fiatOptions,\n        messenger,\n        quote: fiatQuote,\n        transaction,\n      })\n    : await waitForOrderCompletion({\n        messenger,\n        orderCode: orderId,\n        providerCode,\n        transactionId,\n        walletAddress,\n      });\n\n  log('Fiat order completed', {\n    cryptoAmount: order.cryptoAmount,\n    orderId,\n    transactionId,\n  });\n\n  return await submitRelayAfterFiatCompletion({ order, request });\n}\n\nfunction getFiatOptions(\n  messenger: TransactionPayControllerMessenger,\n): TransactionPayFiatOptions | undefined {\n  try {\n    return messenger.call('TransactionPayController:getFiatOptions');\n  } catch (error) {\n    log('Failed to retrieve fiat options', error);\n    return undefined;\n  }\n}\n\n/**\n * Validates that the completed order's crypto asset matches the expected fiat asset.\n *\n * @param options - The validation options.\n * @param options.expectedAsset - The expected fiat asset derived from the transaction type.\n * @param options.orderCrypto - The crypto currency information from the completed order.\n * @param options.transactionId - Transaction ID for error reporting.\n */\nfunction validateOrderAsset({\n  expectedAsset,\n  orderCrypto,\n  transactionId,\n}: {\n  expectedAsset: TransactionPayFiatAsset;\n  orderCrypto: RampsOrderCryptoCurrency | undefined;\n  transactionId: string;\n}): void {\n  const orderAssetId = orderCrypto?.assetId?.toLowerCase();\n  const expectedAssetId = buildCaipAssetType(\n    expectedAsset.chainId,\n    expectedAsset.address,\n  ).toLowerCase();\n  const expectedChainId = expectedAssetId.split('/')[0];\n  const orderChainId = orderCrypto?.chainId?.toLowerCase();\n\n  if (orderAssetId && orderAssetId !== expectedAssetId) {\n    throw new Error(\n      `Fiat order asset mismatch for transaction ${transactionId}: ` +\n        `expected ${expectedAssetId}, got ${orderAssetId}`,\n    );\n  }\n\n  if (orderChainId && orderChainId !== expectedChainId) {\n    throw new Error(\n      `Fiat order chain mismatch for transaction ${transactionId}: ` +\n        `expected ${expectedChainId}, got ${orderChainId}`,\n    );\n  }\n}\n\n/**\n * Polls the on-ramp order until it reaches a terminal status.\n *\n * @param options - The polling options.\n * @param options.messenger - Controller messenger for calling `RampsController:getOrder`.\n * @param options.orderCode - The order identifier within the provider.\n * @param options.providerCode - The on-ramp provider code (e.g. \"transak\").\n * @param options.transactionId - Transaction ID for logging.\n * @param options.walletAddress - Wallet address associated with the order.\n * @returns The completed order data.\n */\nasync function waitForOrderCompletion({\n  messenger,\n  orderCode,\n  providerCode,\n  transactionId,\n  walletAddress,\n}: {\n  messenger: TransactionPayControllerMessenger;\n  orderCode: string;\n  providerCode: string;\n  transactionId: string;\n  walletAddress: string;\n}): Promise<RampsOrder> {\n  const pollIntervalMs = getFiatOrderPollIntervalMs(messenger);\n  const pollTimeoutMs = getFiatOrderPollTimeoutMs(messenger);\n  const startTime = Date.now();\n  let lastStatus: string | undefined;\n\n  while (true) {\n    let order: RampsOrder | undefined;\n\n    try {\n      order = await messenger.call(\n        'RampsController:getOrder',\n        providerCode,\n        orderCode,\n        walletAddress,\n      );\n    } catch (error) {\n      log('Order polling network error', error);\n    }\n\n    if (order) {\n      lastStatus = order.status;\n\n      log('Polled fiat order', {\n        orderStatus: order.status,\n        providerCode,\n        transactionId,\n      });\n\n      if (order.status === RampsOrderStatus.Completed) {\n        return order;\n      }\n\n      if (TERMINAL_FAILURE_STATUSES.includes(order.status)) {\n        throw new Error(`Fiat order ${order.status.toLowerCase()}`);\n      }\n    }\n\n    if (Date.now() - startTime >= pollTimeoutMs) {\n      throw new Error(\n        `Fiat order polling timed out (last status: ${lastStatus})`,\n      );\n    }\n\n    await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));\n  }\n}\n\n/**\n * Re-quotes and submits the relay leg using the settled amount from a completed fiat order.\n *\n * @param options - The submission options.\n * @param options.order - The completed on-ramp order containing the settled crypto amount.\n * @param options.request - The original fiat strategy execute request.\n * @returns An object containing the relay transaction hash if available.\n */\nasync function submitRelayAfterFiatCompletion({\n  order,\n  request,\n}: {\n  order: RampsOrder;\n  request: PayStrategyExecuteRequest<FiatQuote>;\n}): Promise<{ transactionHash?: Hex }> {\n  const { messenger, quotes, transaction } = request;\n  const transactionId = transaction.id;\n\n  if (quotes.length > 1) {\n    throw new Error('Multiple fiat quotes are not supported for submission');\n  }\n\n  const fiatQuote = quotes[0];\n  const isDirectMusd = isDirectMusdMoneyAccountQuote(fiatQuote);\n\n  if (isDirectMusd) {\n    validateOrderAsset({\n      expectedAsset: MUSD_MONAD_FIAT_ASSET,\n      orderCrypto: order.cryptoCurrency,\n      transactionId,\n    });\n\n    const sourceAmountRaw = await resolveSourceAmountRaw({\n      messenger,\n      order,\n      fiatAsset: MUSD_MONAD_FIAT_ASSET,\n      walletAddress: transaction.txParams.from as Hex,\n    });\n\n    return await submitDirectMusdVaultDeposit({\n      request,\n      sourceAmountRaw,\n      transaction,\n    });\n  }\n\n  const fiatAsset = deriveFiatAssetForFiatPayment(transaction, messenger);\n\n  validateOrderAsset({\n    expectedAsset: fiatAsset,\n    orderCrypto: order.cryptoCurrency,\n    transactionId,\n  });\n\n  const baseRequest = fiatQuote.request;\n\n  const sourceAmountRaw = await resolveSourceAmountRaw({\n    messenger,\n    order,\n    fiatAsset,\n    walletAddress: baseRequest.from,\n  });\n\n  if (!fiatQuote.original.relayQuote) {\n    throw new Error('Missing Relay quote for fiat submission');\n  }\n\n  const hasNestedCalldata = (transaction.nestedTransactions?.length ?? 0) >= 2;\n\n  // Transactions with nested calldata (e.g. moneyAccountDeposit with\n  // approve + deposit) need a three-phase flow: discovery quote to learn\n  // the target amount, calldata re-encoding, then a delegation quote.\n  // Simple deposits (Perps, Predict) skip straight to a single EXACT_INPUT\n  // relay quote — cheaper fees, no leftover dust, one fewer request.\n  if (hasNestedCalldata) {\n    return await submitWithTransactionData({\n      baseRequest,\n      request,\n      sourceAmountRaw,\n      transaction,\n    });\n  }\n\n  return await submitSimpleRelay({\n    baseRequest,\n    request,\n    sourceAmountRaw,\n    transaction,\n  });\n}\n\nfunction getWalletAddress({\n  quotes,\n  transaction,\n  accountOverride,\n}: {\n  quotes: PayStrategyExecuteRequest<FiatQuote>['quotes'];\n  transaction: PayStrategyExecuteRequest<FiatQuote>['transaction'];\n  accountOverride: Hex | undefined;\n}): Hex {\n  const address = isDirectMusdMoneyAccountQuote(quotes[0])\n    ? transaction.txParams.from\n    : (accountOverride ?? transaction.txParams.from);\n\n  if (!address) {\n    throw new Error('Missing wallet address for fiat submission');\n  }\n\n  return address as Hex;\n}\n"]}
+{"version":3,"file":"fiat-submit.mjs","sourceRoot":"","sources":["../../../src/strategy/fiat/fiat-submit.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RampsOrder } from '@metamask/ramps-controller';\nimport { RampsOrderStatus } from '@metamask/ramps-controller';\nimport type { Hex } from '@metamask/utils';\nimport { createModuleLogger } from '@metamask/utils';\n\nimport { projectLogger } from '../../logger';\nimport type {\n  PayStrategy,\n  PayStrategyExecuteRequest,\n  TransactionPayFiatOptions,\n  TransactionPayControllerMessenger,\n} from '../../types';\nimport { prefixError } from '../../utils/error-prefix';\nimport {\n  getFiatOrderPollIntervalMs,\n  getFiatOrderPollTimeoutMs,\n} from '../../utils/feature-flags';\nimport { updateTransaction } from '../../utils/transaction';\nimport {\n  isDirectMusdMoneyAccountQuote,\n  submitDirectMusdAfterFiatCompletion,\n} from './fiat-direct-musd';\nimport { submitSimpleRelay } from './fiat-submit-simple';\nimport { submitWithTransactionData } from './fiat-submit-with-transaction-data';\nimport { fundFiatOrderFromTestSource } from './fiat-test-funding';\nimport type { FiatQuote } from './types';\nimport {\n  deriveFiatAssetForFiatPayment,\n  extractProviderCode,\n  resolveSourceAmountRaw,\n  validateOrderAsset,\n} from './utils';\n\nconst log = createModuleLogger(projectLogger, 'fiat-submit');\nconst POST_RAMP_ERROR_PREFIX = 'Post-Ramp: ';\n\nconst TERMINAL_FAILURE_STATUSES: RampsOrderStatus[] = [\n  RampsOrderStatus.Cancelled,\n  RampsOrderStatus.Failed,\n  RampsOrderStatus.IdExpired,\n];\n\n/**\n * Submits fiat strategy quotes by polling the on-ramp order until completion,\n * then re-quoting and submitting the relay leg with the settled crypto amount.\n *\n * @param request - Strategy execute request containing fiat quotes, messenger, and transaction metadata.\n * @param request.messenger - Controller messenger for cross-controller calls.\n * @param request.quotes - Fiat quotes to execute (exactly one expected).\n * @param request.transaction - Original transaction metadata.\n * @param request.isSmartTransaction - Callback to check smart transaction eligibility.\n * @returns An object containing the relay transaction hash if available.\n */\nexport async function submitFiatQuotes(\n  request: PayStrategyExecuteRequest<FiatQuote>,\n): ReturnType<PayStrategy<FiatQuote>['execute']> {\n  const { messenger, transaction } = request;\n  const transactionId = transaction.id;\n  const state = messenger.call('TransactionPayController:getState');\n  const transactionData = state.transactionData[transactionId];\n\n  const walletAddress = getWalletAddress({\n    quotes: request.quotes,\n    transaction,\n    accountOverride: transactionData?.accountOverride,\n  });\n\n  const fiatPayment = transactionData?.fiatPayment;\n  const orderId = fiatPayment?.orderId;\n\n  if (!orderId) {\n    throw new Error('Missing order ID');\n  }\n\n  const providerCode = extractProviderCode(fiatPayment?.rampsQuote?.provider);\n\n  if (!providerCode) {\n    throw new Error('Missing provider code');\n  }\n\n  updateTransaction(\n    {\n      transactionId,\n      messenger,\n      note: 'Persist fiat order metadata',\n    },\n    (tx) => {\n      tx.metamaskPay ??= {};\n      tx.metamaskPay.fiat = { orderId, provider: providerCode };\n    },\n  );\n\n  log('Starting fiat order polling', {\n    orderId,\n    providerCode,\n    transactionId,\n  });\n\n  const fiatQuote = request.quotes[0];\n\n  if (!fiatQuote) {\n    throw new Error('Missing quote');\n  }\n\n  const fiatOptions = getFiatOptions(messenger);\n\n  const order = fiatOptions?.testFundingSource\n    ? await fundFiatOrderFromTestSource({\n        fiat: fiatOptions,\n        messenger,\n        quote: fiatQuote,\n        transaction,\n      })\n    : await waitForOrderCompletion({\n        messenger,\n        orderCode: orderId,\n        providerCode,\n        transactionId,\n        walletAddress,\n      });\n\n  log('Fiat order completed', {\n    cryptoAmount: order.cryptoAmount,\n    orderId,\n    transactionId,\n  });\n\n  try {\n    const result = await submitRelayAfterFiatCompletion({ order, request });\n\n    if (result.transactionHash === undefined) {\n      throw new Error('Missing transaction hash');\n    }\n\n    return result;\n  } catch (error) {\n    throw prefixError(error, POST_RAMP_ERROR_PREFIX);\n  }\n}\n\nfunction getFiatOptions(\n  messenger: TransactionPayControllerMessenger,\n): TransactionPayFiatOptions | undefined {\n  try {\n    return messenger.call('TransactionPayController:getFiatOptions');\n  } catch (error) {\n    log('Failed to retrieve fiat options', error);\n    return undefined;\n  }\n}\n\n/**\n * Polls the on-ramp order until it reaches a terminal status.\n *\n * @param options - The polling options.\n * @param options.messenger - Controller messenger for calling `RampsController:getOrder`.\n * @param options.orderCode - The order identifier within the provider.\n * @param options.providerCode - The on-ramp provider code (e.g. \"transak\").\n * @param options.transactionId - Transaction ID for logging.\n * @param options.walletAddress - Wallet address associated with the order.\n * @returns The completed order data.\n */\nasync function waitForOrderCompletion({\n  messenger,\n  orderCode,\n  providerCode,\n  transactionId,\n  walletAddress,\n}: {\n  messenger: TransactionPayControllerMessenger;\n  orderCode: string;\n  providerCode: string;\n  transactionId: string;\n  walletAddress: string;\n}): Promise<RampsOrder> {\n  const pollIntervalMs = getFiatOrderPollIntervalMs(messenger);\n  const pollTimeoutMs = getFiatOrderPollTimeoutMs(messenger);\n  const startTime = Date.now();\n  let lastStatus: string | undefined;\n\n  while (true) {\n    let order: RampsOrder | undefined;\n\n    try {\n      order = await messenger.call(\n        'RampsController:getOrder',\n        providerCode,\n        orderCode,\n        walletAddress,\n      );\n    } catch (error) {\n      log('Order polling network error', error);\n    }\n\n    if (order) {\n      lastStatus = order.status;\n\n      log('Polled fiat order', {\n        orderStatus: order.status,\n        providerCode,\n        transactionId,\n      });\n\n      if (order.status === RampsOrderStatus.Completed) {\n        return order;\n      }\n\n      if (TERMINAL_FAILURE_STATUSES.includes(order.status)) {\n        throw new Error(`Fiat order ${order.status.toLowerCase()}`);\n      }\n    }\n\n    if (Date.now() - startTime >= pollTimeoutMs) {\n      throw new Error(\n        `Fiat order polling timed out (last status: ${lastStatus})`,\n      );\n    }\n\n    await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));\n  }\n}\n\n/**\n * Re-quotes and submits the relay leg using the settled amount from a completed fiat order.\n *\n * @param options - The submission options.\n * @param options.order - The completed on-ramp order containing the settled crypto amount.\n * @param options.request - The original fiat strategy execute request.\n * @returns An object containing the relay transaction hash if available.\n */\nasync function submitRelayAfterFiatCompletion({\n  order,\n  request,\n}: {\n  order: RampsOrder;\n  request: PayStrategyExecuteRequest<FiatQuote>;\n}): Promise<{ transactionHash?: Hex }> {\n  const { messenger, quotes, transaction } = request;\n  const transactionId = transaction.id;\n\n  if (quotes.length > 1) {\n    throw new Error('Multiple fiat quotes are not supported for submission');\n  }\n\n  const fiatQuote = quotes[0];\n  const isDirectMusd = isDirectMusdMoneyAccountQuote(fiatQuote);\n\n  if (isDirectMusd) {\n    return await submitDirectMusdAfterFiatCompletion({ order, request });\n  }\n\n  const fiatAsset = deriveFiatAssetForFiatPayment(transaction, messenger);\n\n  validateOrderAsset({\n    expectedAsset: fiatAsset,\n    orderCrypto: order.cryptoCurrency,\n    transactionId,\n  });\n\n  const baseRequest = fiatQuote.request;\n\n  const sourceAmountRaw = await resolveSourceAmountRaw({\n    messenger,\n    order,\n    fiatAsset,\n    walletAddress: baseRequest.from,\n  });\n\n  if (!fiatQuote.original.relayQuote) {\n    throw new Error('Missing Relay quote');\n  }\n\n  const hasNestedCalldata = (transaction.nestedTransactions?.length ?? 0) >= 2;\n\n  // Transactions with nested calldata (e.g. moneyAccountDeposit with\n  // approve + deposit) need a three-phase flow: discovery quote to learn\n  // the target amount, calldata re-encoding, then a delegation quote.\n  // Simple deposits (Perps, Predict) skip straight to a single EXACT_INPUT\n  // relay quote — cheaper fees, no leftover dust, one fewer request.\n  if (hasNestedCalldata) {\n    return await submitWithTransactionData({\n      baseRequest,\n      request,\n      sourceAmountRaw,\n      transaction,\n    });\n  }\n\n  return await submitSimpleRelay({\n    baseRequest,\n    request,\n    sourceAmountRaw,\n    transaction,\n  });\n}\n\nfunction getWalletAddress({\n  quotes,\n  transaction,\n  accountOverride,\n}: {\n  quotes: PayStrategyExecuteRequest<FiatQuote>['quotes'];\n  transaction: PayStrategyExecuteRequest<FiatQuote>['transaction'];\n  accountOverride: Hex | undefined;\n}): Hex {\n  const address = isDirectMusdMoneyAccountQuote(quotes[0])\n    ? transaction.txParams.from\n    : (accountOverride ?? transaction.txParams.from);\n\n  if (!address) {\n    throw new Error('Missing wallet address');\n  }\n\n  return address as Hex;\n}\n"]}

package/dist/strategy/fiat/utils.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractProviderCode = exports.validateRelayRateDrift = exports.getRawSourceAmountFromOrderCryptoAmount = exports.resolveSourceAmountRaw = exports.getRampsQuote = exports.isMoneyAccountDepositTransaction = exports.resolveTransactionType = exports.deriveFiatAssetForFiatPayment = void 0;
+exports.extractProviderCode = exports.validateRelayRateDrift = exports.getRawSourceAmountFromOrderCryptoAmount = exports.resolveSourceAmountRaw = exports.validateOrderAsset = exports.getRampsQuote = exports.isMoneyAccountDepositTransaction = exports.resolveTransactionType = exports.deriveFiatAssetForFiatPayment = void 0;
 const transaction_controller_1 = require("@metamask/transaction-controller");
 const utils_1 = require("@metamask/utils");
 const bignumber_js_1 = require("bignumber.js");
@@ -84,6 +84,29 @@ async function getRampsQuote({ adjustedAmount, errorMessage = 'No matching ramps
     return quote;
 }
 exports.getRampsQuote = getRampsQuote;
+/**
+ * Validates that a completed order's crypto asset matches the expected fiat asset.
+ *
+ * @param options - The validation options.
+ * @param options.expectedAsset - The expected fiat asset derived from the transaction type.
+ * @param options.orderCrypto - The crypto currency information from the completed order.
+ * @param options.transactionId - Transaction ID for error reporting.
+ */
+function validateOrderAsset({ expectedAsset, orderCrypto, transactionId, }) {
+    const orderAssetId = orderCrypto?.assetId?.toLowerCase();
+    const expectedAssetId = (0, token_1.buildCaipAssetType)(expectedAsset.chainId, expectedAsset.address).toLowerCase();
+    const expectedChainId = expectedAssetId.split('/')[0];
+    const orderChainId = orderCrypto?.chainId?.toLowerCase();
+    if (orderAssetId && orderAssetId !== expectedAssetId) {
+        throw new Error(`Order asset mismatch for transaction ${transactionId}: ` +
+            `expected ${expectedAssetId}, got ${orderAssetId}`);
+    }
+    if (orderChainId && orderChainId !== expectedChainId) {
+        throw new Error(`Order chain mismatch for transaction ${transactionId}: ` +
+            `expected ${expectedChainId}, got ${orderChainId}`);
+    }
+}
+exports.validateOrderAsset = validateOrderAsset;
 /**
  * Resolves the raw source amount for a completed fiat order.
  *

package/dist/strategy/fiat/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","sourceRoot":"","sources":["../../../src/strategy/fiat/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  Quote as RampsQuote,\n  RampsOrder,\n} from '@metamask/ramps-controller';\nimport type { TransactionMeta } from '@metamask/transaction-controller';\nimport { TransactionType } from '@metamask/transaction-controller';\nimport type { Hex } from '@metamask/utils';\nimport { createModuleLogger } from '@metamask/utils';\nimport { BigNumber } from 'bignumber.js';\n\nimport { projectLogger } from '../../logger';\nimport type { TransactionPayControllerMessenger } from '../../types';\nimport {\n  getFiatAssetPerTransactionType,\n  getFiatEnabledTypes,\n} from '../../utils/feature-flags';\nimport { buildCaipAssetType, getTokenInfo } from '../../utils/token';\nimport { getTransferredAmountFromTxHash } from '../../utils/transaction';\nimport type { RelayQuote } from '../relay/types';\nimport type { TransactionPayFiatAsset } from './constants';\nimport { DEFAULT_FIAT_CURRENCY, FIAT_ENABLED_TYPES } from './constants';\n\nconst log = createModuleLogger(projectLogger, 'fiat-utils');\n\nexport function deriveFiatAssetForFiatPayment(\n  transaction: TransactionMeta,\n  messenger: TransactionPayControllerMessenger,\n): TransactionPayFiatAsset {\n  const enabledTypes = getFiatEnabledTypes(messenger);\n  const txType = resolveTransactionType(transaction, enabledTypes);\n\n  return getFiatAssetPerTransactionType(messenger, txType);\n}\n\n/**\n * Resolves the effective transaction type for fiat strategy purposes.\n *\n * For non-batch transactions returns the transaction's own type.\n * For batch transactions returns the first nested transaction type\n * that appears in the enabled types list, or the batch type itself\n * if no nested type matches.\n *\n * @param transaction - The transaction metadata to inspect.\n * @param enabledTypes - Transaction types eligible for fiat payment.\n * @returns The resolved transaction type, or `undefined`.\n */\nexport function resolveTransactionType(\n  transaction: TransactionMeta,\n  enabledTypes: TransactionType[],\n): TransactionType | undefined {\n  if (transaction.type !== TransactionType.batch) {\n    return transaction.type;\n  }\n\n  const nestedType = transaction.nestedTransactions?.find(\n    (tx) => tx.type && enabledTypes.includes(tx.type),\n  )?.type;\n\n  return nestedType ?? transaction.type;\n}\n\n/**\n * Checks whether a transaction is a Money Account deposit.\n *\n * Handles both direct `moneyAccountDeposit` transactions and EIP-7702\n * batch transactions that contain a `moneyAccountDeposit` nested call.\n * Uses {@link resolveTransactionType} with `FIAT_ENABLED_TYPES` to\n * correctly skip non-deposit nested types (e.g. `tokenMethodApprove`).\n *\n * @param transaction - The transaction metadata to inspect.\n * @returns `true` if the transaction is a Money Account deposit.\n */\nexport function isMoneyAccountDepositTransaction(\n  transaction: TransactionMeta,\n): boolean {\n  return (\n    resolveTransactionType(transaction, FIAT_ENABLED_TYPES) ===\n    TransactionType.moneyAccountDeposit\n  );\n}\n\n/**\n * Fetches the first matching Ramps quote for a fiat asset and payment method.\n *\n * @param options - Quote options.\n * @param options.adjustedAmount - Fiat amount sent to Ramps.\n * @param options.errorMessage - Error thrown when no matching quote is returned.\n * @param options.fiatAsset - Fiat asset to buy.\n * @param options.fiatPaymentMethod - Selected fiat payment method.\n * @param options.messenger - Controller messenger.\n * @param options.walletAddress - Wallet address that receives the on-ramped asset.\n * @returns The first matching Ramps quote.\n */\nexport async function getRampsQuote({\n  adjustedAmount,\n  errorMessage = 'No matching ramps quote found for selected provider',\n  fiatAsset,\n  fiatPaymentMethod,\n  messenger,\n  walletAddress,\n}: {\n  adjustedAmount: number;\n  errorMessage?: string;\n  fiatAsset: TransactionPayFiatAsset;\n  fiatPaymentMethod: string;\n  messenger: TransactionPayControllerMessenger;\n  walletAddress: string;\n}): Promise<RampsQuote> {\n  const quotes = await messenger.call('RampsController:getQuotes', {\n    amount: adjustedAmount,\n    assetId: buildCaipAssetType(fiatAsset.chainId, fiatAsset.address),\n    autoSelectProvider: true,\n    fiat: DEFAULT_FIAT_CURRENCY,\n    paymentMethods: [fiatPaymentMethod],\n    restrictToKnownOrNativeProviders: true,\n    walletAddress,\n  });\n\n  log('Fetched ramps quotes', {\n    quotesCount: quotes.success?.length ?? 0,\n  });\n\n  const quote = quotes.success?.[0];\n\n  if (!quote) {\n    throw new Error(errorMessage);\n  }\n\n  return quote;\n}\n\n/**\n * Resolves the raw source amount for a completed fiat order.\n *\n * Attempts to read the actual transferred amount from the on-chain transaction\n * identified by `order.txHash`. If the on-chain read fails or returns\n * no amount, falls back to computing the amount from `order.cryptoAmount`.\n *\n * @param options - The resolution options.\n * @param options.messenger - Controller messenger for network access.\n * @param options.order - The completed on-ramp order.\n * @param options.fiatAsset - The fiat asset describing the expected token.\n * @param options.walletAddress - Recipient wallet address for on-chain lookup.\n * @returns The raw (atomic) source amount as a decimal string.\n */\nexport async function resolveSourceAmountRaw({\n  messenger,\n  order,\n  fiatAsset,\n  walletAddress,\n}: {\n  messenger: TransactionPayControllerMessenger;\n  order: RampsOrder;\n  fiatAsset: TransactionPayFiatAsset;\n  walletAddress: Hex;\n}): Promise<string> {\n  if (order.txHash) {\n    try {\n      const onChainAmount = await getTransferredAmountFromTxHash({\n        messenger,\n        txHash: order.txHash,\n        chainId: fiatAsset.chainId,\n        tokenAddress: fiatAsset.address,\n        walletAddress,\n      });\n\n      if (onChainAmount) {\n        log('Resolved source amount from on-chain transaction', {\n          txHash: order.txHash,\n          onChainAmount,\n        });\n        return onChainAmount;\n      }\n    } catch (error) {\n      log(\n        'Failed to read on-chain amount, falling back to order.cryptoAmount',\n        { txHash: order.txHash, error },\n      );\n    }\n  }\n\n  const tokenInfo = getTokenInfo(\n    messenger,\n    fiatAsset.address,\n    fiatAsset.chainId,\n  );\n\n  if (!tokenInfo) {\n    throw new Error(\n      `Unable to resolve token info for fiat asset ${fiatAsset.address} on chain ${fiatAsset.chainId}`,\n    );\n  }\n\n  return getRawSourceAmountFromOrderCryptoAmount({\n    cryptoAmount: order.cryptoAmount,\n    decimals: tokenInfo.decimals,\n  });\n}\n\n/**\n * Converts the order's human-readable crypto amount to a raw token amount.\n *\n * @param options - The conversion options.\n * @param options.cryptoAmount - Human-readable crypto amount from the completed order.\n * @param options.decimals - Token decimals for the fiat asset.\n * @returns The raw token amount as a string.\n */\nexport function getRawSourceAmountFromOrderCryptoAmount({\n  cryptoAmount,\n  decimals,\n}: {\n  cryptoAmount: RampsOrder['cryptoAmount'];\n  decimals: number;\n}): string {\n  const normalizedAmount = new BigNumber(String(cryptoAmount));\n\n  if (!normalizedAmount.isFinite() || normalizedAmount.lte(0)) {\n    throw new Error(\n      `Invalid fiat order crypto amount: ${String(cryptoAmount)}`,\n    );\n  }\n\n  const rawAmount = normalizedAmount\n    .shiftedBy(decimals)\n    .decimalPlaces(0, BigNumber.ROUND_DOWN)\n    .toFixed(0);\n\n  if (!new BigNumber(rawAmount).gt(0)) {\n    throw new Error('Computed fiat order source amount is not positive');\n  }\n\n  return rawAmount;\n}\n\n/**\n * Validates that the relay exchange rate hasn't drifted significantly between\n * the original quoting phase and the post-settlement discovery quote.\n *\n * Compares the USD output/input ratio from both quotes. This normalises for\n * different source amounts (quoting phase uses a theoretical amount, discovery\n * uses the actual settled amount) so the comparison reflects genuine rate\n * movement rather than amount differences.\n *\n * @param options - The validation options.\n * @param options.originalQuote - Relay quote from the original quoting phase.\n * @param options.discoveryQuote - Relay quote from the post-settlement discovery.\n * @param options.maxRateDriftPercent - Maximum allowed rate drift percentage.\n * @param options.transactionId - Transaction ID for error reporting.\n */\nexport function validateRelayRateDrift({\n  originalQuote,\n  discoveryQuote,\n  maxRateDriftPercent,\n  transactionId,\n}: {\n  originalQuote: RelayQuote;\n  discoveryQuote: RelayQuote;\n  maxRateDriftPercent: number;\n  transactionId: string;\n}): void {\n  const originalIn = new BigNumber(originalQuote.details.currencyIn.amountUsd);\n  const originalOut = new BigNumber(\n    originalQuote.details.currencyOut.amountUsd,\n  );\n  const discoveryIn = new BigNumber(\n    discoveryQuote.details.currencyIn.amountUsd,\n  );\n  const discoveryOut = new BigNumber(\n    discoveryQuote.details.currencyOut.amountUsd,\n  );\n\n  if (\n    !originalIn.gt(0) ||\n    !originalOut.gt(0) ||\n    !discoveryIn.gt(0) ||\n    !discoveryOut.gt(0)\n  ) {\n    return;\n  }\n\n  const originalRate = originalOut.dividedBy(originalIn);\n  const discoveryRate = discoveryOut.dividedBy(discoveryIn);\n\n  const driftPercent = originalRate\n    .minus(discoveryRate)\n    .dividedBy(originalRate)\n    .multipliedBy(100);\n\n  log('Relay rate drift check', {\n    originalRate: originalRate.toFixed(6),\n    discoveryRate: discoveryRate.toFixed(6),\n    driftPercent: driftPercent.toFixed(2),\n    maxRateDriftPercent,\n    transactionId,\n  });\n\n  if (driftPercent.gt(maxRateDriftPercent)) {\n    throw new Error(\n      `Relay rate drift too high for transaction ` +\n        `${driftPercent.toFixed(2)}% exceeds ${maxRateDriftPercent}% max`,\n    );\n  }\n}\n\n/**\n * Extracts the provider code from a ramps provider string.\n *\n * Accepts the canonical provider code (e.g. `transak-native`) and, for\n * backwards compatibility, the legacy path form (e.g. `/providers/transak-native`).\n *\n * @param provider - Canonical provider code, or legacy provider path.\n * @returns The provider code, or `null` if the format is invalid.\n */\nexport function extractProviderCode(\n  provider: string | undefined,\n): string | null {\n  if (!provider) {\n    return null;\n  }\n\n  const parts = provider.split('/').filter(Boolean);\n\n  if (parts[0] === 'providers') {\n    return parts[1] ?? null;\n  }\n\n  return parts.length === 1 ? parts[0] : null;\n}\n"]}
+{"version":3,"file":"utils.cjs","sourceRoot":"","sources":["../../../src/strategy/fiat/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  Quote as RampsQuote,\n  RampsOrder,\n  RampsOrderCryptoCurrency,\n} from '@metamask/ramps-controller';\nimport type { TransactionMeta } from '@metamask/transaction-controller';\nimport { TransactionType } from '@metamask/transaction-controller';\nimport type { Hex } from '@metamask/utils';\nimport { createModuleLogger } from '@metamask/utils';\nimport { BigNumber } from 'bignumber.js';\n\nimport { projectLogger } from '../../logger';\nimport type { TransactionPayControllerMessenger } from '../../types';\nimport {\n  getFiatAssetPerTransactionType,\n  getFiatEnabledTypes,\n} from '../../utils/feature-flags';\nimport { buildCaipAssetType, getTokenInfo } from '../../utils/token';\nimport { getTransferredAmountFromTxHash } from '../../utils/transaction';\nimport type { RelayQuote } from '../relay/types';\nimport type { TransactionPayFiatAsset } from './constants';\nimport { DEFAULT_FIAT_CURRENCY, FIAT_ENABLED_TYPES } from './constants';\n\nconst log = createModuleLogger(projectLogger, 'fiat-utils');\n\nexport function deriveFiatAssetForFiatPayment(\n  transaction: TransactionMeta,\n  messenger: TransactionPayControllerMessenger,\n): TransactionPayFiatAsset {\n  const enabledTypes = getFiatEnabledTypes(messenger);\n  const txType = resolveTransactionType(transaction, enabledTypes);\n\n  return getFiatAssetPerTransactionType(messenger, txType);\n}\n\n/**\n * Resolves the effective transaction type for fiat strategy purposes.\n *\n * For non-batch transactions returns the transaction's own type.\n * For batch transactions returns the first nested transaction type\n * that appears in the enabled types list, or the batch type itself\n * if no nested type matches.\n *\n * @param transaction - The transaction metadata to inspect.\n * @param enabledTypes - Transaction types eligible for fiat payment.\n * @returns The resolved transaction type, or `undefined`.\n */\nexport function resolveTransactionType(\n  transaction: TransactionMeta,\n  enabledTypes: TransactionType[],\n): TransactionType | undefined {\n  if (transaction.type !== TransactionType.batch) {\n    return transaction.type;\n  }\n\n  const nestedType = transaction.nestedTransactions?.find(\n    (tx) => tx.type && enabledTypes.includes(tx.type),\n  )?.type;\n\n  return nestedType ?? transaction.type;\n}\n\n/**\n * Checks whether a transaction is a Money Account deposit.\n *\n * Handles both direct `moneyAccountDeposit` transactions and EIP-7702\n * batch transactions that contain a `moneyAccountDeposit` nested call.\n * Uses {@link resolveTransactionType} with `FIAT_ENABLED_TYPES` to\n * correctly skip non-deposit nested types (e.g. `tokenMethodApprove`).\n *\n * @param transaction - The transaction metadata to inspect.\n * @returns `true` if the transaction is a Money Account deposit.\n */\nexport function isMoneyAccountDepositTransaction(\n  transaction: TransactionMeta,\n): boolean {\n  return (\n    resolveTransactionType(transaction, FIAT_ENABLED_TYPES) ===\n    TransactionType.moneyAccountDeposit\n  );\n}\n\n/**\n * Fetches the first matching Ramps quote for a fiat asset and payment method.\n *\n * @param options - Quote options.\n * @param options.adjustedAmount - Fiat amount sent to Ramps.\n * @param options.errorMessage - Error thrown when no matching quote is returned.\n * @param options.fiatAsset - Fiat asset to buy.\n * @param options.fiatPaymentMethod - Selected fiat payment method.\n * @param options.messenger - Controller messenger.\n * @param options.walletAddress - Wallet address that receives the on-ramped asset.\n * @returns The first matching Ramps quote.\n */\nexport async function getRampsQuote({\n  adjustedAmount,\n  errorMessage = 'No matching ramps quote found for selected provider',\n  fiatAsset,\n  fiatPaymentMethod,\n  messenger,\n  walletAddress,\n}: {\n  adjustedAmount: number;\n  errorMessage?: string;\n  fiatAsset: TransactionPayFiatAsset;\n  fiatPaymentMethod: string;\n  messenger: TransactionPayControllerMessenger;\n  walletAddress: string;\n}): Promise<RampsQuote> {\n  const quotes = await messenger.call('RampsController:getQuotes', {\n    amount: adjustedAmount,\n    assetId: buildCaipAssetType(fiatAsset.chainId, fiatAsset.address),\n    autoSelectProvider: true,\n    fiat: DEFAULT_FIAT_CURRENCY,\n    paymentMethods: [fiatPaymentMethod],\n    restrictToKnownOrNativeProviders: true,\n    walletAddress,\n  });\n\n  log('Fetched ramps quotes', {\n    quotesCount: quotes.success?.length ?? 0,\n  });\n\n  const quote = quotes.success?.[0];\n\n  if (!quote) {\n    throw new Error(errorMessage);\n  }\n\n  return quote;\n}\n\n/**\n * Validates that a completed order's crypto asset matches the expected fiat asset.\n *\n * @param options - The validation options.\n * @param options.expectedAsset - The expected fiat asset derived from the transaction type.\n * @param options.orderCrypto - The crypto currency information from the completed order.\n * @param options.transactionId - Transaction ID for error reporting.\n */\nexport function validateOrderAsset({\n  expectedAsset,\n  orderCrypto,\n  transactionId,\n}: {\n  expectedAsset: TransactionPayFiatAsset;\n  orderCrypto: RampsOrderCryptoCurrency | undefined;\n  transactionId: string;\n}): void {\n  const orderAssetId = orderCrypto?.assetId?.toLowerCase();\n  const expectedAssetId = buildCaipAssetType(\n    expectedAsset.chainId,\n    expectedAsset.address,\n  ).toLowerCase();\n  const expectedChainId = expectedAssetId.split('/')[0];\n  const orderChainId = orderCrypto?.chainId?.toLowerCase();\n\n  if (orderAssetId && orderAssetId !== expectedAssetId) {\n    throw new Error(\n      `Order asset mismatch for transaction ${transactionId}: ` +\n        `expected ${expectedAssetId}, got ${orderAssetId}`,\n    );\n  }\n\n  if (orderChainId && orderChainId !== expectedChainId) {\n    throw new Error(\n      `Order chain mismatch for transaction ${transactionId}: ` +\n        `expected ${expectedChainId}, got ${orderChainId}`,\n    );\n  }\n}\n\n/**\n * Resolves the raw source amount for a completed fiat order.\n *\n * Attempts to read the actual transferred amount from the on-chain transaction\n * identified by `order.txHash`. If the on-chain read fails or returns\n * no amount, falls back to computing the amount from `order.cryptoAmount`.\n *\n * @param options - The resolution options.\n * @param options.messenger - Controller messenger for network access.\n * @param options.order - The completed on-ramp order.\n * @param options.fiatAsset - The fiat asset describing the expected token.\n * @param options.walletAddress - Recipient wallet address for on-chain lookup.\n * @returns The raw (atomic) source amount as a decimal string.\n */\nexport async function resolveSourceAmountRaw({\n  messenger,\n  order,\n  fiatAsset,\n  walletAddress,\n}: {\n  messenger: TransactionPayControllerMessenger;\n  order: RampsOrder;\n  fiatAsset: TransactionPayFiatAsset;\n  walletAddress: Hex;\n}): Promise<string> {\n  if (order.txHash) {\n    try {\n      const onChainAmount = await getTransferredAmountFromTxHash({\n        messenger,\n        txHash: order.txHash,\n        chainId: fiatAsset.chainId,\n        tokenAddress: fiatAsset.address,\n        walletAddress,\n      });\n\n      if (onChainAmount) {\n        log('Resolved source amount from on-chain transaction', {\n          txHash: order.txHash,\n          onChainAmount,\n        });\n        return onChainAmount;\n      }\n    } catch (error) {\n      log(\n        'Failed to read on-chain amount, falling back to order.cryptoAmount',\n        { txHash: order.txHash, error },\n      );\n    }\n  }\n\n  const tokenInfo = getTokenInfo(\n    messenger,\n    fiatAsset.address,\n    fiatAsset.chainId,\n  );\n\n  if (!tokenInfo) {\n    throw new Error(\n      `Unable to resolve token info for fiat asset ${fiatAsset.address} on chain ${fiatAsset.chainId}`,\n    );\n  }\n\n  return getRawSourceAmountFromOrderCryptoAmount({\n    cryptoAmount: order.cryptoAmount,\n    decimals: tokenInfo.decimals,\n  });\n}\n\n/**\n * Converts the order's human-readable crypto amount to a raw token amount.\n *\n * @param options - The conversion options.\n * @param options.cryptoAmount - Human-readable crypto amount from the completed order.\n * @param options.decimals - Token decimals for the fiat asset.\n * @returns The raw token amount as a string.\n */\nexport function getRawSourceAmountFromOrderCryptoAmount({\n  cryptoAmount,\n  decimals,\n}: {\n  cryptoAmount: RampsOrder['cryptoAmount'];\n  decimals: number;\n}): string {\n  const normalizedAmount = new BigNumber(String(cryptoAmount));\n\n  if (!normalizedAmount.isFinite() || normalizedAmount.lte(0)) {\n    throw new Error(\n      `Invalid fiat order crypto amount: ${String(cryptoAmount)}`,\n    );\n  }\n\n  const rawAmount = normalizedAmount\n    .shiftedBy(decimals)\n    .decimalPlaces(0, BigNumber.ROUND_DOWN)\n    .toFixed(0);\n\n  if (!new BigNumber(rawAmount).gt(0)) {\n    throw new Error('Computed fiat order source amount is not positive');\n  }\n\n  return rawAmount;\n}\n\n/**\n * Validates that the relay exchange rate hasn't drifted significantly between\n * the original quoting phase and the post-settlement discovery quote.\n *\n * Compares the USD output/input ratio from both quotes. This normalises for\n * different source amounts (quoting phase uses a theoretical amount, discovery\n * uses the actual settled amount) so the comparison reflects genuine rate\n * movement rather than amount differences.\n *\n * @param options - The validation options.\n * @param options.originalQuote - Relay quote from the original quoting phase.\n * @param options.discoveryQuote - Relay quote from the post-settlement discovery.\n * @param options.maxRateDriftPercent - Maximum allowed rate drift percentage.\n * @param options.transactionId - Transaction ID for error reporting.\n */\nexport function validateRelayRateDrift({\n  originalQuote,\n  discoveryQuote,\n  maxRateDriftPercent,\n  transactionId,\n}: {\n  originalQuote: RelayQuote;\n  discoveryQuote: RelayQuote;\n  maxRateDriftPercent: number;\n  transactionId: string;\n}): void {\n  const originalIn = new BigNumber(originalQuote.details.currencyIn.amountUsd);\n  const originalOut = new BigNumber(\n    originalQuote.details.currencyOut.amountUsd,\n  );\n  const discoveryIn = new BigNumber(\n    discoveryQuote.details.currencyIn.amountUsd,\n  );\n  const discoveryOut = new BigNumber(\n    discoveryQuote.details.currencyOut.amountUsd,\n  );\n\n  if (\n    !originalIn.gt(0) ||\n    !originalOut.gt(0) ||\n    !discoveryIn.gt(0) ||\n    !discoveryOut.gt(0)\n  ) {\n    return;\n  }\n\n  const originalRate = originalOut.dividedBy(originalIn);\n  const discoveryRate = discoveryOut.dividedBy(discoveryIn);\n\n  const driftPercent = originalRate\n    .minus(discoveryRate)\n    .dividedBy(originalRate)\n    .multipliedBy(100);\n\n  log('Relay rate drift check', {\n    originalRate: originalRate.toFixed(6),\n    discoveryRate: discoveryRate.toFixed(6),\n    driftPercent: driftPercent.toFixed(2),\n    maxRateDriftPercent,\n    transactionId,\n  });\n\n  if (driftPercent.gt(maxRateDriftPercent)) {\n    throw new Error(\n      `Relay rate drift too high for transaction ` +\n        `${driftPercent.toFixed(2)}% exceeds ${maxRateDriftPercent}% max`,\n    );\n  }\n}\n\n/**\n * Extracts the provider code from a ramps provider string.\n *\n * Accepts the canonical provider code (e.g. `transak-native`) and, for\n * backwards compatibility, the legacy path form (e.g. `/providers/transak-native`).\n *\n * @param provider - Canonical provider code, or legacy provider path.\n * @returns The provider code, or `null` if the format is invalid.\n */\nexport function extractProviderCode(\n  provider: string | undefined,\n): string | null {\n  if (!provider) {\n    return null;\n  }\n\n  const parts = provider.split('/').filter(Boolean);\n\n  if (parts[0] === 'providers') {\n    return parts[1] ?? null;\n  }\n\n  return parts.length === 1 ? parts[0] : null;\n}\n"]}

package/dist/strategy/fiat/utils.d.cts

@@ -1,4 +1,4 @@
-import type { Quote as RampsQuote, RampsOrder } from "@metamask/ramps-controller";
+import type { Quote as RampsQuote, RampsOrder, RampsOrderCryptoCurrency } from "@metamask/ramps-controller";
 import type { TransactionMeta } from "@metamask/transaction-controller";
 import { TransactionType } from "@metamask/transaction-controller";
 import type { Hex } from "@metamask/utils";
@@ -51,6 +51,19 @@ export declare function getRampsQuote({ adjustedAmount, errorMessage, fiatAsset,
     messenger: TransactionPayControllerMessenger;
     walletAddress: string;
 }): Promise<RampsQuote>;
+/**
+ * Validates that a completed order's crypto asset matches the expected fiat asset.
+ *
+ * @param options - The validation options.
+ * @param options.expectedAsset - The expected fiat asset derived from the transaction type.
+ * @param options.orderCrypto - The crypto currency information from the completed order.
+ * @param options.transactionId - Transaction ID for error reporting.
+ */
+export declare function validateOrderAsset({ expectedAsset, orderCrypto, transactionId, }: {
+    expectedAsset: TransactionPayFiatAsset;
+    orderCrypto: RampsOrderCryptoCurrency | undefined;
+    transactionId: string;
+}): void;
 /**
  * Resolves the raw source amount for a completed fiat order.
  *

package/dist/strategy/fiat/utils.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../../../src/strategy/fiat/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,IAAI,UAAU,EACnB,UAAU,EACX,mCAAmC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AACxE,OAAO,EAAE,eAAe,EAAE,yCAAyC;AACnE,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAK3C,OAAO,KAAK,EAAE,iCAAiC,EAAE,wBAAoB;AAOrE,OAAO,KAAK,EAAE,UAAU,EAAE,2BAAuB;AACjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,wBAAoB;AAK3D,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,eAAe,EAC5B,SAAS,EAAE,iCAAiC,GAC3C,uBAAuB,CAKzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,eAAe,EAC5B,YAAY,EAAE,eAAe,EAAE,GAC9B,eAAe,GAAG,SAAS,CAU7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,eAAe,GAC3B,OAAO,CAKT;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,EAClC,cAAc,EACd,YAAoE,EACpE,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,aAAa,GACd,EAAE;IACD,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,uBAAuB,CAAC;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,iCAAiC,CAAC;IAC7C,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,SAAS,EACT,KAAK,EACL,SAAS,EACT,aAAa,GACd,EAAE;IACD,SAAS,EAAE,iCAAiC,CAAC;IAC7C,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,uBAAuB,CAAC;IACnC,aAAa,EAAE,GAAG,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0ClB;AAED;;;;;;;GAOG;AACH,wBAAgB,uCAAuC,CAAC,EACtD,YAAY,EACZ,QAAQ,GACT,EAAE;IACD,YAAY,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAmBT;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,aAAa,GACd,EAAE;IACD,aAAa,EAAE,UAAU,CAAC;IAC1B,cAAc,EAAE,UAAU,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,IAAI,CA2CP;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,IAAI,CAYf"}
+{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../../../src/strategy/fiat/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,IAAI,UAAU,EACnB,UAAU,EACV,wBAAwB,EACzB,mCAAmC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AACxE,OAAO,EAAE,eAAe,EAAE,yCAAyC;AACnE,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAK3C,OAAO,KAAK,EAAE,iCAAiC,EAAE,wBAAoB;AAOrE,OAAO,KAAK,EAAE,UAAU,EAAE,2BAAuB;AACjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,wBAAoB;AAK3D,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,eAAe,EAC5B,SAAS,EAAE,iCAAiC,GAC3C,uBAAuB,CAKzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,eAAe,EAC5B,YAAY,EAAE,eAAe,EAAE,GAC9B,eAAe,GAAG,SAAS,CAU7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,eAAe,GAC3B,OAAO,CAKT;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,EAClC,cAAc,EACd,YAAoE,EACpE,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,aAAa,GACd,EAAE;IACD,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,uBAAuB,CAAC;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,iCAAiC,CAAC;IAC7C,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBtB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,aAAa,EACb,WAAW,EACX,aAAa,GACd,EAAE;IACD,aAAa,EAAE,uBAAuB,CAAC;IACvC,WAAW,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAClD,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,IAAI,CAsBP;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,SAAS,EACT,KAAK,EACL,SAAS,EACT,aAAa,GACd,EAAE;IACD,SAAS,EAAE,iCAAiC,CAAC;IAC7C,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,uBAAuB,CAAC;IACnC,aAAa,EAAE,GAAG,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0ClB;AAED;;;;;;;GAOG;AACH,wBAAgB,uCAAuC,CAAC,EACtD,YAAY,EACZ,QAAQ,GACT,EAAE;IACD,YAAY,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAmBT;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,aAAa,GACd,EAAE;IACD,aAAa,EAAE,UAAU,CAAC;IAC1B,cAAc,EAAE,UAAU,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,IAAI,CA2CP;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,IAAI,CAYf"}

package/dist/strategy/fiat/utils.d.mts

@@ -1,4 +1,4 @@
-import type { Quote as RampsQuote, RampsOrder } from "@metamask/ramps-controller";
+import type { Quote as RampsQuote, RampsOrder, RampsOrderCryptoCurrency } from "@metamask/ramps-controller";
 import type { TransactionMeta } from "@metamask/transaction-controller";
 import { TransactionType } from "@metamask/transaction-controller";
 import type { Hex } from "@metamask/utils";
@@ -51,6 +51,19 @@ export declare function getRampsQuote({ adjustedAmount, errorMessage, fiatAsset,
     messenger: TransactionPayControllerMessenger;
     walletAddress: string;
 }): Promise<RampsQuote>;
+/**
+ * Validates that a completed order's crypto asset matches the expected fiat asset.
+ *
+ * @param options - The validation options.
+ * @param options.expectedAsset - The expected fiat asset derived from the transaction type.
+ * @param options.orderCrypto - The crypto currency information from the completed order.
+ * @param options.transactionId - Transaction ID for error reporting.
+ */
+export declare function validateOrderAsset({ expectedAsset, orderCrypto, transactionId, }: {
+    expectedAsset: TransactionPayFiatAsset;
+    orderCrypto: RampsOrderCryptoCurrency | undefined;
+    transactionId: string;
+}): void;
 /**
  * Resolves the raw source amount for a completed fiat order.
  *

package/dist/strategy/fiat/utils.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../../../src/strategy/fiat/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,IAAI,UAAU,EACnB,UAAU,EACX,mCAAmC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AACxE,OAAO,EAAE,eAAe,EAAE,yCAAyC;AACnE,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAK3C,OAAO,KAAK,EAAE,iCAAiC,EAAE,wBAAoB;AAOrE,OAAO,KAAK,EAAE,UAAU,EAAE,2BAAuB;AACjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,wBAAoB;AAK3D,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,eAAe,EAC5B,SAAS,EAAE,iCAAiC,GAC3C,uBAAuB,CAKzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,eAAe,EAC5B,YAAY,EAAE,eAAe,EAAE,GAC9B,eAAe,GAAG,SAAS,CAU7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,eAAe,GAC3B,OAAO,CAKT;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,EAClC,cAAc,EACd,YAAoE,EACpE,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,aAAa,GACd,EAAE;IACD,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,uBAAuB,CAAC;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,iCAAiC,CAAC;IAC7C,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,SAAS,EACT,KAAK,EACL,SAAS,EACT,aAAa,GACd,EAAE;IACD,SAAS,EAAE,iCAAiC,CAAC;IAC7C,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,uBAAuB,CAAC;IACnC,aAAa,EAAE,GAAG,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0ClB;AAED;;;;;;;GAOG;AACH,wBAAgB,uCAAuC,CAAC,EACtD,YAAY,EACZ,QAAQ,GACT,EAAE;IACD,YAAY,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAmBT;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,aAAa,GACd,EAAE;IACD,aAAa,EAAE,UAAU,CAAC;IAC1B,cAAc,EAAE,UAAU,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,IAAI,CA2CP;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,IAAI,CAYf"}
+{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../../../src/strategy/fiat/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,IAAI,UAAU,EACnB,UAAU,EACV,wBAAwB,EACzB,mCAAmC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AACxE,OAAO,EAAE,eAAe,EAAE,yCAAyC;AACnE,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAK3C,OAAO,KAAK,EAAE,iCAAiC,EAAE,wBAAoB;AAOrE,OAAO,KAAK,EAAE,UAAU,EAAE,2BAAuB;AACjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,wBAAoB;AAK3D,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,eAAe,EAC5B,SAAS,EAAE,iCAAiC,GAC3C,uBAAuB,CAKzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,eAAe,EAC5B,YAAY,EAAE,eAAe,EAAE,GAC9B,eAAe,GAAG,SAAS,CAU7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,eAAe,GAC3B,OAAO,CAKT;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,EAClC,cAAc,EACd,YAAoE,EACpE,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,aAAa,GACd,EAAE;IACD,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,uBAAuB,CAAC;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,iCAAiC,CAAC;IAC7C,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBtB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,aAAa,EACb,WAAW,EACX,aAAa,GACd,EAAE;IACD,aAAa,EAAE,uBAAuB,CAAC;IACvC,WAAW,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAClD,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,IAAI,CAsBP;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,SAAS,EACT,KAAK,EACL,SAAS,EACT,aAAa,GACd,EAAE;IACD,SAAS,EAAE,iCAAiC,CAAC;IAC7C,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,uBAAuB,CAAC;IACnC,aAAa,EAAE,GAAG,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0ClB;AAED;;;;;;;GAOG;AACH,wBAAgB,uCAAuC,CAAC,EACtD,YAAY,EACZ,QAAQ,GACT,EAAE;IACD,YAAY,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAmBT;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,aAAa,GACd,EAAE;IACD,aAAa,EAAE,UAAU,CAAC;IAC1B,cAAc,EAAE,UAAU,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,IAAI,CA2CP;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,IAAI,CAYf"}

package/dist/strategy/fiat/utils.mjs

@@ -77,6 +77,28 @@ export async function getRampsQuote({ adjustedAmount, errorMessage = 'No matchin
     }
     return quote;
 }
+/**
+ * Validates that a completed order's crypto asset matches the expected fiat asset.
+ *
+ * @param options - The validation options.
+ * @param options.expectedAsset - The expected fiat asset derived from the transaction type.
+ * @param options.orderCrypto - The crypto currency information from the completed order.
+ * @param options.transactionId - Transaction ID for error reporting.
+ */
+export function validateOrderAsset({ expectedAsset, orderCrypto, transactionId, }) {
+    const orderAssetId = orderCrypto?.assetId?.toLowerCase();
+    const expectedAssetId = buildCaipAssetType(expectedAsset.chainId, expectedAsset.address).toLowerCase();
+    const expectedChainId = expectedAssetId.split('/')[0];
+    const orderChainId = orderCrypto?.chainId?.toLowerCase();
+    if (orderAssetId && orderAssetId !== expectedAssetId) {
+        throw new Error(`Order asset mismatch for transaction ${transactionId}: ` +
+            `expected ${expectedAssetId}, got ${orderAssetId}`);
+    }
+    if (orderChainId && orderChainId !== expectedChainId) {
+        throw new Error(`Order chain mismatch for transaction ${transactionId}: ` +
+            `expected ${expectedChainId}, got ${orderChainId}`);
+    }
+}
 /**
  * Resolves the raw source amount for a completed fiat order.
  *

package/dist/strategy/fiat/utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.mjs","sourceRoot":"","sources":["../../../src/strategy/fiat/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  Quote as RampsQuote,\n  RampsOrder,\n} from '@metamask/ramps-controller';\nimport type { TransactionMeta } from '@metamask/transaction-controller';\nimport { TransactionType } from '@metamask/transaction-controller';\nimport type { Hex } from '@metamask/utils';\nimport { createModuleLogger } from '@metamask/utils';\nimport { BigNumber } from 'bignumber.js';\n\nimport { projectLogger } from '../../logger';\nimport type { TransactionPayControllerMessenger } from '../../types';\nimport {\n  getFiatAssetPerTransactionType,\n  getFiatEnabledTypes,\n} from '../../utils/feature-flags';\nimport { buildCaipAssetType, getTokenInfo } from '../../utils/token';\nimport { getTransferredAmountFromTxHash } from '../../utils/transaction';\nimport type { RelayQuote } from '../relay/types';\nimport type { TransactionPayFiatAsset } from './constants';\nimport { DEFAULT_FIAT_CURRENCY, FIAT_ENABLED_TYPES } from './constants';\n\nconst log = createModuleLogger(projectLogger, 'fiat-utils');\n\nexport function deriveFiatAssetForFiatPayment(\n  transaction: TransactionMeta,\n  messenger: TransactionPayControllerMessenger,\n): TransactionPayFiatAsset {\n  const enabledTypes = getFiatEnabledTypes(messenger);\n  const txType = resolveTransactionType(transaction, enabledTypes);\n\n  return getFiatAssetPerTransactionType(messenger, txType);\n}\n\n/**\n * Resolves the effective transaction type for fiat strategy purposes.\n *\n * For non-batch transactions returns the transaction's own type.\n * For batch transactions returns the first nested transaction type\n * that appears in the enabled types list, or the batch type itself\n * if no nested type matches.\n *\n * @param transaction - The transaction metadata to inspect.\n * @param enabledTypes - Transaction types eligible for fiat payment.\n * @returns The resolved transaction type, or `undefined`.\n */\nexport function resolveTransactionType(\n  transaction: TransactionMeta,\n  enabledTypes: TransactionType[],\n): TransactionType | undefined {\n  if (transaction.type !== TransactionType.batch) {\n    return transaction.type;\n  }\n\n  const nestedType = transaction.nestedTransactions?.find(\n    (tx) => tx.type && enabledTypes.includes(tx.type),\n  )?.type;\n\n  return nestedType ?? transaction.type;\n}\n\n/**\n * Checks whether a transaction is a Money Account deposit.\n *\n * Handles both direct `moneyAccountDeposit` transactions and EIP-7702\n * batch transactions that contain a `moneyAccountDeposit` nested call.\n * Uses {@link resolveTransactionType} with `FIAT_ENABLED_TYPES` to\n * correctly skip non-deposit nested types (e.g. `tokenMethodApprove`).\n *\n * @param transaction - The transaction metadata to inspect.\n * @returns `true` if the transaction is a Money Account deposit.\n */\nexport function isMoneyAccountDepositTransaction(\n  transaction: TransactionMeta,\n): boolean {\n  return (\n    resolveTransactionType(transaction, FIAT_ENABLED_TYPES) ===\n    TransactionType.moneyAccountDeposit\n  );\n}\n\n/**\n * Fetches the first matching Ramps quote for a fiat asset and payment method.\n *\n * @param options - Quote options.\n * @param options.adjustedAmount - Fiat amount sent to Ramps.\n * @param options.errorMessage - Error thrown when no matching quote is returned.\n * @param options.fiatAsset - Fiat asset to buy.\n * @param options.fiatPaymentMethod - Selected fiat payment method.\n * @param options.messenger - Controller messenger.\n * @param options.walletAddress - Wallet address that receives the on-ramped asset.\n * @returns The first matching Ramps quote.\n */\nexport async function getRampsQuote({\n  adjustedAmount,\n  errorMessage = 'No matching ramps quote found for selected provider',\n  fiatAsset,\n  fiatPaymentMethod,\n  messenger,\n  walletAddress,\n}: {\n  adjustedAmount: number;\n  errorMessage?: string;\n  fiatAsset: TransactionPayFiatAsset;\n  fiatPaymentMethod: string;\n  messenger: TransactionPayControllerMessenger;\n  walletAddress: string;\n}): Promise<RampsQuote> {\n  const quotes = await messenger.call('RampsController:getQuotes', {\n    amount: adjustedAmount,\n    assetId: buildCaipAssetType(fiatAsset.chainId, fiatAsset.address),\n    autoSelectProvider: true,\n    fiat: DEFAULT_FIAT_CURRENCY,\n    paymentMethods: [fiatPaymentMethod],\n    restrictToKnownOrNativeProviders: true,\n    walletAddress,\n  });\n\n  log('Fetched ramps quotes', {\n    quotesCount: quotes.success?.length ?? 0,\n  });\n\n  const quote = quotes.success?.[0];\n\n  if (!quote) {\n    throw new Error(errorMessage);\n  }\n\n  return quote;\n}\n\n/**\n * Resolves the raw source amount for a completed fiat order.\n *\n * Attempts to read the actual transferred amount from the on-chain transaction\n * identified by `order.txHash`. If the on-chain read fails or returns\n * no amount, falls back to computing the amount from `order.cryptoAmount`.\n *\n * @param options - The resolution options.\n * @param options.messenger - Controller messenger for network access.\n * @param options.order - The completed on-ramp order.\n * @param options.fiatAsset - The fiat asset describing the expected token.\n * @param options.walletAddress - Recipient wallet address for on-chain lookup.\n * @returns The raw (atomic) source amount as a decimal string.\n */\nexport async function resolveSourceAmountRaw({\n  messenger,\n  order,\n  fiatAsset,\n  walletAddress,\n}: {\n  messenger: TransactionPayControllerMessenger;\n  order: RampsOrder;\n  fiatAsset: TransactionPayFiatAsset;\n  walletAddress: Hex;\n}): Promise<string> {\n  if (order.txHash) {\n    try {\n      const onChainAmount = await getTransferredAmountFromTxHash({\n        messenger,\n        txHash: order.txHash,\n        chainId: fiatAsset.chainId,\n        tokenAddress: fiatAsset.address,\n        walletAddress,\n      });\n\n      if (onChainAmount) {\n        log('Resolved source amount from on-chain transaction', {\n          txHash: order.txHash,\n          onChainAmount,\n        });\n        return onChainAmount;\n      }\n    } catch (error) {\n      log(\n        'Failed to read on-chain amount, falling back to order.cryptoAmount',\n        { txHash: order.txHash, error },\n      );\n    }\n  }\n\n  const tokenInfo = getTokenInfo(\n    messenger,\n    fiatAsset.address,\n    fiatAsset.chainId,\n  );\n\n  if (!tokenInfo) {\n    throw new Error(\n      `Unable to resolve token info for fiat asset ${fiatAsset.address} on chain ${fiatAsset.chainId}`,\n    );\n  }\n\n  return getRawSourceAmountFromOrderCryptoAmount({\n    cryptoAmount: order.cryptoAmount,\n    decimals: tokenInfo.decimals,\n  });\n}\n\n/**\n * Converts the order's human-readable crypto amount to a raw token amount.\n *\n * @param options - The conversion options.\n * @param options.cryptoAmount - Human-readable crypto amount from the completed order.\n * @param options.decimals - Token decimals for the fiat asset.\n * @returns The raw token amount as a string.\n */\nexport function getRawSourceAmountFromOrderCryptoAmount({\n  cryptoAmount,\n  decimals,\n}: {\n  cryptoAmount: RampsOrder['cryptoAmount'];\n  decimals: number;\n}): string {\n  const normalizedAmount = new BigNumber(String(cryptoAmount));\n\n  if (!normalizedAmount.isFinite() || normalizedAmount.lte(0)) {\n    throw new Error(\n      `Invalid fiat order crypto amount: ${String(cryptoAmount)}`,\n    );\n  }\n\n  const rawAmount = normalizedAmount\n    .shiftedBy(decimals)\n    .decimalPlaces(0, BigNumber.ROUND_DOWN)\n    .toFixed(0);\n\n  if (!new BigNumber(rawAmount).gt(0)) {\n    throw new Error('Computed fiat order source amount is not positive');\n  }\n\n  return rawAmount;\n}\n\n/**\n * Validates that the relay exchange rate hasn't drifted significantly between\n * the original quoting phase and the post-settlement discovery quote.\n *\n * Compares the USD output/input ratio from both quotes. This normalises for\n * different source amounts (quoting phase uses a theoretical amount, discovery\n * uses the actual settled amount) so the comparison reflects genuine rate\n * movement rather than amount differences.\n *\n * @param options - The validation options.\n * @param options.originalQuote - Relay quote from the original quoting phase.\n * @param options.discoveryQuote - Relay quote from the post-settlement discovery.\n * @param options.maxRateDriftPercent - Maximum allowed rate drift percentage.\n * @param options.transactionId - Transaction ID for error reporting.\n */\nexport function validateRelayRateDrift({\n  originalQuote,\n  discoveryQuote,\n  maxRateDriftPercent,\n  transactionId,\n}: {\n  originalQuote: RelayQuote;\n  discoveryQuote: RelayQuote;\n  maxRateDriftPercent: number;\n  transactionId: string;\n}): void {\n  const originalIn = new BigNumber(originalQuote.details.currencyIn.amountUsd);\n  const originalOut = new BigNumber(\n    originalQuote.details.currencyOut.amountUsd,\n  );\n  const discoveryIn = new BigNumber(\n    discoveryQuote.details.currencyIn.amountUsd,\n  );\n  const discoveryOut = new BigNumber(\n    discoveryQuote.details.currencyOut.amountUsd,\n  );\n\n  if (\n    !originalIn.gt(0) ||\n    !originalOut.gt(0) ||\n    !discoveryIn.gt(0) ||\n    !discoveryOut.gt(0)\n  ) {\n    return;\n  }\n\n  const originalRate = originalOut.dividedBy(originalIn);\n  const discoveryRate = discoveryOut.dividedBy(discoveryIn);\n\n  const driftPercent = originalRate\n    .minus(discoveryRate)\n    .dividedBy(originalRate)\n    .multipliedBy(100);\n\n  log('Relay rate drift check', {\n    originalRate: originalRate.toFixed(6),\n    discoveryRate: discoveryRate.toFixed(6),\n    driftPercent: driftPercent.toFixed(2),\n    maxRateDriftPercent,\n    transactionId,\n  });\n\n  if (driftPercent.gt(maxRateDriftPercent)) {\n    throw new Error(\n      `Relay rate drift too high for transaction ` +\n        `${driftPercent.toFixed(2)}% exceeds ${maxRateDriftPercent}% max`,\n    );\n  }\n}\n\n/**\n * Extracts the provider code from a ramps provider string.\n *\n * Accepts the canonical provider code (e.g. `transak-native`) and, for\n * backwards compatibility, the legacy path form (e.g. `/providers/transak-native`).\n *\n * @param provider - Canonical provider code, or legacy provider path.\n * @returns The provider code, or `null` if the format is invalid.\n */\nexport function extractProviderCode(\n  provider: string | undefined,\n): string | null {\n  if (!provider) {\n    return null;\n  }\n\n  const parts = provider.split('/').filter(Boolean);\n\n  if (parts[0] === 'providers') {\n    return parts[1] ?? null;\n  }\n\n  return parts.length === 1 ? parts[0] : null;\n}\n"]}
+{"version":3,"file":"utils.mjs","sourceRoot":"","sources":["../../../src/strategy/fiat/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  Quote as RampsQuote,\n  RampsOrder,\n  RampsOrderCryptoCurrency,\n} from '@metamask/ramps-controller';\nimport type { TransactionMeta } from '@metamask/transaction-controller';\nimport { TransactionType } from '@metamask/transaction-controller';\nimport type { Hex } from '@metamask/utils';\nimport { createModuleLogger } from '@metamask/utils';\nimport { BigNumber } from 'bignumber.js';\n\nimport { projectLogger } from '../../logger';\nimport type { TransactionPayControllerMessenger } from '../../types';\nimport {\n  getFiatAssetPerTransactionType,\n  getFiatEnabledTypes,\n} from '../../utils/feature-flags';\nimport { buildCaipAssetType, getTokenInfo } from '../../utils/token';\nimport { getTransferredAmountFromTxHash } from '../../utils/transaction';\nimport type { RelayQuote } from '../relay/types';\nimport type { TransactionPayFiatAsset } from './constants';\nimport { DEFAULT_FIAT_CURRENCY, FIAT_ENABLED_TYPES } from './constants';\n\nconst log = createModuleLogger(projectLogger, 'fiat-utils');\n\nexport function deriveFiatAssetForFiatPayment(\n  transaction: TransactionMeta,\n  messenger: TransactionPayControllerMessenger,\n): TransactionPayFiatAsset {\n  const enabledTypes = getFiatEnabledTypes(messenger);\n  const txType = resolveTransactionType(transaction, enabledTypes);\n\n  return getFiatAssetPerTransactionType(messenger, txType);\n}\n\n/**\n * Resolves the effective transaction type for fiat strategy purposes.\n *\n * For non-batch transactions returns the transaction's own type.\n * For batch transactions returns the first nested transaction type\n * that appears in the enabled types list, or the batch type itself\n * if no nested type matches.\n *\n * @param transaction - The transaction metadata to inspect.\n * @param enabledTypes - Transaction types eligible for fiat payment.\n * @returns The resolved transaction type, or `undefined`.\n */\nexport function resolveTransactionType(\n  transaction: TransactionMeta,\n  enabledTypes: TransactionType[],\n): TransactionType | undefined {\n  if (transaction.type !== TransactionType.batch) {\n    return transaction.type;\n  }\n\n  const nestedType = transaction.nestedTransactions?.find(\n    (tx) => tx.type && enabledTypes.includes(tx.type),\n  )?.type;\n\n  return nestedType ?? transaction.type;\n}\n\n/**\n * Checks whether a transaction is a Money Account deposit.\n *\n * Handles both direct `moneyAccountDeposit` transactions and EIP-7702\n * batch transactions that contain a `moneyAccountDeposit` nested call.\n * Uses {@link resolveTransactionType} with `FIAT_ENABLED_TYPES` to\n * correctly skip non-deposit nested types (e.g. `tokenMethodApprove`).\n *\n * @param transaction - The transaction metadata to inspect.\n * @returns `true` if the transaction is a Money Account deposit.\n */\nexport function isMoneyAccountDepositTransaction(\n  transaction: TransactionMeta,\n): boolean {\n  return (\n    resolveTransactionType(transaction, FIAT_ENABLED_TYPES) ===\n    TransactionType.moneyAccountDeposit\n  );\n}\n\n/**\n * Fetches the first matching Ramps quote for a fiat asset and payment method.\n *\n * @param options - Quote options.\n * @param options.adjustedAmount - Fiat amount sent to Ramps.\n * @param options.errorMessage - Error thrown when no matching quote is returned.\n * @param options.fiatAsset - Fiat asset to buy.\n * @param options.fiatPaymentMethod - Selected fiat payment method.\n * @param options.messenger - Controller messenger.\n * @param options.walletAddress - Wallet address that receives the on-ramped asset.\n * @returns The first matching Ramps quote.\n */\nexport async function getRampsQuote({\n  adjustedAmount,\n  errorMessage = 'No matching ramps quote found for selected provider',\n  fiatAsset,\n  fiatPaymentMethod,\n  messenger,\n  walletAddress,\n}: {\n  adjustedAmount: number;\n  errorMessage?: string;\n  fiatAsset: TransactionPayFiatAsset;\n  fiatPaymentMethod: string;\n  messenger: TransactionPayControllerMessenger;\n  walletAddress: string;\n}): Promise<RampsQuote> {\n  const quotes = await messenger.call('RampsController:getQuotes', {\n    amount: adjustedAmount,\n    assetId: buildCaipAssetType(fiatAsset.chainId, fiatAsset.address),\n    autoSelectProvider: true,\n    fiat: DEFAULT_FIAT_CURRENCY,\n    paymentMethods: [fiatPaymentMethod],\n    restrictToKnownOrNativeProviders: true,\n    walletAddress,\n  });\n\n  log('Fetched ramps quotes', {\n    quotesCount: quotes.success?.length ?? 0,\n  });\n\n  const quote = quotes.success?.[0];\n\n  if (!quote) {\n    throw new Error(errorMessage);\n  }\n\n  return quote;\n}\n\n/**\n * Validates that a completed order's crypto asset matches the expected fiat asset.\n *\n * @param options - The validation options.\n * @param options.expectedAsset - The expected fiat asset derived from the transaction type.\n * @param options.orderCrypto - The crypto currency information from the completed order.\n * @param options.transactionId - Transaction ID for error reporting.\n */\nexport function validateOrderAsset({\n  expectedAsset,\n  orderCrypto,\n  transactionId,\n}: {\n  expectedAsset: TransactionPayFiatAsset;\n  orderCrypto: RampsOrderCryptoCurrency | undefined;\n  transactionId: string;\n}): void {\n  const orderAssetId = orderCrypto?.assetId?.toLowerCase();\n  const expectedAssetId = buildCaipAssetType(\n    expectedAsset.chainId,\n    expectedAsset.address,\n  ).toLowerCase();\n  const expectedChainId = expectedAssetId.split('/')[0];\n  const orderChainId = orderCrypto?.chainId?.toLowerCase();\n\n  if (orderAssetId && orderAssetId !== expectedAssetId) {\n    throw new Error(\n      `Order asset mismatch for transaction ${transactionId}: ` +\n        `expected ${expectedAssetId}, got ${orderAssetId}`,\n    );\n  }\n\n  if (orderChainId && orderChainId !== expectedChainId) {\n    throw new Error(\n      `Order chain mismatch for transaction ${transactionId}: ` +\n        `expected ${expectedChainId}, got ${orderChainId}`,\n    );\n  }\n}\n\n/**\n * Resolves the raw source amount for a completed fiat order.\n *\n * Attempts to read the actual transferred amount from the on-chain transaction\n * identified by `order.txHash`. If the on-chain read fails or returns\n * no amount, falls back to computing the amount from `order.cryptoAmount`.\n *\n * @param options - The resolution options.\n * @param options.messenger - Controller messenger for network access.\n * @param options.order - The completed on-ramp order.\n * @param options.fiatAsset - The fiat asset describing the expected token.\n * @param options.walletAddress - Recipient wallet address for on-chain lookup.\n * @returns The raw (atomic) source amount as a decimal string.\n */\nexport async function resolveSourceAmountRaw({\n  messenger,\n  order,\n  fiatAsset,\n  walletAddress,\n}: {\n  messenger: TransactionPayControllerMessenger;\n  order: RampsOrder;\n  fiatAsset: TransactionPayFiatAsset;\n  walletAddress: Hex;\n}): Promise<string> {\n  if (order.txHash) {\n    try {\n      const onChainAmount = await getTransferredAmountFromTxHash({\n        messenger,\n        txHash: order.txHash,\n        chainId: fiatAsset.chainId,\n        tokenAddress: fiatAsset.address,\n        walletAddress,\n      });\n\n      if (onChainAmount) {\n        log('Resolved source amount from on-chain transaction', {\n          txHash: order.txHash,\n          onChainAmount,\n        });\n        return onChainAmount;\n      }\n    } catch (error) {\n      log(\n        'Failed to read on-chain amount, falling back to order.cryptoAmount',\n        { txHash: order.txHash, error },\n      );\n    }\n  }\n\n  const tokenInfo = getTokenInfo(\n    messenger,\n    fiatAsset.address,\n    fiatAsset.chainId,\n  );\n\n  if (!tokenInfo) {\n    throw new Error(\n      `Unable to resolve token info for fiat asset ${fiatAsset.address} on chain ${fiatAsset.chainId}`,\n    );\n  }\n\n  return getRawSourceAmountFromOrderCryptoAmount({\n    cryptoAmount: order.cryptoAmount,\n    decimals: tokenInfo.decimals,\n  });\n}\n\n/**\n * Converts the order's human-readable crypto amount to a raw token amount.\n *\n * @param options - The conversion options.\n * @param options.cryptoAmount - Human-readable crypto amount from the completed order.\n * @param options.decimals - Token decimals for the fiat asset.\n * @returns The raw token amount as a string.\n */\nexport function getRawSourceAmountFromOrderCryptoAmount({\n  cryptoAmount,\n  decimals,\n}: {\n  cryptoAmount: RampsOrder['cryptoAmount'];\n  decimals: number;\n}): string {\n  const normalizedAmount = new BigNumber(String(cryptoAmount));\n\n  if (!normalizedAmount.isFinite() || normalizedAmount.lte(0)) {\n    throw new Error(\n      `Invalid fiat order crypto amount: ${String(cryptoAmount)}`,\n    );\n  }\n\n  const rawAmount = normalizedAmount\n    .shiftedBy(decimals)\n    .decimalPlaces(0, BigNumber.ROUND_DOWN)\n    .toFixed(0);\n\n  if (!new BigNumber(rawAmount).gt(0)) {\n    throw new Error('Computed fiat order source amount is not positive');\n  }\n\n  return rawAmount;\n}\n\n/**\n * Validates that the relay exchange rate hasn't drifted significantly between\n * the original quoting phase and the post-settlement discovery quote.\n *\n * Compares the USD output/input ratio from both quotes. This normalises for\n * different source amounts (quoting phase uses a theoretical amount, discovery\n * uses the actual settled amount) so the comparison reflects genuine rate\n * movement rather than amount differences.\n *\n * @param options - The validation options.\n * @param options.originalQuote - Relay quote from the original quoting phase.\n * @param options.discoveryQuote - Relay quote from the post-settlement discovery.\n * @param options.maxRateDriftPercent - Maximum allowed rate drift percentage.\n * @param options.transactionId - Transaction ID for error reporting.\n */\nexport function validateRelayRateDrift({\n  originalQuote,\n  discoveryQuote,\n  maxRateDriftPercent,\n  transactionId,\n}: {\n  originalQuote: RelayQuote;\n  discoveryQuote: RelayQuote;\n  maxRateDriftPercent: number;\n  transactionId: string;\n}): void {\n  const originalIn = new BigNumber(originalQuote.details.currencyIn.amountUsd);\n  const originalOut = new BigNumber(\n    originalQuote.details.currencyOut.amountUsd,\n  );\n  const discoveryIn = new BigNumber(\n    discoveryQuote.details.currencyIn.amountUsd,\n  );\n  const discoveryOut = new BigNumber(\n    discoveryQuote.details.currencyOut.amountUsd,\n  );\n\n  if (\n    !originalIn.gt(0) ||\n    !originalOut.gt(0) ||\n    !discoveryIn.gt(0) ||\n    !discoveryOut.gt(0)\n  ) {\n    return;\n  }\n\n  const originalRate = originalOut.dividedBy(originalIn);\n  const discoveryRate = discoveryOut.dividedBy(discoveryIn);\n\n  const driftPercent = originalRate\n    .minus(discoveryRate)\n    .dividedBy(originalRate)\n    .multipliedBy(100);\n\n  log('Relay rate drift check', {\n    originalRate: originalRate.toFixed(6),\n    discoveryRate: discoveryRate.toFixed(6),\n    driftPercent: driftPercent.toFixed(2),\n    maxRateDriftPercent,\n    transactionId,\n  });\n\n  if (driftPercent.gt(maxRateDriftPercent)) {\n    throw new Error(\n      `Relay rate drift too high for transaction ` +\n        `${driftPercent.toFixed(2)}% exceeds ${maxRateDriftPercent}% max`,\n    );\n  }\n}\n\n/**\n * Extracts the provider code from a ramps provider string.\n *\n * Accepts the canonical provider code (e.g. `transak-native`) and, for\n * backwards compatibility, the legacy path form (e.g. `/providers/transak-native`).\n *\n * @param provider - Canonical provider code, or legacy provider path.\n * @returns The provider code, or `null` if the format is invalid.\n */\nexport function extractProviderCode(\n  provider: string | undefined,\n): string | null {\n  if (!provider) {\n    return null;\n  }\n\n  const parts = provider.split('/').filter(Boolean);\n\n  if (parts[0] === 'providers') {\n    return parts[1] ?? null;\n  }\n\n  return parts.length === 1 ? parts[0] : null;\n}\n"]}