@jack-kernel/sdk 1.0.0 → 1.2.1

package/dist/cjs/lifi/lifi-provider.js

@@ -0,0 +1,496 @@
+"use strict";
+/**
+ * LifiProvider — main entry point for all LI.FI operations.
+ *
+ * Handles initialization, parameter validation, SDK delegation,
+ * response normalization, retry logic, and fallback.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LifiProvider = void 0;
+const sdk_1 = require("@lifi/sdk");
+const fallback_js_1 = require("./fallback.js");
+const chain_map_js_1 = require("./chain-map.js");
+const token_map_js_1 = require("./token-map.js");
+const utils_js_1 = require("./utils.js");
+/** Default configuration values. */
+const DEFAULTS = {
+    integrator: 'jackkernel',
+    apiUrl: 'https://li.quest/v1',
+    chains: [42161, 10, 8453, 137],
+    timeout: 30_000,
+    maxRetries: 3,
+    retryDelay: 1_000,
+};
+/**
+ * LifiProvider wraps the `@lifi/sdk` to provide quote fetching, route
+ * discovery, status tracking, and execution capabilities for the JACK SDK.
+ *
+ * The constructor calls `createConfig` from `@lifi/sdk` with the integrator
+ * string "jackkernel" and any user-supplied configuration. Each public method
+ * validates input, delegates to the SDK with retry logic, normalizes the
+ * response, and falls back to the FallbackProvider on any error.
+ */
+class LifiProvider {
+    config;
+    /**
+     * Create a new LifiProvider.
+     *
+     * @param userConfig - Optional configuration overrides
+     * @throws If `createConfig` from `@lifi/sdk` fails
+     */
+    constructor(userConfig) {
+        this.config = {
+            integrator: userConfig?.integrator ?? DEFAULTS.integrator,
+            apiKey: userConfig?.apiKey,
+            apiUrl: userConfig?.apiUrl ?? DEFAULTS.apiUrl,
+            rpcUrls: userConfig?.rpcUrls ?? {},
+            chains: userConfig?.chains ?? [...DEFAULTS.chains],
+            timeout: userConfig?.timeout ?? DEFAULTS.timeout,
+            maxRetries: userConfig?.maxRetries ?? DEFAULTS.maxRetries,
+            retryDelay: userConfig?.retryDelay ?? DEFAULTS.retryDelay,
+        };
+        try {
+            (0, sdk_1.createConfig)({
+                integrator: this.config.integrator,
+                ...(this.config.apiKey ? { apiKey: this.config.apiKey } : {}),
+                ...(Object.keys(this.config.rpcUrls).length > 0
+                    ? { rpcUrls: this.config.rpcUrls }
+                    : {}),
+                chains: this.config.chains.map((id) => ({ id, name: String(id), network: String(id) })),
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`LifiProvider: failed to initialize LI.FI SDK — ${message}`);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Public API (stubs — implemented in tasks 5.2, 5.3, 5.4)
+    // ---------------------------------------------------------------------------
+    /**
+     * Fetch a quote for the given intent parameters.
+     *
+     * Validates params, resolves chains/tokens, calls `getQuote` from `@lifi/sdk`
+     * with retry, normalizes the response, and falls back on error.
+     *
+     * @param params - Intent parameters
+     * @returns A normalized {@link LifiQuotePayload}
+     */
+    async fetchQuote(params) {
+        // 1. Validate params
+        const invalid = this.validateParams(params);
+        if (invalid) {
+            return (0, fallback_js_1.buildFallbackQuote)(params, invalid);
+        }
+        // 2. Resolve source chain
+        const fromChainRes = (0, chain_map_js_1.resolveChain)(params.sourceChain);
+        if (!fromChainRes.ok) {
+            return (0, fallback_js_1.buildFallbackQuote)(params, {
+                enabled: true,
+                reasonCode: 'UNSUPPORTED_CHAIN',
+                message: fromChainRes.reason,
+            });
+        }
+        const fromChainId = fromChainRes.chainId;
+        // 3. Resolve destination chain
+        const toChainRes = (0, chain_map_js_1.resolveChain)(params.destinationChain);
+        if (!toChainRes.ok) {
+            return (0, fallback_js_1.buildFallbackQuote)(params, {
+                enabled: true,
+                reasonCode: 'UNSUPPORTED_CHAIN',
+                message: toChainRes.reason,
+            });
+        }
+        const toChainId = toChainRes.chainId;
+        // 4. Resolve source token
+        const fromTokenRes = (0, token_map_js_1.resolveToken)(fromChainId, params.tokenIn);
+        if (!fromTokenRes.ok) {
+            return (0, fallback_js_1.buildFallbackQuote)(params, {
+                enabled: true,
+                reasonCode: 'UNSUPPORTED_TOKEN',
+                message: fromTokenRes.reason,
+            });
+        }
+        const fromToken = fromTokenRes.token;
+        // 5. Resolve destination token
+        const toTokenRes = (0, token_map_js_1.resolveToken)(toChainId, params.tokenOut);
+        if (!toTokenRes.ok) {
+            return (0, fallback_js_1.buildFallbackQuote)(params, {
+                enabled: true,
+                reasonCode: 'UNSUPPORTED_TOKEN',
+                message: toTokenRes.reason,
+            });
+        }
+        const toToken = toTokenRes.token;
+        // 6. Convert amountIn to base units
+        const fromAmount = (0, utils_js_1.toBaseUnits)(params.amountIn, fromToken.decimals);
+        try {
+            // 7. Call getQuote from @lifi/sdk with retry
+            const data = await this.executeWithRetry(() => (0, sdk_1.getQuote)({
+                fromChain: fromChainId,
+                toChain: toChainId,
+                fromToken: fromToken.address,
+                toToken: toToken.address,
+                fromAmount: fromAmount,
+                fromAddress: '0x0000000000000000000000000000000000000000',
+            }));
+            // 8. If data is empty/null, return fallback
+            if (!data) {
+                return (0, fallback_js_1.buildFallbackQuote)(params, {
+                    enabled: true,
+                    reasonCode: 'LIFI_EMPTY_RESPONSE',
+                    message: 'LI.FI returned an empty response',
+                });
+            }
+            // 9. Normalize the response
+            const amountOut = data.estimate?.toAmount
+                ? (0, utils_js_1.fromBaseUnits)(data.estimate.toAmount, toToken.decimals)
+                : params.amountIn;
+            const routeId = data.id ?? (0, fallback_js_1.deterministicId)(JSON.stringify(data));
+            const estimatedGasUsd = data.estimate?.gasCosts?.[0]?.amountUSD ?? undefined;
+            return {
+                provider: 'lifi',
+                routeId,
+                timestamp: Date.now(),
+                quote: {
+                    amountIn: params.amountIn,
+                    amountOut,
+                    minAmountOut: params.minAmountOut,
+                    fromChainId,
+                    toChainId,
+                    fromToken: params.tokenIn,
+                    toToken: params.tokenOut,
+                    estimatedGasUsd,
+                },
+                raw: data,
+            };
+        }
+        catch (error) {
+            // 10. Catch errors and return fallback with mapped reason code
+            const reasonCode = this.mapErrorToReasonCode(error);
+            const message = error instanceof Error ? error.message : 'LI.FI quote request failed';
+            return (0, fallback_js_1.buildFallbackQuote)(params, {
+                enabled: true,
+                reasonCode,
+                message,
+            });
+        }
+    }
+    /**
+     * Fetch the best route for the given intent parameters.
+     *
+     * Validates params, resolves chains/tokens, calls `getRoutes` from `@lifi/sdk`
+     * with retry, selects the best route by output amount, normalizes, and falls
+     * back on error.
+     *
+     * @param params - Intent parameters
+     * @returns A normalized {@link LifiRoutePayload}
+     */
+    async fetchRoute(params) {
+        // 1. Validate params
+        const invalid = this.validateParams(params);
+        if (invalid) {
+            return (0, fallback_js_1.buildFallbackRoute)(params, invalid);
+        }
+        // 2. Resolve source chain
+        const fromChainRes = (0, chain_map_js_1.resolveChain)(params.sourceChain);
+        if (!fromChainRes.ok) {
+            return (0, fallback_js_1.buildFallbackRoute)(params, {
+                enabled: true,
+                reasonCode: 'UNSUPPORTED_CHAIN',
+                message: fromChainRes.reason,
+            });
+        }
+        const fromChainId = fromChainRes.chainId;
+        // 3. Resolve destination chain
+        const toChainRes = (0, chain_map_js_1.resolveChain)(params.destinationChain);
+        if (!toChainRes.ok) {
+            return (0, fallback_js_1.buildFallbackRoute)(params, {
+                enabled: true,
+                reasonCode: 'UNSUPPORTED_CHAIN',
+                message: toChainRes.reason,
+            });
+        }
+        const toChainId = toChainRes.chainId;
+        // 4. Resolve source token
+        const fromTokenRes = (0, token_map_js_1.resolveToken)(fromChainId, params.tokenIn);
+        if (!fromTokenRes.ok) {
+            return (0, fallback_js_1.buildFallbackRoute)(params, {
+                enabled: true,
+                reasonCode: 'UNSUPPORTED_TOKEN',
+                message: fromTokenRes.reason,
+            });
+        }
+        const fromToken = fromTokenRes.token;
+        // 5. Resolve destination token
+        const toTokenRes = (0, token_map_js_1.resolveToken)(toChainId, params.tokenOut);
+        if (!toTokenRes.ok) {
+            return (0, fallback_js_1.buildFallbackRoute)(params, {
+                enabled: true,
+                reasonCode: 'UNSUPPORTED_TOKEN',
+                message: toTokenRes.reason,
+            });
+        }
+        const toToken = toTokenRes.token;
+        // 6. Convert amountIn to base units
+        const fromAmount = (0, utils_js_1.toBaseUnits)(params.amountIn, fromToken.decimals);
+        try {
+            // 7. Call getRoutes from @lifi/sdk with retry
+            const data = await this.executeWithRetry(() => (0, sdk_1.getRoutes)({
+                fromChainId,
+                toChainId,
+                fromTokenAddress: fromToken.address,
+                toTokenAddress: toToken.address,
+                fromAmount: fromAmount,
+            }));
+            // 8. If no routes returned, return fallback
+            if (!data.routes || data.routes.length === 0) {
+                return (0, fallback_js_1.buildFallbackRoute)(params, {
+                    enabled: true,
+                    reasonCode: 'LIFI_EMPTY_RESPONSE',
+                    message: 'LI.FI returned no routes',
+                });
+            }
+            // 9. Select the best route by highest toAmount
+            const bestRoute = data.routes.reduce((best, route) => BigInt(route.toAmount ?? '0') > BigInt(best.toAmount ?? '0')
+                ? route
+                : best);
+            // 10. Compute estimated duration as sum of step durations
+            const steps = bestRoute.steps;
+            const estimatedDuration = Array.isArray(steps)
+                ? steps.reduce((sum, step) => {
+                    const estimate = step.estimate;
+                    if (typeof estimate === 'object' && estimate !== null) {
+                        return sum + Number(estimate.executionDuration ?? 0);
+                    }
+                    return sum;
+                }, 0)
+                : undefined;
+            // 11. Normalize the response into a LifiRoutePayload
+            const routeId = bestRoute.id != null
+                ? String(bestRoute.id)
+                : (0, fallback_js_1.deterministicId)(JSON.stringify(bestRoute));
+            return {
+                provider: 'lifi',
+                routeId,
+                timestamp: Date.now(),
+                route: {
+                    fromChainId,
+                    toChainId,
+                    fromToken: params.tokenIn,
+                    toToken: params.tokenOut,
+                    steps: steps,
+                    tags: bestRoute.tags,
+                    estimatedDuration,
+                },
+                raw: bestRoute,
+            };
+        }
+        catch (error) {
+            // 12. Catch errors and return fallback with mapped reason code
+            const reasonCode = this.mapErrorToReasonCode(error);
+            const message = error instanceof Error ? error.message : 'LI.FI route request failed';
+            return (0, fallback_js_1.buildFallbackRoute)(params, {
+                enabled: true,
+                reasonCode,
+                message,
+            });
+        }
+    }
+    /**
+     * Check the status of a LI.FI transaction.
+     *
+     * 1. Checks for missing txHash — returns fallback with 'MISSING_TX_HASH'
+     * 2. Calls `getStatus` from `@lifi/sdk` with retry
+     * 3. If data is empty/null, returns fallback with 'LIFI_EMPTY_RESPONSE'
+     * 4. Normalizes the response into a LifiStatusPayload
+     * 5. Catches errors and returns fallback with mapped reason code
+     *
+     * @param txHash - Transaction hash to query
+     * @returns A normalized {@link LifiStatusPayload}
+     */
+    async fetchStatus(txHash) {
+        // 1. Check for missing txHash
+        if (!txHash) {
+            return (0, fallback_js_1.buildFallbackStatus)(txHash, {
+                enabled: true,
+                reasonCode: 'MISSING_TX_HASH',
+                message: 'Transaction hash is required',
+            });
+        }
+        try {
+            // 2. Call getStatus from @lifi/sdk with retry
+            const data = await this.executeWithRetry(() => (0, sdk_1.getStatus)({ txHash }));
+            // 3. If data is empty/null, return fallback
+            if (!data) {
+                return (0, fallback_js_1.buildFallbackStatus)(txHash, {
+                    enabled: true,
+                    reasonCode: 'LIFI_EMPTY_RESPONSE',
+                    message: 'LI.FI returned an empty status response',
+                });
+            }
+            // 4. Normalize the response into a LifiStatusPayload
+            const statusData = data;
+            return {
+                provider: 'lifi',
+                timestamp: Date.now(),
+                status: {
+                    state: statusData.status ?? 'UNKNOWN',
+                    substatus: statusData.substatus,
+                    txHash,
+                },
+                raw: data,
+            };
+        }
+        catch (error) {
+            // 5. Catch errors and return fallback with mapped reason code
+            const reasonCode = this.mapErrorToReasonCode(error);
+            const message = error instanceof Error
+                ? error.message
+                : 'LI.FI status request failed';
+            return (0, fallback_js_1.buildFallbackStatus)(txHash, {
+                enabled: true,
+                reasonCode,
+                message,
+            });
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Execute a function with exponential backoff retry logic.
+     *
+     * Retries on rate-limit (429) and server errors (5xx). Non-retryable errors
+     * are re-thrown immediately.
+     *
+     * @param fn - Async function to execute
+     * @returns The result of `fn`
+     * @throws The last error if all retries are exhausted
+     */
+    async executeWithRetry(fn) {
+        let delay = this.config.retryDelay;
+        for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                if (!this.isRetryable(error) || attempt === this.config.maxRetries) {
+                    throw error;
+                }
+                await this.sleep(delay);
+                delay *= 2; // exponential backoff
+            }
+        }
+        // Unreachable in practice, but satisfies the compiler
+        throw new Error('Retry exhausted');
+    }
+    /**
+     * Determine whether an error is retryable.
+     *
+     * Retryable errors:
+     * - HTTP 429 (rate limited)
+     * - HTTP 5xx (server errors)
+     * - Network errors (TypeError, or message containing 'network' / 'fetch')
+     *
+     * @param error - The caught error
+     * @returns `true` if the request should be retried
+     */
+    isRetryable(error) {
+        // Check for HTTP status codes on the error object
+        if (error !== null && typeof error === 'object') {
+            const statusCode = error['status'] ??
+                error['statusCode'];
+            if (typeof statusCode === 'number') {
+                if (statusCode === 429)
+                    return true;
+                if (statusCode >= 500)
+                    return true;
+                // Non-retryable client errors (4xx except 429)
+                return false;
+            }
+        }
+        // Network errors
+        if (error instanceof TypeError)
+            return true;
+        if (error instanceof Error) {
+            const msg = error.message.toLowerCase();
+            if (msg.includes('network') || msg.includes('fetch'))
+                return true;
+        }
+        return false;
+    }
+    /**
+     * Sleep for the given number of milliseconds.
+     *
+     * @param ms - Duration in milliseconds
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Validate that all required IntentParams fields are present and valid.
+     *
+     * @param params - Intent parameters to validate
+     * @returns A {@link LifiFallback} if validation fails, or `null` if valid
+     */
+    validateParams(params) {
+        const requiredFields = [
+            'sourceChain',
+            'destinationChain',
+            'tokenIn',
+            'tokenOut',
+            'amountIn',
+        ];
+        for (const field of requiredFields) {
+            const value = params[field];
+            if (value === undefined || value === null || value === '') {
+                return {
+                    enabled: true,
+                    reasonCode: 'MISSING_PARAMS',
+                    message: `Missing required parameter: ${field}`,
+                };
+            }
+        }
+        // Validate amountIn is a valid positive number
+        const amount = Number(params.amountIn);
+        if (!Number.isFinite(amount) || amount <= 0) {
+            return {
+                enabled: true,
+                reasonCode: 'INVALID_AMOUNT',
+                message: `Invalid amount: "${params.amountIn}" must be a positive number`,
+            };
+        }
+        return null;
+    }
+    /**
+     * Map an error to a LI.FI reason code based on HTTP status codes.
+     *
+     * - 400 or 422 → 'LIFI_BAD_REQUEST'
+     * - 429 → 'LIFI_RATE_LIMITED'
+     * - >= 500 → 'LIFI_SERVER_ERROR'
+     * - Otherwise → 'LIFI_UNAVAILABLE'
+     *
+     * @param error - The caught error
+     * @returns The appropriate {@link LifiReasonCode}
+     */
+    mapErrorToReasonCode(error) {
+        if (error !== null && typeof error === 'object') {
+            const statusCode = error['status'] ??
+                error['statusCode'];
+            if (typeof statusCode === 'number') {
+                if (statusCode === 400 || statusCode === 422)
+                    return 'LIFI_BAD_REQUEST';
+                if (statusCode === 429)
+                    return 'LIFI_RATE_LIMITED';
+                if (statusCode >= 500)
+                    return 'LIFI_SERVER_ERROR';
+            }
+        }
+        return 'LIFI_UNAVAILABLE';
+    }
+}
+exports.LifiProvider = LifiProvider;
+//# sourceMappingURL=lifi-provider.js.map

package/dist/cjs/lifi/lifi-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifi-provider.js","sourceRoot":"","sources":["../../../src/lifi/lifi-provider.ts"],"names":[],"mappings":"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"}

package/dist/cjs/lifi/token-map.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * TokenMap — pure mapping module for token symbol → address resolution.
+ *
+ * Lookups are case-insensitive via `symbol.toUpperCase()`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveToken = resolveToken;
+exports.getSupportedTokens = getSupportedTokens;
+/** Default token mappings per chain ID. Keyed by chain ID → uppercase symbol → TokenInfo. */
+const TOKEN_MAP = {
+    // Arbitrum
+    42161: {
+        USDC: { address: '0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8', decimals: 6 },
+        WETH: { address: '0x82aF49447D8a07e3bd95BD0d56f35241523fBab1', decimals: 18 },
+        ETH: { address: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE', decimals: 18 },
+    },
+    // Optimism
+    10: {
+        USDC: { address: '0x7F5c764cBc14f9669B88837ca1490cCa17c31607', decimals: 6 },
+        WETH: { address: '0x4200000000000000000000000000000000000006', decimals: 18 },
+        ETH: { address: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE', decimals: 18 },
+    },
+    // Base
+    8453: {
+        USDC: { address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', decimals: 6 },
+        WETH: { address: '0x4200000000000000000000000000000000000006', decimals: 18 },
+        ETH: { address: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE', decimals: 18 },
+    },
+    // Polygon
+    137: {
+        USDC: { address: '0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174', decimals: 6 },
+        WETH: { address: '0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619', decimals: 18 },
+        ETH: { address: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE', decimals: 18 },
+    },
+};
+/**
+ * Resolve a token symbol on a given chain to its on-chain address and decimal count.
+ *
+ * @param chainId - Numeric chain ID (e.g. 42161 for Arbitrum)
+ * @param symbol  - Token symbol (case-insensitive), e.g. "usdc", "WETH"
+ * @returns A discriminated union: `{ ok: true, token }` on success,
+ *          `{ ok: false, reason }` when the token is not supported on the chain.
+ */
+function resolveToken(chainId, symbol) {
+    const chainTokens = TOKEN_MAP[chainId];
+    if (chainTokens === undefined) {
+        return { ok: false, reason: `Unsupported chain ID: ${chainId}` };
+    }
+    const token = chainTokens[symbol.toUpperCase()];
+    if (token !== undefined) {
+        return { ok: true, token };
+    }
+    return { ok: false, reason: `Unsupported token "${symbol}" on chain ${chainId}` };
+}
+/**
+ * Return a copy of the token mappings for a given chain.
+ *
+ * @param chainId - Numeric chain ID
+ * @returns A new `Record<string, TokenInfo>` with all supported token entries for the chain,
+ *          or an empty object if the chain is not supported.
+ */
+function getSupportedTokens(chainId) {
+    const chainTokens = TOKEN_MAP[chainId];
+    if (chainTokens === undefined) {
+        return {};
+    }
+    // Return a shallow copy so callers cannot mutate the internal map
+    const copy = {};
+    for (const [symbol, info] of Object.entries(chainTokens)) {
+        copy[symbol] = { ...info };
+    }
+    return copy;
+}
+//# sourceMappingURL=token-map.js.map

package/dist/cjs/lifi/token-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-map.js","sourceRoot":"","sources":["../../../src/lifi/token-map.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AA+CH,oCAUC;AASD,gDAWC;AAlED,6FAA6F;AAC7F,MAAM,SAAS,GAA8C;IAC3D,WAAW;IACX,KAAK,EAAE;QACL,IAAI,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE,QAAQ,EAAE,CAAC,EAAE;QAC5E,IAAI,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC7E,GAAG,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE,QAAQ,EAAE,EAAE,EAAE;KAC7E;IACD,WAAW;IACX,EAAE,EAAE;QACF,IAAI,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE,QAAQ,EAAE,CAAC,EAAE;QAC5E,IAAI,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC7E,GAAG,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE,QAAQ,EAAE,EAAE,EAAE;KAC7E;IACD,OAAO;IACP,IAAI,EAAE;QACJ,IAAI,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE,QAAQ,EAAE,CAAC,EAAE;QAC5E,IAAI,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC7E,GAAG,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE,QAAQ,EAAE,EAAE,EAAE;KAC7E;IACD,UAAU;IACV,GAAG,EAAE;QACH,IAAI,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE,QAAQ,EAAE,CAAC,EAAE;QAC5E,IAAI,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC7E,GAAG,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE,QAAQ,EAAE,EAAE,EAAE;KAC7E;CACF,CAAC;AAEF;;;;;;;GAOG;AACH,SAAgB,YAAY,CAAC,OAAe,EAAE,MAAc;IAC1D,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,yBAAyB,OAAO,EAAE,EAAE,CAAC;IACnE,CAAC;IACD,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAChD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,MAAM,cAAc,OAAO,EAAE,EAAE,CAAC;AACpF,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAC,OAAe;IAChD,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,kEAAkE;IAClE,MAAM,IAAI,GAA8B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cjs/lifi/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/lifi/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lifi/types.ts"],"names":[],"mappings":""}

package/dist/cjs/lifi/utils.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Unit conversion utilities for converting between human-readable token amounts
+ * and base unit (wei-like) representations.
+ *
+ * Ported from apps/dashboard/src/lib/lifi.ts for reuse across the SDK.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toBaseUnits = toBaseUnits;
+exports.fromBaseUnits = fromBaseUnits;
+/**
+ * Converts a human-readable token amount to its base unit representation.
+ *
+ * For example, converting "1.5" USDC (6 decimals) produces "1500000",
+ * and converting "1.5" ETH (18 decimals) produces "1500000000000000000".
+ *
+ * @param amount - The human-readable amount as a string (e.g. "1.5", "100", "0.001")
+ * @param decimals - The number of decimal places for the token
+ * @returns The amount in base units as a string with no decimal point
+ */
+function toBaseUnits(amount, decimals) {
+    const [whole = '0', fraction = ''] = amount.split('.');
+    const normalizedFraction = fraction.padEnd(decimals, '0').slice(0, decimals);
+    const base = `${whole}${normalizedFraction}`.replace(/^0+(?=\d)/, '');
+    return base.length ? base : '0';
+}
+/**
+ * Converts a base unit amount back to a human-readable representation.
+ *
+ * For example, converting "1500000" with 6 decimals produces "1.5",
+ * and converting "1500000000000000000" with 18 decimals produces "1.5".
+ *
+ * @param amount - The base unit amount as a string (e.g. "1500000", "1000000000000000000")
+ * @param decimals - The number of decimal places for the token
+ * @returns The human-readable amount as a string with trailing zeros removed
+ */
+function fromBaseUnits(amount, decimals) {
+    if (!amount || amount === '0')
+        return '0';
+    const padded = amount.padStart(decimals + 1, '0');
+    const whole = padded.slice(0, -decimals) || '0';
+    const fraction = padded.slice(-decimals).replace(/0+$/, '');
+    return fraction ? `${whole}.${fraction}` : whole;
+}
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/lifi/utils.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAYH,kCAKC;AAYD,sCAMC;AAjCD;;;;;;;;;GASG;AACH,SAAgB,WAAW,CAAC,MAAc,EAAE,QAAgB;IAC1D,MAAM,CAAC,KAAK,GAAG,GAAG,EAAE,QAAQ,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvD,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,GAAG,KAAK,GAAG,kBAAkB,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;AAClC,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,aAAa,CAAC,MAAc,EAAE,QAAgB;IAC5D,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,GAAG,CAAC;IAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC;IAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC5D,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACnD,CAAC"}