@lifi/sdk 0.0.0-preview-f5cf9f8

package/dist/cjs/core/tasks/helpers/checkBalance.js

@@ -0,0 +1,108 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors_errors = require("../../../errors/errors.js");
+const require_utils_sleep = require("../../../utils/sleep.js");
+const require_utils_formatUnits = require("../../../utils/formatUnits.js");
+const require_utils_withTimeout = require("../../../utils/withTimeout.js");
+//#region src/core/tasks/helpers/checkBalance.ts
+const MAX_ATTEMPTS = 6;
+const BACKOFF_BASE_MS = 150;
+const OVERALL_TIMEOUT_MS = 1e4;
+const SLIPPAGE_PRECISION = 1000000000n;
+/**
+* Verifies that the wallet holds enough of every token required to execute
+* the step on its source chain — the source-token amount, any gas costs, and
+* any non-included fee costs. Reads all balances in one batched provider
+* call, retries within a bounded budget to absorb transient RPC failures and
+* post-confirmation propagation lag, and applies slippage to the source-token
+* portion only as a last resort (overhead is never trimmed).
+*
+* Throws BalanceError("The balance is too low.") on a genuine shortfall, or
+* BalanceError("Could not read wallet balance.") if the balance can't be read
+* after retries.
+*/
+const checkBalance = async (client, walletAddress, step, options = {}) => {
+	const fromChainId = step.action.fromChainId;
+	const fromChain = await client.getChainById(fromChainId);
+	const walletPaysGas = (options.walletPaysGas ?? true) && !fromChain.nonStandardNativeDecimals;
+	const requirements = /* @__PURE__ */ new Map();
+	const add = (token, amount, bucket) => {
+		if (token.chainId !== fromChainId || amount === 0n) return;
+		const key = token.address.toLowerCase();
+		const req = requirements.get(key) ?? {
+			token,
+			sourcePart: 0n,
+			gasPart: 0n,
+			feePart: 0n
+		};
+		if (bucket === "source") req.sourcePart += amount;
+		else if (bucket === "gas") req.gasPart += amount;
+		else req.feePart += amount;
+		requirements.set(key, req);
+	};
+	add(step.action.fromToken, BigInt(step.action.fromAmount), "source");
+	for (const gas of step.estimate?.gasCosts ?? []) add(gas.token, BigInt(gas.amount), "gas");
+	for (const fee of step.estimate?.feeCosts ?? []) if (!fee.included) add(fee.token, BigInt(fee.amount), "fee");
+	const reservedOverhead = (r) => r.feePart + (walletPaysGas ? r.gasPart : 0n);
+	const need = (r) => r.sourcePart + reservedOverhead(r);
+	for (const [key, req] of requirements) if (need(req) === 0n) requirements.delete(key);
+	if (requirements.size === 0) return;
+	const provider = client.providers.find((p) => p.isAddress(walletAddress));
+	if (!provider) throw new Error(`SDK Token Provider for ${walletAddress} is not found.`);
+	const reqs = Array.from(requirements.values());
+	const tokens = reqs.map((r) => r.token);
+	const slippage = step.action.slippage ?? 0;
+	const slippageScaled = BigInt(Math.floor((1 - slippage) * Number(SLIPPAGE_PRECISION)));
+	await require_utils_withTimeout.withTimeout(async () => {
+		for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
+			const isFinal = attempt === MAX_ATTEMPTS - 1;
+			let balances;
+			try {
+				balances = await provider.getBalance(client, walletAddress, tokens);
+			} catch (error) {
+				if (isFinal) throw new require_errors_errors.BalanceError("Could not read wallet balance.", error);
+				await require_utils_sleep.sleep(BACKOFF_BASE_MS * 2 ** attempt);
+				continue;
+			}
+			const balanceByAddress = new Map(balances.map((b) => [b.address.toLowerCase(), b.amount]));
+			const unknown = [];
+			const insufficient = [];
+			for (const req of reqs) {
+				const have = balanceByAddress.get(req.token.address.toLowerCase());
+				if (have === void 0) unknown.push(req.token);
+				else if (have < need(req)) insufficient.push({
+					req,
+					have
+				});
+			}
+			if (unknown.length === 0 && insufficient.length === 0) return;
+			if (isFinal && unknown.length === 0 && insufficient.length === 1 && insufficient[0].req.sourcePart > 0n) {
+				const { req, have } = insufficient[0];
+				const reserved = reservedOverhead(req);
+				if (have >= req.sourcePart * slippageScaled / SLIPPAGE_PRECISION + reserved) {
+					const newFromAmount = (have - reserved).toString();
+					step.action.fromAmount = newFromAmount;
+					if (step.includedSteps?.length) step.includedSteps[0].action.fromAmount = newFromAmount;
+					return;
+				}
+			}
+			if (isFinal) {
+				if (unknown.length > 0) throw new require_errors_errors.BalanceError("Could not read wallet balance.", /* @__PURE__ */ new Error(`Could not read balance for: ${unknown.map((t) => t.symbol || t.address).join(", ")}.`));
+				const lines = insufficient.map(({ req, have }) => {
+					const needed = require_utils_formatUnits.formatUnits(need(req), req.token.decimals);
+					const current = require_utils_formatUnits.formatUnits(have, req.token.decimals);
+					const symbol = req.token.symbol;
+					return req.sourcePart > 0n ? `Your ${symbol} balance is too low, you try to transfer ${needed} ${symbol}, but your wallet only holds ${current} ${symbol}.` : `Insufficient ${symbol} for fees: need ${needed} ${symbol}, have ${current} ${symbol}.`;
+				});
+				throw new require_errors_errors.BalanceError("The balance is too low.", /* @__PURE__ */ new Error(`${lines.join(" ")} No funds have been sent.`));
+			}
+			await require_utils_sleep.sleep(BACKOFF_BASE_MS * 2 ** attempt);
+		}
+	}, {
+		timeout: OVERALL_TIMEOUT_MS,
+		errorInstance: new require_errors_errors.BalanceError("Could not read wallet balance.")
+	});
+};
+//#endregion
+exports.checkBalance = checkBalance;
+
+//# sourceMappingURL=checkBalance.js.map

