@lifi/sdk 0.0.0-preview-f5cf9f8

package/dist/cjs/core/execution.js

@@ -0,0 +1,147 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../errors/constants.js");
+const require_errors_errors = require("../errors/errors.js");
+const require_core_executionState = require("./executionState.js");
+const require_core_prepareRestart = require("./prepareRestart.js");
+//#region src/core/execution.ts
+/**
+* Execute a route.
+* @param client - The SDK client.
+* @param route - The route that should be executed. Cannot be an active route.
+* @param executionOptions - An object containing settings and callbacks.
+* @returns The executed route.
+* @throws {LiFiError} Throws a LiFiError if the execution fails.
+*/
+const executeRoute = async (client, route, executionOptions) => {
+	const clonedRoute = structuredClone(route);
+	let executionPromise = require_core_executionState.executionState.get(clonedRoute.id)?.promise;
+	if (executionPromise) return executionPromise;
+	require_core_executionState.executionState.create({
+		route: clonedRoute,
+		executionOptions
+	});
+	executionPromise = executeSteps(client, clonedRoute);
+	require_core_executionState.executionState.update({
+		route: clonedRoute,
+		promise: executionPromise
+	});
+	return executionPromise;
+};
+/**
+* Resume the execution of a route that has been stopped or had an error while executing.
+* @param client - The SDK client.
+* @param route - The route that is to be executed. Cannot be an active route.
+* @param executionOptions - An object containing settings and callbacks.
+* @returns The executed route.
+* @throws {LiFiError} Throws a LiFiError if the execution fails.
+*/
+const resumeRoute = async (client, route, executionOptions) => {
+	const execution = require_core_executionState.executionState.get(route.id);
+	if (execution) {
+		if (!execution.executors.some((executor) => !executor.allowExecution)) {
+			updateRouteExecution(route, { executeInBackground: executionOptions?.executeInBackground });
+			if (!execution.promise) throw new Error("Route execution promise not found.");
+			return execution.promise;
+		}
+	}
+	require_core_prepareRestart.prepareRestart(route);
+	return executeRoute(client, route, executionOptions);
+};
+const executeSteps = async (client, route) => {
+	for (let index = 0; index < route.steps.length; index++) {
+		const execution = require_core_executionState.executionState.get(route.id);
+		if (!execution) break;
+		const step = route.steps[index];
+		const previousStep = route.steps[index - 1];
+		if (step.execution?.status === "DONE") continue;
+		if (previousStep?.execution?.toAmount) {
+			step.action.fromAmount = previousStep.execution.toAmount;
+			if (step.includedSteps?.length) step.includedSteps[0].action.fromAmount = previousStep.execution.toAmount;
+		}
+		try {
+			const fromAddress = step.action.fromAddress;
+			if (!fromAddress) throw new Error("Action fromAddress is not specified.");
+			const provider = client.providers.find((provider) => provider.isAddress(fromAddress));
+			if (!provider) throw new require_errors_errors.ProviderError(1005, "SDK Execution Provider not found.");
+			const stepExecutor = await provider.getStepExecutor({
+				routeId: route.id,
+				executionOptions: execution.executionOptions
+			});
+			execution.executors.push(stepExecutor);
+			if (execution.executionOptions) updateRouteExecution(route, execution.executionOptions);
+			let executedStep;
+			try {
+				executedStep = await stepExecutor.executeStep(client, step);
+			} catch (e) {
+				if (e instanceof require_errors_errors.ExecuteStepRetryError) {
+					step.execution = void 0;
+					executedStep = await stepExecutor.executeStep(client, step, e.retryParams);
+				} else throw e;
+			}
+			if (executedStep.execution?.status !== "DONE") stopRouteExecution(route);
+			if (!stepExecutor.allowExecution) return route;
+		} catch (e) {
+			stopRouteExecution(route);
+			throw e;
+		}
+	}
+	require_core_executionState.executionState.delete(route.id);
+	return route;
+};
+/**
+* Updates route execution to background or foreground state.
+* @param route - A route that is currently in execution.
+* @param options - An object with execution settings.
+*/
+const updateRouteExecution = (route, options) => {
+	const execution = require_core_executionState.executionState.get(route.id);
+	if (!execution) return;
+	if ("executeInBackground" in options) for (const executor of execution.executors) executor.setInteraction({
+		allowInteraction: !options?.executeInBackground,
+		allowUpdates: true
+	});
+	execution.executionOptions = {
+		...execution.executionOptions,
+		...options
+	};
+};
+/**
+* Stops the execution of an active route.
+* @param route - A route that is currently in execution.
+* @returns The stopped route.
+*/
+const stopRouteExecution = (route) => {
+	const execution = require_core_executionState.executionState.get(route.id);
+	if (!execution) return route;
+	for (const executor of execution.executors) executor.setInteraction({
+		allowInteraction: false,
+		allowUpdates: false,
+		allowExecution: false
+	});
+	require_core_executionState.executionState.delete(route.id);
+	return execution.route;
+};
+/**
+* Get the list of active routes.
+* @returns A list of routes.
+*/
+const getActiveRoutes = () => {
+	return Object.values(require_core_executionState.executionState.state).map((dict) => dict?.route).filter(Boolean);
+};
+/**
+* Return the current route information for given route. The route has to be active.
+* @param routeId - A route id.
+* @returns The updated route.
+*/
+const getActiveRoute = (routeId) => {
+	return require_core_executionState.executionState.get(routeId)?.route;
+};
+//#endregion
+exports.executeRoute = executeRoute;
+exports.getActiveRoute = getActiveRoute;
+exports.getActiveRoutes = getActiveRoutes;
+exports.resumeRoute = resumeRoute;
+exports.stopRouteExecution = stopRouteExecution;
+exports.updateRouteExecution = updateRouteExecution;
+
+//# sourceMappingURL=execution.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","names":["executionState","ProviderError","ExecuteStepRetryError"],"sources":["../../../src/core/execution.ts"],"sourcesContent":["import type { Route } from '@lifi/types'\nimport { LiFiErrorCode } from '../errors/constants.js'\nimport { ExecuteStepRetryError, ProviderError } from '../errors/errors.js'\nimport type {\n  ExecutionOptions,\n  LiFiStepExtended,\n  RouteExtended,\n  SDKClient,\n  SDKProvider,\n} from '../types/core.js'\nimport { executionState } from './executionState.js'\nimport { prepareRestart } from './prepareRestart.js'\n\n/**\n * Execute a route.\n * @param client - The SDK client.\n * @param route - The route that should be executed. Cannot be an active route.\n * @param executionOptions - An object containing settings and callbacks.\n * @returns The executed route.\n * @throws {LiFiError} Throws a LiFiError if the execution fails.\n */\nexport const executeRoute = async (\n  client: SDKClient,\n  route: Route,\n  executionOptions?: ExecutionOptions\n): Promise<RouteExtended> => {\n  // Deep clone to prevent side effects\n  const clonedRoute = structuredClone<Route>(route)\n\n  let executionPromise = executionState.get(clonedRoute.id)?.promise\n  // Check if route is already running\n  if (executionPromise) {\n    return executionPromise\n  }\n\n  executionState.create({ route: clonedRoute, executionOptions })\n  executionPromise = executeSteps(client, clonedRoute)\n  executionState.update({\n    route: clonedRoute,\n    promise: executionPromise,\n  })\n\n  return executionPromise\n}\n\n/**\n * Resume the execution of a route that has been stopped or had an error while executing.\n * @param client - The SDK client.\n * @param route - The route that is to be executed. Cannot be an active route.\n * @param executionOptions - An object containing settings and callbacks.\n * @returns The executed route.\n * @throws {LiFiError} Throws a LiFiError if the execution fails.\n */\nexport const resumeRoute = async (\n  client: SDKClient,\n  route: Route,\n  executionOptions?: ExecutionOptions\n): Promise<RouteExtended> => {\n  const execution = executionState.get(route.id)\n\n  if (execution) {\n    const executionHalted = execution.executors.some(\n      (executor) => !executor.allowExecution\n    )\n    if (!executionHalted) {\n      // Check if we want to resume route execution in the background\n      updateRouteExecution(route, {\n        executeInBackground: executionOptions?.executeInBackground,\n      })\n      if (!execution.promise) {\n        // We should never reach this point if we do clean-up properly\n        throw new Error('Route execution promise not found.')\n      }\n      return execution.promise\n    }\n  }\n\n  prepareRestart(route)\n\n  return executeRoute(client, route, executionOptions)\n}\n\nconst executeSteps = async (\n  client: SDKClient,\n  route: RouteExtended\n): Promise<RouteExtended> => {\n  // Loop over steps and execute them\n  for (let index = 0; index < route.steps.length; index++) {\n    const execution = executionState.get(route.id)\n    // Check if execution has stopped in the meantime\n    if (!execution) {\n      break\n    }\n\n    const step = route.steps[index]\n    const previousStep = route.steps[index - 1]\n    // Check if the step is already done\n    if (step.execution?.status === 'DONE') {\n      continue\n    }\n\n    // Update step fromAmount using output of the previous step execution. In the future this should be handled by calling `updateRoute`\n    if (previousStep?.execution?.toAmount) {\n      step.action.fromAmount = previousStep.execution.toAmount\n      if (step.includedSteps?.length) {\n        step.includedSteps[0].action.fromAmount =\n          previousStep.execution.toAmount\n      }\n    }\n\n    try {\n      const fromAddress = step.action.fromAddress\n      if (!fromAddress) {\n        throw new Error('Action fromAddress is not specified.')\n      }\n\n      const provider = client.providers.find((provider: SDKProvider) =>\n        provider.isAddress(fromAddress)\n      )\n\n      if (!provider) {\n        throw new ProviderError(\n          LiFiErrorCode.ProviderUnavailable,\n          'SDK Execution Provider not found.'\n        )\n      }\n\n      const stepExecutor = await provider.getStepExecutor({\n        routeId: route.id,\n        executionOptions: execution.executionOptions,\n      })\n      execution.executors.push(stepExecutor)\n\n      // Check if we want to execute this step in the background\n      if (execution.executionOptions) {\n        updateRouteExecution(route, execution.executionOptions)\n      }\n\n      let executedStep: LiFiStepExtended\n      try {\n        executedStep = await stepExecutor.executeStep(client, step)\n      } catch (e) {\n        if (e instanceof ExecuteStepRetryError) {\n          step.execution = undefined\n          executedStep = await stepExecutor.executeStep(\n            client,\n            step,\n            e.retryParams\n          )\n        } else {\n          throw e\n        }\n      }\n\n      // We may reach this point if user interaction isn't allowed. We want to stop execution until we resume it\n      if (executedStep.execution?.status !== 'DONE') {\n        stopRouteExecution(route)\n      }\n\n      // Execution stopped during the current step, we don't want to continue to the next step so we return already\n      if (!stepExecutor.allowExecution) {\n        return route\n      }\n    } catch (e) {\n      stopRouteExecution(route)\n      throw e\n    }\n  }\n\n  // Clean up after the execution\n  executionState.delete(route.id)\n  return route\n}\n\n/**\n * Updates route execution to background or foreground state.\n * @param route - A route that is currently in execution.\n * @param options - An object with execution settings.\n */\nexport const updateRouteExecution = (\n  route: Route,\n  options: ExecutionOptions\n): void => {\n  const execution = executionState.get(route.id)\n  if (!execution) {\n    return\n  }\n\n  if ('executeInBackground' in options) {\n    for (const executor of execution.executors) {\n      executor.setInteraction({\n        allowInteraction: !options?.executeInBackground,\n        allowUpdates: true,\n      })\n    }\n  }\n  // Update active route settings so we know what the current state of execution is\n  execution.executionOptions = {\n    ...execution.executionOptions,\n    ...options,\n  }\n}\n\n/**\n * Stops the execution of an active route.\n * @param route - A route that is currently in execution.\n * @returns The stopped route.\n */\nexport const stopRouteExecution = (route: Route): Route => {\n  const execution = executionState.get(route.id)\n  if (!execution) {\n    return route\n  }\n\n  for (const executor of execution.executors) {\n    executor.setInteraction({\n      allowInteraction: false,\n      allowUpdates: false,\n      allowExecution: false,\n    })\n  }\n  executionState.delete(route.id)\n  return execution.route\n}\n\n/**\n * Get the list of active routes.\n * @returns A list of routes.\n */\nexport const getActiveRoutes = (): RouteExtended[] => {\n  return Object.values(executionState.state)\n    .map((dict) => dict?.route)\n    .filter(Boolean) as RouteExtended[]\n}\n\n/**\n * Return the current route information for given route. The route has to be active.\n * @param routeId - A route id.\n * @returns The updated route.\n */\nexport const getActiveRoute = (routeId: string): RouteExtended | undefined => {\n  return executionState.get(routeId)?.route\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,21 @@
+import { ExecutionOptions, RouteExtended, StepExecutor } from "../types/core.js";
+
+//#region src/core/executionState.d.ts
+interface ExecutionData {
+  route: RouteExtended;
+  executors: StepExecutor[];
+  executionOptions?: ExecutionOptions;
+  promise?: Promise<RouteExtended>;
+}
+type ExecutionStateParams = Omit<ExecutionData, "executors">;
+interface ExecutionState {
+  state: Partial<Record<string, ExecutionData>>;
+  get(routeId: string): ExecutionData | undefined;
+  create(params: ExecutionStateParams): ExecutionData;
+  update(params: ExecutionStateParams): void;
+  delete(routeId: string): void;
+}
+declare const executionState: ExecutionState;
+//#endregion
+export { executionState };
+//# sourceMappingURL=executionState.d.ts.map

