@lifi/sdk 3.0.0-alpha.3 → 3.0.0-alpha.31

package/dist/cjs/connectors.js

@@ -1,75 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMulticallAddress = exports.getPublicClient = exports.getRpcUrls = exports.getRpcUrl = exports.getChainById = void 0;
-const viem_1 = require("viem");
-const chains = __importStar(require("viem/chains")); // TODO: optimize using BE chains
-const ConfigService_1 = __importDefault(require("./services/ConfigService"));
-const errors_1 = require("./utils/errors");
-// cached providers
-const publicClients = {};
-const getChainById = (chainId) => {
-    return Object.values(chains).find((chain) => chain.id === chainId);
-};
-exports.getChainById = getChainById;
-// RPC Urls
-const getRpcUrl = async (chainId) => {
-    const rpcUrls = await (0, exports.getRpcUrls)(chainId);
-    return rpcUrls[0];
-};
-exports.getRpcUrl = getRpcUrl;
-const getRpcUrls = async (chainId) => {
-    const configService = ConfigService_1.default.getInstance();
-    const config = await configService.getConfigAsync();
-    return config.rpcs[chainId];
-};
-exports.getRpcUrls = getRpcUrls;
-const getPublicClient = async (chainId) => {
-    if (!publicClients[chainId]) {
-        const urls = await (0, exports.getRpcUrls)(chainId);
-        const fallbackTransports = urls.map((url) => (0, viem_1.http)(url, {
-            batch: true,
-        }));
-        publicClients[chainId] = (0, viem_1.createPublicClient)({
-            chain: (0, exports.getChainById)(chainId),
-            transport: (0, viem_1.fallback)(fallbackTransports),
-        });
-    }
-    if (!publicClients[chainId]) {
-        throw new errors_1.ServerError(`Unable to configure provider for chain ${chainId}`);
-    }
-    return publicClients[chainId];
-};
-exports.getPublicClient = getPublicClient;
-// Multicall
-const getMulticallAddress = async (chainId) => {
-    const configService = ConfigService_1.default.getInstance();
-    const config = await configService.getConfigAsync();
-    return config.multicallAddresses[chainId];
-};
-exports.getMulticallAddress = getMulticallAddress;

package/dist/cjs/execution/RouteExecutionManager.d.ts

@@ -1,59 +0,0 @@
-import type { Route } from '@lifi/types';
-import type { WalletClient } from 'viem';
-import ConfigService from '../services/ConfigService';
-import type { ConfigUpdate, ExecutionSettings } from '../types';
-export declare class RouteExecutionManager {
-    private executionDictionary;
-    private executionPromiseDictionary;
-    protected configService: ConfigService;
-    constructor(configUpdate: ConfigUpdate);
-    /**
-     * Execute a route.
-     * @param walletClient - The walletClient required to send the transactions.
-     * @param route - The route that should be executed. Cannot be an active route.
-     * @param settings - An object containing settings and callbacks.
-     * @returns The executed route.
-     * @throws {LiFiError} Throws a LiFiError if the execution fails.
-     */
-    executeRoute: (walletClient: WalletClient, route: Route, settings?: ExecutionSettings) => Promise<Route>;
-    /**
-     * Resume the execution of a route that has been stopped or had an error while executing.
-     * @param walletClient - The walletClient required to send the transactions.
-     * @param route - The route that is to be executed. Cannot be an active route.
-     * @param settings - An object containing settings and callbacks.
-     * @returns The executed route.
-     * @throws {LiFiError} Throws a LiFiError if the execution fails.
-     */
-    resumeRoute: (walletClient: WalletClient, route: Route, settings?: ExecutionSettings) => Promise<Route>;
-    private executeSteps;
-    /**
-     * Updates route execution to background or foreground state.
-     * @param route - A route that is currently in execution.
-     * @param settings - An object with execution settings.
-     */
-    updateRouteExecution: (route: Route, settings: Pick<ExecutionSettings, 'executeInBackground'>) => void;
-    /**
-     * Update the ExecutionSettings for an active route.
-     * @param settings - An object with execution settings.
-     * @param route - The active route that gets the new execution settings.
-     * @throws {ValidationError} Throws a ValidationError if parameters are invalid.
-     */
-    updateExecutionSettings: (settings: ExecutionSettings, route: Route) => void;
-    /**
-     * Stops the execution of an active route.
-     * @param route - A route that is currently in execution.
-     * @returns The stopped route.
-     */
-    stopExecution: (route: Route) => Route;
-    /**
-     * Get the list of active routes.
-     * @returns A list of routes.
-     */
-    getActiveRoutes: () => Route[];
-    /**
-     * Return the current route information for given route. The route has to be active.
-     * @param route - A route object.
-     * @returns The updated route.
-     */
-    getActiveRoute: (route: Route) => Route | undefined;
-}

