@jack-kernel/sdk 1.1.0 → 1.2.2

package/dist/types/index.d.ts

@@ -21,6 +21,9 @@ import { CostTracker } from './costs.js';
 import { AgentUtils } from './agent.js';
 import { YellowProvider } from './yellow/yellow-provider.js';
 import type { YellowConfig } from './yellow/yellow-provider.js';
+import { LifiProvider } from './lifi/lifi-provider.js';
+import type { LifiConfig } from './lifi/lifi-provider.js';
+import type { LifiQuotePayload, LifiRoutePayload } from './lifi/types.js';
 import { type ClientConfig, type IntentParams, type Intent } from './types.js';
 import type { WalletClient } from 'viem';
 /**
@@ -87,6 +90,10 @@ export declare class JACK_SDK {
      * **Validates: Requirements 1.6, 1.7**
      */
     readonly yellow?: YellowProvider;
+    /**
+     * LI.FI provider - cross-chain quote and route discovery (optional)
+     */
+    readonly lifi?: LifiProvider;
     /**
      * Internal HTTP client (exposed for advanced use cases)
      */
@@ -99,7 +106,8 @@ export declare class JACK_SDK {
      * caching, and custom headers.
      *
      * @param config - Client configuration (baseUrl required, other options optional). Optionally includes
-     *   a `yellow` field with YellowSDKConfig to enable Yellow Network integration.
+     *   a `yellow` field with YellowSDKConfig to enable Yellow Network integration, and/or a `lifi` field
+     *   with LifiConfig to enable LI.FI integration.
      * @throws ValidationError if configuration is invalid
      * @throws Error if YellowProvider initialization fails when yellow config is provided
      *
@@ -129,10 +137,18 @@ export declare class JACK_SDK {
      *   }
      * });
      * console.log(sdk.yellow); // YellowProvider instance
