@jack-kernel/sdk 1.1.0 → 1.2.2

package/dist/esm/index.js

@@ -30,6 +30,8 @@ import { CostTracker } from './costs.js';
 import { AgentUtils } from './agent.js';
 // Import Yellow provider and config for SDK integration
 import { YellowProvider } from './yellow/yellow-provider.js';
+// Import LI.FI provider and types
+import { LifiProvider } from './lifi/lifi-provider.js';
 // Import types and enums for use in this file
 import { ExecutionStatus } from './types.js';
 /**
@@ -84,6 +86,10 @@ export class JACK_SDK {
      * **Validates: Requirements 1.6, 1.7**
      */
     yellow;
+    /**
+     * LI.FI provider - cross-chain quote and route discovery (optional)
+     */
+    lifi;
     /**
      * Internal HTTP client (exposed for advanced use cases)
      */
@@ -96,7 +102,8 @@ export 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
      *
@@ -126,6 +133,13 @@ export 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) {
@@ -140,6 +154,10 @@ export class JACK_SDK {
         if (config.yellow !== undefined) {
             this.yellow = new YellowProvider(config.yellow, config.yellow.walletClient);
         }
+        // Conditionally initialize LI.FI provider
+        if (config.lifi !== undefined) {
+            this.lifi = new LifiProvider(config.lifi);
+        }
     }
     /**
      * Convenience method: Submit a signed intent
@@ -265,5 +283,55 @@ export class JACK_SDK {
     getIntentTypedData(params) {
         return this.intents.getTypedData(params);
     }
+    /**
+     * 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**
+     */
+    async getLifiQuote(params) {
+        if (!this.lifi)
+            throw new Error('LI.FI not configured');
+        return this.lifi.fetchQuote(params);
+    }
+    /**
+     * 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**
+     */
+    async getLifiRoute(params) {
+        if (!this.lifi)
+            throw new Error('LI.FI not configured');
+        return this.lifi.fetchRoute(params);
+    }
 }
+// LI.FI integration
+export * from './lifi/index.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

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

package/dist/esm/lifi/chain-map.js

@@ -0,0 +1,35 @@
+/**
+ * ChainMap — pure mapping module for chain name → chain ID resolution.
+ *
+ * Lookups are case-insensitive via `name.toLowerCase()`.
+ */
+/** Default chain name → chain ID mappings. */
+const CHAIN_MAP = {
+    arbitrum: 42161,
+    optimism: 10,
+    base: 8453,
+    polygon: 137,
+};
+/**
+ * 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 function resolveChain(name) {
+    const chainId = CHAIN_MAP[name.toLowerCase()];
+    if (chainId !== undefined) {
+        return { ok: true, chainId };
+    }
+    return { ok: false, reason: `Unsupported chain: ${name}` };
+}
+/**
+ * Return a copy of the supported chain mappings.
+ *
+ * @returns A new `Record<string, number>` with all supported chain entries.
+ */
+export function getSupportedChains() {
+    return { ...CHAIN_MAP };
+}
+//# sourceMappingURL=chain-map.js.map

package/dist/esm/lifi/chain-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-map.js","sourceRoot":"","sources":["../../../src/lifi/chain-map.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,8CAA8C;AAC9C,MAAM,SAAS,GAA2B;IACxC,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,EAAE;IACZ,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,GAAG;CACb,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,IAAI,EAAE,EAAE,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,EAAE,GAAG,SAAS,EAAE,CAAC;AAC1B,CAAC"}

package/dist/esm/lifi/fallback.js

