@lifi/sdk 4.0.0-beta.0 → 4.0.0-beta.10

package/dist/esm/core/tasks/WaitForTransactionStatusTask.js

@@ -1,74 +1,61 @@
-import { LiFiErrorCode } from '../../errors/constants.js';
-import { TransactionError } from '../../errors/errors.js';
-import { getTransactionFailedMessage } from '../../utils/getTransactionMessage.js';
-import { BaseStepExecutionTask } from '../BaseStepExecutionTask.js';
-import { waitForTransactionStatus } from './helpers/waitForTransactionStatus.js';
-export class WaitForTransactionStatusTask extends BaseStepExecutionTask {
-    actionType;
-    constructor(actionType) {
-        super();
-        this.actionType = actionType;
-    }
-    async run(context) {
-        const { client, step, statusManager, pollingIntervalMs, toChain, isBridgeExecution, } = context;
-        // At this point, we should have a txHash or taskId
-        // taskId is used for custom integrations that don't use the standard transaction hash
-        let transactionHash;
-        try {
-            const swapOrBridgeAction = statusManager.findAction(step, isBridgeExecution ? 'CROSS_CHAIN' : 'SWAP');
-            transactionHash = swapOrBridgeAction?.txHash || swapOrBridgeAction?.taskId;
-            // Wait for the transaction status on the destination chain
-            if (!transactionHash) {
-                throw new Error('Transaction hash is undefined.');
-            }
-            const action = statusManager.initializeAction({
-                step,
-                type: this.actionType,
-                chainId: this.actionType === 'RECEIVING_CHAIN'
-                    ? step.action.toChainId
-                    : step.action.fromChainId,
-                status: 'PENDING',
-            });
-            const statusResponse = (await waitForTransactionStatus(client, statusManager, transactionHash, step, action.type, pollingIntervalMs));
-            const statusReceiving = statusResponse.receiving;
-            // Update action status
-            statusManager.updateAction(step, action.type, 'DONE', {
-                chainId: statusReceiving?.chainId || toChain.id,
-                substatus: statusResponse.substatus,
-                substatusMessage: statusResponse.substatusMessage,
-                txHash: statusReceiving?.txHash,
-                txLink: statusReceiving?.txLink ||
-                    `${toChain.metamask.blockExplorerUrls[0]}tx/${statusReceiving?.txHash}`,
-            });
-            // Update execution status
-            statusManager.updateExecution(step, {
-                status: 'DONE',
-                ...(statusResponse.sending.amount && {
-                    fromAmount: statusResponse.sending.amount,
-                }),
-                ...(statusReceiving?.amount && { toAmount: statusReceiving.amount }),
-                ...(statusReceiving?.token && { toToken: statusReceiving.token }),
-                internalTxLink: statusResponse?.lifiExplorerLink,
-                externalTxLink: statusResponse?.bridgeExplorerLink,
-                gasCosts: [
-                    {
-                        amount: statusResponse.sending.gasAmount,
-                        amountUSD: statusResponse.sending.gasAmountUSD,
-                        token: statusResponse.sending.gasToken,
-                        estimate: statusResponse.sending.gasUsed,
-                        limit: statusResponse.sending.gasUsed,
-                        price: statusResponse.sending.gasPrice,
-                        type: 'SEND',
-                    },
-                ],
-            });
-            return { status: 'COMPLETED' };
-        }
-        catch (e) {
-            const htmlMessage = await getTransactionFailedMessage(client, step, `${toChain.metamask.blockExplorerUrls[0]}tx/${transactionHash}`);
-            throw new TransactionError(LiFiErrorCode.TransactionFailed, htmlMessage ??
-                'Failed while waiting for status of destination chain transaction.', e);
-        }
-    }
-}
+import "../../errors/constants.js";
+import { TransactionError } from "../../errors/errors.js";
+import { BaseStepExecutionTask } from "../BaseStepExecutionTask.js";
+import { getTransactionFailedMessage } from "../../utils/getTransactionMessage.js";
+import { waitForTransactionStatus } from "./helpers/waitForTransactionStatus.js";
+//#region src/core/tasks/WaitForTransactionStatusTask.ts
+var WaitForTransactionStatusTask = class extends BaseStepExecutionTask {
+	actionType;
+	constructor(actionType) {
+		super();
+		this.actionType = actionType;
+	}
+	async run(context) {
+		const { client, step, statusManager, pollingIntervalMs, toChain, isBridgeExecution } = context;
+		let transactionHash;
+		try {
+			const swapOrBridgeAction = statusManager.findAction(step, isBridgeExecution ? "CROSS_CHAIN" : "SWAP");
+			transactionHash = swapOrBridgeAction?.txHash || swapOrBridgeAction?.taskId;
+			if (!transactionHash) throw new Error("Transaction hash is undefined.");
+			const action = statusManager.initializeAction({
+				step,
+				type: this.actionType,
+				chainId: this.actionType === "RECEIVING_CHAIN" ? step.action.toChainId : step.action.fromChainId,
+				status: "PENDING"
+			});
+			const statusResponse = await waitForTransactionStatus(client, statusManager, transactionHash, step, action.type, pollingIntervalMs);
+			const statusReceiving = statusResponse.receiving;
+			statusManager.updateAction(step, action.type, "DONE", {
+				chainId: statusReceiving?.chainId || toChain.id,
+				substatus: statusResponse.substatus,
+				substatusMessage: statusResponse.substatusMessage,
+				txHash: statusReceiving?.txHash,
+				txLink: statusReceiving?.txLink || `${toChain.metamask.blockExplorerUrls[0]}tx/${statusReceiving?.txHash}`
+			});
+			statusManager.updateExecution(step, {
+				status: "DONE",
+				...statusResponse.sending.amount && { fromAmount: statusResponse.sending.amount },
+				...statusReceiving?.amount && { toAmount: statusReceiving.amount },
+				...statusReceiving?.token && { toToken: statusReceiving.token },
+				internalTxLink: statusResponse?.lifiExplorerLink,
+				externalTxLink: statusResponse?.bridgeExplorerLink,
+				gasCosts: [{
+					amount: statusResponse.sending.gasAmount,
+					amountUSD: statusResponse.sending.gasAmountUSD,
+					token: statusResponse.sending.gasToken,
+					estimate: statusResponse.sending.gasUsed,
+					limit: statusResponse.sending.gasUsed,
+					price: statusResponse.sending.gasPrice,
+					type: "SEND"
+				}]
+			});
+			return { status: "COMPLETED" };
+		} catch (e) {
+			throw new TransactionError(1003, await getTransactionFailedMessage(client, step, `${toChain.metamask.blockExplorerUrls[0]}tx/${transactionHash}`) ?? "Failed while waiting for status of destination chain transaction.", e);
+		}
+	}
+};
+//#endregion
+export { WaitForTransactionStatusTask };
+
 //# sourceMappingURL=WaitForTransactionStatusTask.js.map