package/dist/cjs/core/executionState.js

@@ -0,0 +1,29 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/core/executionState.ts
+const executionState = {
+	state: {},
+	get(routeId) {
+		return this.state[routeId];
+	},
+	create(params) {
+		this.state[params.route.id] = {
+			...this.state[params.route.id],
+			...params,
+			executors: this.state[params.route.id]?.executors ?? []
+		};
+		return this.state[params.route.id];
+	},
+	update(state) {
+		if (this.state[state.route.id]) this.state[state.route.id] = {
+			...this.state[state.route.id],
+			...state
+		};
+	},
+	delete(routeId) {
+		delete this.state[routeId];
+	}
+};
+//#endregion
+exports.executionState = executionState;
+
+//# sourceMappingURL=executionState.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executionState.js","names":[],"sources":["../../../src/core/executionState.ts"],"sourcesContent":["import type {\n  ExecutionOptions,\n  RouteExtended,\n  StepExecutor,\n} from '../types/core.js'\n\ninterface ExecutionData {\n  route: RouteExtended\n  executors: StepExecutor[]\n  executionOptions?: ExecutionOptions\n  promise?: Promise<RouteExtended>\n}\n\ntype ExecutionStateParams = Omit<ExecutionData, 'executors'>\n\ninterface ExecutionState {\n  state: Partial<Record<string, ExecutionData>>\n  get(routeId: string): ExecutionData | undefined\n  create(params: ExecutionStateParams): ExecutionData\n  update(params: ExecutionStateParams): void\n  delete(routeId: string): void\n}\n\nexport const executionState: ExecutionState = {\n  state: {},\n  get(routeId: string) {\n    return this.state[routeId]\n  },\n  create(params) {\n    this.state[params.route.id] = {\n      ...this.state[params.route.id],\n      ...params,\n      executors: this.state[params.route.id]?.executors ?? [],\n    }\n    return this.state[params.route.id]!\n  },\n  update(state) {\n    if (this.state[state.route.id]) {\n      this.state[state.route.id] = {\n        ...this.state[state.route.id]!,\n        ...state,\n      }\n    }\n  },\n  delete(routeId) {\n    delete this.state[routeId]\n  },\n}\n"],"mappings":";;AAuBA,MAAa,iBAAiC;CAC5C,OAAO,CAAC;CACR,IAAI,SAAiB;EACnB,OAAO,KAAK,MAAM;CACpB;CACA,OAAO,QAAQ;EACb,KAAK,MAAM,OAAO,MAAM,MAAM;GAC5B,GAAG,KAAK,MAAM,OAAO,MAAM;GAC3B,GAAG;GACH,WAAW,KAAK,MAAM,OAAO,MAAM,KAAK,aAAa,CAAC;EACxD;EACA,OAAO,KAAK,MAAM,OAAO,MAAM;CACjC;CACA,OAAO,OAAO;EACZ,IAAI,KAAK,MAAM,MAAM,MAAM,KACzB,KAAK,MAAM,MAAM,MAAM,MAAM;GAC3B,GAAG,KAAK,MAAM,MAAM,MAAM;GAC1B,GAAG;EACL;CAEJ;CACA,OAAO,SAAS;EACd,OAAO,KAAK,MAAM;CACpB;AACF"}

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

