@metamask/transaction-pay-controller 1.0.0

package/dist/utils/required-tokens.d.mts

@@ -0,0 +1,11 @@
+import type { TransactionMeta } from "@metamask/transaction-controller";
+import type { TransactionPayControllerMessenger, TransactionPayRequiredToken } from "../types.mjs";
+/**
+ * Parse required tokens from a transaction.
+ *
+ * @param transaction - Transaction metadata.
+ * @param messenger - Controller messenger.
+ * @returns An array of required tokens.
+ */
+export declare function parseRequiredTokens(transaction: TransactionMeta, messenger: TransactionPayControllerMessenger): TransactionPayRequiredToken[];
+//# sourceMappingURL=required-tokens.d.mts.map

package/dist/utils/required-tokens.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-tokens.d.mts","sourceRoot":"","sources":["../../src/utils/required-tokens.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AAUxE,OAAO,KAAK,EAEV,iCAAiC,EACjC,2BAA2B,EAC5B,qBAAiB;AAIlB;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,eAAe,EAC5B,SAAS,EAAE,iCAAiC,GAC3C,2BAA2B,EAAE,CAK/B"}

package/dist/utils/required-tokens.mjs

@@ -0,0 +1,175 @@
+import { Interface } from "@ethersproject/abi";
+import { toHex } from "@metamask/controller-utils";
+import { abiERC20 } from "@metamask/metamask-eth-abis";
+import { add0x } from "@metamask/utils";
+import { BigNumber } from "bignumber.js";
+import { getNativeToken, getTokenBalance, getTokenFiatRate, getTokenInfo } from "./token.mjs";
+const FOUR_BYTE_TOKEN_TRANSFER = '0xa9059cbb';
+/**
+ * Parse required tokens from a transaction.
+ *
+ * @param transaction - Transaction metadata.
+ * @param messenger - Controller messenger.
+ * @returns An array of required tokens.
+ */
+export function parseRequiredTokens(transaction, messenger) {
+    return [
+        getTokenTransferToken(transaction, messenger),
+        getGasFeeToken(transaction, messenger),
+    ].filter(Boolean);
+}
+/**
+ * Parse a required token from a token transfer.
+ *
+ * @param transaction - Transaction metadata.
+ * @param messenger - Controller messenger.
+ * @returns The required token or undefined if the transaction is not a token transfer.
+ */
+function getTokenTransferToken(transaction, messenger) {
+    const { data, to } = getTokenTransferData(transaction) ?? {};
+    if (!to || !data) {
+        return undefined;
+    }
+    let transferAmount;
+    try {
+        const result = new Interface(abiERC20).decodeFunctionData('transfer', data);
+        transferAmount = toHex(result._value);
+    }
+    catch {
+        // Intentionally empty
+    }
+    if (transferAmount === undefined) {
+        return undefined;
+    }
+    return buildRequiredToken(transaction, to, transferAmount, messenger);
+}
+/**
+ * Get the gas fee token required for a transaction.
+ *
+ * @param transaction - Transaction metadata.
+ * @param messenger - Controller messenger.
+ * @returns The gas fee token or undefined if it could not be determined.
+ */
+function getGasFeeToken(transaction, messenger) {
+    const { chainId, txParams } = transaction;
+    const { gas, maxFeePerGas } = txParams;
+    const nativeTokenAddress = getNativeToken(chainId);
+    const maxGasCostRawHex = add0x(new BigNumber(gas ?? '0x0')
+        .multipliedBy(new BigNumber(maxFeePerGas ?? '0x0'))
+        .toString(16));
+    const token = buildRequiredToken(transaction, nativeTokenAddress, maxGasCostRawHex, messenger);
+    if (!token) {
+        return undefined;
+    }
+    const amountUsdValue = new BigNumber(token.amountUsd);
+    const hasBalance = new BigNumber(token.balanceRaw).isGreaterThanOrEqualTo(token.amountRaw);
+    if (hasBalance || amountUsdValue.isGreaterThanOrEqualTo(1)) {
+        return {
+            ...token,
+            allowUnderMinimum: true,
+            skipIfBalance: true,
+        };
+    }
+    const fiatRates = getTokenFiatRate(messenger, nativeTokenAddress, chainId);
+    const oneDollarRawHex = add0x(new BigNumber(1).dividedBy(fiatRates.usdRate).shiftedBy(18).toString(16));
+    const oneDollarToken = buildRequiredToken(transaction, nativeTokenAddress, oneDollarRawHex, messenger);
+    /* istanbul ignore next */
+    if (!oneDollarToken) {
+        return undefined;
+    }
+    return {
+        ...oneDollarToken,
+        allowUnderMinimum: true,
+        skipIfBalance: true,
+    };
+}
+/**
+ * Get the full token properties for a specific token and amount.
+ *
+ * @param transaction - Transaction metadata.
+ * @param tokenAddress - Token address.
+ * @param amountRawHex - Raw token amount in hexadecimal format.
+ * @param messenger - Controller messenger.
+ * @returns The full token properties or undefined if the token data could not be retrieved.
+ */
+function buildRequiredToken(transaction, tokenAddress, amountRawHex, messenger) {
+    const { chainId, txParams } = transaction;
+    const from = txParams.from;
+    const { decimals: tokenDecimals, symbol } = getTokenInfo(messenger, tokenAddress, chainId) ?? {};
+    const fiatRates = getTokenFiatRate(messenger, tokenAddress, chainId);
+    const tokenBalance = getTokenBalance(messenger, from, chainId, tokenAddress);
+    if (tokenDecimals === undefined || !symbol || fiatRates === undefined) {
+        return undefined;
+    }
+    const { amountHuman: balanceHuman, amountRaw: balanceRaw, amountFiat: balanceFiat, amountUsd: balanceUsd, } = calculateAmounts(tokenBalance, tokenDecimals, fiatRates);
+    const { amountHuman, amountRaw, amountFiat, amountUsd } = calculateAmounts(amountRawHex, tokenDecimals, fiatRates);
+    return {
+        address: tokenAddress,
+        allowUnderMinimum: false,
+        amountFiat,
+        amountHuman,
+        amountRaw,
+        amountUsd,
+        balanceFiat,
+        balanceHuman,
+        balanceRaw,
+        balanceUsd,
+        chainId,
+        decimals: tokenDecimals,
+        skipIfBalance: false,
+        symbol,
+    };
+}
+/**
+ * Calculates the various amount representations for a token value.
+ *
+ * @param amountRawInput - Raw amount.
+ * @param decimals - Number of decimals for the token.
+ * @param fiatRates - Fiat rates for the token.
+ * @returns Object containing amount in fiat, human-readable, raw, and USD formats.
+ */
+function calculateAmounts(amountRawInput, decimals, fiatRates) {
+    const amountRawValue = new BigNumber(amountRawInput);
+    const amountHumanValue = amountRawValue.shiftedBy(-decimals);
+    const amountFiat = amountHumanValue
+        .multipliedBy(fiatRates.fiatRate)
+        .toString(10);
+    const amountUsd = amountHumanValue
+        .multipliedBy(fiatRates.usdRate)
+        .toString(10);
+    const amountRaw = amountRawValue.toFixed(0);
+    const amountHuman = amountHumanValue.toString(10);
+    return {
+        amountFiat,
+        amountHuman,
+        amountRaw,
+        amountUsd,
+    };
+}
+/**
+ * Find token transfer data in a transaction.
+ *
+ * @param transactionMeta - Transaction metadata.
+ * @returns - Token transfer data or undefined if not found.
+ */
+function getTokenTransferData(transactionMeta) {
+    const { nestedTransactions, txParams } = transactionMeta;
+    const { data: singleData } = txParams;
+    const singleTo = txParams?.to;
+    if (singleData?.startsWith(FOUR_BYTE_TOKEN_TRANSFER) && singleTo) {
+        return { data: singleData, to: singleTo, index: undefined };
+    }
+    const nestedCallIndex = nestedTransactions?.findIndex((call) => call.data?.startsWith(FOUR_BYTE_TOKEN_TRANSFER));
+    const nestedCall = nestedCallIndex !== undefined
+        ? nestedTransactions?.[nestedCallIndex]
+        : undefined;
+    if (nestedCall?.data && nestedCall.to) {
+        return {
+            data: nestedCall.data,
+            to: nestedCall.to,
+            index: nestedCallIndex,
+        };
+    }
+    return undefined;
+}
+//# sourceMappingURL=required-tokens.mjs.map