package/dist/esm/core/tasks/WaitForTransactionStatusTask.js.map

@@ -1 +1 @@
-{"version":3,"file":"WaitForTransactionStatusTask.js","sourceRoot":"","sources":["../../../../src/core/tasks/WaitForTransactionStatusTask.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"WaitForTransactionStatusTask.js","names":[],"sources":["../../../../src/core/tasks/WaitForTransactionStatusTask.ts"],"sourcesContent":["import type { ExtendedTransactionInfo, FullStatusData } from '@lifi/types'\nimport { LiFiErrorCode } from '../../errors/constants.js'\nimport { TransactionError } from '../../errors/errors.js'\nimport type { ExecutionActionType } from '../../types/core.js'\nimport type { StepExecutorContext, TaskResult } from '../../types/execution.js'\nimport { getTransactionFailedMessage } from '../../utils/getTransactionMessage.js'\nimport { BaseStepExecutionTask } from '../BaseStepExecutionTask.js'\nimport { waitForTransactionStatus } from './helpers/waitForTransactionStatus.js'\n\nexport class WaitForTransactionStatusTask extends BaseStepExecutionTask {\n  readonly actionType: ExecutionActionType\n\n  constructor(actionType: ExecutionActionType) {\n    super()\n    this.actionType = actionType\n  }\n\n  async run(context: StepExecutorContext): Promise<TaskResult> {\n    const {\n      client,\n      step,\n      statusManager,\n      pollingIntervalMs,\n      toChain,\n      isBridgeExecution,\n    } = context\n\n    // At this point, we should have a txHash or taskId\n    // taskId is used for custom integrations that don't use the standard transaction hash\n    let transactionHash: string | undefined\n    try {\n      const swapOrBridgeAction = statusManager.findAction(\n        step,\n        isBridgeExecution ? 'CROSS_CHAIN' : 'SWAP'\n      )\n      transactionHash = swapOrBridgeAction?.txHash || swapOrBridgeAction?.taskId\n\n      // Wait for the transaction status on the destination chain\n      if (!transactionHash) {\n        throw new Error('Transaction hash is undefined.')\n      }\n\n      const action = statusManager.initializeAction({\n        step,\n        type: this.actionType,\n        chainId:\n          this.actionType === 'RECEIVING_CHAIN'\n            ? step.action.toChainId\n            : step.action.fromChainId,\n        status: 'PENDING',\n      })\n\n      const statusResponse = (await waitForTransactionStatus(\n        client,\n        statusManager,\n        transactionHash,\n        step,\n        action.type,\n        pollingIntervalMs\n      )) as FullStatusData\n\n      const statusReceiving =\n        statusResponse.receiving as ExtendedTransactionInfo\n\n      // Update action status\n      statusManager.updateAction(step, action.type, 'DONE', {\n        chainId: statusReceiving?.chainId || toChain.id,\n        substatus: statusResponse.substatus,\n        substatusMessage: statusResponse.substatusMessage,\n        txHash: statusReceiving?.txHash,\n        txLink:\n          statusReceiving?.txLink ||\n          `${toChain.metamask.blockExplorerUrls[0]}tx/${statusReceiving?.txHash}`,\n      })\n\n      // Update execution status\n      statusManager.updateExecution(step, {\n        status: 'DONE',\n        ...(statusResponse.sending.amount && {\n          fromAmount: statusResponse.sending.amount,\n        }),\n        ...(statusReceiving?.amount && { toAmount: statusReceiving.amount }),\n        ...(statusReceiving?.token && { toToken: statusReceiving.token }),\n        internalTxLink: statusResponse?.lifiExplorerLink,\n        externalTxLink: statusResponse?.bridgeExplorerLink,\n        gasCosts: [\n          {\n            amount: statusResponse.sending.gasAmount,\n            amountUSD: statusResponse.sending.gasAmountUSD,\n            token: statusResponse.sending.gasToken,\n            estimate: statusResponse.sending.gasUsed,\n            limit: statusResponse.sending.gasUsed,\n            price: statusResponse.sending.gasPrice,\n            type: 'SEND',\n          },\n        ],\n      })\n\n      return { status: 'COMPLETED' }\n    } catch (e: any) {\n      const htmlMessage = await getTransactionFailedMessage(\n        client,\n        step,\n        `${toChain.metamask.blockExplorerUrls[0]}tx/${transactionHash}`\n      )\n      throw new TransactionError(\n        LiFiErrorCode.TransactionFailed,\n        htmlMessage ??\n          'Failed while waiting for status of destination chain transaction.',\n        e\n      )\n    }\n  }\n}\n"],"mappings":";;;;;;AASA,IAAa,+BAAb,cAAkD,sBAAsB;CACtE;CAEA,YAAY,YAAiC;EAC3C,OAAO;EACP,KAAK,aAAa;;CAGpB,MAAM,IAAI,SAAmD;EAC3D,MAAM,EACJ,QACA,MACA,eACA,mBACA,SACA,sBACE;EAIJ,IAAI;EACJ,IAAI;GACF,MAAM,qBAAqB,cAAc,WACvC,MACA,oBAAoB,gBAAgB,OACrC;GACD,kBAAkB,oBAAoB,UAAU,oBAAoB;GAGpE,IAAI,CAAC,iBACH,MAAM,IAAI,MAAM,iCAAiC;GAGnD,MAAM,SAAS,cAAc,iBAAiB;IAC5C;IACA,MAAM,KAAK;IACX,SACE,KAAK,eAAe,oBAChB,KAAK,OAAO,YACZ,KAAK,OAAO;IAClB,QAAQ;IACT,CAAC;GAEF,MAAM,iBAAkB,MAAM,yBAC5B,QACA,eACA,iBACA,MACA,OAAO,MACP,kBACD;GAED,MAAM,kBACJ,eAAe;GAGjB,cAAc,aAAa,MAAM,OAAO,MAAM,QAAQ;IACpD,SAAS,iBAAiB,WAAW,QAAQ;IAC7C,WAAW,eAAe;IAC1B,kBAAkB,eAAe;IACjC,QAAQ,iBAAiB;IACzB,QACE,iBAAiB,UACjB,GAAG,QAAQ,SAAS,kBAAkB,GAAG,KAAK,iBAAiB;IAClE,CAAC;GAGF,cAAc,gBAAgB,MAAM;IAClC,QAAQ;IACR,GAAI,eAAe,QAAQ,UAAU,EACnC,YAAY,eAAe,QAAQ,QACpC;IACD,GAAI,iBAAiB,UAAU,EAAE,UAAU,gBAAgB,QAAQ;IACnE,GAAI,iBAAiB,SAAS,EAAE,SAAS,gBAAgB,OAAO;IAChE,gBAAgB,gBAAgB;IAChC,gBAAgB,gBAAgB;IAChC,UAAU,CACR;KACE,QAAQ,eAAe,QAAQ;KAC/B,WAAW,eAAe,QAAQ;KAClC,OAAO,eAAe,QAAQ;KAC9B,UAAU,eAAe,QAAQ;KACjC,OAAO,eAAe,QAAQ;KAC9B,OAAO,eAAe,QAAQ;KAC9B,MAAM;KACP,CACF;IACF,CAAC;GAEF,OAAO,EAAE,QAAQ,aAAa;WACvB,GAAQ;GAMf,MAAM,IAAI,iBAAA,MAER,MAPwB,4BACxB,QACA,MACA,GAAG,QAAQ,SAAS,kBAAkB,GAAG,KAAK,kBAC/C,IAIG,qEACF,EACD"}

package/dist/esm/core/tasks/helpers/checkBalance.d.ts

@@ -1,3 +1,30 @@
-import type { LiFiStep } from '@lifi/types';
-import type { SDKClient } from '../../../types/core.js';
-export declare const checkBalance: (client: SDKClient, walletAddress: string, step: LiFiStep, depth?: number) => Promise<void>;
+import { SDKClient } from "../../../types/core.js";
+import { LiFiStep } from "@lifi/types";
+
+//#region src/core/tasks/helpers/checkBalance.d.ts
+type CheckBalanceOptions = {
+  /**
+  * Set to `false` when outer-tx gas is paid by something other than
+  * `walletAddress` (SCA executor, 4337 bundler / paymaster, relayer):
+  * `gasPart` is excluded from the sufficiency check and slippage rescue.
+  * Source amount and non-included fees (e.g. LZ `msg.value`) are still
+  * verified. Defaults to `true` (strict, today's behavior).
+  */
+  walletPaysGas?: boolean;
+};
+/**
+* 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.
+*/
+declare const checkBalance: (client: SDKClient, walletAddress: string, step: LiFiStep, options?: CheckBalanceOptions) => Promise<void>;
+//#endregion
+export { CheckBalanceOptions, checkBalance };
+//# sourceMappingURL=checkBalance.d.ts.map

package/dist/esm/core/tasks/helpers/checkBalance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkBalance.d.ts","names":[],"sources":["../../../../../src/core/tasks/helpers/checkBalance.ts"],"mappings":";;;;KAsBY,mBAAA;;AAAZ;;;;;AAuBA;EAfE,aAAA;AAAA;;;;;;;;;;;;;cAeW,YAAA,GACX,MAAA,EAAQ,SAAA,EACR,aAAA,UACA,IAAA,EAAM,QAAA,EACN,OAAA,GAAS,mBAAA,KACR,OAAA"}

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

@@ -1,34 +1,106 @@
-import { getTokenBalance } from '../../../actions/getTokenBalance.js';
-import { BalanceError } from '../../../errors/errors.js';
-import { formatUnits } from '../../../utils/formatUnits.js';
-import { sleep } from '../../../utils/sleep.js';
-export const checkBalance = async (client, walletAddress, step, depth = 0) => {
-    const token = await getTokenBalance(client, walletAddress, step.action.fromToken);
-    if (token) {
-        const currentBalance = token.amount ?? 0n;
-        const neededBalance = BigInt(step.action.fromAmount);
-        if (currentBalance < neededBalance) {
-            if (depth <= 3) {
-                await sleep(200);
-                await checkBalance(client, walletAddress, step, depth + 1);
-            }
-            else if ((neededBalance *
-                BigInt((1 - (step.action.slippage ?? 0)) * 1_000_000_000)) /
-                1000000000n <=
-                currentBalance) {
-                // adjust amount in slippage limits
-                step.action.fromAmount = currentBalance.toString();
-            }
-            else {
-                const needed = formatUnits(neededBalance, token.decimals);
-                const current = formatUnits(currentBalance, token.decimals);
-                let errorMessage = `Your ${token.symbol} balance is too low, you try to transfer ${needed} ${token.symbol}, but your wallet only holds ${current} ${token.symbol}. No funds have been sent.`;
-                if (currentBalance !== 0n) {
-                    errorMessage += `If the problem consists, please delete this transfer and start a new one with a maximum of ${current} ${token.symbol}.`;
-                }
-                throw new BalanceError('The balance is too low.', new Error(errorMessage));
-            }
-        }
-    }
+import { BalanceError } from "../../../errors/errors.js";
+import { sleep } from "../../../utils/sleep.js";
+import { formatUnits } from "../../../utils/formatUnits.js";
+import { withTimeout } from "../../../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 walletPaysGas = options.walletPaysGas ?? true;
+	const fromChainId = step.action.fromChainId;
+	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 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 BalanceError("Could not read wallet balance.", error);
+				await 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 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 = formatUnits(need(req), req.token.decimals);
+					const current = 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 BalanceError("The balance is too low.", /* @__PURE__ */ new Error(`${lines.join(" ")} No funds have been sent.`));
+			}
+			await sleep(BACKOFF_BASE_MS * 2 ** attempt);
+		}
+	}, {
+		timeout: OVERALL_TIMEOUT_MS,
+		errorInstance: new BalanceError("Could not read wallet balance.")
+	});
 };