@@ -0,0 +1,7 @@
+import { RouteExtended } from "../types/core.js";
+
+//#region src/core/prepareRestart.d.ts
+declare const prepareRestart: (route: RouteExtended) => void;
+//#endregion
+export { prepareRestart };
+//# sourceMappingURL=prepareRestart.d.ts.map

package/dist/cjs/core/prepareRestart.js

@@ -0,0 +1,21 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/core/prepareRestart.ts
+const prepareRestart = (route) => {
+	for (let index = 0; index < route.steps.length; index++) {
+		const step = route.steps[index];
+		if (step.execution) {
+			const lastValidIndex = step.execution.actions.findLastIndex((action) => [
+				"SWAP",
+				"CROSS_CHAIN",
+				"RECEIVING_CHAIN"
+			].includes(action.type) && (!!action.txHash || !!action.taskId) && action.status !== "FAILED");
+			if (lastValidIndex >= 0) step.execution.actions = step.execution.actions.slice(0, lastValidIndex + 1);
+			else step.execution.actions = [];
+		}
+		step.transactionRequest = void 0;
+	}
+};
+//#endregion
+exports.prepareRestart = prepareRestart;
+
+//# sourceMappingURL=prepareRestart.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prepareRestart.js","names":[],"sources":["../../../src/core/prepareRestart.ts"],"sourcesContent":["import type { RouteExtended } from '../types/core.js'\n\nexport const prepareRestart = (route: RouteExtended): void => {\n  for (let index = 0; index < route.steps.length; index++) {\n    const step = route.steps[index]\n    if (step.execution) {\n      // Find the index of the last action that has tx hash, taskId, or signed messages\n      const lastValidIndex = step.execution.actions.findLastIndex(\n        (action) =>\n          ['SWAP', 'CROSS_CHAIN', 'RECEIVING_CHAIN'].includes(action.type) &&\n          (!!action.txHash || !!action.taskId) &&\n          action.status !== 'FAILED'\n      )\n\n      // Keep all actions up to the one with tx hash\n      if (lastValidIndex >= 0) {\n        step.execution.actions = step.execution.actions.slice(\n          0,\n          lastValidIndex + 1\n        )\n      } else {\n        // If no tx hash exists, reset the actions array\n        step.execution.actions = []\n      }\n    }\n    step.transactionRequest = undefined\n  }\n}\n"],"mappings":";;AAEA,MAAa,kBAAkB,UAA+B;CAC5D,KAAK,IAAI,QAAQ,GAAG,QAAQ,MAAM,MAAM,QAAQ,SAAS;EACvD,MAAM,OAAO,MAAM,MAAM;EACzB,IAAI,KAAK,WAAW;GAElB,MAAM,iBAAiB,KAAK,UAAU,QAAQ,eAC3C,WACC;IAAC;IAAQ;IAAe;GAAiB,EAAE,SAAS,OAAO,IAAI,MAC9D,CAAC,CAAC,OAAO,UAAU,CAAC,CAAC,OAAO,WAC7B,OAAO,WAAW,QACtB;GAGA,IAAI,kBAAkB,GACpB,KAAK,UAAU,UAAU,KAAK,UAAU,QAAQ,MAC9C,GACA,iBAAiB,CACnB;QAGA,KAAK,UAAU,UAAU,CAAC;EAE9B;EACA,KAAK,qBAAqB,KAAA;CAC5B;AACF"}

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