package/dist/cjs/core/tasks/helpers/checkBalance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkBalance.js","names":["withTimeout","BalanceError","sleep","formatUnits"],"sources":["../../../../../src/core/tasks/helpers/checkBalance.ts"],"sourcesContent":["import type { LiFiStep, Token, TokenAmount } from '@lifi/types'\nimport { BalanceError } from '../../../errors/errors.js'\nimport type { SDKClient } from '../../../types/core.js'\nimport { formatUnits } from '../../../utils/formatUnits.js'\nimport { sleep } from '../../../utils/sleep.js'\nimport { withTimeout } from '../../../utils/withTimeout.js'\n\nconst MAX_ATTEMPTS = 6\n// Exponential backoff: 150, 300, 600, 1200, 2400 → ≈4.65s of sleep total.\nconst BACKOFF_BASE_MS = 150\nconst OVERALL_TIMEOUT_MS = 10_000\nconst SLIPPAGE_PRECISION = 1_000_000_000n\n\ntype Bucket = 'source' | 'gas' | 'fee'\n\ntype Requirement = {\n  token: Token\n  sourcePart: bigint // step.action.fromAmount\n  gasPart: bigint // step.estimate.gasCosts in this token\n  feePart: bigint // non-included step.estimate.feeCosts in this token\n}\n\nexport type CheckBalanceOptions = {\n  /**\n   * Set to `false` when outer-tx gas is paid by something other than\n   * `walletAddress` (SCA executor, 4337 bundler / paymaster, relayer):\n   * `gasPart` is excluded from the sufficiency check and slippage rescue.\n   * Source amount and non-included fees (e.g. LZ `msg.value`) are still\n   * verified. Defaults to `true` (strict, today's behavior).\n   */\n  walletPaysGas?: boolean\n}\n\n/**\n * Verifies that the wallet holds enough of every token required to execute\n * the step on its source chain — the source-token amount, any gas costs, and\n * any non-included fee costs. Reads all balances in one batched provider\n * call, retries within a bounded budget to absorb transient RPC failures and\n * post-confirmation propagation lag, and applies slippage to the source-token\n * portion only as a last resort (overhead is never trimmed).\n *\n * Throws BalanceError(\"The balance is too low.\") on a genuine shortfall, or\n * BalanceError(\"Could not read wallet balance.\") if the balance can't be read\n * after retries.\n */\nexport const checkBalance = async (\n  client: SDKClient,\n  walletAddress: string,\n  step: LiFiStep,\n  options: CheckBalanceOptions = {}\n): Promise<void> => {\n  const fromChainId = step.action.fromChainId\n  // Chains with non-standard native decimals (e.g. Tempo, Stable) report\n  // gas costs in units that don't align with wallet balances — drop the\n  // gas portion of the check on those chains.\n  const fromChain = await client.getChainById(fromChainId)\n  const walletPaysGas =\n    (options.walletPaysGas ?? true) && !fromChain.nonStandardNativeDecimals\n  const requirements = new Map<string, Requirement>()\n  const add = (token: Token, amount: bigint, bucket: Bucket): void => {\n    if (token.chainId !== fromChainId || amount === 0n) {\n      return\n    }\n    const key = token.address.toLowerCase()\n    const req = requirements.get(key) ?? {\n      token,\n      sourcePart: 0n,\n      gasPart: 0n,\n      feePart: 0n,\n    }\n    if (bucket === 'source') {\n      req.sourcePart += amount\n    } else if (bucket === 'gas') {\n      req.gasPart += amount\n    } else {\n      req.feePart += amount\n    }\n    requirements.set(key, req)\n  }\n  add(step.action.fromToken, BigInt(step.action.fromAmount), 'source')\n  for (const gas of step.estimate?.gasCosts ?? []) {\n    add(gas.token, BigInt(gas.amount), 'gas')\n  }\n  for (const fee of step.estimate?.feeCosts ?? []) {\n    // Included fees are already part of fromAmount — don't count twice.\n    if (!fee.included) {\n      add(fee.token, BigInt(fee.amount), 'fee')\n    }\n  }\n\n  const reservedOverhead = (r: Requirement): bigint =>\n    r.feePart + (walletPaysGas ? r.gasPart : 0n)\n  const need = (r: Requirement): bigint => r.sourcePart + reservedOverhead(r)\n\n  // Drop pure-gas entries when `walletPaysGas` is false (e.g. native ETH\n  // on Safe Apps with only `gasPart`) — saves one balance read each.\n  for (const [key, req] of requirements) {\n    if (need(req) === 0n) {\n      requirements.delete(key)\n    }\n  }\n\n  if (requirements.size === 0) {\n    return\n  }\n\n  // Provider is dispatched by wallet address; all requirements share the\n  // source chain, which matches this provider by virtue of the address.\n  const provider = client.providers.find((p) => p.isAddress(walletAddress))\n  if (!provider) {\n    throw new Error(`SDK Token Provider for ${walletAddress} is not found.`)\n  }\n\n  const reqs = Array.from(requirements.values())\n  const tokens = reqs.map((r) => r.token)\n  const slippage = step.action.slippage ?? 0\n  const slippageScaled = BigInt(\n    Math.floor((1 - slippage) * Number(SLIPPAGE_PRECISION))\n  )\n\n  await withTimeout(\n    async () => {\n      for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {\n        const isFinal = attempt === MAX_ATTEMPTS - 1\n\n        let balances: TokenAmount[]\n        try {\n          balances = await provider.getBalance(client, walletAddress, tokens)\n        } catch (error) {\n          if (isFinal) {\n            throw new BalanceError(\n              'Could not read wallet balance.',\n              error as Error\n            )\n          }\n          await sleep(BACKOFF_BASE_MS * 2 ** attempt)\n          continue\n        }\n\n        const balanceByAddress = new Map(\n          balances.map((b) => [b.address.toLowerCase(), b.amount] as const)\n        )\n\n        const unknown: Token[] = []\n        const insufficient: { req: Requirement; have: bigint }[] = []\n        for (const req of reqs) {\n          const have = balanceByAddress.get(req.token.address.toLowerCase())\n          if (have === undefined) {\n            unknown.push(req.token)\n          } else if (have < need(req)) {\n            insufficient.push({ req, have })\n          }\n        }\n\n        if (unknown.length === 0 && insufficient.length === 0) {\n          return\n        }\n\n        // Final-attempt slippage rescue: only when the sole shortfall is\n        // the source-token portion. Trim source to (balance − reserved\n        // overhead) so the overhead reserve is preserved.\n        if (\n          isFinal &&\n          unknown.length === 0 &&\n          insufficient.length === 1 &&\n          insufficient[0].req.sourcePart > 0n\n        ) {\n          const { req, have } = insufficient[0]\n          const reserved = reservedOverhead(req)\n          const minAcceptable =\n            (req.sourcePart * slippageScaled) / SLIPPAGE_PRECISION + reserved\n          if (have >= minAcceptable) {\n            const newFromAmount = (have - reserved).toString()\n            step.action.fromAmount = newFromAmount\n            if (step.includedSteps?.length) {\n              step.includedSteps[0].action.fromAmount = newFromAmount\n            }\n            return\n          }\n        }\n\n        if (isFinal) {\n          if (unknown.length > 0) {\n            throw new BalanceError(\n              'Could not read wallet balance.',\n              new Error(\n                `Could not read balance for: ${unknown\n                  .map((t) => t.symbol || t.address)\n                  .join(', ')}.`\n              )\n            )\n          }\n          const lines = insufficient.map(({ req, have }) => {\n            const needed = formatUnits(need(req), req.token.decimals)\n            const current = formatUnits(have, req.token.decimals)\n            const symbol = req.token.symbol\n            // The \"fees\" branch covers pure-overhead tokens; with\n            // walletPaysGas=false, gas is excluded from `need(req)` so it\n            // only fires for genuine fee shortfalls.\n            return req.sourcePart > 0n\n              ? `Your ${symbol} balance is too low, you try to transfer ${needed} ${symbol}, but your wallet only holds ${current} ${symbol}.`\n              : `Insufficient ${symbol} for fees: need ${needed} ${symbol}, have ${current} ${symbol}.`\n          })\n          throw new BalanceError(\n            'The balance is too low.',\n            new Error(`${lines.join(' ')} No funds have been sent.`)\n          )\n        }\n\n        await sleep(BACKOFF_BASE_MS * 2 ** attempt)\n      }\n    },\n    {\n      timeout: OVERALL_TIMEOUT_MS,\n      errorInstance: new BalanceError('Could not read wallet balance.'),\n    }\n  )\n}\n"],"mappings":"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"}