package/dist/cjs/execution/RouteExecutionManager.js

@@ -1,202 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RouteExecutionManager = void 0;
-const ConfigService_1 = __importDefault(require("../services/ConfigService"));
-const errors_1 = require("../utils/errors");
-const StatusManager_1 = require("./StatusManager");
-const StepExecutor_1 = require("./StepExecutor");
-const prepareRestart_1 = require("./prepareRestart");
-class RouteExecutionManager {
-    constructor(configUpdate) {
-        this.executionDictionary = {};
-        this.executionPromiseDictionary = {};
-        /**
-         * Execute a route.
-         * @param walletClient - The walletClient required to send the transactions.
-         * @param route - The route that should be executed. Cannot be an active route.
-         * @param settings - An object containing settings and callbacks.
-         * @returns The executed route.
-         * @throws {LiFiError} Throws a LiFiError if the execution fails.
-         */
-        this.executeRoute = async (walletClient, route, settings) => {
-            // Deep clone to prevent side effects
-            const clonedRoute = structuredClone(route);
-            let executionPromise = this.executionPromiseDictionary[clonedRoute.id];
-            // Check if route is already running
-            if (executionPromise) {
-                return executionPromise;
-            }
-            executionPromise = this.executeSteps(walletClient, clonedRoute, settings);
-            this.executionPromiseDictionary[clonedRoute.id] = executionPromise;
-            return executionPromise;
-        };
-        /**
-         * Resume the execution of a route that has been stopped or had an error while executing.
-         * @param walletClient - The walletClient required to send the transactions.
-         * @param route - The route that is to be executed. Cannot be an active route.
-         * @param settings - An object containing settings and callbacks.
-         * @returns The executed route.
-         * @throws {LiFiError} Throws a LiFiError if the execution fails.
-         */
-        this.resumeRoute = async (walletClient, route, settings) => {
-            // Deep clone to prevent side effects
-            const clonedRoute = structuredClone(route);
-            const execution = this.executionDictionary[clonedRoute.id];
-            if (execution) {
-                const executionHalted = execution.executors.some((executor) => executor.executionStopped);
-                if (!executionHalted) {
-                    // Check if we want to resume route execution in the background
-                    this.updateRouteExecution(route, {
-                        executeInBackground: settings?.executeInBackground,
-                    });
-                    const executionPromise = this.executionPromiseDictionary[clonedRoute.id];
-                    return executionPromise ?? clonedRoute;
-                }
-            }
-            await (0, prepareRestart_1.prepareRestart)(clonedRoute, walletClient);
-            const executionPromise = this.executeSteps(walletClient, clonedRoute, settings);
-            this.executionPromiseDictionary[clonedRoute.id] = executionPromise;
-            return executionPromise;
-        };
-        this.executeSteps = async (walletClient, route, settings) => {
-            const config = this.configService.getConfig();
-            const execution = {
-                route,
-                executors: [],
-                settings: { ...config.defaultExecutionSettings, ...settings },
-            };
-            this.executionDictionary[route.id] = execution;
-            const statusManager = new StatusManager_1.StatusManager(route, execution.settings, (route) => {
-                if (this.executionDictionary[route.id]) {
-                    execution.route = route;
-                }
-            });
-            // Loop over steps and execute them
-            for (let index = 0; index < route.steps.length; index++) {
-                const execution = this.executionDictionary[route.id];
-                // Check if execution has stopped in the meantime
-                if (!execution) {
-                    break;
-                }
-                const step = route.steps[index];
-                const previousStep = route.steps[index - 1];
-                // Check if the step is already done
-                //
-                if (step.execution?.status === 'DONE') {
-                    continue;
-                }
-                // Update amount using output of previous execution. In the future this should be handled by calling `updateRoute`
-                if (previousStep?.execution?.toAmount) {
-                    step.action.fromAmount = previousStep.execution.toAmount;
-                }
-                try {
-                    const stepExecutor = new StepExecutor_1.StepExecutor(statusManager, execution.settings);
-                    execution.executors.push(stepExecutor);
-                    // Check if we want to execute this step in the background
-                    this.updateRouteExecution(route, execution.settings);
-                    const executedStep = await stepExecutor.executeStep(walletClient, step);
-                    // We may reach this point if user interaction isn't allowed. We want to stop execution until we resume it
-                    if (executedStep.execution?.status !== 'DONE') {
-                        this.stopExecution(route);
-                    }
-                    // Execution stopped during the current step, we don't want to continue to the next step so we return already
-                    if (stepExecutor.executionStopped) {
-                        return route;
-                    }
-                }
-                catch (e) {
-                    this.stopExecution(route);
-                    throw e;
-                }
-            }
-            // Clean up after the execution
-            delete this.executionDictionary[route.id];
-            return route;
-        };
-        /**
-         * Updates route execution to background or foreground state.
-         * @param route - A route that is currently in execution.
-         * @param settings - An object with execution settings.
-         */
-        this.updateRouteExecution = (route, settings) => {
-            const execution = this.executionDictionary[route.id];
-            if (!execution) {
-                return;
-            }
-            for (const executor of execution.executors) {
-                executor.setInteraction({
-                    allowInteraction: !settings.executeInBackground,
-                    allowUpdates: true,
-                });
-            }
-            // Update active route settings so we know what the current state of execution is
-            execution.settings = {
-                ...execution.settings,
-                ...settings,
-            };
-        };
-        /**
-         * Update the ExecutionSettings for an active route.
-         * @param settings - An object with execution settings.
-         * @param route - The active route that gets the new execution settings.
-         * @throws {ValidationError} Throws a ValidationError if parameters are invalid.
-         */
-        this.updateExecutionSettings = (settings, route) => {
-            const execution = this.executionDictionary[route.id];
-            if (!execution) {
-                throw new errors_1.ValidationError("Can't set ExecutionSettings for the inactive route.");
-            }
-            const config = this.configService.getConfig();
-            execution.settings = {
-                ...config.defaultExecutionSettings,
-                ...settings,
-            };
-        };
-        /**
-         * Stops the execution of an active route.
-         * @param route - A route that is currently in execution.
-         * @returns The stopped route.
-         */
-        this.stopExecution = (route) => {
-            const execution = this.executionDictionary[route.id];
-            if (!execution) {
-                return route;
-            }
-            for (const executor of execution.executors) {
-                executor.setInteraction({
-                    allowInteraction: false,
-                    allowUpdates: false,
-                    stopExecution: true,
-                });
-            }
-            delete this.executionDictionary[route.id];
-            return route;
-        };
-        /**
-         * Get the list of active routes.
-         * @returns A list of routes.
-         */
-        this.getActiveRoutes = () => {
-            return Object.values(this.executionDictionary)
-                .map((dict) => dict?.route)
-                .filter(Boolean);
-        };
-        /**
-         * Return the current route information for given route. The route has to be active.
-         * @param route - A route object.
-         * @returns The updated route.
-         */
-        this.getActiveRoute = (route) => {
-            return this.executionDictionary[route.id]?.route;
-        };
-        this.configService = ConfigService_1.default.getInstance();
-        if (configUpdate) {
-            // Update API urls before we request chains
-            this.configService.updateConfig(configUpdate);
-        }
-    }
-}
-exports.RouteExecutionManager = RouteExecutionManager;