@@ -0,0 +1,21 @@
+//#region src/core/storage.d.ts
+interface SDKStorage {
+  get(key: string): string | null | Promise<string | null>;
+  set(key: string, value: string): void | Promise<void>;
+  remove(key: string): void | Promise<void>;
+}
+declare class LocalStorageAdapter implements SDKStorage {
+  get(key: string): string | null;
+  set(key: string, value: string): void;
+  remove(key: string): void;
+}
+declare class InMemoryStorage implements SDKStorage {
+  private store;
+  get(key: string): string | null;
+  set(key: string, value: string): void;
+  remove(key: string): void;
+}
+declare function createDefaultStorage(): SDKStorage;
+//#endregion
+export { InMemoryStorage, LocalStorageAdapter, SDKStorage, createDefaultStorage };
+//# sourceMappingURL=storage.d.ts.map

package/dist/cjs/core/storage.js

@@ -0,0 +1,35 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/core/storage.ts
+var LocalStorageAdapter = class {
+	get(key) {
+		return window.localStorage.getItem(key);
+	}
+	set(key, value) {
+		window.localStorage.setItem(key, value);
+	}
+	remove(key) {
+		window.localStorage.removeItem(key);
+	}
+};
+var InMemoryStorage = class {
+	store = /* @__PURE__ */ new Map();
+	get(key) {
+		return this.store.get(key) ?? null;
+	}
+	set(key, value) {
+		this.store.set(key, value);
+	}
+	remove(key) {
+		this.store.delete(key);
+	}
+};
+function createDefaultStorage() {
+	if (typeof window !== "undefined" && window.localStorage) return new LocalStorageAdapter();
+	return new InMemoryStorage();
+}
+//#endregion
+exports.InMemoryStorage = InMemoryStorage;
+exports.LocalStorageAdapter = LocalStorageAdapter;
+exports.createDefaultStorage = createDefaultStorage;
+
+//# sourceMappingURL=storage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","names":[],"sources":["../../../src/core/storage.ts"],"sourcesContent":["export interface SDKStorage {\n  get(key: string): string | null | Promise<string | null>\n  set(key: string, value: string): void | Promise<void>\n  remove(key: string): void | Promise<void>\n}\n\nexport class LocalStorageAdapter implements SDKStorage {\n  get(key: string): string | null {\n    return window.localStorage.getItem(key)\n  }\n\n  set(key: string, value: string): void {\n    window.localStorage.setItem(key, value)\n  }\n\n  remove(key: string): void {\n    window.localStorage.removeItem(key)\n  }\n}\n\nexport class InMemoryStorage implements SDKStorage {\n  private store = new Map<string, string>()\n\n  get(key: string): string | null {\n    return this.store.get(key) ?? null\n  }\n\n  set(key: string, value: string): void {\n    this.store.set(key, value)\n  }\n\n  remove(key: string): void {\n    this.store.delete(key)\n  }\n}\n\nexport function createDefaultStorage(): SDKStorage {\n  if (typeof window !== 'undefined' && window.localStorage) {\n    return new LocalStorageAdapter()\n  }\n  return new InMemoryStorage()\n}\n"],"mappings":";;AAMA,IAAa,sBAAb,MAAuD;CACrD,IAAI,KAA4B;EAC9B,OAAO,OAAO,aAAa,QAAQ,GAAG;CACxC;CAEA,IAAI,KAAa,OAAqB;EACpC,OAAO,aAAa,QAAQ,KAAK,KAAK;CACxC;CAEA,OAAO,KAAmB;EACxB,OAAO,aAAa,WAAW,GAAG;CACpC;AACF;AAEA,IAAa,kBAAb,MAAmD;CACjD,wBAAgB,IAAI,IAAoB;CAExC,IAAI,KAA4B;EAC9B,OAAO,KAAK,MAAM,IAAI,GAAG,KAAK;CAChC;CAEA,IAAI,KAAa,OAAqB;EACpC,KAAK,MAAM,IAAI,KAAK,KAAK;CAC3B;CAEA,OAAO,KAAmB;EACxB,KAAK,MAAM,OAAO,GAAG;CACvB;AACF;AAEA,SAAgB,uBAAmC;CACjD,IAAI,OAAO,WAAW,eAAe,OAAO,cAC1C,OAAO,IAAI,oBAAoB;CAEjC,OAAO,IAAI,gBAAgB;AAC7B"}