+//#endregion
+export { checkBalance };
+
 //# sourceMappingURL=checkBalance.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"checkBalance.js","sourceRoot":"","sources":["../../../../../src/core/tasks/helpers/checkBalance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AAE/C,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAC/B,MAAiB,EACjB,aAAqB,EACrB,IAAc,EACd,KAAK,GAAG,CAAC,EACM,EAAE;IACjB,MAAM,KAAK,GAAG,MAAM,eAAe,CACjC,MAAM,EACN,aAAa,EACb,IAAI,CAAC,MAAM,CAAC,SAAS,CACtB,CAAA;IACD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAA;QACzC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;QAEpD,IAAI,cAAc,GAAG,aAAa,EAAE,CAAC;YACnC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;gBAChB,MAAM,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAA;YAC5D,CAAC;iBAAM,IACL,CAAC,aAAa;gBACZ,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC;gBAC1D,WAAc;gBAChB,cAAc,EACd,CAAC;gBACD,mCAAmC;gBACnC,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAA;YACpD,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,WAAW,CAAC,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;gBACzD,MAAM,OAAO,GAAG,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;gBAC3D,IAAI,YAAY,GAAG,QAAQ,KAAK,CAAC,MAAM,4CAA4C,MAAM,IAAI,KAAK,CAAC,MAAM,gCAAgC,OAAO,IAAI,KAAK,CAAC,MAAM,4BAA4B,CAAA;gBAE5L,IAAI,cAAc,KAAK,EAAE,EAAE,CAAC;oBAC1B,YAAY,IAAI,8FAA8F,OAAO,IAAI,KAAK,CAAC,MAAM,GAAG,CAAA;gBAC1I,CAAC;gBAED,MAAM,IAAI,YAAY,CACpB,yBAAyB,EACzB,IAAI,KAAK,CAAC,YAAY,CAAC,CACxB,CAAA;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC,CAAA"}