package/dist/cjs/execution/StatusManager.js

@@ -1,171 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.StatusManager = void 0;
-const types_1 = require("../types");
-const utils_1 = require("./utils");
-/**
- * Manages status updates of a route and provides various functions for tracking processes
- * @param {Route} route The route this StatusManger belongs to.
- * @param {InternalExecutionSettings} settings The ExecutionSettings for this route.
- * @param {InternalUpdateRouteCallback} internalUpdateRouteCallback Internal callback to propage route changes.
- * @returns {StatusManager} An instance of StatusManager.
- */
-class StatusManager {
-    constructor(route, settings, internalUpdateRouteCallback) {
-        this.shouldUpdate = true;
-        /**
-         * Initializes the execution object of a Step.
-         * @param step  The current step in execution
-         * @returns The initialized execution object for this step and a function to update this step
-         */
-        this.initExecutionObject = (step) => {
-            const currentExecution = step.execution || structuredClone(types_1.emptyExecution);
-            if (!step.execution) {
-                step.execution = currentExecution;
-                step.execution.status = 'PENDING';
-                this.updateStepInRoute(step);
-            }
-            // Change status to PENDING after resuming from FAILED
-            if (currentExecution.status === 'FAILED') {
-                currentExecution.status = 'PENDING';
-                this.updateStepInRoute(step);
-            }
-            return currentExecution;
-        };
-        /**
-         * Create and push a new process into the execution.
-         * @param step The step that should contain the new process.
-         * @param type Type of the process. Used to identify already existing processes.
-         * @param status By default created procces is set to the STARTED status. We can override new process with the needed status.
-         * @returns Returns process.
-         */
-        this.findOrCreateProcess = (step, type, status) => {
-            if (!step.execution?.process) {
-                throw new Error("Execution hasn't been initialized.");
-            }
-            const process = step.execution.process.find((p) => p.type === type);
-            if (process) {
-                if (status && process.status !== status) {
-                    process.status = status;
-                    this.updateStepInRoute(step);
-                }
-                return process;
-            }
-            const newProcess = {
-                type: type,
-                startedAt: Date.now(),
-                message: (0, utils_1.getProcessMessage)(type, status ?? 'STARTED'),
-                status: status ?? 'STARTED',
-            };
-            step.execution.process.push(newProcess);
-            this.updateStepInRoute(step);
-            return newProcess;
-        };
-        /**
-         * Update a process object.
-         * @param step The step where the process should be updated
-         * @param type  The process type to update
-         * @param status The status the process gets.
-         * @param [params]   Additional parameters to append to the process.
-         * @returns The update process
-         */
-        this.updateProcess = (step, type, status, params) => {
-            if (!step.execution) {
-                throw new Error("Can't update an empty step execution.");
-            }
-            const currentProcess = step?.execution?.process.find((p) => p.type === type);
-            if (!currentProcess) {
-                throw new Error("Can't find a process for the given type.");
-            }
-            switch (status) {
-                case 'CANCELLED':
-                    currentProcess.doneAt = Date.now();
-                    break;
-                case 'FAILED':
-                    currentProcess.doneAt = Date.now();
-                    step.execution.status = 'FAILED';
-                    break;
-                case 'DONE':
-                    currentProcess.doneAt = Date.now();
-                    break;
-                case 'PENDING':
-                    step.execution.status = 'PENDING';
-                    break;
-                case 'ACTION_REQUIRED':
-                    step.execution.status = 'ACTION_REQUIRED';
-                    break;
-                default:
-                    break;
-            }
-            currentProcess.status = status;
-            currentProcess.message = (0, utils_1.getProcessMessage)(type, status);
-            // set extra parameters or overwritte the standard params set in the switch statement
-            if (params) {
-                for (const [key, value] of Object.entries(params)) {
-                    currentProcess[key] = value;
-                }
-            }
-            // Sort processes, the ones with DONE status go first
-            step.execution.process = [
-                ...step?.execution?.process.filter((process) => process.status === 'DONE'),
-                ...step?.execution?.process.filter((process) => process.status !== 'DONE'),
-            ];
-            this.updateStepInRoute(step); // updates the step in the route
-            return currentProcess;
-        };
-        /**
-         * Remove a process from the execution
-         * @param step The step where the process should be removed from
-         * @param type  The process type to remove
-         */
-        this.removeProcess = (step, type) => {
-            if (!step.execution) {
-                throw new Error("Execution hasn't been initialized.");
-            }
-            const index = step.execution.process.findIndex((p) => p.type === type);
-            step.execution.process.splice(index, 1);
-            this.updateStepInRoute(step);
-        };
-        this.updateStepInRoute = (step) => {
-            if (!this.shouldUpdate) {
-                return step;
-            }
-            const stepIndex = this.route.steps.findIndex((routeStep) => routeStep.id === step.id);
-            if (stepIndex === -1) {
-                throw new Error("Couldn't find a step to update.");
-            }
-            this.route.steps[stepIndex] = Object.assign(this.route.steps[stepIndex], step);
-            this.settings.updateRouteHook(this.route);
-            this.internalUpdateRouteCallback(this.route);
-            return this.route.steps[stepIndex];
-        };
-        this.route = route;
-        this.settings = settings;
-        this.internalUpdateRouteCallback = internalUpdateRouteCallback;
-    }
-    /**
-     * Updates the execution object of a Step.
-     * @param step  The current step in execution
-     * @param status  The status for the execution
-     * @param receipt Optional. Information about received tokens
-     * @returns       The step with the updated execution object
-     */
-    updateExecution(step, status, receipt) {
-        if (!step.execution) {
-            throw Error("Can't update empty execution.");
-        }
-        step.execution.status = status;
-        if (receipt) {
-            step.execution = {
-                ...step.execution,
-                ...receipt,
-            };
-        }
-        this.updateStepInRoute(step);
-        return step;
-    }
-    allowUpdates(value) {
-        this.shouldUpdate = value;
-    }
-}
-exports.StatusManager = StatusManager;

package/dist/cjs/execution/StepExecutionManager.d.ts

@@ -1,7 +0,0 @@
-import type { Execution } from '@lifi/types';
-import type { ExecutionParams } from '../types';
-export declare class StepExecutionManager {
-    allowUserInteraction: boolean;
-    allowInteraction: (value: boolean) => void;
-    execute: ({ walletClient, step, statusManager, settings, }: ExecutionParams) => Promise<Execution>;
-}