package/dist/cjs/core/tasks/CheckBalanceTask.d.ts

@@ -0,0 +1,19 @@
+import { StepExecutorContext, TaskResult } from "../../types/execution.js";
+import { BaseStepExecutionTask } from "../BaseStepExecutionTask.js";
+import { CheckBalanceOptions } from "./helpers/checkBalance.js";
+
+//#region src/core/tasks/CheckBalanceTask.d.ts
+declare class CheckBalanceTask extends BaseStepExecutionTask {
+  /**
+  * Per-step options hook for chain-specific subclasses (e.g. skip the
+  * gas check for smart-contract wallets or relayed steps). Default `{}`
+  * keeps behavior unchanged for every provider that doesn't override.
+  * Resolved lazily inside `run()` — pipelines that resume past
+  * `CheckBalance` pay no cost.
+  */
+  protected getCheckBalanceOptions(_context: StepExecutorContext): Promise<CheckBalanceOptions>;
+  run(context: StepExecutorContext): Promise<TaskResult>;
+}
+//#endregion
+export { CheckBalanceTask };
+//# sourceMappingURL=CheckBalanceTask.d.ts.map

package/dist/cjs/core/tasks/CheckBalanceTask.js

@@ -0,0 +1,35 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../errors/constants.js");
+const require_errors_errors = require("../../errors/errors.js");
+const require_core_BaseStepExecutionTask = require("../BaseStepExecutionTask.js");
+const require_core_tasks_helpers_checkBalance = require("./helpers/checkBalance.js");
+//#region src/core/tasks/CheckBalanceTask.ts
+var CheckBalanceTask = class extends require_core_BaseStepExecutionTask.BaseStepExecutionTask {
+	/**
+	* Per-step options hook for chain-specific subclasses (e.g. skip the
+	* gas check for smart-contract wallets or relayed steps). Default `{}`
+	* keeps behavior unchanged for every provider that doesn't override.
+	* Resolved lazily inside `run()` — pipelines that resume past
+	* `CheckBalance` pay no cost.
+	*/
+	getCheckBalanceOptions(_context) {
+		return Promise.resolve({});
+	}
+	async run(context) {
+		const { client, step, statusManager, isBridgeExecution } = context;
+		statusManager.initializeAction({
+			step,
+			type: isBridgeExecution ? "CROSS_CHAIN" : "SWAP",
+			chainId: step.action.fromChainId,
+			status: "STARTED"
+		});
+		const walletAddress = step.action.fromAddress;
+		if (!walletAddress) throw new require_errors_errors.TransactionError(1e3, "The wallet address is undefined.");
+		await require_core_tasks_helpers_checkBalance.checkBalance(client, walletAddress, step, await this.getCheckBalanceOptions(context));
+		return { status: "COMPLETED" };
+	}
+};
+//#endregion
+exports.CheckBalanceTask = CheckBalanceTask;
+
+//# sourceMappingURL=CheckBalanceTask.js.map