package/dist/cjs/core/tasks/helpers/getTransactionRequestData.d.ts

@@ -0,0 +1,7 @@
+import { ExecutionOptions, LiFiStepExtended } from "../../../types/core.js";
+
+//#region src/core/tasks/helpers/getTransactionRequestData.d.ts
+declare const getTransactionRequestData: (step: LiFiStepExtended, executionOptions?: ExecutionOptions) => Promise<string>;
+//#endregion
+export { getTransactionRequestData };
+//# sourceMappingURL=getTransactionRequestData.d.ts.map

package/dist/cjs/core/tasks/helpers/getTransactionRequestData.js

@@ -0,0 +1,25 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../../errors/constants.js");
+const require_errors_errors = require("../../../errors/errors.js");
+//#region src/core/tasks/helpers/getTransactionRequestData.ts
+const getTransactionRequestData = async (step, executionOptions) => {
+	if (!step.transactionRequest?.data) throw new require_errors_errors.TransactionError(1008, "Unable to prepare transaction. Transaction request data is not found.");
+	let transactionRequest = { data: step.transactionRequest.data };
+	if (executionOptions?.updateTransactionRequestHook) {
+		const customizedTransactionRequest = await executionOptions.updateTransactionRequestHook({
+			requestType: "transaction",
+			...transactionRequest
+		});
+		transactionRequest = {
+			...transactionRequest,
+			...customizedTransactionRequest
+		};
+	}
+	const transactionRequestData = transactionRequest.data;
+	if (!transactionRequestData) throw new require_errors_errors.TransactionError(1008, "Unable to prepare transaction. Transaction request data is not found.");
+	return transactionRequestData;
+};
+//#endregion
+exports.getTransactionRequestData = getTransactionRequestData;
+
+//# sourceMappingURL=getTransactionRequestData.js.map

package/dist/cjs/core/tasks/helpers/getTransactionRequestData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTransactionRequestData.js","names":["TransactionError"],"sources":["../../../../../src/core/tasks/helpers/getTransactionRequestData.ts"],"sourcesContent":["import { LiFiErrorCode } from '../../../errors/constants.js'\nimport { TransactionError } from '../../../errors/errors.js'\nimport type {\n  ExecutionOptions,\n  LiFiStepExtended,\n  TransactionParameters,\n} from '../../../types/core.js'\n\nexport const getTransactionRequestData = async (\n  step: LiFiStepExtended,\n  executionOptions?: ExecutionOptions\n): Promise<string> => {\n  if (!step.transactionRequest?.data) {\n    throw new TransactionError(\n      LiFiErrorCode.TransactionUnprepared,\n      'Unable to prepare transaction. Transaction request data is not found.'\n    )\n  }\n\n  let transactionRequest: TransactionParameters = {\n    data: step.transactionRequest.data,\n  }\n\n  if (executionOptions?.updateTransactionRequestHook) {\n    const customizedTransactionRequest: TransactionParameters =\n      await executionOptions.updateTransactionRequestHook({\n        requestType: 'transaction',\n        ...transactionRequest,\n      })\n\n    transactionRequest = {\n      ...transactionRequest,\n      ...customizedTransactionRequest,\n    }\n  }\n\n  const transactionRequestData = transactionRequest.data\n\n  if (!transactionRequestData) {\n    throw new TransactionError(\n      LiFiErrorCode.TransactionUnprepared,\n      'Unable to prepare transaction. Transaction request data is not found.'\n    )\n  }\n\n  return transactionRequestData\n}\n"],"mappings":";;;;AAQA,MAAa,4BAA4B,OACvC,MACA,qBACoB;CACpB,IAAI,CAAC,KAAK,oBAAoB,MAC5B,MAAM,IAAIA,sBAAAA,iBAAAA,MAER,uEACF;CAGF,IAAI,qBAA4C,EAC9C,MAAM,KAAK,mBAAmB,KAChC;CAEA,IAAI,kBAAkB,8BAA8B;EAClD,MAAM,+BACJ,MAAM,iBAAiB,6BAA6B;GAClD,aAAa;GACb,GAAG;EACL,CAAC;EAEH,qBAAqB;GACnB,GAAG;GACH,GAAG;EACL;CACF;CAEA,MAAM,yBAAyB,mBAAmB;CAElD,IAAI,CAAC,wBACH,MAAM,IAAIA,sBAAAA,iBAAAA,MAER,uEACF;CAGF,OAAO;AACT"}

package/dist/cjs/core/tasks/helpers/stepComparison.d.ts

@@ -0,0 +1,21 @@
+import { ExecutionOptions } from "../../../types/core.js";
+import { StatusManager } from "../../StatusManager.js";
+import { LiFiStep } from "@lifi/types";
+
+//#region src/core/tasks/helpers/stepComparison.d.ts
+/**
+* This method checks whether the new and updated Step meets the required exchange rate conditions.
+* If yes it returns the updated Step.
+* If no and if user interaction is allowed it triggers the acceptExchangeRateUpdateHook. If no user interaction is allowed it aborts.
+* @param statusManager
+* @param oldStep
+* @param newStep
+* @param settings
+* @param allowUserInteraction
+* @param executionOptions
+* @returns Return LiFiStep
+*/
+declare const stepComparison: (statusManager: StatusManager, oldStep: LiFiStep, newStep: LiFiStep, allowUserInteraction: boolean, executionOptions?: ExecutionOptions) => Promise<LiFiStep>;
+//#endregion
+export { stepComparison };
+//# sourceMappingURL=stepComparison.d.ts.map

package/dist/cjs/core/tasks/helpers/stepComparison.js

@@ -0,0 +1,32 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../../errors/constants.js");
+const require_errors_errors = require("../../../errors/errors.js");
+const require_core_utils = require("../../utils.js");
+//#region src/core/tasks/helpers/stepComparison.ts
+/**
+* This method checks whether the new and updated Step meets the required exchange rate conditions.
+* If yes it returns the updated Step.
+* If no and if user interaction is allowed it triggers the acceptExchangeRateUpdateHook. If no user interaction is allowed it aborts.
+* @param statusManager
+* @param oldStep
+* @param newStep
+* @param settings
+* @param allowUserInteraction
+* @param executionOptions
+* @returns Return LiFiStep
+*/
+const stepComparison = async (statusManager, oldStep, newStep, allowUserInteraction, executionOptions) => {
+	if (require_core_utils.checkStepSlippageThreshold(oldStep, newStep)) return statusManager.updateStepInRoute(newStep);
+	let allowStepUpdate;
+	if (allowUserInteraction) allowStepUpdate = await executionOptions?.acceptExchangeRateUpdateHook?.({
+		oldToAmount: oldStep.estimate.toAmount,
+		newToAmount: newStep.estimate.toAmount,
+		toToken: newStep.action.toToken
+	});
+	if (!allowStepUpdate) throw new require_errors_errors.TransactionError(1016, "Exchange rate has changed!\nTransaction was not sent, your funds are still in your wallet.\nThe exchange rate has changed and the previous estimation can not be fulfilled due to value loss.");
+	return statusManager.updateStepInRoute(newStep);
+};
+//#endregion
+exports.stepComparison = stepComparison;
+
+//# sourceMappingURL=stepComparison.js.map

