@jack-kernel/sdk 1.1.0 → 1.2.1

package/dist/cjs/index.js

@@ -1,4 +1,18 @@
 "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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.JACK_SDK = exports.inferMapping = exports.mapStateIntent = exports.mapChannelStatus = exports.mapYellowEvent = exports.extractRevertReason = exports.mapErrorToReasonCode = exports.NitroliteClient = exports.YellowProvider = exports.JackClient = exports.AgentUtils = exports.CostTracker = exports.ExecutionTracker = exports.IntentManager = exports.validateIntentParams = exports.parseIntentParams = exports.serializeIntentParams = exports.getTypedData = exports.RetryError = exports.TimeoutError = exports.ValidationError = exports.APIError = exports.NetworkError = exports.JackError = exports.ExecutionStatus = void 0;
 // Re-export enums
@@ -57,6 +71,8 @@ const costs_js_2 = require("./costs.js");
 const agent_js_2 = require("./agent.js");
 // Import Yellow provider and config for SDK integration
 const yellow_provider_js_4 = require("./yellow/yellow-provider.js");
+// Import LI.FI provider and types
+const lifi_provider_js_1 = require("./lifi/lifi-provider.js");
 // Import types and enums for use in this file
 const types_js_2 = require("./types.js");
 /**
@@ -111,6 +127,10 @@ 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)
      */
@@ -123,7 +143,8 @@ 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
      *
@@ -153,6 +174,13 @@ 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) {
@@ -167,6 +195,10 @@ class JACK_SDK {
         if (config.yellow !== undefined) {
             this.yellow = new yellow_provider_js_4.YellowProvider(config.yellow, config.yellow.walletClient);
         }
+        // Conditionally initialize LI.FI provider
+        if (config.lifi !== undefined) {
+            this.lifi = new lifi_provider_js_1.LifiProvider(config.lifi);
+        }
     }
     /**
      * Convenience method: Submit a signed intent
@@ -292,6 +324,56 @@ 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);
+    }
 }
 exports.JACK_SDK = JACK_SDK;
+// LI.FI integration
+__exportStar(require("./lifi/index.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/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/cjs/lifi/chain-map.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * ChainMap — pure mapping module for chain name → chain ID resolution.
+ *
+ * Lookups are case-insensitive via `name.toLowerCase()`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveChain = resolveChain;
+exports.getSupportedChains = getSupportedChains;
+/** 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.
+ */
+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.
+ */
+function getSupportedChains() {
+    return { ...CHAIN_MAP };
+}
+//# sourceMappingURL=chain-map.js.map

package/dist/cjs/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;;AAqBH,oCAMC;AAOD,gDAEC;AA9BD,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,SAAgB,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,SAAgB,kBAAkB;IAChC,OAAO,EAAE,GAAG,SAAS,EAAE,CAAC;AAC1B,CAAC"}

package/dist/cjs/lifi/fallback.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FALLBACK_RATES = void 0;
+exports.deterministicId = deterministicId;
+exports.buildFallbackQuote = buildFallbackQuote;
+exports.buildFallbackRoute = buildFallbackRoute;
+exports.buildFallbackStatus = buildFallbackStatus;
+const chain_map_js_1 = require("./chain-map.js");
+/**
+ * Static exchange rates used when the LI.FI SDK is unavailable.
+ * Keys are formatted as `TOKENA:TOKENB` (upper-case).
+ */
+exports.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]+`
+ */
+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'`
+ */
+function buildFallbackQuote(params, reason) {
+    const fromChainRes = (0, chain_map_js_1.resolveChain)(params.sourceChain ?? '');
+    const toChainRes = (0, chain_map_js_1.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 = exports.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'`
+ */
+function buildFallbackRoute(params, reason) {
+    const fromChainRes = (0, chain_map_js_1.resolveChain)(params.sourceChain ?? '');
+    const toChainRes = (0, chain_map_js_1.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'`
+ */
+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/cjs/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/cjs/lifi/index.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FALLBACK_RATES = exports.deterministicId = exports.buildFallbackStatus = exports.buildFallbackRoute = exports.buildFallbackQuote = exports.fromBaseUnits = exports.toBaseUnits = exports.getSupportedTokens = exports.resolveToken = exports.getSupportedChains = exports.resolveChain = exports.LifiProvider = void 0;
+// LifiProvider class and config
+var lifi_provider_js_1 = require("./lifi-provider.js");
+Object.defineProperty(exports, "LifiProvider", { enumerable: true, get: function () { return lifi_provider_js_1.LifiProvider; } });
+// Chain resolution
+var chain_map_js_1 = require("./chain-map.js");
+Object.defineProperty(exports, "resolveChain", { enumerable: true, get: function () { return chain_map_js_1.resolveChain; } });
+Object.defineProperty(exports, "getSupportedChains", { enumerable: true, get: function () { return chain_map_js_1.getSupportedChains; } });
+// Token resolution
+var token_map_js_1 = require("./token-map.js");
+Object.defineProperty(exports, "resolveToken", { enumerable: true, get: function () { return token_map_js_1.resolveToken; } });
+Object.defineProperty(exports, "getSupportedTokens", { enumerable: true, get: function () { return token_map_js_1.getSupportedTokens; } });
+// Unit conversion utilities
+var utils_js_1 = require("./utils.js");
+Object.defineProperty(exports, "toBaseUnits", { enumerable: true, get: function () { return utils_js_1.toBaseUnits; } });
+Object.defineProperty(exports, "fromBaseUnits", { enumerable: true, get: function () { return utils_js_1.fromBaseUnits; } });
+// Fallback provider
+var fallback_js_1 = require("./fallback.js");
+Object.defineProperty(exports, "buildFallbackQuote", { enumerable: true, get: function () { return fallback_js_1.buildFallbackQuote; } });
+Object.defineProperty(exports, "buildFallbackRoute", { enumerable: true, get: function () { return fallback_js_1.buildFallbackRoute; } });
+Object.defineProperty(exports, "buildFallbackStatus", { enumerable: true, get: function () { return fallback_js_1.buildFallbackStatus; } });
+Object.defineProperty(exports, "deterministicId", { enumerable: true, get: function () { return fallback_js_1.deterministicId; } });
+Object.defineProperty(exports, "FALLBACK_RATES", { enumerable: true, get: function () { return fallback_js_1.FALLBACK_RATES; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/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,uDAAkD;AAAzC,gHAAA,YAAY,OAAA;AAarB,mBAAmB;AACnB,+CAAkE;AAAzD,4GAAA,YAAY,OAAA;AAAE,kHAAA,kBAAkB,OAAA;AAGzC,mBAAmB;AACnB,+CAAkE;AAAzD,4GAAA,YAAY,OAAA;AAAE,kHAAA,kBAAkB,OAAA;AAGzC,4BAA4B;AAC5B,uCAAwD;AAA/C,uGAAA,WAAW,OAAA;AAAE,yGAAA,aAAa,OAAA;AAEnC,oBAAoB;AACpB,6CAMuB;AALrB,iHAAA,kBAAkB,OAAA;AAClB,iHAAA,kBAAkB,OAAA;AAClB,kHAAA,mBAAmB,OAAA;AACnB,8GAAA,eAAe,OAAA;AACf,6GAAA,cAAc,OAAA"}