package/dist/cjs/core/tasks/CheckBalanceTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckBalanceTask.js","names":["BaseStepExecutionTask","TransactionError","checkBalance"],"sources":["../../../../src/core/tasks/CheckBalanceTask.ts"],"sourcesContent":["import { LiFiErrorCode } from '../../errors/constants.js'\nimport { TransactionError } from '../../errors/errors.js'\nimport type { StepExecutorContext, TaskResult } from '../../types/execution.js'\nimport { BaseStepExecutionTask } from '../BaseStepExecutionTask.js'\nimport {\n  type CheckBalanceOptions,\n  checkBalance,\n} from './helpers/checkBalance.js'\n\nexport class CheckBalanceTask extends BaseStepExecutionTask {\n  /**\n   * Per-step options hook for chain-specific subclasses (e.g. skip the\n   * gas check for smart-contract wallets or relayed steps). Default `{}`\n   * keeps behavior unchanged for every provider that doesn't override.\n   * Resolved lazily inside `run()` — pipelines that resume past\n   * `CheckBalance` pay no cost.\n   */\n  protected getCheckBalanceOptions(\n    _context: StepExecutorContext\n  ): Promise<CheckBalanceOptions> {\n    return Promise.resolve({})\n  }\n\n  async run(context: StepExecutorContext): Promise<TaskResult> {\n    const { client, step, statusManager, isBridgeExecution } = context\n\n    statusManager.initializeAction({\n      step,\n      type: isBridgeExecution ? 'CROSS_CHAIN' : 'SWAP',\n      chainId: step.action.fromChainId,\n      status: 'STARTED',\n    })\n\n    const walletAddress = step.action.fromAddress\n    if (!walletAddress) {\n      throw new TransactionError(\n        LiFiErrorCode.InternalError,\n        'The wallet address is undefined.'\n      )\n    }\n\n    const options = await this.getCheckBalanceOptions(context)\n    await checkBalance(client, walletAddress, step, options)\n    return { status: 'COMPLETED' }\n  }\n}\n"],"mappings":";;;;;;AASA,IAAa,mBAAb,cAAsCA,mCAAAA,sBAAsB;;;;;;;;CAQ1D,uBACE,UAC8B;EAC9B,OAAO,QAAQ,QAAQ,CAAC,CAAC;CAC3B;CAEA,MAAM,IAAI,SAAmD;EAC3D,MAAM,EAAE,QAAQ,MAAM,eAAe,sBAAsB;EAE3D,cAAc,iBAAiB;GAC7B;GACA,MAAM,oBAAoB,gBAAgB;GAC1C,SAAS,KAAK,OAAO;GACrB,QAAQ;EACV,CAAC;EAED,MAAM,gBAAgB,KAAK,OAAO;EAClC,IAAI,CAAC,eACH,MAAM,IAAIC,sBAAAA,iBAAAA,KAER,kCACF;EAIF,MAAMC,wCAAAA,aAAa,QAAQ,eAAe,MAAM,MAD1B,KAAK,uBAAuB,OAAO,CACF;EACvD,OAAO,EAAE,QAAQ,YAAY;CAC/B;AACF"}

package/dist/cjs/core/tasks/PrepareTransactionTask.d.ts