@@ -0,0 +1,128 @@
+/**
+ * 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 { resolveChain } from './chain-map.js';
+/**
+ * Static exchange rates used when the LI.FI SDK is unavailable.
+ * Keys are formatted as `TOKENA:TOKENB` (upper-case).
+ */
+export const FALLBACK_RATES = {
+    'USDC:WETH': 0.0004,
+    'USDC:ETH': 0.0004,
+    'ETH:USDC': 2500,
+    'WETH:USDC': 2500,
+    'ETH:WETH': 1,
+    'WETH:ETH': 1,
+};
+/**
+ * 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 function deterministicId(seed) {
+    let hash = 5381;
+    for (let i = 0; i < seed.length; i += 1) {
+        hash = (hash * 33) ^ seed.charCodeAt(i);
+    }
+    return `JK-LIFI-${(hash >>> 0).toString(36).toUpperCase()}`;
+}
+/**
+ * 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 function buildFallbackQuote(params, reason) {
+    const fromChainRes = resolveChain(params.sourceChain ?? '');
+    const toChainRes = resolveChain(params.destinationChain ?? '');
+    const fromChainId = fromChainRes.ok ? fromChainRes.chainId : 0;
+    const toChainId = toChainRes.ok ? toChainRes.chainId : 0;
+    const rateKey = `${params.tokenIn}:${params.tokenOut}`.toUpperCase();
+    const rate = FALLBACK_RATES[rateKey] ?? 1;
+    const amountInNum = Number(params.amountIn || '0');
+    const amountOut = Number.isFinite(amountInNum)
+        ? (amountInNum * rate).toFixed(6)
+        : params.amountIn;
+    const seed = `${params.sourceChain}-${params.destinationChain}-${params.tokenIn}-${params.tokenOut}-${params.amountIn}`;
+    return {
+        provider: 'fallback',
+        routeId: deterministicId(seed),
+        timestamp: Date.now(),
+        quote: {
+            amountIn: params.amountIn,
+            amountOut,
+            minAmountOut: params.minAmountOut,
+            fromChainId,
+            toChainId,
+            fromToken: params.tokenIn,
+            toToken: params.tokenOut,
+            estimatedGasUsd: '0',
+        },
+        fallback: reason,
+    };
+}
+/**
+ * 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 function buildFallbackRoute(params, reason) {
+    const fromChainRes = resolveChain(params.sourceChain ?? '');
+    const toChainRes = resolveChain(params.destinationChain ?? '');
+    const fromChainId = fromChainRes.ok ? fromChainRes.chainId : 0;
+    const toChainId = toChainRes.ok ? toChainRes.chainId : 0;
+    const seed = `${params.sourceChain}-${params.destinationChain}-${params.tokenIn}-${params.tokenOut}-${params.amountIn}`;
+    return {
+        provider: 'fallback',
+        routeId: deterministicId(seed),
+        timestamp: Date.now(),
+        route: {
+            fromChainId,
+            toChainId,
+            fromToken: params.tokenIn,
+            toToken: params.tokenOut,
+            steps: [],
+            tags: [],
+        },
+        fallback: reason,
+    };
+}
+/**
+ * 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 function buildFallbackStatus(txHash, reason) {
+    return {
+        provider: 'fallback',
+        timestamp: Date.now(),
+        status: {
+            state: txHash ? 'UNKNOWN' : 'NOT_AVAILABLE',
+            txHash,
+        },
+        fallback: reason,
+    };
+}
+//# sourceMappingURL=fallback.js.map

package/dist/esm/lifi/fallback.js.map

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

package/dist/esm/lifi/index.js

@@ -0,0 +1,19 @@
+/**
+ * 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
+ */
+// LifiProvider class and config
+export { LifiProvider } from './lifi-provider.js';
+// Chain resolution
+export { resolveChain, getSupportedChains } from './chain-map.js';
+// Token resolution
+export { resolveToken, getSupportedTokens } from './token-map.js';
+// Unit conversion utilities
+export { toBaseUnits, fromBaseUnits } from './utils.js';
+// Fallback provider
+export { buildFallbackQuote, buildFallbackRoute, buildFallbackStatus, deterministicId, FALLBACK_RATES, } from './fallback.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/lifi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lifi/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,gCAAgC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAalD,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGlE,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGlE,4BAA4B;AAC5B,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAExD,oBAAoB;AACpB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,cAAc,GACf,MAAM,eAAe,CAAC"}