+{"version":3,"file":"checkBalance.js","names":[],"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 walletPaysGas = options.walletPaysGas ?? true\n  const fromChainId = step.action.fromChainId\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/esm/core/tasks/helpers/getTransactionRequestData.d.ts

@@ -1,2 +1,7 @@
-import type { ExecutionOptions, LiFiStepExtended } from '../../../types/core.js';
-export declare const getTransactionRequestData: (step: LiFiStepExtended, executionOptions?: ExecutionOptions) => Promise<string>;
+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/esm/core/tasks/helpers/getTransactionRequestData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTransactionRequestData.d.ts","names":[],"sources":["../../../../../src/core/tasks/helpers/getTransactionRequestData.ts"],"mappings":";;;cAQa,yBAAA,GACX,IAAA,EAAM,gBAAA,EACN,gBAAA,GAAmB,gBAAA,KAClB,OAAA"}

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

@@ -1,26 +1,24 @@
-import { LiFiErrorCode } from '../../../errors/constants.js';
-import { TransactionError } from '../../../errors/errors.js';
-export const getTransactionRequestData = async (step, executionOptions) => {
-    if (!step.transactionRequest?.data) {
-        throw new TransactionError(LiFiErrorCode.TransactionUnprepared, '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 TransactionError(LiFiErrorCode.TransactionUnprepared, 'Unable to prepare transaction. Transaction request data is not found.');
-    }
-    return transactionRequestData;
+import "../../../errors/constants.js";
+import { TransactionError } from "../../../errors/errors.js";
+//#region src/core/tasks/helpers/getTransactionRequestData.ts
+const getTransactionRequestData = async (step, executionOptions) => {
+	if (!step.transactionRequest?.data) throw new 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 TransactionError(1008, "Unable to prepare transaction. Transaction request data is not found.");
+	return transactionRequestData;
 };
+//#endregion
+export { getTransactionRequestData };
+
 //# sourceMappingURL=getTransactionRequestData.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"getTransactionRequestData.js","sourceRoot":"","sources":["../../../../../src/core/tasks/helpers/getTransactionRequestData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAO5D,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,EAC5C,IAAsB,EACtB,gBAAmC,EAClB,EAAE;IACnB,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC;QACnC,MAAM,IAAI,gBAAgB,CACxB,aAAa,CAAC,qBAAqB,EACnC,uEAAuE,CACxE,CAAA;IACH,CAAC;IAED,IAAI,kBAAkB,GAA0B;QAC9C,IAAI,EAAE,IAAI,CAAC,kBAAkB,CAAC,IAAI;KACnC,CAAA;IAED,IAAI,gBAAgB,EAAE,4BAA4B,EAAE,CAAC;QACnD,MAAM,4BAA4B,GAChC,MAAM,gBAAgB,CAAC,4BAA4B,CAAC;YAClD,WAAW,EAAE,aAAa;YAC1B,GAAG,kBAAkB;SACtB,CAAC,CAAA;QAEJ,kBAAkB,GAAG;YACnB,GAAG,kBAAkB;YACrB,GAAG,4BAA4B;SAChC,CAAA;IACH,CAAC;IAED,MAAM,sBAAsB,GAAG,kBAAkB,CAAC,IAAI,CAAA;IAEtD,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC5B,MAAM,IAAI,gBAAgB,CACxB,aAAa,CAAC,qBAAqB,EACnC,uEAAuE,CACxE,CAAA;IACH,CAAC;IAED,OAAO,sBAAsB,CAAA;AAC/B,CAAC,CAAA"}
+{"version":3,"file":"getTransactionRequestData.js","names":[],"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,IAAI,iBAAA,MAER,wEACD;CAGH,IAAI,qBAA4C,EAC9C,MAAM,KAAK,mBAAmB,MAC/B;CAED,IAAI,kBAAkB,8BAA8B;EAClD,MAAM,+BACJ,MAAM,iBAAiB,6BAA6B;GAClD,aAAa;GACb,GAAG;GACJ,CAAC;EAEJ,qBAAqB;GACnB,GAAG;GACH,GAAG;GACJ;;CAGH,MAAM,yBAAyB,mBAAmB;CAElD,IAAI,CAAC,wBACH,MAAM,IAAI,iBAAA,MAER,wEACD;CAGH,OAAO"}

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

@@ -1,16 +1,21 @@
-import type { LiFiStep } from '@lifi/types';
-import type { StatusManager } from '../../../core/StatusManager.js';
-import type { ExecutionOptions } from '../../../types/core.js';
+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
- */
-export declare const stepComparison: (statusManager: StatusManager, oldStep: LiFiStep, newStep: LiFiStep, allowUserInteraction: boolean, executionOptions?: ExecutionOptions) => Promise<LiFiStep>;
+* 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/esm/core/tasks/helpers/stepComparison.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepComparison.d.ts","names":[],"sources":["../../../../../src/core/tasks/helpers/stepComparison.ts"],"mappings":";;;;;;;AAmBA;;;;;;;;;;cAAa,cAAA,GACX,aAAA,EAAe,aAAA,EACf,OAAA,EAAS,QAAA,EACT,OAAA,EAAS,QAAA,EACT,oBAAA,WACA,gBAAA,GAAmB,gBAAA,KAClB,OAAA,CAAQ,QAAA"}

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

@@ -1,35 +1,31 @@
-import { checkStepSlippageThreshold } from '../../../core/utils.js';
-import { LiFiErrorCode } from '../../../errors/constants.js';
-import { TransactionError } from '../../../errors/errors.js';
+import "../../../errors/constants.js";
+import { TransactionError } from "../../../errors/errors.js";
+import { checkStepSlippageThreshold } from "../../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
- */
-export const stepComparison = async (statusManager, oldStep, newStep, allowUserInteraction, executionOptions) => {
-    // Check if changed exchange rate is in the range of slippage threshold
-    if (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) {
-        // The user declined the new exchange rate, so we are not going to proceed
-        throw new TransactionError(LiFiErrorCode.ExchangeRateUpdateCanceled, '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);
+* 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 (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 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
+export { stepComparison };
+
 //# sourceMappingURL=stepComparison.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"stepComparison.js","sourceRoot":"","sources":["../../../../../src/core/tasks/helpers/stepComparison.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAG5D;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,aAA4B,EAC5B,OAAiB,EACjB,OAAiB,EACjB,oBAA6B,EAC7B,gBAAmC,EAChB,EAAE;IACrB,uEAAuE;IACvE,IAAI,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;QACjD,OAAO,aAAa,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAA;IACjD,CAAC;IAED,IAAI,eAAoC,CAAA;IACxC,IAAI,oBAAoB,EAAE,CAAC;QACzB,eAAe,GAAG,MAAM,gBAAgB,EAAE,4BAA4B,EAAE,CAAC;YACvE,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ;YACtC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ;YACtC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO;SAChC,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,0EAA0E;QAC1E,MAAM,IAAI,gBAAgB,CACxB,aAAa,CAAC,0BAA0B,EACxC,+LAA+L,CAChM,CAAA;IACH,CAAC;IAED,OAAO,aAAa,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAA;AACjD,CAAC,CAAA"}
+{"version":3,"file":"stepComparison.js","names":[],"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,IAAI,2BAA2B,SAAS,QAAQ,EAC9C,OAAO,cAAc,kBAAkB,QAAQ;CAGjD,IAAI;CACJ,IAAI,sBACF,kBAAkB,MAAM,kBAAkB,+BAA+B;EACvE,aAAa,QAAQ,SAAS;EAC9B,aAAa,QAAQ,SAAS;EAC9B,SAAS,QAAQ,OAAO;EACzB,CAAC;CAGJ,IAAI,CAAC,iBAEH,MAAM,IAAI,iBAAA,MAER,gMACD;CAGH,OAAO,cAAc,kBAAkB,QAAQ"}

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

@@ -1,4 +1,9 @@
-import type { LiFiStep, StatusResponse } from '@lifi/types';
-import type { ExecutionActionType, SDKClient } from '../../../types/core.js';
-import type { StatusManager } from '../../StatusManager.js';
-export declare function waitForTransactionStatus(client: SDKClient, statusManager: StatusManager, txHash: string, step: LiFiStep, actionType: ExecutionActionType, interval?: number): Promise<StatusResponse>;
+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/esm/core/tasks/helpers/waitForTransactionStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitForTransactionStatus.d.ts","names":[],"sources":["../../../../../src/core/tasks/helpers/waitForTransactionStatus.ts"],"mappings":";;;;;iBAUsB,wBAAA,CACpB,MAAA,EAAQ,SAAA,EACR,aAAA,EAAe,aAAA,EACf,MAAA,UACA,IAAA,EAAM,QAAA,EACN,UAAA,EAAY,mBAAA,EACZ,QAAA,YACC,OAAA,CAAQ,cAAA"}