@@ -0,0 +1,10 @@
+import { StepExecutorContext, TaskResult } from "../../types/execution.js";
+import { BaseStepExecutionTask } from "../BaseStepExecutionTask.js";
+
+//#region src/core/tasks/PrepareTransactionTask.d.ts
+declare class PrepareTransactionTask extends BaseStepExecutionTask {
+  run(context: StepExecutorContext): Promise<TaskResult>;
+}
+//#endregion
+export { PrepareTransactionTask };
+//# sourceMappingURL=PrepareTransactionTask.d.ts.map

package/dist/cjs/core/tasks/PrepareTransactionTask.js

@@ -0,0 +1,30 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../errors/constants.js");
+const require_errors_errors = require("../../errors/errors.js");
+const require_actions_getStepTransaction = require("../../actions/getStepTransaction.js");
+const require_core_BaseStepExecutionTask = require("../BaseStepExecutionTask.js");
+const require_core_tasks_helpers_stepComparison = require("./helpers/stepComparison.js");
+//#region src/core/tasks/PrepareTransactionTask.ts
+var PrepareTransactionTask = class extends require_core_BaseStepExecutionTask.BaseStepExecutionTask {
+	async run(context) {
+		const { client, step, statusManager, allowUserInteraction, executionOptions, isBridgeExecution } = context;
+		const action = statusManager.findAction(step, isBridgeExecution ? "CROSS_CHAIN" : "SWAP");
+		if (!action) throw new require_errors_errors.TransactionError(1008, "Unable to prepare transaction. Action not found.");
+		if (!step.transactionRequest) {
+			const { execution, ...stepBase } = step;
+			const comparedStep = await require_core_tasks_helpers_stepComparison.stepComparison(statusManager, step, await require_actions_getStepTransaction.getStepTransaction(client, stepBase), allowUserInteraction, executionOptions);
+			Object.assign(step, {
+				...comparedStep,
+				execution: step.execution
+			});
+		}
+		if (!step.transactionRequest?.data) throw new require_errors_errors.TransactionError(1008, "Unable to prepare transaction. Transaction request data is not found.");
+		statusManager.updateAction(step, action.type, "ACTION_REQUIRED");
+		if (!allowUserInteraction) return { status: "PAUSED" };
+		return { status: "COMPLETED" };
+	}
+};
+//#endregion
+exports.PrepareTransactionTask = PrepareTransactionTask;
+
+//# sourceMappingURL=PrepareTransactionTask.js.map

package/dist/cjs/core/tasks/PrepareTransactionTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrepareTransactionTask.js","names":["BaseStepExecutionTask","TransactionError","stepComparison","getStepTransaction"],"sources":["../../../../src/core/tasks/PrepareTransactionTask.ts"],"sourcesContent":["import { getStepTransaction } from '../../actions/getStepTransaction.js'\nimport { LiFiErrorCode } from '../../errors/constants.js'\nimport { TransactionError } from '../../errors/errors.js'\nimport type { StepExecutorContext, TaskResult } from '../../types/execution.js'\nimport { BaseStepExecutionTask } from '../BaseStepExecutionTask.js'\nimport { stepComparison } from './helpers/stepComparison.js'\n\nexport class PrepareTransactionTask extends BaseStepExecutionTask {\n  async run(context: StepExecutorContext): Promise<TaskResult> {\n    const {\n      client,\n      step,\n      statusManager,\n      allowUserInteraction,\n      executionOptions,\n      isBridgeExecution,\n    } = context\n\n    const action = statusManager.findAction(\n      step,\n      isBridgeExecution ? 'CROSS_CHAIN' : 'SWAP'\n    )\n\n    if (!action) {\n      throw new TransactionError(\n        LiFiErrorCode.TransactionUnprepared,\n        'Unable to prepare transaction. Action not found.'\n      )\n    }\n\n    if (!step.transactionRequest) {\n      const { execution, ...stepBase } = step\n      const updatedStep = await getStepTransaction(client, stepBase)\n      const comparedStep = await stepComparison(\n        statusManager,\n        step,\n        updatedStep,\n        allowUserInteraction,\n        executionOptions\n      )\n      Object.assign(step, {\n        ...comparedStep,\n        execution: step.execution,\n      })\n    }\n\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    statusManager.updateAction(step, action.type, 'ACTION_REQUIRED')\n\n    if (!allowUserInteraction) {\n      return { status: 'PAUSED' }\n    }\n\n    return { status: 'COMPLETED' }\n  }\n}\n"],"mappings":";;;;;;;AAOA,IAAa,yBAAb,cAA4CA,mCAAAA,sBAAsB;CAChE,MAAM,IAAI,SAAmD;EAC3D,MAAM,EACJ,QACA,MACA,eACA,sBACA,kBACA,sBACE;EAEJ,MAAM,SAAS,cAAc,WAC3B,MACA,oBAAoB,gBAAgB,MACtC;EAEA,IAAI,CAAC,QACH,MAAM,IAAIC,sBAAAA,iBAAAA,MAER,kDACF;EAGF,IAAI,CAAC,KAAK,oBAAoB;GAC5B,MAAM,EAAE,WAAW,GAAG,aAAa;GAEnC,MAAM,eAAe,MAAMC,0CAAAA,eACzB,eACA,MACA,MAJwBC,mCAAAA,mBAAmB,QAAQ,QAAQ,GAK3D,sBACA,gBACF;GACA,OAAO,OAAO,MAAM;IAClB,GAAG;IACH,WAAW,KAAK;GAClB,CAAC;EACH;EAEA,IAAI,CAAC,KAAK,oBAAoB,MAC5B,MAAM,IAAIF,sBAAAA,iBAAAA,MAER,uEACF;EAGF,cAAc,aAAa,MAAM,OAAO,MAAM,iBAAiB;EAE/D,IAAI,CAAC,sBACH,OAAO,EAAE,QAAQ,SAAS;EAG5B,OAAO,EAAE,QAAQ,YAAY;CAC/B;AACF"}