+     *
+     * // With LI.FI integration
+     * const sdk = new JACK_SDK({
+     *   baseUrl: 'https://api.jack.example',
+     *   lifi: { integrator: 'jackkernel' }
+     * });
+     * console.log(sdk.lifi); // LifiProvider instance
      * ```
      */
     constructor(config: ClientConfig & {
         yellow?: YellowSDKConfig;
+        lifi?: LifiConfig;
     });
     /**
      * Convenience method: Submit a signed intent
@@ -246,5 +262,46 @@ export declare class JACK_SDK {
      * @returns EIP-712 TypedData object
      */
     getIntentTypedData(params: IntentParams): import("./types.js").TypedData;
+    /**
+     * Convenience method: Get a LI.FI quote for intent params
+     *
+     * Delegates to LifiProvider.fetchQuote(). Throws if the SDK was not
+     * initialized with a LI.FI configuration.
+     *
+     * @param params - Intent parameters
+     * @returns Promise resolving to a normalized LifiQuotePayload
+     * @throws Error if LI.FI is not configured
+     *
+     * @example
+     * ```typescript
+     * const sdk = new JACK_SDK({ baseUrl: '...', lifi: {} });
+     * const quote = await sdk.getLifiQuote(params);
+     * console.log('Quote:', quote.quote.amountOut);
+     * ```
+     *
+     * **Validates: Requirements 1.6, 1.7**
+     */
+    getLifiQuote(params: IntentParams): Promise<LifiQuotePayload>;
+    /**
+     * Convenience method: Get a LI.FI route for intent params
+     *
+     * Delegates to LifiProvider.fetchRoute(). Throws if the SDK was not
+     * initialized with a LI.FI configuration.
+     *
+     * @param params - Intent parameters
+     * @returns Promise resolving to a normalized LifiRoutePayload
+     * @throws Error if LI.FI is not configured
+     *
+     * @example
+     * ```typescript
+     * const sdk = new JACK_SDK({ baseUrl: '...', lifi: {} });
+     * const route = await sdk.getLifiRoute(params);
+     * console.log('Route:', route.route?.steps);
+     * ```
+     *
+     * **Validates: Requirements 1.6, 1.7**
+     */
+    getLifiRoute(params: IntentParams): Promise<LifiRoutePayload>;
 }
+export * from './lifi/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/lifi/chain-map.d.ts

@@ -0,0 +1,27 @@
+/**
+ * ChainMap — pure mapping module for chain name → chain ID resolution.
+ *
+ * Lookups are case-insensitive via `name.toLowerCase()`.
+ */
+export type ChainResolution = {
+    ok: true;
+    chainId: number;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Resolve a human-readable chain name to its numeric chain ID.
+ *
+ * @param name - Chain name (case-insensitive), e.g. "Arbitrum", "OPTIMISM"
+ * @returns A discriminated union: `{ ok: true, chainId }` on success,
+ *          `{ ok: false, reason }` when the chain is not supported.
+ */
+export declare function resolveChain(name: string): ChainResolution;
+/**
+ * Return a copy of the supported chain mappings.
+ *
+ * @returns A new `Record<string, number>` with all supported chain entries.
+ */
+export declare function getSupportedChains(): Record<string, number>;
+//# sourceMappingURL=chain-map.d.ts.map

package/dist/types/lifi/chain-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-map.d.ts","sourceRoot":"","sources":["../../../src/lifi/chain-map.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAUlC;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAM1D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE3D"}

package/dist/types/lifi/fallback.d.ts

@@ -0,0 +1,58 @@
+/**
+ * FallbackProvider — generates estimated quotes, routes, and statuses when
+ * the LI.FI SDK is unavailable or returns errors.
+ *
+ * Ported from `apps/dashboard/src/lib/lifi.ts` for reuse across the SDK.
+ *
+ * @module
+ */
+import type { IntentParams } from '../types.js';
+import type { LifiFallback, LifiQuotePayload, LifiRoutePayload, LifiStatusPayload } from './types.js';
+/**
+ * Static exchange rates used when the LI.FI SDK is unavailable.
+ * Keys are formatted as `TOKENA:TOKENB` (upper-case).
+ */
+export declare const FALLBACK_RATES: Record<string, number>;
+/**
+ * Produce a deterministic, human-readable ID from a seed string using the
+ * DJB2 hash algorithm.
+ *
+ * The result has the form `JK-LIFI-{hash}` where `{hash}` is the unsigned
+ * 32-bit DJB2 value encoded in upper-case base-36.
+ *
+ * @param seed - Arbitrary string to hash
+ * @returns A deterministic ID of the form `JK-LIFI-[A-Z0-9]+`
+ */
+export declare function deterministicId(seed: string): string;
+/**
+ * Build a fallback quote payload when the LI.FI SDK is unavailable.
+ *
+ * Uses static exchange rates from {@link FALLBACK_RATES} to estimate the
+ * output amount. If the token pair is not in the static table the rate
+ * defaults to `1`.
+ *
+ * @param params - The original intent parameters
+ * @param reason - Fallback metadata describing why the fallback was triggered
+ * @returns A complete {@link LifiQuotePayload} with `provider: 'fallback'`
+ */
+export declare function buildFallbackQuote(params: IntentParams, reason: LifiFallback): LifiQuotePayload;
+/**
+ * Build a fallback route payload when the LI.FI SDK is unavailable.
+ *
+ * The route payload contains no execution steps but preserves the chain and
+ * token metadata so callers can still display useful information.
+ *
+ * @param params - The original intent parameters
+ * @param reason - Fallback metadata describing why the fallback was triggered
+ * @returns A complete {@link LifiRoutePayload} with `provider: 'fallback'`
+ */
+export declare function buildFallbackRoute(params: IntentParams, reason: LifiFallback): LifiRoutePayload;
+/**
+ * Build a fallback status payload when the LI.FI SDK is unavailable.
+ *
+ * @param txHash  - The transaction hash being queried (may be `undefined`)
+ * @param reason  - Fallback metadata describing why the fallback was triggered
+ * @returns A complete {@link LifiStatusPayload} with `provider: 'fallback'`
+ */
+export declare function buildFallbackStatus(txHash: string | undefined, reason: LifiFallback): LifiStatusPayload;
+//# sourceMappingURL=fallback.d.ts.map

package/dist/types/lifi/fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../../src/lifi/fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGtG;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOjD,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,GACnB,gBAAgB,CAgClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,GACnB,gBAAgB,CAsBlB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,YAAY,GACnB,iBAAiB,CAUnB"}

package/dist/types/lifi/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Barrel export for the LI.FI integration submodule.
+ *
+ * Re-exports all public types, classes, and functions from the lifi submodule
+ * so consumers can import from a single entry point.
+ *
+ * @module
+ */
+export { LifiProvider } from './lifi-provider.js';
+export type { LifiConfig } from './lifi-provider.js';
+export type { LifiProviderType, LifiReasonCode, LifiFallback, LifiQuotePayload, LifiRoutePayload, LifiStatusPayload, } from './types.js';
+export { resolveChain, getSupportedChains } from './chain-map.js';
+export type { ChainResolution } from './chain-map.js';
+export { resolveToken, getSupportedTokens } from './token-map.js';
+export type { TokenInfo, TokenResolution } from './token-map.js';
+export { toBaseUnits, fromBaseUnits } from './utils.js';
+export { buildFallbackQuote, buildFallbackRoute, buildFallbackStatus, deterministicId, FALLBACK_RATES, } from './fallback.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/lifi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lifi/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAClE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGxD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,cAAc,GACf,MAAM,eAAe,CAAC"}

package/dist/types/lifi/lifi-provider.d.ts

@@ -0,0 +1,133 @@
+/**
+ * LifiProvider — main entry point for all LI.FI operations.
+ *
+ * Handles initialization, parameter validation, SDK delegation,
+ * response normalization, retry logic, and fallback.
+ *
+ * @module
+ */
+import type { IntentParams } from '../types.js';
+import type { LifiQuotePayload, LifiRoutePayload, LifiStatusPayload } from './types.js';
+/**
+ * Configuration options for the LI.FI SDK integration.
+ */
+export interface LifiConfig {
+    /** LI.FI integrator identifier (max 23 chars). Default: "jackkernel" */
+    integrator?: string;
+    /** Optional API key for higher rate limits */
+    apiKey?: string;
+    /** LI.FI API base URL. Default: "https://li.quest/v1" */
+    apiUrl?: string;
+    /** Custom RPC URLs per chain ID */
+    rpcUrls?: Record<number, string[]>;
+    /** Supported chain IDs. Default: [42161, 10, 8453, 137] */
+    chains?: number[];
+    /** Request timeout in ms. Default: 30000 */
+    timeout?: number;
+    /** Max retry attempts for retryable errors. Default: 3 */
+    maxRetries?: number;
+    /** Initial retry delay in ms. Default: 1000 */
+    retryDelay?: number;
+}
+/**
+ * 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.
+ */
+export declare class LifiProvider {
+    private readonly config;
+    /**
+     * Create a new LifiProvider.
+     *
+     * @param userConfig - Optional configuration overrides
+     * @throws If `createConfig` from `@lifi/sdk` fails
+     */
+    constructor(userConfig?: LifiConfig);
+    /**
+     * 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}
+     */
+    fetchQuote(params: IntentParams): Promise<LifiQuotePayload>;
+    /**
+     * 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}
+     */
+    fetchRoute(params: IntentParams): Promise<LifiRoutePayload>;
+    /**
+     * 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}
+     */
+    fetchStatus(txHash?: string): Promise<LifiStatusPayload>;
+    /**
+     * 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
+     */
+    executeWithRetry<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * 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
+     */
+    private isRetryable;
+    /**
+     * Sleep for the given number of milliseconds.
+     *
+     * @param ms - Duration in milliseconds
+     */
+    private sleep;
+    /**
+     * 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
+     */
+    private validateParams;
+    /**
+     * 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}
+     */
+    private mapErrorToReasonCode;
+}
+//# sourceMappingURL=lifi-provider.d.ts.map

package/dist/types/lifi/lifi-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifi-provider.d.ts","sourceRoot":"","sources":["../../../src/lifi/lifi-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAEV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAWpB;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACnC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAwBD;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IAExC;;;;;OAKG;gBACS,UAAU,CAAC,EAAE,UAAU;IAkCnC;;;;;;;;OAQG;IACG,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmHjE;;;;;;;;;OASG;IACG,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoIjE;;;;;;;;;;;OAWG;IACG,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwD9D;;;;;;;;;OASG;IACG,gBAAgB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmB3D;;;;;;;;;;OAUG;IACH,OAAO,CAAC,WAAW;IA0BnB;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAIb;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAiCtB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,oBAAoB;CAe7B"}

package/dist/types/lifi/token-map.d.ts

@@ -0,0 +1,34 @@
+/**
+ * TokenMap — pure mapping module for token symbol → address resolution.
+ *
+ * Lookups are case-insensitive via `symbol.toUpperCase()`.
+ */
+export interface TokenInfo {
+    address: string;
+    decimals: number;
+}
+export type TokenResolution = {
+    ok: true;
+    token: TokenInfo;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * 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.
+ */
+export declare function resolveToken(chainId: number, symbol: string): TokenResolution;
+/**
+ * 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.
+ */
+export declare function getSupportedTokens(chainId: number): Record<string, TokenInfo>;
+//# sourceMappingURL=token-map.d.ts.map

package/dist/types/lifi/token-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-map.d.ts","sourceRoot":"","sources":["../../../src/lifi/token-map.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAC9B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AA8BlC;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAU7E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAW7E"}

package/dist/types/lifi/types.d.ts

@@ -0,0 +1,52 @@
+export type LifiProviderType = 'lifi' | 'fallback';
+export type LifiReasonCode = 'MISSING_PARAMS' | 'INVALID_AMOUNT' | 'UNSUPPORTED_CHAIN' | 'UNSUPPORTED_TOKEN' | 'LIFI_BAD_REQUEST' | 'LIFI_RATE_LIMITED' | 'LIFI_SERVER_ERROR' | 'LIFI_UNAVAILABLE' | 'LIFI_EMPTY_RESPONSE' | 'MISSING_TX_HASH';
+export interface LifiFallback {
+    enabled: true;
+    reasonCode: LifiReasonCode;
+    message: string;
+}
+export interface LifiQuotePayload {
+    provider: LifiProviderType;
+    routeId: string;
+    timestamp: number;
+    quote: {
+        amountIn: string;
+        amountOut: string;
+        minAmountOut?: string;
+        fromChainId: number;
+        toChainId: number;
+        fromToken: string;
+        toToken: string;
+        estimatedGasUsd?: string;
+    };
+    raw?: unknown;
+    fallback?: LifiFallback;
+}
+export interface LifiRoutePayload {
+    provider: LifiProviderType;
+    routeId: string;
+    timestamp: number;
+    route?: {
+        fromChainId: number;
+        toChainId: number;
+        fromToken: string;
+        toToken: string;
+        steps?: unknown[];
+        tags?: string[];
+        estimatedDuration?: number;
+    };
+    raw?: unknown;
+    fallback?: LifiFallback;
+}
+export interface LifiStatusPayload {
+    provider: LifiProviderType;
+    timestamp: number;
+    status: {
+        state: string;
+        substatus?: string;
+        txHash?: string;
+    };
+    raw?: unknown;
+    fallback?: LifiFallback;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/lifi/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lifi/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,CAAC;AAEnD,MAAM,MAAM,cAAc,GACtB,gBAAgB,GAChB,gBAAgB,GAChB,mBAAmB,GACnB,mBAAmB,GACnB,kBAAkB,GAClB,mBAAmB,GACnB,mBAAmB,GACnB,kBAAkB,GAClB,qBAAqB,GACrB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,IAAI,CAAC;IACd,UAAU,EAAE,cAAc,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB"}

package/dist/types/lifi/utils.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 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.
+ */
+/**
+ * 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
+ */
+export declare function toBaseUnits(amount: string, decimals: number): string;
+/**
+ * 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
+ */
+export declare function fromBaseUnits(amount: string, decimals: number): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/types/lifi/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lifi/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jack-kernel/sdk",
-  "version": "1.1.0",
+  "version": "1.2.2",
   "description": "TypeScript SDK for JACK cross-chain execution kernel",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -31,6 +31,9 @@
     "url": "https://github.com/your-org/jack.git",
     "directory": "packages/sdk"
   },
+  "dependencies": {
+    "@lifi/sdk": "^3.15.5"
+  },
   "peerDependencies": {
     "viem": "^2.0.0"
   },