package/dist/cjs/core/tasks/helpers/stepComparison.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepComparison.js","names":["checkStepSlippageThreshold","TransactionError"],"sources":["../../../../../src/core/tasks/helpers/stepComparison.ts"],"sourcesContent":["import type { LiFiStep } from '@lifi/types'\nimport type { StatusManager } from '../../../core/StatusManager.js'\nimport { checkStepSlippageThreshold } from '../../../core/utils.js'\nimport { LiFiErrorCode } from '../../../errors/constants.js'\nimport { TransactionError } from '../../../errors/errors.js'\nimport type { ExecutionOptions } from '../../../types/core.js'\n\n/**\n * This method checks whether the new and updated Step meets the required exchange rate conditions.\n * If yes it returns the updated Step.\n * If no and if user interaction is allowed it triggers the acceptExchangeRateUpdateHook. If no user interaction is allowed it aborts.\n * @param statusManager\n * @param oldStep\n * @param newStep\n * @param settings\n * @param allowUserInteraction\n * @param executionOptions\n * @returns Return LiFiStep\n */\nexport const stepComparison = async (\n  statusManager: StatusManager,\n  oldStep: LiFiStep,\n  newStep: LiFiStep,\n  allowUserInteraction: boolean,\n  executionOptions?: ExecutionOptions\n): Promise<LiFiStep> => {\n  // Check if changed exchange rate is in the range of slippage threshold\n  if (checkStepSlippageThreshold(oldStep, newStep)) {\n    return statusManager.updateStepInRoute(newStep)\n  }\n\n  let allowStepUpdate: boolean | undefined\n  if (allowUserInteraction) {\n    allowStepUpdate = await executionOptions?.acceptExchangeRateUpdateHook?.({\n      oldToAmount: oldStep.estimate.toAmount,\n      newToAmount: newStep.estimate.toAmount,\n      toToken: newStep.action.toToken,\n    })\n  }\n\n  if (!allowStepUpdate) {\n    // The user declined the new exchange rate, so we are not going to proceed\n    throw new TransactionError(\n      LiFiErrorCode.ExchangeRateUpdateCanceled,\n      'Exchange rate has changed!\\nTransaction was not sent, your funds are still in your wallet.\\nThe exchange rate has changed and the previous estimation can not be fulfilled due to value loss.'\n    )\n  }\n\n  return statusManager.updateStepInRoute(newStep)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAmBA,MAAa,iBAAiB,OAC5B,eACA,SACA,SACA,sBACA,qBACsB;CAEtB,IAAIA,mBAAAA,2BAA2B,SAAS,OAAO,GAC7C,OAAO,cAAc,kBAAkB,OAAO;CAGhD,IAAI;CACJ,IAAI,sBACF,kBAAkB,MAAM,kBAAkB,+BAA+B;EACvE,aAAa,QAAQ,SAAS;EAC9B,aAAa,QAAQ,SAAS;EAC9B,SAAS,QAAQ,OAAO;CAC1B,CAAC;CAGH,IAAI,CAAC,iBAEH,MAAM,IAAIC,sBAAAA,iBAAAA,MAER,+LACF;CAGF,OAAO,cAAc,kBAAkB,OAAO;AAChD"}

package/dist/cjs/core/tasks/helpers/waitForTransactionStatus.d.ts

@@ -0,0 +1,9 @@
+import { ExecutionActionType, SDKClient } from "../../../types/core.js";
+import { StatusManager } from "../../StatusManager.js";
+import { LiFiStep, StatusResponse } from "@lifi/types";
+
+//#region src/core/tasks/helpers/waitForTransactionStatus.d.ts
+declare function waitForTransactionStatus(client: SDKClient, statusManager: StatusManager, txHash: string, step: LiFiStep, actionType: ExecutionActionType, interval?: number): Promise<StatusResponse>;
+//#endregion
+export { waitForTransactionStatus };
+//# sourceMappingURL=waitForTransactionStatus.d.ts.map

package/dist/cjs/core/tasks/helpers/waitForTransactionStatus.js

@@ -0,0 +1,48 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors_errors = require("../../../errors/errors.js");
+const require_actions_getStatus = require("../../../actions/getStatus.js");
+const require_core_actionMessages = require("../../actionMessages.js");
+const require_utils_waitForResult = require("../../../utils/waitForResult.js");
+//#region src/core/tasks/helpers/waitForTransactionStatus.ts
+const TRANSACTION_HASH_OBSERVERS = {};
+async function waitForTransactionStatus(client, statusManager, txHash, step, actionType, interval = 5e3) {
+	const _getStatus = () => {
+		return require_actions_getStatus.getStatus(client, {
+			fromChain: step.action.fromChainId,
+			fromAddress: step.action.fromAddress,
+			toChain: step.action.toChainId,
+			txHash,
+			...step.tool !== "custom" && { bridge: step.tool },
+			...step.transactionId && { transactionId: step.transactionId }
+		}).then((statusResponse) => {
+			switch (statusResponse.status) {
+				case "DONE": return statusResponse;
+				case "PENDING":
+					statusManager?.updateAction(step, actionType, "PENDING", {
+						substatus: statusResponse.substatus,
+						substatusMessage: statusResponse.substatusMessage || require_core_actionMessages.getSubstatusMessage(statusResponse.status, statusResponse.substatus),
+						txLink: statusResponse.bridgeExplorerLink
+					});
+					return;
+				case "NOT_FOUND": return;
+				default: return Promise.reject();
+			}
+		}).catch((e) => {
+			if (process.env.NODE_ENV === "development") console.debug("Fetching status from backend failed.", e);
+		});
+	};
+	let status = TRANSACTION_HASH_OBSERVERS[txHash];
+	if (!status) {
+		status = require_utils_waitForResult.waitForResult(_getStatus, interval).finally(() => {
+			delete TRANSACTION_HASH_OBSERVERS[txHash];
+		});
+		TRANSACTION_HASH_OBSERVERS[txHash] = status;
+	}
+	const resolvedStatus = await status;
+	if (!("receiving" in resolvedStatus)) throw new require_errors_errors.ServerError("Status doesn't contain destination chain information.");
+	return resolvedStatus;
+}
+//#endregion
+exports.waitForTransactionStatus = waitForTransactionStatus;
+
+//# sourceMappingURL=waitForTransactionStatus.js.map

package/dist/cjs/core/tasks/helpers/waitForTransactionStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitForTransactionStatus.js","names":["getStatus","getSubstatusMessage","waitForResult","ServerError"],"sources":["../../../../../src/core/tasks/helpers/waitForTransactionStatus.ts"],"sourcesContent":["import type { FullStatusData, LiFiStep, StatusResponse } from '@lifi/types'\nimport { getStatus } from '../../../actions/getStatus.js'\nimport { ServerError } from '../../../errors/errors.js'\nimport type { ExecutionActionType, SDKClient } from '../../../types/core.js'\nimport { waitForResult } from '../../../utils/waitForResult.js'\nimport { getSubstatusMessage } from '../../actionMessages.js'\nimport type { StatusManager } from '../../StatusManager.js'\n\nconst TRANSACTION_HASH_OBSERVERS: Record<string, Promise<StatusResponse>> = {}\n\nexport async function waitForTransactionStatus(\n  client: SDKClient,\n  statusManager: StatusManager,\n  txHash: string,\n  step: LiFiStep,\n  actionType: ExecutionActionType,\n  interval = 5_000\n): Promise<StatusResponse> {\n  const _getStatus = (): Promise<StatusResponse | undefined> => {\n    return getStatus(client, {\n      fromChain: step.action.fromChainId,\n      fromAddress: step.action.fromAddress,\n      toChain: step.action.toChainId,\n      txHash,\n      ...(step.tool !== 'custom' && { bridge: step.tool }),\n      ...(step.transactionId && { transactionId: step.transactionId }),\n    })\n      .then((statusResponse) => {\n        switch (statusResponse.status) {\n          case 'DONE':\n            return statusResponse\n          case 'PENDING':\n            statusManager?.updateAction(step, actionType, 'PENDING', {\n              substatus: statusResponse.substatus,\n              substatusMessage:\n                statusResponse.substatusMessage ||\n                getSubstatusMessage(\n                  statusResponse.status,\n                  statusResponse.substatus\n                ),\n              txLink: (statusResponse as FullStatusData).bridgeExplorerLink,\n            })\n            return undefined\n          case 'NOT_FOUND':\n            return undefined\n          default:\n            return Promise.reject()\n        }\n      })\n      .catch((e) => {\n        if (process.env.NODE_ENV === 'development') {\n          console.debug('Fetching status from backend failed.', e)\n        }\n        return undefined\n      })\n  }\n\n  let status = TRANSACTION_HASH_OBSERVERS[txHash]\n\n  if (!status) {\n    status = waitForResult(_getStatus, interval).finally(() => {\n      delete TRANSACTION_HASH_OBSERVERS[txHash]\n    })\n    TRANSACTION_HASH_OBSERVERS[txHash] = status\n  }\n\n  const resolvedStatus = await status\n\n  if (!('receiving' in resolvedStatus)) {\n    throw new ServerError(\n      \"Status doesn't contain destination chain information.\"\n    )\n  }\n\n  return resolvedStatus\n}\n"],"mappings":";;;;;;AAQA,MAAM,6BAAsE,CAAC;AAE7E,eAAsB,yBACpB,QACA,eACA,QACA,MACA,YACA,WAAW,KACc;CACzB,MAAM,mBAAwD;EAC5D,OAAOA,0BAAAA,UAAU,QAAQ;GACvB,WAAW,KAAK,OAAO;GACvB,aAAa,KAAK,OAAO;GACzB,SAAS,KAAK,OAAO;GACrB;GACA,GAAI,KAAK,SAAS,YAAY,EAAE,QAAQ,KAAK,KAAK;GAClD,GAAI,KAAK,iBAAiB,EAAE,eAAe,KAAK,cAAc;EAChE,CAAC,EACE,MAAM,mBAAmB;GACxB,QAAQ,eAAe,QAAvB;IACE,KAAK,QACH,OAAO;IACT,KAAK;KACH,eAAe,aAAa,MAAM,YAAY,WAAW;MACvD,WAAW,eAAe;MAC1B,kBACE,eAAe,oBACfC,4BAAAA,oBACE,eAAe,QACf,eAAe,SACjB;MACF,QAAS,eAAkC;KAC7C,CAAC;KACD;IACF,KAAK,aACH;IACF,SACE,OAAO,QAAQ,OAAO;GAC1B;EACF,CAAC,EACA,OAAO,MAAM;GACZ,IAAI,QAAQ,IAAI,aAAa,eAC3B,QAAQ,MAAM,wCAAwC,CAAC;EAG3D,CAAC;CACL;CAEA,IAAI,SAAS,2BAA2B;CAExC,IAAI,CAAC,QAAQ;EACX,SAASC,4BAAAA,cAAc,YAAY,QAAQ,EAAE,cAAc;GACzD,OAAO,2BAA2B;EACpC,CAAC;EACD,2BAA2B,UAAU;CACvC;CAEA,MAAM,iBAAiB,MAAM;CAE7B,IAAI,EAAE,eAAe,iBACnB,MAAM,IAAIC,sBAAAA,YACR,uDACF;CAGF,OAAO;AACT"}

package/dist/cjs/core/utils.d.ts

@@ -0,0 +1,17 @@
+import { RPCUrls } from "../types/core.js";
+import { ChainId, ExtendedChain, LiFiStep } from "@lifi/types";
+
+//#region src/core/utils.d.ts
+/**
+* Used to check if changed exchange rate is in the range of slippage threshold.
+* We use a slippage value as a threshold to trigger the rate change hook.
+* This can result in almost doubled slippage for the user and need to be revisited.
+* @param oldStep - old step
+* @param newStep - new step
+* @returns Boolean
+*/
+declare function checkStepSlippageThreshold(oldStep: LiFiStep, newStep: LiFiStep): boolean;
+declare function getRpcUrlsFromChains(existingRpcUrls: RPCUrls, chains: ExtendedChain[], skipChains?: ChainId[]): RPCUrls;
+//#endregion
+export { checkStepSlippageThreshold, getRpcUrlsFromChains };
+//# sourceMappingURL=utils.d.ts.map

package/dist/cjs/core/utils.js

@@ -0,0 +1,42 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/core/utils.ts
+const standardThreshold = .005;
+/**
+* Used to check if changed exchange rate is in the range of slippage threshold.
+* We use a slippage value as a threshold to trigger the rate change hook.
+* This can result in almost doubled slippage for the user and need to be revisited.
+* @param oldStep - old step
+* @param newStep - new step
+* @returns Boolean
+*/
+function checkStepSlippageThreshold(oldStep, newStep) {
+	const setSlippage = oldStep.action.slippage || standardThreshold;
+	const oldEstimatedToAmount = BigInt(oldStep.estimate.toAmountMin);
+	const amountDifference = oldEstimatedToAmount - BigInt(newStep.estimate.toAmountMin);
+	let actualSlippage = 0;
+	if (oldEstimatedToAmount > 0) actualSlippage = Number(amountDifference * 1000000000n / oldEstimatedToAmount) / 1e9;
+	return actualSlippage <= setSlippage;
+}
+function getRpcUrlsFromChains(existingRpcUrls, chains, skipChains) {
+	const rpcUrlsFromChains = chains.reduce((rpcUrls, chain) => {
+		if (chain.metamask?.rpcUrls?.length) rpcUrls[chain.id] = chain.metamask.rpcUrls;
+		return rpcUrls;
+	}, {});
+	const result = { ...existingRpcUrls };
+	for (const rpcUrlsKey in rpcUrlsFromChains) {
+		const chainId = Number(rpcUrlsKey);
+		const urls = rpcUrlsFromChains[chainId];
+		if (!urls?.length) continue;
+		if (!result[chainId]?.length) result[chainId] = Array.from(urls);
+		else if (!skipChains?.includes(chainId)) {
+			const filteredUrls = urls.filter((url) => !result[chainId]?.includes(url));
+			result[chainId].push(...filteredUrls);
+		}
+	}
+	return result;
+}
+//#endregion
+exports.checkStepSlippageThreshold = checkStepSlippageThreshold;
+exports.getRpcUrlsFromChains = getRpcUrlsFromChains;
+
+//# sourceMappingURL=utils.js.map

package/dist/cjs/core/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../../src/core/utils.ts"],"sourcesContent":["import type { ChainId, ExtendedChain, LiFiStep } from '@lifi/types'\nimport type { RPCUrls } from '../types/core.js'\n\n// Standard threshold for destination amount difference (0.5%)\nconst standardThreshold = 0.005\n\n/**\n * Used to check if changed exchange rate is in the range of slippage threshold.\n * We use a slippage value as a threshold to trigger the rate change hook.\n * This can result in almost doubled slippage for the user and need to be revisited.\n * @param oldStep - old step\n * @param newStep - new step\n * @returns Boolean\n */\nexport function checkStepSlippageThreshold(\n  oldStep: LiFiStep,\n  newStep: LiFiStep\n): boolean {\n  const setSlippage = oldStep.action.slippage || standardThreshold\n  const oldEstimatedToAmount = BigInt(oldStep.estimate.toAmountMin)\n  const newEstimatedToAmount = BigInt(newStep.estimate.toAmountMin)\n  const amountDifference = oldEstimatedToAmount - newEstimatedToAmount\n  // oldEstimatedToAmount can be 0 when we use contract calls\n  let actualSlippage = 0\n  if (oldEstimatedToAmount > 0) {\n    actualSlippage =\n      Number((amountDifference * 1_000_000_000n) / oldEstimatedToAmount) /\n      1_000_000_000\n  }\n  return actualSlippage <= setSlippage\n}\n\nexport function getRpcUrlsFromChains(\n  existingRpcUrls: RPCUrls,\n  chains: ExtendedChain[],\n  skipChains?: ChainId[]\n): RPCUrls {\n  const rpcUrlsFromChains = chains.reduce((rpcUrls, chain) => {\n    if (chain.metamask?.rpcUrls?.length) {\n      rpcUrls[chain.id as ChainId] = chain.metamask.rpcUrls\n    }\n    return rpcUrls\n  }, {} as RPCUrls)\n  const result = { ...existingRpcUrls }\n  for (const rpcUrlsKey in rpcUrlsFromChains) {\n    const chainId = Number(rpcUrlsKey) as ChainId\n    const urls = rpcUrlsFromChains[chainId]\n    if (!urls?.length) {\n      continue\n    }\n    if (!result[chainId]?.length) {\n      result[chainId] = Array.from(urls)\n    } else if (!skipChains?.includes(chainId)) {\n      const filteredUrls = urls.filter((url) => !result[chainId]?.includes(url))\n      result[chainId].push(...filteredUrls)\n    }\n  }\n  return result\n}\n"],"mappings":";;AAIA,MAAM,oBAAoB;;;;;;;;;AAU1B,SAAgB,2BACd,SACA,SACS;CACT,MAAM,cAAc,QAAQ,OAAO,YAAY;CAC/C,MAAM,uBAAuB,OAAO,QAAQ,SAAS,WAAW;CAEhE,MAAM,mBAAmB,uBADI,OAAO,QAAQ,SAAS,WACc;CAEnE,IAAI,iBAAiB;CACrB,IAAI,uBAAuB,GACzB,iBACE,OAAQ,mBAAmB,cAAkB,oBAAoB,IACjE;CAEJ,OAAO,kBAAkB;AAC3B;AAEA,SAAgB,qBACd,iBACA,QACA,YACS;CACT,MAAM,oBAAoB,OAAO,QAAQ,SAAS,UAAU;EAC1D,IAAI,MAAM,UAAU,SAAS,QAC3B,QAAQ,MAAM,MAAiB,MAAM,SAAS;EAEhD,OAAO;CACT,GAAG,CAAC,CAAY;CAChB,MAAM,SAAS,EAAE,GAAG,gBAAgB;CACpC,KAAK,MAAM,cAAc,mBAAmB;EAC1C,MAAM,UAAU,OAAO,UAAU;EACjC,MAAM,OAAO,kBAAkB;EAC/B,IAAI,CAAC,MAAM,QACT;EAEF,IAAI,CAAC,OAAO,UAAU,QACpB,OAAO,WAAW,MAAM,KAAK,IAAI;OAC5B,IAAI,CAAC,YAAY,SAAS,OAAO,GAAG;GACzC,MAAM,eAAe,KAAK,QAAQ,QAAQ,CAAC,OAAO,UAAU,SAAS,GAAG,CAAC;GACzE,OAAO,SAAS,KAAK,GAAG,YAAY;EACtC;CACF;CACA,OAAO;AACT"}

package/dist/cjs/errors/SDKError.d.ts

@@ -0,0 +1,17 @@
+import { ExecutionAction } from "../types/core.js";
+import { ErrorCode } from "./constants.js";
+import { BaseError } from "./baseError.js";
+import { LiFiStep } from "@lifi/types";
+
+//#region src/errors/SDKError.d.ts
+declare class SDKError extends Error {
+  step?: LiFiStep;
+  action?: ExecutionAction;
+  code: ErrorCode;
+  override name: string;
+  override cause: BaseError;
+  constructor(cause: BaseError, step?: LiFiStep, action?: ExecutionAction);
+}
+//#endregion
+export { SDKError };
+//# sourceMappingURL=SDKError.d.ts.map

package/dist/cjs/errors/SDKError.js

@@ -0,0 +1,24 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_version = require("../version.js");
+//#region src/errors/SDKError.ts
+var SDKError = class extends Error {
+	step;
+	action;
+	code;
+	name = "SDKError";
+	cause;
+	constructor(cause, step, action) {
+		const errorMessage = `${cause.message ? `[${cause.name}] ${cause.message}` : "Unknown error occurred"}\nLI.FI SDK version: ${require_version.version}`;
+		super(errorMessage);
+		this.name = "SDKError";
+		this.step = step;
+		this.action = action;
+		this.cause = cause;
+		this.stack = this.cause.stack;
+		this.code = cause.code;
+	}
+};
+//#endregion
+exports.SDKError = SDKError;
+
+//# sourceMappingURL=SDKError.js.map

package/dist/cjs/errors/SDKError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SDKError.js","names":["version"],"sources":["../../../src/errors/SDKError.ts"],"sourcesContent":["import type { LiFiStep } from '@lifi/types'\nimport type { ExecutionAction } from '../types/core.js'\nimport { version } from '../version.js'\nimport type { BaseError } from './baseError.js'\nimport type { ErrorCode } from './constants.js'\n\n// Note: SDKError is used to wrapper and present errors at the top level\n// Where opportunity allows we also add the step and the action related to the error\nexport class SDKError extends Error {\n  step?: LiFiStep\n  action?: ExecutionAction\n  code: ErrorCode\n  override name = 'SDKError'\n  override cause: BaseError\n\n  constructor(cause: BaseError, step?: LiFiStep, action?: ExecutionAction) {\n    const errorMessage = `${cause.message ? `[${cause.name}] ${cause.message}` : 'Unknown error occurred'}\\nLI.FI SDK version: ${version}`\n    super(errorMessage)\n    this.name = 'SDKError'\n    this.step = step\n    this.action = action\n    this.cause = cause\n    this.stack = this.cause.stack\n    this.code = cause.code\n  }\n}\n"],"mappings":";;;AAQA,IAAa,WAAb,cAA8B,MAAM;CAClC;CACA;CACA;CACA,OAAgB;CAChB;CAEA,YAAY,OAAkB,MAAiB,QAA0B;EACvE,MAAM,eAAe,GAAG,MAAM,UAAU,IAAI,MAAM,KAAK,IAAI,MAAM,YAAY,yBAAyB,uBAAuBA,gBAAAA;EAC7H,MAAM,YAAY;EAClB,KAAK,OAAO;EACZ,KAAK,OAAO;EACZ,KAAK,SAAS;EACd,KAAK,QAAQ;EACb,KAAK,QAAQ,KAAK,MAAM;EACxB,KAAK,OAAO,MAAM;CACpB;AACF"}

package/dist/cjs/errors/baseError.d.ts

@@ -0,0 +1,11 @@
+import { ErrorCode, ErrorName } from "./constants.js";
+
+//#region src/errors/baseError.d.ts
+declare class BaseError extends Error {
+  code: ErrorCode;
+  override cause?: Error;
+  constructor(name: ErrorName, code: number, message: string, cause?: Error);
+}
+//#endregion
+export { BaseError };
+//# sourceMappingURL=baseError.d.ts.map

package/dist/cjs/errors/baseError.js

@@ -0,0 +1,19 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors_utils_rootCause = require("./utils/rootCause.js");
+//#region src/errors/baseError.ts
+var BaseError = class extends Error {
+	code;
+	cause;
+	constructor(name, code, message, cause) {
+		super(message);
+		this.name = name;
+		this.code = code;
+		this.cause = cause;
+		const rootCause = require_errors_utils_rootCause.getRootCause(this.cause);
+		if (rootCause?.stack) this.stack = rootCause.stack;
+	}
+};
+//#endregion
+exports.BaseError = BaseError;
+
+//# sourceMappingURL=baseError.js.map

package/dist/cjs/errors/baseError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseError.js","names":["getRootCause"],"sources":["../../../src/errors/baseError.ts"],"sourcesContent":["import type { ErrorCode, ErrorName } from './constants.js'\nimport { getRootCause } from './utils/rootCause.js'\n\n// Note: we use the BaseErrors to capture errors at specific points in the code\n// they can carry addition to help give more context\nexport class BaseError extends Error {\n  code: ErrorCode\n  override cause?: Error\n\n  constructor(name: ErrorName, code: number, message: string, cause?: Error) {\n    super(message)\n\n    this.name = name\n    this.code = code\n    this.cause = cause\n\n    const rootCause = getRootCause(this.cause)\n    if (rootCause?.stack) {\n      this.stack = rootCause.stack\n    }\n  }\n}\n"],"mappings":";;;AAKA,IAAa,YAAb,cAA+B,MAAM;CACnC;CACA;CAEA,YAAY,MAAiB,MAAc,SAAiB,OAAe;EACzE,MAAM,OAAO;EAEb,KAAK,OAAO;EACZ,KAAK,OAAO;EACZ,KAAK,QAAQ;EAEb,MAAM,YAAYA,+BAAAA,aAAa,KAAK,KAAK;EACzC,IAAI,WAAW,OACb,KAAK,QAAQ,UAAU;CAE3B;AACF"}

package/dist/cjs/errors/constants.d.ts

@@ -0,0 +1,55 @@
+//#region src/errors/constants.d.ts
+declare enum ErrorName {
+  RPCError = "RPCError",
+  ProviderError = "ProviderError",
+  ServerError = "ServerError",
+  TransactionError = "TransactionError",
+  ValidationError = "ValidationError",
+  BalanceError = "BalanceError",
+  NotFoundError = "NotFoundError",
+  UnknownError = "UnknownError",
+  SlippageError = "SlippageError",
+  HTTPError = "HTTPError",
+  ConfigError = "ConfigError",
+  ExecuteStepRetryError = "ExecuteStepRetryError"
+}
+type ErrorCode = LiFiErrorCode;
+declare enum LiFiErrorCode {
+  InternalError = 1e3,
+  ValidationError = 1001,
+  TransactionUnderpriced = 1002,
+  TransactionFailed = 1003,
+  Timeout = 1004,
+  ProviderUnavailable = 1005,
+  NotFound = 1006,
+  ChainSwitchError = 1007,
+  TransactionUnprepared = 1008,
+  GasLimitError = 1009,
+  TransactionCanceled = 1010,
+  SlippageError = 1011,
+  SignatureRejected = 1012,
+  BalanceError = 1013,
+  AllowanceRequired = 1014,
+  InsufficientFunds = 1015,
+  ExchangeRateUpdateCanceled = 1016,
+  WalletChangedDuringExecution = 1017,
+  TransactionExpired = 1018,
+  TransactionSimulationFailed = 1019,
+  TransactionConflict = 1020,
+  TransactionNotFound = 1021,
+  TransactionRejected = 1022,
+  RateLimitExceeded = 1023,
+  ThirdPartyError = 1024,
+  InsufficientGas = 1025,
+  ConfigError = 1026
+}
+declare enum ErrorMessage {
+  UnknownError = "Unknown error occurred.",
+  SlippageError = "The slippage is larger than the defined threshold. Please request a new route to get a fresh quote.",
+  GasLimitLow = "Gas limit is too low.",
+  TransactionUnderpriced = "Transaction is underpriced.",
+  TransactionReverted = "Transaction was reverted."
+}
+//#endregion
+export { ErrorCode, ErrorMessage, ErrorName, LiFiErrorCode };
+//# sourceMappingURL=constants.d.ts.map

package/dist/cjs/errors/constants.js

@@ -0,0 +1,61 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/errors/constants.ts
+let ErrorName = /* @__PURE__ */ function(ErrorName) {
+	ErrorName["RPCError"] = "RPCError";
+	ErrorName["ProviderError"] = "ProviderError";
+	ErrorName["ServerError"] = "ServerError";
+	ErrorName["TransactionError"] = "TransactionError";
+	ErrorName["ValidationError"] = "ValidationError";
+	ErrorName["BalanceError"] = "BalanceError";
+	ErrorName["NotFoundError"] = "NotFoundError";
+	ErrorName["UnknownError"] = "UnknownError";
+	ErrorName["SlippageError"] = "SlippageError";
+	ErrorName["HTTPError"] = "HTTPError";
+	ErrorName["ConfigError"] = "ConfigError";
+	ErrorName["ExecuteStepRetryError"] = "ExecuteStepRetryError";
+	return ErrorName;
+}({});
+let LiFiErrorCode = /* @__PURE__ */ function(LiFiErrorCode) {
+	LiFiErrorCode[LiFiErrorCode["InternalError"] = 1e3] = "InternalError";
+	LiFiErrorCode[LiFiErrorCode["ValidationError"] = 1001] = "ValidationError";
+	LiFiErrorCode[LiFiErrorCode["TransactionUnderpriced"] = 1002] = "TransactionUnderpriced";
+	LiFiErrorCode[LiFiErrorCode["TransactionFailed"] = 1003] = "TransactionFailed";
+	LiFiErrorCode[LiFiErrorCode["Timeout"] = 1004] = "Timeout";
+	LiFiErrorCode[LiFiErrorCode["ProviderUnavailable"] = 1005] = "ProviderUnavailable";
+	LiFiErrorCode[LiFiErrorCode["NotFound"] = 1006] = "NotFound";
+	LiFiErrorCode[LiFiErrorCode["ChainSwitchError"] = 1007] = "ChainSwitchError";
+	LiFiErrorCode[LiFiErrorCode["TransactionUnprepared"] = 1008] = "TransactionUnprepared";
+	LiFiErrorCode[LiFiErrorCode["GasLimitError"] = 1009] = "GasLimitError";
+	LiFiErrorCode[LiFiErrorCode["TransactionCanceled"] = 1010] = "TransactionCanceled";
+	LiFiErrorCode[LiFiErrorCode["SlippageError"] = 1011] = "SlippageError";
+	LiFiErrorCode[LiFiErrorCode["SignatureRejected"] = 1012] = "SignatureRejected";
+	LiFiErrorCode[LiFiErrorCode["BalanceError"] = 1013] = "BalanceError";
+	LiFiErrorCode[LiFiErrorCode["AllowanceRequired"] = 1014] = "AllowanceRequired";
+	LiFiErrorCode[LiFiErrorCode["InsufficientFunds"] = 1015] = "InsufficientFunds";
+	LiFiErrorCode[LiFiErrorCode["ExchangeRateUpdateCanceled"] = 1016] = "ExchangeRateUpdateCanceled";
+	LiFiErrorCode[LiFiErrorCode["WalletChangedDuringExecution"] = 1017] = "WalletChangedDuringExecution";
+	LiFiErrorCode[LiFiErrorCode["TransactionExpired"] = 1018] = "TransactionExpired";
+	LiFiErrorCode[LiFiErrorCode["TransactionSimulationFailed"] = 1019] = "TransactionSimulationFailed";
+	LiFiErrorCode[LiFiErrorCode["TransactionConflict"] = 1020] = "TransactionConflict";
+	LiFiErrorCode[LiFiErrorCode["TransactionNotFound"] = 1021] = "TransactionNotFound";
+	LiFiErrorCode[LiFiErrorCode["TransactionRejected"] = 1022] = "TransactionRejected";
+	LiFiErrorCode[LiFiErrorCode["RateLimitExceeded"] = 1023] = "RateLimitExceeded";
+	LiFiErrorCode[LiFiErrorCode["ThirdPartyError"] = 1024] = "ThirdPartyError";
+	LiFiErrorCode[LiFiErrorCode["InsufficientGas"] = 1025] = "InsufficientGas";
+	LiFiErrorCode[LiFiErrorCode["ConfigError"] = 1026] = "ConfigError";
+	return LiFiErrorCode;
+}({});
+let ErrorMessage = /* @__PURE__ */ function(ErrorMessage) {
+	ErrorMessage["UnknownError"] = "Unknown error occurred.";
+	ErrorMessage["SlippageError"] = "The slippage is larger than the defined threshold. Please request a new route to get a fresh quote.";
+	ErrorMessage["GasLimitLow"] = "Gas limit is too low.";
+	ErrorMessage["TransactionUnderpriced"] = "Transaction is underpriced.";
+	ErrorMessage["TransactionReverted"] = "Transaction was reverted.";
+	return ErrorMessage;
+}({});
+//#endregion
+exports.ErrorMessage = ErrorMessage;
+exports.ErrorName = ErrorName;
+exports.LiFiErrorCode = LiFiErrorCode;
+
+//# sourceMappingURL=constants.js.map

package/dist/cjs/errors/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","names":[],"sources":["../../../src/errors/constants.ts"],"sourcesContent":["export enum ErrorName {\n  RPCError = 'RPCError',\n  ProviderError = 'ProviderError',\n  ServerError = 'ServerError',\n  TransactionError = 'TransactionError',\n  ValidationError = 'ValidationError',\n  BalanceError = 'BalanceError',\n  NotFoundError = 'NotFoundError',\n  UnknownError = 'UnknownError',\n  SlippageError = 'SlippageError',\n  HTTPError = 'HTTPError',\n  ConfigError = 'ConfigError',\n  ExecuteStepRetryError = 'ExecuteStepRetryError',\n}\n\nexport type ErrorCode = LiFiErrorCode\n\nexport enum LiFiErrorCode {\n  InternalError = 1000,\n  ValidationError = 1001,\n  TransactionUnderpriced = 1002,\n  TransactionFailed = 1003,\n  Timeout = 1004,\n  ProviderUnavailable = 1005,\n  NotFound = 1006,\n  ChainSwitchError = 1007,\n  TransactionUnprepared = 1008,\n  GasLimitError = 1009,\n  TransactionCanceled = 1010,\n  SlippageError = 1011,\n  SignatureRejected = 1012,\n  BalanceError = 1013,\n  AllowanceRequired = 1014,\n  InsufficientFunds = 1015,\n  ExchangeRateUpdateCanceled = 1016,\n  WalletChangedDuringExecution = 1017,\n  TransactionExpired = 1018,\n  TransactionSimulationFailed = 1019,\n  TransactionConflict = 1020,\n  TransactionNotFound = 1021,\n  TransactionRejected = 1022,\n  RateLimitExceeded = 1023,\n  ThirdPartyError = 1024,\n  InsufficientGas = 1025,\n  ConfigError = 1026,\n}\n\nexport enum ErrorMessage {\n  UnknownError = 'Unknown error occurred.',\n  SlippageError = 'The slippage is larger than the defined threshold. Please request a new route to get a fresh quote.',\n  GasLimitLow = 'Gas limit is too low.',\n  TransactionUnderpriced = 'Transaction is underpriced.',\n  TransactionReverted = 'Transaction was reverted.',\n}\n"],"mappings":";;AAAA,IAAY,YAAL,yBAAA,WAAA;CACL,UAAA,cAAA;CACA,UAAA,mBAAA;CACA,UAAA,iBAAA;CACA,UAAA,sBAAA;CACA,UAAA,qBAAA;CACA,UAAA,kBAAA;CACA,UAAA,mBAAA;CACA,UAAA,kBAAA;CACA,UAAA,mBAAA;CACA,UAAA,eAAA;CACA,UAAA,iBAAA;CACA,UAAA,2BAAA;;AACF,EAAA,CAAA,CAAA;AAIA,IAAY,gBAAL,yBAAA,eAAA;CACL,cAAA,cAAA,mBAAA,OAAA;CACA,cAAA,cAAA,qBAAA,QAAA;CACA,cAAA,cAAA,4BAAA,QAAA;CACA,cAAA,cAAA,uBAAA,QAAA;CACA,cAAA,cAAA,aAAA,QAAA;CACA,cAAA,cAAA,yBAAA,QAAA;CACA,cAAA,cAAA,cAAA,QAAA;CACA,cAAA,cAAA,sBAAA,QAAA;CACA,cAAA,cAAA,2BAAA,QAAA;CACA,cAAA,cAAA,mBAAA,QAAA;CACA,cAAA,cAAA,yBAAA,QAAA;CACA,cAAA,cAAA,mBAAA,QAAA;CACA,cAAA,cAAA,uBAAA,QAAA;CACA,cAAA,cAAA,kBAAA,QAAA;CACA,cAAA,cAAA,uBAAA,QAAA;CACA,cAAA,cAAA,uBAAA,QAAA;CACA,cAAA,cAAA,gCAAA,QAAA;CACA,cAAA,cAAA,kCAAA,QAAA;CACA,cAAA,cAAA,wBAAA,QAAA;CACA,cAAA,cAAA,iCAAA,QAAA;CACA,cAAA,cAAA,yBAAA,QAAA;CACA,cAAA,cAAA,yBAAA,QAAA;CACA,cAAA,cAAA,yBAAA,QAAA;CACA,cAAA,cAAA,uBAAA,QAAA;CACA,cAAA,cAAA,qBAAA,QAAA;CACA,cAAA,cAAA,qBAAA,QAAA;CACA,cAAA,cAAA,iBAAA,QAAA;;AACF,EAAA,CAAA,CAAA;AAEA,IAAY,eAAL,yBAAA,cAAA;CACL,aAAA,kBAAA;CACA,aAAA,mBAAA;CACA,aAAA,iBAAA;CACA,aAAA,4BAAA;CACA,aAAA,yBAAA;;AACF,EAAA,CAAA,CAAA"}