package/dist/cjs/core/tasks/WaitForTransactionStatusTask.d.ts

@@ -0,0 +1,13 @@
+import { ExecutionActionType } from "../../types/core.js";
+import { StepExecutorContext, TaskResult } from "../../types/execution.js";
+import { BaseStepExecutionTask } from "../BaseStepExecutionTask.js";
+
+//#region src/core/tasks/WaitForTransactionStatusTask.d.ts
+declare class WaitForTransactionStatusTask extends BaseStepExecutionTask {
+  readonly actionType: ExecutionActionType;
+  constructor(actionType: ExecutionActionType);
+  run(context: StepExecutorContext): Promise<TaskResult>;
+}
+//#endregion
+export { WaitForTransactionStatusTask };
+//# sourceMappingURL=WaitForTransactionStatusTask.d.ts.map

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

@@ -0,0 +1,63 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../errors/constants.js");
+const require_errors_errors = require("../../errors/errors.js");
+const require_core_BaseStepExecutionTask = require("../BaseStepExecutionTask.js");
+const require_utils_getTransactionMessage = require("../../utils/getTransactionMessage.js");
+const require_core_tasks_helpers_waitForTransactionStatus = require("./helpers/waitForTransactionStatus.js");
+//#region src/core/tasks/WaitForTransactionStatusTask.ts
+var WaitForTransactionStatusTask = class extends require_core_BaseStepExecutionTask.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 require_core_tasks_helpers_waitForTransactionStatus.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) {
+			const htmlMessage = await require_utils_getTransactionMessage.getTransactionFailedMessage(client, step, `${toChain.metamask.blockExplorerUrls[0]}tx/${transactionHash}`);
+			throw new require_errors_errors.TransactionError(1003, htmlMessage ?? "Failed while waiting for status of destination chain transaction.", e);
+		}
+	}
+};
+//#endregion
+exports.WaitForTransactionStatusTask = WaitForTransactionStatusTask;
+
+//# sourceMappingURL=WaitForTransactionStatusTask.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WaitForTransactionStatusTask.js","names":["BaseStepExecutionTask","waitForTransactionStatus","getTransactionFailedMessage","TransactionError"],"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,cAAkDA,mCAAAA,sBAAsB;CACtE;CAEA,YAAY,YAAiC;EAC3C,MAAM;EACN,KAAK,aAAa;CACpB;CAEA,MAAM,IAAI,SAAmD;EAC3D,MAAM,EACJ,QACA,MACA,eACA,mBACA,SACA,sBACE;EAIJ,IAAI;EACJ,IAAI;GACF,MAAM,qBAAqB,cAAc,WACvC,MACA,oBAAoB,gBAAgB,MACtC;GACA,kBAAkB,oBAAoB,UAAU,oBAAoB;GAGpE,IAAI,CAAC,iBACH,MAAM,IAAI,MAAM,gCAAgC;GAGlD,MAAM,SAAS,cAAc,iBAAiB;IAC5C;IACA,MAAM,KAAK;IACX,SACE,KAAK,eAAe,oBAChB,KAAK,OAAO,YACZ,KAAK,OAAO;IAClB,QAAQ;GACV,CAAC;GAED,MAAM,iBAAkB,MAAMC,oDAAAA,yBAC5B,QACA,eACA,iBACA,MACA,OAAO,MACP,iBACF;GAEA,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;GACnE,CAAC;GAGD,cAAc,gBAAgB,MAAM;IAClC,QAAQ;IACR,GAAI,eAAe,QAAQ,UAAU,EACnC,YAAY,eAAe,QAAQ,OACrC;IACA,GAAI,iBAAiB,UAAU,EAAE,UAAU,gBAAgB,OAAO;IAClE,GAAI,iBAAiB,SAAS,EAAE,SAAS,gBAAgB,MAAM;IAC/D,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;IACR,CACF;GACF,CAAC;GAED,OAAO,EAAE,QAAQ,YAAY;EAC/B,SAAS,GAAQ;GACf,MAAM,cAAc,MAAMC,oCAAAA,4BACxB,QACA,MACA,GAAG,QAAQ,SAAS,kBAAkB,GAAG,KAAK,iBAChD;GACA,MAAM,IAAIC,sBAAAA,iBAAAA,MAER,eACE,qEACF,CACF;EACF;CACF;AACF"}

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

@@ -0,0 +1,30 @@
+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