@jack-kernel/sdk 1.0.0 → 1.2.1

package/dist/esm/yellow/channel-state-manager.js

@@ -0,0 +1,163 @@
+/**
+ * Channel State Manager for Yellow Network Integration
+ *
+ * Tracks local channel state and provides on-chain query capabilities.
+ * Maintains a local cache of channel states from ClearNode messages and
+ * falls back to on-chain queries via viem PublicClient when the WebSocket
+ * is disconnected.
+ *
+ * Requirements: 7.1, 7.2, 7.3, 7.4
+ */
+// ============================================================================
+// Custody Contract ABI (minimal)
+// ============================================================================
+/**
+ * Minimal ABI for the custody contract's balance query function.
+ *
+ * The custody contract exposes a `getChannelBalances` function that returns
+ * the token balances held in a specific channel for the given token addresses.
+ *
+ * Function signature: getChannelBalances(bytes32 channelId, address[] tokens) → uint256[]
+ */
+const CUSTODY_BALANCE_ABI = [
+    {
+        name: 'getChannelBalances',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'channelId', type: 'bytes32' },
+            { name: 'tokens', type: 'address[]' },
+        ],
+        outputs: [{ name: 'balances', type: 'uint256[]' }],
+    },
+];
+// ============================================================================
+// ChannelStateManager
+// ============================================================================
+/**
+ * Manages local channel state cache and provides on-chain query capabilities.
+ *
+ * The ChannelStateManager serves two purposes:
+ * 1. Maintains a local cache of channel states received from ClearNode messages,
+ *    enabling fast lookups without network calls.
+ * 2. Provides on-chain balance queries via viem PublicClient for when the
+ *    WebSocket connection is unavailable (Requirement 7.4) or when authoritative
+ *    on-chain data is needed (Requirement 7.2).
+ *
+ * Requirements: 7.1, 7.2, 7.3, 7.4
+ */
+export class ChannelStateManager {
+    publicClient;
+    custodyAddress;
+    channels;
+    /**
+     * @param publicClient - viem PublicClient for on-chain balance queries
+     * @param custodyAddress - Address of the custody contract holding channel collateral
+     */
+    constructor(publicClient, custodyAddress) {
+        this.publicClient = publicClient;
+        this.custodyAddress = custodyAddress;
+        this.channels = new Map();
+    }
+    /**
+     * Update the local cache with a channel state from a ClearNode response.
+     *
+     * This is called when the YellowProvider receives channel state updates
+     * from ClearNode messages (create, resize, close, or get_ledger_balances).
+     *
+     * Requirement 7.1: Maintain local channel state from ClearNode responses.
+     *
+     * @param channelId - The channel identifier
+     * @param state - The channel state to cache
+     */
+    updateChannel(channelId, state) {
+        this.channels.set(channelId, state);
+    }
+    /**
+     * Get a locally cached channel state by channel ID.
+     *
+     * Returns undefined if the channel is not in the local cache.
+     * For authoritative on-chain data, use queryOnChainBalances instead.
+     *
+     * Requirement 7.2: Query specific channel status by channel ID.
+     *
+     * @param channelId - The channel identifier
+     * @returns The cached channel state, or undefined if not found
+     */
+    getChannel(channelId) {
+        return this.channels.get(channelId);
+    }
+    /**
+     * Get all locally cached channel states.
+     *
+     * Returns a snapshot array of all channels currently in the cache.
+     * The returned array is a copy; modifications do not affect the cache.
+     *
+     * Requirement 7.1: Return list of channels with their statuses and allocations.
+     *
+     * @returns Array of all cached channel states
+     */
+    getAllChannels() {
+        return Array.from(this.channels.values());
+    }
+    /**
+     * Query on-chain channel balances from the custody contract.
+     *
+     * Uses viem PublicClient.readContract to call the custody contract's
+     * getChannelBalances function. This provides authoritative on-chain data
+     * and is used as a fallback when the ClearNode WebSocket is disconnected.
+     *
+     * Requirement 7.2: Query on-chain custody contract for channel balances.
+     * Requirement 7.4: Fall back to on-chain queries when WebSocket is disconnected.
+     *
+     * @param channelId - The channel identifier (bytes32 hex string)
+     * @param tokens - Array of token addresses to query balances for
+     * @returns Array of token balances as bigint values, one per token
+     * @throws Error if the on-chain query fails
+     */
+    async queryOnChainBalances(channelId, tokens) {
+        try {
+            const balances = await this.publicClient.readContract({
+                address: this.custodyAddress,
+                abi: CUSTODY_BALANCE_ABI,
+                functionName: 'getChannelBalances',
+                args: [channelId, tokens],
+            });
+            return [...balances];
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to query on-chain balances for channel ${channelId}: ${message}`);
+        }
+    }
+    /**
+     * Find an open (ACTIVE) channel for a given token address.
+     *
+     * Searches the local cache for a channel with status 'ACTIVE' that
+     * matches the specified token address. Returns the first match found.
+     *
+     * This is used by the YellowProvider to reuse existing channels
+     * when executing intents, avoiding unnecessary channel creation.
+     *
+     * @param token - The token address to find an open channel for
+     * @returns The first matching ACTIVE channel, or undefined if none found
+     */
+    findOpenChannel(token) {
+        for (const channel of this.channels.values()) {
+            if (channel.status === 'ACTIVE' && channel.token === token) {
+                return channel;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Clear all cached channel states.
+     *
+     * This is typically called when the provider disconnects or when
+     * a full state refresh is needed.
+     */
+    clear() {
+        this.channels.clear();
+    }
+}
+//# sourceMappingURL=channel-state-manager.js.map

package/dist/esm/yellow/channel-state-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-state-manager.js","sourceRoot":"","sources":["../../../src/yellow/channel-state-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,+EAA+E;AAC/E,iCAAiC;AACjC,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,mBAAmB,GAAG;IAC1B;QACE,IAAI,EAAE,oBAAoB;QAC1B,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;YACtC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE;SACtC;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;KACnD;CACO,CAAC;AAEX,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,mBAAmB;IACb,YAAY,CAAe;IAC3B,cAAc,CAAgB;IAC9B,QAAQ,CAA4B;IAErD;;;OAGG;IACH,YAAY,YAA0B,EAAE,cAA6B;QACnE,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;IAClD,CAAC;IAED;;;;;;;;;;OAUG;IACH,aAAa,CAAC,SAAiB,EAAE,KAAmB;QAClD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;;;OAUG;IACH,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;;OASG;IACH,cAAc;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,oBAAoB,CAAC,SAAiB,EAAE,MAAgB;QAC5D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC;gBACpD,OAAO,EAAE,IAAI,CAAC,cAAc;gBAC5B,GAAG,EAAE,mBAAmB;gBACxB,YAAY,EAAE,oBAAoB;gBAClC,IAAI,EAAE,CAAC,SAA0B,EAAE,MAAyB,CAAC;aAC9D,CAAC,CAAC;YAEH,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,iDAAiD,SAAS,KAAK,OAAO,EAAE,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,KAAa;QAC3B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC3D,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/esm/yellow/clear-node-connection.js

@@ -0,0 +1,385 @@
+/**
+ * ClearNode WebSocket Connection Manager
+ *
+ * Manages the WebSocket connection to Yellow Network's ClearNode relay server
+ * with reconnection logic, request-response correlation, and event emission.
+ *
+ * Key features:
+ * - Exponential backoff reconnection: delay = initialDelay * 2^(attempt-1)
+ * - Request-response correlation using method name matching
+ * - EventEmitter pattern for connected/disconnected events
+ * - Cleanup of all pending handlers on disconnect
+ *
+ * Requirements: 10.1, 10.2, 10.3, 10.4, 10.5
+ */
+import { EventEmitter } from 'events';
+/** WebSocket readyState constants */
+const WS_OPEN = 1;
+const WS_CONNECTING = 0;
+/**
+ * Calculate the exponential backoff delay for a given reconnection attempt.
+ *
+ * Formula: delay = initialDelay * 2^(attempt - 1)
+ *
+ * This is exported as a pure function so it can be independently tested
+ * (including via property-based tests).
+ *
+ * @param initialDelay - The base delay in milliseconds
+ * @param attempt - The attempt number (1-based)
+ * @returns The delay in milliseconds before the given attempt
+ */
+export function calculateBackoffDelay(initialDelay, attempt) {
+    if (attempt < 1) {
+        return initialDelay;
+    }
+    return initialDelay * Math.pow(2, attempt - 1);
+}
+/**
+ * Manages a WebSocket connection to Yellow Network's ClearNode.
+ *
+ * Provides:
+ * - connect/disconnect lifecycle management
+ * - send (fire-and-forget) and sendAndWait (request-response correlation)
+ * - Automatic reconnection with exponential backoff
+ * - Event emission for 'connected' and 'disconnected' events
+ * - Cleanup of pending handlers on disconnect
+ *
+ * Requirements: 10.1, 10.2, 10.3, 10.4, 10.5
+ */
+export class ClearNodeConnection {
+    url;
+    maxReconnectAttempts;
+    reconnectDelay;
+    messageTimeout;
+    wsFactory;
+    ws = null;
+    emitter = new EventEmitter();
+    pendingRequests = [];
+    messageHandlers = [];
+    _isConnected = false;
+    _isDisposed = false;
+    reconnectAttempt = 0;
+    reconnectTimer = null;
+    /**
+     * @param url - The ClearNode WebSocket URL
+     * @param options - Connection configuration options
+     * @param wsFactory - Optional WebSocket factory for testing. Defaults to global WebSocket.
+     */
+    constructor(url, options, wsFactory) {
+        this.url = url;
+        this.maxReconnectAttempts = options?.maxReconnectAttempts ?? 5;
+        this.reconnectDelay = options?.reconnectDelay ?? 1000;
+        this.messageTimeout = options?.messageTimeout ?? 30000;
+        this.wsFactory = wsFactory ?? ((wsUrl) => new WebSocket(wsUrl));
+    }
+    /**
+     * Establish a WebSocket connection to ClearNode.
+     *
+     * Resolves when the connection is open and ready.
+     * Rejects if the connection fails to establish.
+     *
+     * Requirement 10.1: Emit a connected event on successful connection.
+     */
+    async connect() {
+        if (this._isDisposed) {
+            throw new Error('ClearNodeConnection has been disposed');
+        }
+        if (this._isConnected && this.ws) {
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            try {
+                this.ws = this.wsFactory(this.url);
+            }
+            catch (err) {
+                reject(new Error(`Failed to create WebSocket: ${err instanceof Error ? err.message : String(err)}`));
+                return;
+            }
+            this.ws.onopen = () => {
+                if (settled)
+                    return;
+                settled = true;
+                this._isConnected = true;
+                this.reconnectAttempt = 0;
+                this.emitter.emit('connected');
+                resolve();
+            };
+            this.ws.onerror = (event) => {
+                if (settled)
+                    return;
+                settled = true;
+                const errorMessage = event && typeof event === 'object' && 'message' in event
+                    ? String(event.message)
+                    : 'WebSocket connection failed';
+                reject(new Error(errorMessage));
+            };
+            this.ws.onclose = () => {
+                if (!settled) {
+                    settled = true;
+                    reject(new Error('WebSocket closed before connection was established'));
+                    return;
+                }
+                this.handleDisconnect();
+            };
+            this.ws.onmessage = (event) => {
+                this.handleMessage(event.data);
+            };
+        });
+    }
+    /**
+     * Close the WebSocket connection and clean up all resources.
+     *
+     * Requirement 10.4: Clean up all pending message handlers on disconnect.
+     */
+    async disconnect() {
+        this._isDisposed = true;
+        this.cancelReconnect();
+        this.cleanupPendingRequests(new Error('Connection closed by client'));
+        this.messageHandlers = [];
+        if (this.ws) {
+            const ws = this.ws;
+            this.ws = null;
+            this._isConnected = false;
+            // Remove handlers to prevent reconnection attempts
+            ws.onopen = null;
+            ws.onclose = null;
+            ws.onerror = null;
+            ws.onmessage = null;
+            // Only close if not already closed/closing
+            if (ws.readyState === WS_OPEN || ws.readyState === WS_CONNECTING) {
+                ws.close();
+            }
+            this.emitter.emit('disconnected');
+        }
+        this._isConnected = false;
+    }
+    /**
+     * Send a message and wait for a correlated response.
+     *
+     * The response is matched by method name: when a message is received
+     * that contains a matching method field, the promise resolves with that response.
+     *
+     * Requirement 10.5: Request-response correlation using method name matching.
+     *
+     * @param message - The message string to send
+     * @param method - The method name to correlate the response with
+     * @param timeout - Optional timeout in ms (defaults to messageTimeout)
+     * @returns The parsed response data
+     * @throws Error if the connection is not open, the request times out, or the connection drops
+     */
+    async sendAndWait(message, method, timeout) {
+        if (!this._isConnected || !this.ws || this.ws.readyState !== WS_OPEN) {
+            throw new Error('WebSocket is not connected');
+        }
+        const effectiveTimeout = timeout ?? this.messageTimeout;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.removePendingRequest(pending);
+                reject(new Error(`Request timed out waiting for response to method: ${method}`));
+            }, effectiveTimeout);
+            const pending = {
+                method,
+                resolve: resolve,
+                reject,
+                timer,
+            };
+            this.pendingRequests.push(pending);
+            this.ws.send(message);
+        });
+    }
+    /**
+     * Send a message without waiting for a response (fire-and-forget).
+     *
+     * @param message - The message string to send
+     * @throws Error if the connection is not open
+     */
+    send(message) {
+        if (!this._isConnected || !this.ws || this.ws.readyState !== WS_OPEN) {
+            throw new Error('WebSocket is not connected');
+        }
+        this.ws.send(message);
+    }
+    /**
+     * Register a handler for incoming messages.
+     *
+     * Handlers receive the parsed message data for all incoming messages
+     * (including those that match pending requests).
+     *
+     * @param handler - Callback invoked with the parsed message data
+     */
+    onMessage(handler) {
+        this.messageHandlers.push(handler);
+    }
+    /**
+     * Whether the WebSocket connection is currently open and ready.
+     */
+    get isConnected() {
+        return this._isConnected;
+    }
+    /**
+     * Register an event listener for connection lifecycle events.
+     *
+     * Supported events: 'connected', 'disconnected'
+     */
+    on(event, handler) {
+        this.emitter.on(event, handler);
+    }
+    /**
+     * Remove an event listener.
+     */
+    off(event, handler) {
+        this.emitter.off(event, handler);
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    /**
+     * Handle an incoming WebSocket message.
+     *
+     * Parses the message as JSON and checks for method-based correlation
+     * with pending requests. Also dispatches to all registered message handlers.
+     */
+    handleMessage(rawData) {
+        let data;
+        try {
+            const text = typeof rawData === 'string' ? rawData : String(rawData);
+            data = JSON.parse(text);
+        }
+        catch {
+            // If the message is not valid JSON, pass the raw data
+            data = rawData;
+        }
+        // Dispatch to all registered message handlers
+        for (const handler of this.messageHandlers) {
+            try {
+                handler(data);
+            }
+            catch {
+                // Swallow handler errors to prevent one handler from breaking others
+            }
+        }
+        // Check for method-based correlation with pending requests
+        if (data && typeof data === 'object') {
+            const messageObj = data;
+            const responseMethod = this.extractMethod(messageObj);
+            if (responseMethod) {
+                const matchIndex = this.pendingRequests.findIndex((req) => req.method === responseMethod);
+                if (matchIndex !== -1) {
+                    const pending = this.pendingRequests[matchIndex];
+                    this.pendingRequests.splice(matchIndex, 1);
+                    clearTimeout(pending.timer);
+                    pending.resolve(data);
+                }
+            }
+        }
+    }
+    /**
+     * Extract the method name from a parsed message object.
+     *
+     * Supports common message formats:
+     * - { method: "..." }
+     * - { type: "..." }
+     * - Nested: { response: { method: "..." } }
+     */
+    extractMethod(obj) {
+        // Direct method field
+        if (typeof obj.method === 'string') {
+            return obj.method;
+        }
+        // Type field as fallback
+        if (typeof obj.type === 'string') {
+            return obj.type;
+        }
+        // Nested response object
+        if (obj.response && typeof obj.response === 'object') {
+            const response = obj.response;
+            if (typeof response.method === 'string') {
+                return response.method;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Handle an unexpected WebSocket disconnection.
+     *
+     * Cleans up state and initiates reconnection with exponential backoff.
+     *
+     * Requirement 10.2: Exponential backoff reconnection.
+     * Requirement 10.3: Emit disconnected and mark unavailable when retries exhausted.
+     */
+    handleDisconnect() {
+        const wasConnected = this._isConnected;
+        this._isConnected = false;
+        this.ws = null;
+        // If disposed, don't attempt reconnection
+        if (this._isDisposed) {
+            return;
+        }
+        // Attempt reconnection
+        if (wasConnected) {
+            this.attemptReconnect();
+        }
+    }
+    /**
+     * Attempt to reconnect with exponential backoff.
+     *
+     * Requirement 10.2: delay = initialDelay * 2^(attempt-1)
+     * Requirement 10.3: Mark provider unavailable when all retries exhausted.
+     */
+    attemptReconnect() {
+        this.reconnectAttempt++;
+        if (this.reconnectAttempt > this.maxReconnectAttempts) {
+            // All retries exhausted
+            this.cleanupPendingRequests(new Error('All reconnection attempts exhausted'));
+            this.emitter.emit('disconnected');
+            return;
+        }
+        const delay = calculateBackoffDelay(this.reconnectDelay, this.reconnectAttempt);
+        this.reconnectTimer = setTimeout(async () => {
+            this.reconnectTimer = null;
+            if (this._isDisposed) {
+                return;
+            }
+            try {
+                await this.connect();
+            }
+            catch {
+                // Connection failed, try again
+                this.attemptReconnect();
+            }
+        }, delay);
+    }
+    /**
+     * Cancel any pending reconnection timer.
+     */
+    cancelReconnect() {
+        if (this.reconnectTimer !== null) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+    }
+    /**
+     * Reject all pending requests with the given error and clean up timers.
+     *
+     * Requirement 10.4: Clean up all pending message handlers on disconnect.
+     */
+    cleanupPendingRequests(error) {
+        const pending = [...this.pendingRequests];
+        this.pendingRequests = [];
+        for (const req of pending) {
+            clearTimeout(req.timer);
+            req.reject(error);
+        }
+    }
+    /**
+     * Remove a specific pending request from the list.
+     */
+    removePendingRequest(request) {
+        const index = this.pendingRequests.indexOf(request);
+        if (index !== -1) {
+            this.pendingRequests.splice(index, 1);
+        }
+    }
+}
+//# sourceMappingURL=clear-node-connection.js.map

package/dist/esm/yellow/clear-node-connection.js.map

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