package/dist/utils/required-tokens.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-tokens.mjs","sourceRoot":"","sources":["../../src/utils/required-tokens.ts"],"names":[],"mappings":"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","sourcesContent":["import { Interface } from '@ethersproject/abi';\nimport { toHex } from '@metamask/controller-utils';\nimport { abiERC20 } from '@metamask/metamask-eth-abis';\nimport type { TransactionMeta } from '@metamask/transaction-controller';\nimport { add0x, type Hex } from '@metamask/utils';\nimport { BigNumber } from 'bignumber.js';\n\nimport {\n  getNativeToken,\n  getTokenBalance,\n  getTokenFiatRate,\n  getTokenInfo,\n} from './token';\nimport type {\n  FiatRates,\n  TransactionPayControllerMessenger,\n  TransactionPayRequiredToken,\n} from '../types';\n\nconst FOUR_BYTE_TOKEN_TRANSFER = '0xa9059cbb';\n\n/**\n * Parse required tokens from a transaction.\n *\n * @param transaction - Transaction metadata.\n * @param messenger - Controller messenger.\n * @returns An array of required tokens.\n */\nexport function parseRequiredTokens(\n  transaction: TransactionMeta,\n  messenger: TransactionPayControllerMessenger,\n): TransactionPayRequiredToken[] {\n  return [\n    getTokenTransferToken(transaction, messenger),\n    getGasFeeToken(transaction, messenger),\n  ].filter(Boolean) as TransactionPayRequiredToken[];\n}\n\n/**\n * Parse a required token from a token transfer.\n *\n * @param transaction - Transaction metadata.\n * @param messenger - Controller messenger.\n * @returns The required token or undefined if the transaction is not a token transfer.\n */\nfunction getTokenTransferToken(\n  transaction: TransactionMeta,\n  messenger: TransactionPayControllerMessenger,\n): TransactionPayRequiredToken | undefined {\n  const { data, to } = getTokenTransferData(transaction) ?? {};\n\n  if (!to || !data) {\n    return undefined;\n  }\n\n  let transferAmount: Hex | undefined;\n\n  try {\n    const result = new Interface(abiERC20).decodeFunctionData('transfer', data);\n    transferAmount = toHex(result._value);\n  } catch {\n    // Intentionally empty\n  }\n\n  if (transferAmount === undefined) {\n    return undefined;\n  }\n\n  return buildRequiredToken(transaction, to, transferAmount, messenger);\n}\n\n/**\n * Get the gas fee token required for a transaction.\n *\n * @param transaction - Transaction metadata.\n * @param messenger - Controller messenger.\n * @returns The gas fee token or undefined if it could not be determined.\n */\nfunction getGasFeeToken(\n  transaction: TransactionMeta,\n  messenger: TransactionPayControllerMessenger,\n): TransactionPayRequiredToken | undefined {\n  const { chainId, txParams } = transaction;\n  const { gas, maxFeePerGas } = txParams;\n  const nativeTokenAddress = getNativeToken(chainId);\n\n  const maxGasCostRawHex = add0x(\n    new BigNumber(gas ?? '0x0')\n      .multipliedBy(new BigNumber(maxFeePerGas ?? '0x0'))\n      .toString(16),\n  );\n\n  const token = buildRequiredToken(\n    transaction,\n    nativeTokenAddress,\n    maxGasCostRawHex,\n    messenger,\n  );\n\n  if (!token) {\n    return undefined;\n  }\n\n  const amountUsdValue = new BigNumber(token.amountUsd);\n\n  const hasBalance = new BigNumber(token.balanceRaw).isGreaterThanOrEqualTo(\n    token.amountRaw,\n  );\n\n  if (hasBalance || amountUsdValue.isGreaterThanOrEqualTo(1)) {\n    return {\n      ...token,\n      allowUnderMinimum: true,\n      skipIfBalance: true,\n    };\n  }\n\n  const fiatRates = getTokenFiatRate(\n    messenger,\n    nativeTokenAddress,\n    chainId,\n  ) as FiatRates;\n\n  const oneDollarRawHex = add0x(\n    new BigNumber(1).dividedBy(fiatRates.usdRate).shiftedBy(18).toString(16),\n  );\n\n  const oneDollarToken = buildRequiredToken(\n    transaction,\n    nativeTokenAddress,\n    oneDollarRawHex,\n    messenger,\n  );\n\n  /* istanbul ignore next */\n  if (!oneDollarToken) {\n    return undefined;\n  }\n\n  return {\n    ...oneDollarToken,\n    allowUnderMinimum: true,\n    skipIfBalance: true,\n  };\n}\n\n/**\n * Get the full token properties for a specific token and amount.\n *\n * @param transaction - Transaction metadata.\n * @param tokenAddress - Token address.\n * @param amountRawHex - Raw token amount in hexadecimal format.\n * @param messenger - Controller messenger.\n * @returns The full token properties or undefined if the token data could not be retrieved.\n */\nfunction buildRequiredToken(\n  transaction: TransactionMeta,\n  tokenAddress: Hex,\n  amountRawHex: Hex,\n  messenger: TransactionPayControllerMessenger,\n): TransactionPayRequiredToken | undefined {\n  const { chainId, txParams } = transaction;\n  const from = txParams.from as Hex;\n\n  const { decimals: tokenDecimals, symbol } =\n    getTokenInfo(messenger, tokenAddress, chainId) ?? {};\n\n  const fiatRates = getTokenFiatRate(messenger, tokenAddress, chainId);\n  const tokenBalance = getTokenBalance(messenger, from, chainId, tokenAddress);\n\n  if (tokenDecimals === undefined || !symbol || fiatRates === undefined) {\n    return undefined;\n  }\n\n  const {\n    amountHuman: balanceHuman,\n    amountRaw: balanceRaw,\n    amountFiat: balanceFiat,\n    amountUsd: balanceUsd,\n  } = calculateAmounts(tokenBalance, tokenDecimals, fiatRates);\n\n  const { amountHuman, amountRaw, amountFiat, amountUsd } = calculateAmounts(\n    amountRawHex,\n    tokenDecimals,\n    fiatRates,\n  );\n\n  return {\n    address: tokenAddress,\n    allowUnderMinimum: false,\n    amountFiat,\n    amountHuman,\n    amountRaw,\n    amountUsd,\n    balanceFiat,\n    balanceHuman,\n    balanceRaw,\n    balanceUsd,\n    chainId,\n    decimals: tokenDecimals,\n    skipIfBalance: false,\n    symbol,\n  };\n}\n\n/**\n * Calculates the various amount representations for a token value.\n *\n * @param amountRawInput - Raw amount.\n * @param decimals - Number of decimals for the token.\n * @param fiatRates - Fiat rates for the token.\n * @returns Object containing amount in fiat, human-readable, raw, and USD formats.\n */\nfunction calculateAmounts(\n  amountRawInput: BigNumber.Value,\n  decimals: number,\n  fiatRates: FiatRates,\n) {\n  const amountRawValue = new BigNumber(amountRawInput);\n  const amountHumanValue = amountRawValue.shiftedBy(-decimals);\n\n  const amountFiat = amountHumanValue\n    .multipliedBy(fiatRates.fiatRate)\n    .toString(10);\n\n  const amountUsd = amountHumanValue\n    .multipliedBy(fiatRates.usdRate)\n    .toString(10);\n\n  const amountRaw = amountRawValue.toFixed(0);\n  const amountHuman = amountHumanValue.toString(10);\n\n  return {\n    amountFiat,\n    amountHuman,\n    amountRaw,\n    amountUsd,\n  };\n}\n\n/**\n * Find token transfer data in a transaction.\n *\n * @param transactionMeta - Transaction metadata.\n * @returns - Token transfer data or undefined if not found.\n */\nfunction getTokenTransferData(transactionMeta: TransactionMeta):\n  | {\n      data: Hex;\n      to: Hex;\n      index?: number;\n    }\n  | undefined {\n  const { nestedTransactions, txParams } = transactionMeta;\n  const { data: singleData } = txParams;\n  const singleTo = txParams?.to as Hex | undefined;\n\n  if (singleData?.startsWith(FOUR_BYTE_TOKEN_TRANSFER) && singleTo) {\n    return { data: singleData as Hex, to: singleTo, index: undefined };\n  }\n\n  const nestedCallIndex = nestedTransactions?.findIndex((call) =>\n    call.data?.startsWith(FOUR_BYTE_TOKEN_TRANSFER),\n  );\n\n  const nestedCall =\n    nestedCallIndex !== undefined\n      ? nestedTransactions?.[nestedCallIndex]\n      : undefined;\n\n  if (nestedCall?.data && nestedCall.to) {\n    return {\n      data: nestedCall.data,\n      to: nestedCall.to,\n      index: nestedCallIndex,\n    };\n  }\n\n  return undefined;\n}\n"]}

package/dist/utils/source-amounts.cjs

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateSourceAmounts = void 0;
+const utils_1 = require("@metamask/utils");
+const bignumber_js_1 = require("bignumber.js");
+const token_1 = require("./token.cjs");
+const logger_1 = require("../logger.cjs");
+const log = (0, utils_1.createModuleLogger)(logger_1.projectLogger, 'source-amounts');
+/**
+ * Update the source amounts for a transaction.
+ *
+ * @param transactionId - ID of the transaction to update.
+ * @param transactionData - Existing transaction data.
+ * @param messenger - Controller messenger.
+ */
+function updateSourceAmounts(transactionId, transactionData, messenger) {
+    if (!transactionData) {
+        return;
+    }
+    const { paymentToken, tokens } = transactionData;
+    if (!tokens.length || !paymentToken) {
+        return;
+    }
+    const sourceAmounts = tokens
+        .map((t) => calculateSourceAmount(paymentToken, t, messenger))
+        .filter(Boolean);
+    log('Updated source amounts', { transactionId, sourceAmounts });
+    transactionData.sourceAmounts = sourceAmounts;
+}
+exports.updateSourceAmounts = updateSourceAmounts;
+/**
+ * Calculate the required source amount for a payment token to cover a target token.
+ *
+ * @param paymentToken - Selected payment token.
+ * @param token - Target token to cover.
+ * @param messenger - Controller messenger.
+ * @returns The source amount or undefined if calculation failed.
+ */
+function calculateSourceAmount(paymentToken, token, messenger) {
+    const paymentTokenFiatRate = (0, token_1.getTokenFiatRate)(messenger, paymentToken.address, paymentToken.chainId);
+    if (!paymentTokenFiatRate) {
+        return undefined;
+    }
+    const hasBalance = new bignumber_js_1.BigNumber(token.balanceRaw).gte(token.amountRaw);
+    const isSameTokenSelected = token.address.toLowerCase() === paymentToken.address.toLowerCase() &&
+        token.chainId === paymentToken.chainId;
+    if (token.skipIfBalance && hasBalance) {
+        log('Skipping token as sufficient balance', {
+            tokenAddress: token.address,
+        });
+        return undefined;
+    }
+    if (isSameTokenSelected) {
+        log('Skipping token as same as payment token');
+        return undefined;
+    }
+    const sourceAmountHumanValue = new bignumber_js_1.BigNumber(token.amountUsd).div(paymentTokenFiatRate.usdRate);
+    const sourceAmountHuman = sourceAmountHumanValue.toString(10);
+    const sourceAmountRaw = sourceAmountHumanValue
+        .shiftedBy(paymentToken.decimals)
+        .toFixed(0);
+    if (token.amountRaw === '0') {
+        log('Skipping token as zero amount', { tokenAddress: token.address });
+        return undefined;
+    }
+    return {
+        sourceAmountHuman,
+        sourceAmountRaw,
+        targetTokenAddress: token.address,
+    };
+}
+//# sourceMappingURL=source-amounts.cjs.map

package/dist/utils/source-amounts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-amounts.cjs","sourceRoot":"","sources":["../../src/utils/source-amounts.ts"],"names":[],"mappings":";;;AAAA,2CAAqD;AACrD,+CAAyC;AAEzC,uCAA2C;AAK3C,0CAA0C;AAO1C,MAAM,GAAG,GAAG,IAAA,0BAAkB,EAAC,sBAAa,EAAE,gBAAgB,CAAC,CAAC;AAEhE;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,aAAqB,EACrB,eAA4C,EAC5C,SAA4C;IAE5C,IAAI,CAAC,eAAe,EAAE;QACpB,OAAO;KACR;IAED,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC;IAEjD,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,YAAY,EAAE;QACnC,OAAO;KACR;IAED,MAAM,aAAa,GAAG,MAAM;SACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,YAAY,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;SAC7D,MAAM,CAAC,OAAO,CAAiC,CAAC;IAEnD,GAAG,CAAC,wBAAwB,EAAE,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC,CAAC;IAEhE,eAAe,CAAC,aAAa,GAAG,aAAa,CAAC;AAChD,CAAC;AAtBD,kDAsBC;AAED;;;;;;;GAOG;AACH,SAAS,qBAAqB,CAC5B,YAAqC,EACrC,KAAkC,EAClC,SAA4C;IAE5C,MAAM,oBAAoB,GAAG,IAAA,wBAAgB,EAC3C,SAAS,EACT,YAAY,CAAC,OAAO,EACpB,YAAY,CAAC,OAAO,CACrB,CAAC;IAEF,IAAI,CAAC,oBAAoB,EAAE;QACzB,OAAO,SAAS,CAAC;KAClB;IAED,MAAM,UAAU,GAAG,IAAI,wBAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAExE,MAAM,mBAAmB,GACvB,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE;QAClE,KAAK,CAAC,OAAO,KAAK,YAAY,CAAC,OAAO,CAAC;IAEzC,IAAI,KAAK,CAAC,aAAa,IAAI,UAAU,EAAE;QACrC,GAAG,CAAC,sCAAsC,EAAE;YAC1C,YAAY,EAAE,KAAK,CAAC,OAAO;SAC5B,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;KAClB;IAED,IAAI,mBAAmB,EAAE;QACvB,GAAG,CAAC,yCAAyC,CAAC,CAAC;QAC/C,OAAO,SAAS,CAAC;KAClB;IAED,MAAM,sBAAsB,GAAG,IAAI,wBAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAC/D,oBAAoB,CAAC,OAAO,CAC7B,CAAC;IAEF,MAAM,iBAAiB,GAAG,sBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAE9D,MAAM,eAAe,GAAG,sBAAsB;SAC3C,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC;SAChC,OAAO,CAAC,CAAC,CAAC,CAAC;IAEd,IAAI,KAAK,CAAC,SAAS,KAAK,GAAG,EAAE;QAC3B,GAAG,CAAC,+BAA+B,EAAE,EAAE,YAAY,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACtE,OAAO,SAAS,CAAC;KAClB;IAED,OAAO;QACL,iBAAiB;QACjB,eAAe;QACf,kBAAkB,EAAE,KAAK,CAAC,OAAO;KAClC,CAAC;AACJ,CAAC","sourcesContent":["import { createModuleLogger } from '@metamask/utils';\nimport { BigNumber } from 'bignumber.js';\n\nimport { getTokenFiatRate } from './token';\nimport type {\n  TransactionPayControllerMessenger,\n  TransactionPaymentToken,\n} from '..';\nimport { projectLogger } from '../logger';\nimport type {\n  TransactionPaySourceAmount,\n  TransactionData,\n  TransactionPayRequiredToken,\n} from '../types';\n\nconst log = createModuleLogger(projectLogger, 'source-amounts');\n\n/**\n * Update the source amounts for a transaction.\n *\n * @param transactionId - ID of the transaction to update.\n * @param transactionData - Existing transaction data.\n * @param messenger - Controller messenger.\n */\nexport function updateSourceAmounts(\n  transactionId: string,\n  transactionData: TransactionData | undefined,\n  messenger: TransactionPayControllerMessenger,\n) {\n  if (!transactionData) {\n    return;\n  }\n\n  const { paymentToken, tokens } = transactionData;\n\n  if (!tokens.length || !paymentToken) {\n    return;\n  }\n\n  const sourceAmounts = tokens\n    .map((t) => calculateSourceAmount(paymentToken, t, messenger))\n    .filter(Boolean) as TransactionPaySourceAmount[];\n\n  log('Updated source amounts', { transactionId, sourceAmounts });\n\n  transactionData.sourceAmounts = sourceAmounts;\n}\n\n/**\n * Calculate the required source amount for a payment token to cover a target token.\n *\n * @param paymentToken - Selected payment token.\n * @param token - Target token to cover.\n * @param messenger - Controller messenger.\n * @returns The source amount or undefined if calculation failed.\n */\nfunction calculateSourceAmount(\n  paymentToken: TransactionPaymentToken,\n  token: TransactionPayRequiredToken,\n  messenger: TransactionPayControllerMessenger,\n): TransactionPaySourceAmount | undefined {\n  const paymentTokenFiatRate = getTokenFiatRate(\n    messenger,\n    paymentToken.address,\n    paymentToken.chainId,\n  );\n\n  if (!paymentTokenFiatRate) {\n    return undefined;\n  }\n\n  const hasBalance = new BigNumber(token.balanceRaw).gte(token.amountRaw);\n\n  const isSameTokenSelected =\n    token.address.toLowerCase() === paymentToken.address.toLowerCase() &&\n    token.chainId === paymentToken.chainId;\n\n  if (token.skipIfBalance && hasBalance) {\n    log('Skipping token as sufficient balance', {\n      tokenAddress: token.address,\n    });\n    return undefined;\n  }\n\n  if (isSameTokenSelected) {\n    log('Skipping token as same as payment token');\n    return undefined;\n  }\n\n  const sourceAmountHumanValue = new BigNumber(token.amountUsd).div(\n    paymentTokenFiatRate.usdRate,\n  );\n\n  const sourceAmountHuman = sourceAmountHumanValue.toString(10);\n\n  const sourceAmountRaw = sourceAmountHumanValue\n    .shiftedBy(paymentToken.decimals)\n    .toFixed(0);\n\n  if (token.amountRaw === '0') {\n    log('Skipping token as zero amount', { tokenAddress: token.address });\n    return undefined;\n  }\n\n  return {\n    sourceAmountHuman,\n    sourceAmountRaw,\n    targetTokenAddress: token.address,\n  };\n}\n"]}

package/dist/utils/source-amounts.d.cts

@@ -0,0 +1,11 @@
+import type { TransactionPayControllerMessenger } from "../index.cjs";
+import type { TransactionData } from "../types.cjs";
+/**
+ * Update the source amounts for a transaction.
+ *
+ * @param transactionId - ID of the transaction to update.
+ * @param transactionData - Existing transaction data.
+ * @param messenger - Controller messenger.
+ */
+export declare function updateSourceAmounts(transactionId: string, transactionData: TransactionData | undefined, messenger: TransactionPayControllerMessenger): void;
+//# sourceMappingURL=source-amounts.d.cts.map

package/dist/utils/source-amounts.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-amounts.d.cts","sourceRoot":"","sources":["../../src/utils/source-amounts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iCAAiC,EAElC,qBAAW;AAEZ,OAAO,KAAK,EAEV,eAAe,EAEhB,qBAAiB;AAIlB;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,eAAe,GAAG,SAAS,EAC5C,SAAS,EAAE,iCAAiC,QAmB7C"}

package/dist/utils/source-amounts.d.mts

@@ -0,0 +1,11 @@
+import type { TransactionPayControllerMessenger } from "../index.mjs";
+import type { TransactionData } from "../types.mjs";
+/**
+ * Update the source amounts for a transaction.
+ *
+ * @param transactionId - ID of the transaction to update.
+ * @param transactionData - Existing transaction data.
+ * @param messenger - Controller messenger.
+ */
+export declare function updateSourceAmounts(transactionId: string, transactionData: TransactionData | undefined, messenger: TransactionPayControllerMessenger): void;
+//# sourceMappingURL=source-amounts.d.mts.map

package/dist/utils/source-amounts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-amounts.d.mts","sourceRoot":"","sources":["../../src/utils/source-amounts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iCAAiC,EAElC,qBAAW;AAEZ,OAAO,KAAK,EAEV,eAAe,EAEhB,qBAAiB;AAIlB;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,eAAe,GAAG,SAAS,EAC5C,SAAS,EAAE,iCAAiC,QAmB7C"}

package/dist/utils/source-amounts.mjs

@@ -0,0 +1,68 @@
+import { createModuleLogger } from "@metamask/utils";
+import { BigNumber } from "bignumber.js";
+import { getTokenFiatRate } from "./token.mjs";
+import { projectLogger } from "../logger.mjs";
+const log = createModuleLogger(projectLogger, 'source-amounts');
+/**
+ * Update the source amounts for a transaction.
+ *
+ * @param transactionId - ID of the transaction to update.
+ * @param transactionData - Existing transaction data.
+ * @param messenger - Controller messenger.
+ */
+export function updateSourceAmounts(transactionId, transactionData, messenger) {
+    if (!transactionData) {
+        return;
+    }
+    const { paymentToken, tokens } = transactionData;
+    if (!tokens.length || !paymentToken) {
+        return;
+    }
+    const sourceAmounts = tokens
+        .map((t) => calculateSourceAmount(paymentToken, t, messenger))
+        .filter(Boolean);
+    log('Updated source amounts', { transactionId, sourceAmounts });
+    transactionData.sourceAmounts = sourceAmounts;
+}
+/**
+ * Calculate the required source amount for a payment token to cover a target token.
+ *
+ * @param paymentToken - Selected payment token.
+ * @param token - Target token to cover.
+ * @param messenger - Controller messenger.
+ * @returns The source amount or undefined if calculation failed.
+ */
+function calculateSourceAmount(paymentToken, token, messenger) {
+    const paymentTokenFiatRate = getTokenFiatRate(messenger, paymentToken.address, paymentToken.chainId);
+    if (!paymentTokenFiatRate) {
+        return undefined;
+    }
+    const hasBalance = new BigNumber(token.balanceRaw).gte(token.amountRaw);
+    const isSameTokenSelected = token.address.toLowerCase() === paymentToken.address.toLowerCase() &&
+        token.chainId === paymentToken.chainId;
+    if (token.skipIfBalance && hasBalance) {
+        log('Skipping token as sufficient balance', {
+            tokenAddress: token.address,
+        });
+        return undefined;
+    }
+    if (isSameTokenSelected) {
+        log('Skipping token as same as payment token');
+        return undefined;
+    }
+    const sourceAmountHumanValue = new BigNumber(token.amountUsd).div(paymentTokenFiatRate.usdRate);
+    const sourceAmountHuman = sourceAmountHumanValue.toString(10);
+    const sourceAmountRaw = sourceAmountHumanValue
+        .shiftedBy(paymentToken.decimals)
+        .toFixed(0);
+    if (token.amountRaw === '0') {
+        log('Skipping token as zero amount', { tokenAddress: token.address });
+        return undefined;
+    }
+    return {
+        sourceAmountHuman,
+        sourceAmountRaw,
+        targetTokenAddress: token.address,
+    };
+}
+//# sourceMappingURL=source-amounts.mjs.map

package/dist/utils/source-amounts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-amounts.mjs","sourceRoot":"","sources":["../../src/utils/source-amounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,wBAAwB;AACrD,OAAO,EAAE,SAAS,EAAE,qBAAqB;AAEzC,OAAO,EAAE,gBAAgB,EAAE,oBAAgB;AAK3C,OAAO,EAAE,aAAa,EAAE,sBAAkB;AAO1C,MAAM,GAAG,GAAG,kBAAkB,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,aAAqB,EACrB,eAA4C,EAC5C,SAA4C;IAE5C,IAAI,CAAC,eAAe,EAAE;QACpB,OAAO;KACR;IAED,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC;IAEjD,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,YAAY,EAAE;QACnC,OAAO;KACR;IAED,MAAM,aAAa,GAAG,MAAM;SACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,YAAY,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;SAC7D,MAAM,CAAC,OAAO,CAAiC,CAAC;IAEnD,GAAG,CAAC,wBAAwB,EAAE,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC,CAAC;IAEhE,eAAe,CAAC,aAAa,GAAG,aAAa,CAAC;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,qBAAqB,CAC5B,YAAqC,EACrC,KAAkC,EAClC,SAA4C;IAE5C,MAAM,oBAAoB,GAAG,gBAAgB,CAC3C,SAAS,EACT,YAAY,CAAC,OAAO,EACpB,YAAY,CAAC,OAAO,CACrB,CAAC;IAEF,IAAI,CAAC,oBAAoB,EAAE;QACzB,OAAO,SAAS,CAAC;KAClB;IAED,MAAM,UAAU,GAAG,IAAI,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAExE,MAAM,mBAAmB,GACvB,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE;QAClE,KAAK,CAAC,OAAO,KAAK,YAAY,CAAC,OAAO,CAAC;IAEzC,IAAI,KAAK,CAAC,aAAa,IAAI,UAAU,EAAE;QACrC,GAAG,CAAC,sCAAsC,EAAE;YAC1C,YAAY,EAAE,KAAK,CAAC,OAAO;SAC5B,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;KAClB;IAED,IAAI,mBAAmB,EAAE;QACvB,GAAG,CAAC,yCAAyC,CAAC,CAAC;QAC/C,OAAO,SAAS,CAAC;KAClB;IAED,MAAM,sBAAsB,GAAG,IAAI,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAC/D,oBAAoB,CAAC,OAAO,CAC7B,CAAC;IAEF,MAAM,iBAAiB,GAAG,sBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAE9D,MAAM,eAAe,GAAG,sBAAsB;SAC3C,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC;SAChC,OAAO,CAAC,CAAC,CAAC,CAAC;IAEd,IAAI,KAAK,CAAC,SAAS,KAAK,GAAG,EAAE;QAC3B,GAAG,CAAC,+BAA+B,EAAE,EAAE,YAAY,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACtE,OAAO,SAAS,CAAC;KAClB;IAED,OAAO;QACL,iBAAiB;QACjB,eAAe;QACf,kBAAkB,EAAE,KAAK,CAAC,OAAO;KAClC,CAAC;AACJ,CAAC","sourcesContent":["import { createModuleLogger } from '@metamask/utils';\nimport { BigNumber } from 'bignumber.js';\n\nimport { getTokenFiatRate } from './token';\nimport type {\n  TransactionPayControllerMessenger,\n  TransactionPaymentToken,\n} from '..';\nimport { projectLogger } from '../logger';\nimport type {\n  TransactionPaySourceAmount,\n  TransactionData,\n  TransactionPayRequiredToken,\n} from '../types';\n\nconst log = createModuleLogger(projectLogger, 'source-amounts');\n\n/**\n * Update the source amounts for a transaction.\n *\n * @param transactionId - ID of the transaction to update.\n * @param transactionData - Existing transaction data.\n * @param messenger - Controller messenger.\n */\nexport function updateSourceAmounts(\n  transactionId: string,\n  transactionData: TransactionData | undefined,\n  messenger: TransactionPayControllerMessenger,\n) {\n  if (!transactionData) {\n    return;\n  }\n\n  const { paymentToken, tokens } = transactionData;\n\n  if (!tokens.length || !paymentToken) {\n    return;\n  }\n\n  const sourceAmounts = tokens\n    .map((t) => calculateSourceAmount(paymentToken, t, messenger))\n    .filter(Boolean) as TransactionPaySourceAmount[];\n\n  log('Updated source amounts', { transactionId, sourceAmounts });\n\n  transactionData.sourceAmounts = sourceAmounts;\n}\n\n/**\n * Calculate the required source amount for a payment token to cover a target token.\n *\n * @param paymentToken - Selected payment token.\n * @param token - Target token to cover.\n * @param messenger - Controller messenger.\n * @returns The source amount or undefined if calculation failed.\n */\nfunction calculateSourceAmount(\n  paymentToken: TransactionPaymentToken,\n  token: TransactionPayRequiredToken,\n  messenger: TransactionPayControllerMessenger,\n): TransactionPaySourceAmount | undefined {\n  const paymentTokenFiatRate = getTokenFiatRate(\n    messenger,\n    paymentToken.address,\n    paymentToken.chainId,\n  );\n\n  if (!paymentTokenFiatRate) {\n    return undefined;\n  }\n\n  const hasBalance = new BigNumber(token.balanceRaw).gte(token.amountRaw);\n\n  const isSameTokenSelected =\n    token.address.toLowerCase() === paymentToken.address.toLowerCase() &&\n    token.chainId === paymentToken.chainId;\n\n  if (token.skipIfBalance && hasBalance) {\n    log('Skipping token as sufficient balance', {\n      tokenAddress: token.address,\n    });\n    return undefined;\n  }\n\n  if (isSameTokenSelected) {\n    log('Skipping token as same as payment token');\n    return undefined;\n  }\n\n  const sourceAmountHumanValue = new BigNumber(token.amountUsd).div(\n    paymentTokenFiatRate.usdRate,\n  );\n\n  const sourceAmountHuman = sourceAmountHumanValue.toString(10);\n\n  const sourceAmountRaw = sourceAmountHumanValue\n    .shiftedBy(paymentToken.decimals)\n    .toFixed(0);\n\n  if (token.amountRaw === '0') {\n    log('Skipping token as zero amount', { tokenAddress: token.address });\n    return undefined;\n  }\n\n  return {\n    sourceAmountHuman,\n    sourceAmountRaw,\n    targetTokenAddress: token.address,\n  };\n}\n"]}

package/dist/utils/strategy.cjs

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStrategyByName = exports.getStrategy = void 0;
+const constants_1 = require("../constants.cjs");
+const BridgeStrategy_1 = require("../strategy/bridge/BridgeStrategy.cjs");
+const RelayStrategy_1 = require("../strategy/relay/RelayStrategy.cjs");
+const TestStrategy_1 = require("../strategy/test/TestStrategy.cjs");
+/**
+ * Get the payment strategy instance.
+ *
+ * @param messenger - Controller messenger
+ * @param transaction - Transaction to get the strategy for.
+ * @returns The payment strategy instance.
+ */
+async function getStrategy(messenger, transaction) {
+    const strategyName = await messenger.call('TransactionPayController:getStrategy', transaction);
+    return getStrategyByName(strategyName);
+}
+exports.getStrategy = getStrategy;
+/**
+ * Get strategy instance by name.
+ *
+ * @param strategyName - Strategy name.
+ * @returns - Strategy instance.
+ */
+function getStrategyByName(strategyName) {
+    switch (strategyName) {
+        case constants_1.TransactionPayStrategy.Bridge:
+            return new BridgeStrategy_1.BridgeStrategy();
+        case constants_1.TransactionPayStrategy.Relay:
+            return new RelayStrategy_1.RelayStrategy();
+        case constants_1.TransactionPayStrategy.Test:
+            return new TestStrategy_1.TestStrategy();
+        default:
+            throw new Error(`Unknown strategy: ${strategyName}`);
+    }
+}
+exports.getStrategyByName = getStrategyByName;
+//# sourceMappingURL=strategy.cjs.map

package/dist/utils/strategy.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.cjs","sourceRoot":"","sources":["../../src/utils/strategy.ts"],"names":[],"mappings":";;;AAEA,gDAAsD;AACtD,0EAAmE;AACnE,uEAAgE;AAChE,oEAA6D;AAG7D;;;;;;GAMG;AACI,KAAK,UAAU,WAAW,CAC/B,SAA4C,EAC5C,WAA4B;IAE5B,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,IAAI,CACvC,sCAAsC,EACtC,WAAW,CACZ,CAAC;IAEF,OAAO,iBAAiB,CAAC,YAAY,CAAC,CAAC;AACzC,CAAC;AAVD,kCAUC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAC/B,YAAoC;IAEpC,QAAQ,YAAY,EAAE;QACpB,KAAK,kCAAsB,CAAC,MAAM;YAChC,OAAO,IAAI,+BAAc,EAAW,CAAC;QAEvC,KAAK,kCAAsB,CAAC,KAAK;YAC/B,OAAO,IAAI,6BAAa,EAAW,CAAC;QAEtC,KAAK,kCAAsB,CAAC,IAAI;YAC9B,OAAO,IAAI,2BAAY,EAAW,CAAC;QAErC;YACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,YAAsB,EAAE,CAAC,CAAC;KAClE;AACH,CAAC;AAhBD,8CAgBC","sourcesContent":["import type { TransactionMeta } from '@metamask/transaction-controller';\n\nimport { TransactionPayStrategy } from '../constants';\nimport { BridgeStrategy } from '../strategy/bridge/BridgeStrategy';\nimport { RelayStrategy } from '../strategy/relay/RelayStrategy';\nimport { TestStrategy } from '../strategy/test/TestStrategy';\nimport type { PayStrategy, TransactionPayControllerMessenger } from '../types';\n\n/**\n * Get the payment strategy instance.\n *\n * @param messenger - Controller messenger\n * @param transaction - Transaction to get the strategy for.\n * @returns The payment strategy instance.\n */\nexport async function getStrategy(\n  messenger: TransactionPayControllerMessenger,\n  transaction: TransactionMeta,\n): Promise<PayStrategy<unknown>> {\n  const strategyName = await messenger.call(\n    'TransactionPayController:getStrategy',\n    transaction,\n  );\n\n  return getStrategyByName(strategyName);\n}\n\n/**\n * Get strategy instance by name.\n *\n * @param strategyName - Strategy name.\n * @returns - Strategy instance.\n */\nexport function getStrategyByName(\n  strategyName: TransactionPayStrategy,\n): PayStrategy<unknown> {\n  switch (strategyName) {\n    case TransactionPayStrategy.Bridge:\n      return new BridgeStrategy() as never;\n\n    case TransactionPayStrategy.Relay:\n      return new RelayStrategy() as never;\n\n    case TransactionPayStrategy.Test:\n      return new TestStrategy() as never;\n\n    default:\n      throw new Error(`Unknown strategy: ${strategyName as string}`);\n  }\n}\n"]}

package/dist/utils/strategy.d.cts

@@ -0,0 +1,19 @@
+import type { TransactionMeta } from "@metamask/transaction-controller";
+import { TransactionPayStrategy } from "../constants.cjs";
+import type { PayStrategy, TransactionPayControllerMessenger } from "../types.cjs";
+/**
+ * Get the payment strategy instance.
+ *
+ * @param messenger - Controller messenger
+ * @param transaction - Transaction to get the strategy for.
+ * @returns The payment strategy instance.
+ */
+export declare function getStrategy(messenger: TransactionPayControllerMessenger, transaction: TransactionMeta): Promise<PayStrategy<unknown>>;
+/**
+ * Get strategy instance by name.
+ *
+ * @param strategyName - Strategy name.
+ * @returns - Strategy instance.
+ */
+export declare function getStrategyByName(strategyName: TransactionPayStrategy): PayStrategy<unknown>;
+//# sourceMappingURL=strategy.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.cts","sourceRoot":"","sources":["../../src/utils/strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AAExE,OAAO,EAAE,sBAAsB,EAAE,yBAAqB;AAItD,OAAO,KAAK,EAAE,WAAW,EAAE,iCAAiC,EAAE,qBAAiB;AAE/E;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,iCAAiC,EAC5C,WAAW,EAAE,eAAe,GAC3B,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAO/B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,sBAAsB,GACnC,WAAW,CAAC,OAAO,CAAC,CActB"}

package/dist/utils/strategy.d.mts

@@ -0,0 +1,19 @@
+import type { TransactionMeta } from "@metamask/transaction-controller";
+import { TransactionPayStrategy } from "../constants.mjs";
+import type { PayStrategy, TransactionPayControllerMessenger } from "../types.mjs";
+/**
+ * Get the payment strategy instance.
+ *
+ * @param messenger - Controller messenger
+ * @param transaction - Transaction to get the strategy for.
+ * @returns The payment strategy instance.
+ */
+export declare function getStrategy(messenger: TransactionPayControllerMessenger, transaction: TransactionMeta): Promise<PayStrategy<unknown>>;
+/**
+ * Get strategy instance by name.
+ *
+ * @param strategyName - Strategy name.
+ * @returns - Strategy instance.
+ */
+export declare function getStrategyByName(strategyName: TransactionPayStrategy): PayStrategy<unknown>;
+//# sourceMappingURL=strategy.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.mts","sourceRoot":"","sources":["../../src/utils/strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AAExE,OAAO,EAAE,sBAAsB,EAAE,yBAAqB;AAItD,OAAO,KAAK,EAAE,WAAW,EAAE,iCAAiC,EAAE,qBAAiB;AAE/E;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,iCAAiC,EAC5C,WAAW,EAAE,eAAe,GAC3B,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAO/B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,sBAAsB,GACnC,WAAW,CAAC,OAAO,CAAC,CActB"}

package/dist/utils/strategy.mjs

@@ -0,0 +1,34 @@
+import { TransactionPayStrategy } from "../constants.mjs";
+import { BridgeStrategy } from "../strategy/bridge/BridgeStrategy.mjs";
+import { RelayStrategy } from "../strategy/relay/RelayStrategy.mjs";
+import { TestStrategy } from "../strategy/test/TestStrategy.mjs";
+/**
+ * Get the payment strategy instance.
+ *
+ * @param messenger - Controller messenger
+ * @param transaction - Transaction to get the strategy for.
+ * @returns The payment strategy instance.
+ */
+export async function getStrategy(messenger, transaction) {
+    const strategyName = await messenger.call('TransactionPayController:getStrategy', transaction);
+    return getStrategyByName(strategyName);
+}
+/**
+ * Get strategy instance by name.
+ *
+ * @param strategyName - Strategy name.
+ * @returns - Strategy instance.
+ */
+export function getStrategyByName(strategyName) {
+    switch (strategyName) {
+        case TransactionPayStrategy.Bridge:
+            return new BridgeStrategy();
+        case TransactionPayStrategy.Relay:
+            return new RelayStrategy();
+        case TransactionPayStrategy.Test:
+            return new TestStrategy();
+        default:
+            throw new Error(`Unknown strategy: ${strategyName}`);
+    }
+}
+//# sourceMappingURL=strategy.mjs.map

package/dist/utils/strategy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.mjs","sourceRoot":"","sources":["../../src/utils/strategy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,yBAAqB;AACtD,OAAO,EAAE,cAAc,EAAE,8CAA0C;AACnE,OAAO,EAAE,aAAa,EAAE,4CAAwC;AAChE,OAAO,EAAE,YAAY,EAAE,0CAAsC;AAG7D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAA4C,EAC5C,WAA4B;IAE5B,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,IAAI,CACvC,sCAAsC,EACtC,WAAW,CACZ,CAAC;IAEF,OAAO,iBAAiB,CAAC,YAAY,CAAC,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,YAAoC;IAEpC,QAAQ,YAAY,EAAE;QACpB,KAAK,sBAAsB,CAAC,MAAM;YAChC,OAAO,IAAI,cAAc,EAAW,CAAC;QAEvC,KAAK,sBAAsB,CAAC,KAAK;YAC/B,OAAO,IAAI,aAAa,EAAW,CAAC;QAEtC,KAAK,sBAAsB,CAAC,IAAI;YAC9B,OAAO,IAAI,YAAY,EAAW,CAAC;QAErC;YACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,YAAsB,EAAE,CAAC,CAAC;KAClE;AACH,CAAC","sourcesContent":["import type { TransactionMeta } from '@metamask/transaction-controller';\n\nimport { TransactionPayStrategy } from '../constants';\nimport { BridgeStrategy } from '../strategy/bridge/BridgeStrategy';\nimport { RelayStrategy } from '../strategy/relay/RelayStrategy';\nimport { TestStrategy } from '../strategy/test/TestStrategy';\nimport type { PayStrategy, TransactionPayControllerMessenger } from '../types';\n\n/**\n * Get the payment strategy instance.\n *\n * @param messenger - Controller messenger\n * @param transaction - Transaction to get the strategy for.\n * @returns The payment strategy instance.\n */\nexport async function getStrategy(\n  messenger: TransactionPayControllerMessenger,\n  transaction: TransactionMeta,\n): Promise<PayStrategy<unknown>> {\n  const strategyName = await messenger.call(\n    'TransactionPayController:getStrategy',\n    transaction,\n  );\n\n  return getStrategyByName(strategyName);\n}\n\n/**\n * Get strategy instance by name.\n *\n * @param strategyName - Strategy name.\n * @returns - Strategy instance.\n */\nexport function getStrategyByName(\n  strategyName: TransactionPayStrategy,\n): PayStrategy<unknown> {\n  switch (strategyName) {\n    case TransactionPayStrategy.Bridge:\n      return new BridgeStrategy() as never;\n\n    case TransactionPayStrategy.Relay:\n      return new RelayStrategy() as never;\n\n    case TransactionPayStrategy.Test:\n      return new TestStrategy() as never;\n\n    default:\n      throw new Error(`Unknown strategy: ${strategyName as string}`);\n  }\n}\n"]}