@gvnrdao/dh-lit-actions 0.0.3 → 0.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gvnrdao/dh-lit-actions",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Diamond Hands Protocol LIT Actions - Deterministic, Auditable Builds",
   "main": "pkg-dist/index.js",
   "types": "pkg-dist/index.d.ts",
@@ -27,8 +27,8 @@
     "test:coverage": "jest --coverage"
   },
   "dependencies": {
-    "@lit-protocol/contracts-sdk": "^7.3.0",
-    "@lit-protocol/lit-node-client": "^7.3.0",
+    "@lit-protocol/contracts-sdk": "^7.3.1",
+    "@lit-protocol/lit-node-client": "^7.3.1",
     "axios": "1.7.7",
     "bs58": "^6.0.0",
     "dotenv": "16.4.7",

package/pkg-dist/utils/chunks/connection-helpers.d.ts

@@ -0,0 +1,99 @@
+/**
+ * LIT Protocol Connection Helpers
+ * Provides retry logic, error handling, and connection validation utilities
+ * for robust LIT Protocol operations
+ */
+/**
+ * Retry configuration options
+ */
+export interface RetryConfig {
+    maxAttempts: number;
+    initialDelayMs: number;
+    maxDelayMs: number;
+    backoffMultiplier: number;
+    retryableErrors: string[];
+}
+/**
+ * Default retry configuration optimized for LIT Protocol operations
+ */
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+/**
+ * Connection validation result
+ */
+export interface ConnectionValidationResult {
+    isValid: boolean;
+    error?: string;
+    latencyMs?: number;
+}
+/**
+ * Sleep utility for retry delays
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Check if an error is retryable using enhanced classification system
+ */
+export declare function isRetryableError(error: any, retryableErrors?: string[]): boolean;
+/**
+ * Calculate exponential backoff delay with jitter
+ */
+export declare function calculateDelay(attempt: number, config: RetryConfig): number;
+/**
+ * Enhanced retry wrapper with intelligent error classification
+ */
+export declare function withRetry<T>(operation: () => Promise<T>, config?: Partial<RetryConfig>, operationName?: string): Promise<T>;
+/**
+ * Enhanced LIT Node Client connector with retry logic and readiness validation
+ */
+export declare function connectLitNodeClient(litNodeClient: any, config?: Partial<RetryConfig>): Promise<void>;
+/**
+ * Enhanced LIT Contracts connector with retry logic
+ */
+export declare function connectLitContracts(litContracts: any, config?: Partial<RetryConfig>): Promise<void>;
+/**
+ * Validate LIT Node Client connection health
+ */
+export declare function validateLitNodeConnection(litNodeClient: any): Promise<ConnectionValidationResult>;
+/**
+ * Enhanced session signature generator with retry logic and caching
+ */
+export declare function generateSessionSignatures(litNodeClient: any, sessionConfig: any, config?: Partial<RetryConfig>, pkpTokenId?: string, litActionCid?: string, signerAddress?: string, network?: string): Promise<any>;
+/**
+ * Validate LIT Node Client readiness before operations
+ */
+export declare function validateLitNodeReadiness(litNodeClient: any): Promise<void>;
+/**
+ * Enhanced LIT Action executor with retry logic and readiness validation
+ */
+export declare function executeLitAction(litNodeClient: any, executionConfig: any, config?: Partial<RetryConfig>): Promise<any>;
+/**
+ * PKP operation wrapper with enhanced error handling
+ */
+export declare function executePkpOperation<T>(operation: () => Promise<T>, operationName: string, config?: Partial<RetryConfig>): Promise<T>;
+/**
+ * Network-specific timeout configurations
+ */
+export declare const NETWORK_TIMEOUTS: {
+    readonly datil: {
+        readonly connection: 60000;
+        readonly operation: 120000;
+        readonly pkpValidation: 180000;
+    };
+    readonly 'datil-test': {
+        readonly connection: 30000;
+        readonly operation: 60000;
+        readonly pkpValidation: 90000;
+    };
+};
+/**
+ * Get network-specific timeout configuration
+ */
+export declare function getNetworkTimeouts(network: string): {
+    readonly connection: 60000;
+    readonly operation: 120000;
+    readonly pkpValidation: 180000;
+} | {
+    readonly connection: 30000;
+    readonly operation: 60000;
+    readonly pkpValidation: 90000;
+};
+//# sourceMappingURL=connection-helpers.d.ts.map

package/pkg-dist/utils/chunks/connection-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-helpers.d.ts","sourceRoot":"","sources":["../../../pkg-src/utils/chunks/connection-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyBH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WA2BlC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,eAAe,GAAE,MAAM,EAAyC,GAAG,OAAO,CAmBtH;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAS3E;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,EACjC,aAAa,GAAE,MAAoB,GAClC,OAAO,CAAC,CAAC,CAAC,CA8EZ;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,GAAG,EAClB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAChC,OAAO,CAAC,IAAI,CAAC,CAmCf;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,GAAG,EACjB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAChC,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,aAAa,EAAE,GAAG,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAmBvG;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,aAAa,EAAE,GAAG,EAClB,aAAa,EAAE,GAAG,EAClB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,EACjC,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,GAAE,MAAgB,GACxB,OAAO,CAAC,GAAG,CAAC,CAgCd;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,aAAa,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,GAAG,EAClB,eAAe,EAAE,GAAG,EACpB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAChC,OAAO,CAAC,GAAG,CAAC,CA4Bd;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAChC,OAAO,CAAC,CAAC,CAAC,CAcZ;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;CAWnB,CAAC;AAEX;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM;;;;;;;;EAEjD"}

package/pkg-dist/utils/chunks/connection-helpers.js

@@ -0,0 +1,362 @@
+"use strict";
+/**
+ * LIT Protocol Connection Helpers
+ * Provides retry logic, error handling, and connection validation utilities
+ * for robust LIT Protocol operations
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NETWORK_TIMEOUTS = exports.DEFAULT_RETRY_CONFIG = void 0;
+exports.sleep = sleep;
+exports.isRetryableError = isRetryableError;
+exports.calculateDelay = calculateDelay;
+exports.withRetry = withRetry;
+exports.connectLitNodeClient = connectLitNodeClient;
+exports.connectLitContracts = connectLitContracts;
+exports.validateLitNodeConnection = validateLitNodeConnection;
+exports.generateSessionSignatures = generateSessionSignatures;
+exports.validateLitNodeReadiness = validateLitNodeReadiness;
+exports.executeLitAction = executeLitAction;
+exports.executePkpOperation = executePkpOperation;
+exports.getNetworkTimeouts = getNetworkTimeouts;
+const debug_logger_1 = require("./debug-logger");
+const error_classification_1 = require("./error-classification");
+/**
+ * Default retry configuration optimized for LIT Protocol operations
+ */
+exports.DEFAULT_RETRY_CONFIG = {
+    maxAttempts: 5, // Increased from 3 for PKP operations
+    initialDelayMs: 2000, // Increased from 1000ms for PKP operations
+    maxDelayMs: 60000, // Increased from 30000ms for PKP operations
+    backoffMultiplier: 2,
+    retryableErrors: [
+        'request_timeout',
+        'network error',
+        'connection failed',
+        'ENOTFOUND',
+        'ECONNREFUSED',
+        'ETIMEDOUT',
+        'socket hang up',
+        'timeout',
+        // PKP-specific errors
+        'signing shares',
+        'There was an error getting the signing shares',
+        'PKP validation',
+        'pkp validation failed',
+        'resource validation',
+        'ipfs propagation',
+        'session.*expired',
+        'NodeError',
+        'Response from the nodes',
+        'consensus',
+        'threshold'
+    ]
+};
+/**
+ * Sleep utility for retry delays
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Check if an error is retryable using enhanced classification system
+ */
+function isRetryableError(error, retryableErrors = exports.DEFAULT_RETRY_CONFIG.retryableErrors) {
+    if (!error)
+        return false;
+    // Use enhanced error classification for LIT Protocol specific errors
+    const classification = (0, error_classification_1.classifyError)(error);
+    // If classification determined retryability, use that
+    if (classification.isRetryable !== undefined) {
+        (0, debug_logger_1.debugInfo)('ERROR_CLASSIFICATION', `Error classified as: ${classification.category} (retryable: ${classification.isRetryable})`);
+        return classification.isRetryable;
+    }
+    // Fallback to legacy pattern matching
+    const errorMessage = error.message || error.toString() || '';
+    const errorLower = errorMessage.toLowerCase();
+    return retryableErrors.some(pattern => errorLower.includes(pattern.toLowerCase()));
+}
+/**
+ * Calculate exponential backoff delay with jitter
+ */
+function calculateDelay(attempt, config) {
+    const exponentialDelay = Math.min(config.initialDelayMs * Math.pow(config.backoffMultiplier, attempt - 1), config.maxDelayMs);
+    // Add jitter (±25%) to avoid thundering herd
+    const jitter = exponentialDelay * 0.25 * (Math.random() - 0.5);
+    return Math.max(100, exponentialDelay + jitter);
+}
+/**
+ * Enhanced retry wrapper with intelligent error classification
+ */
+async function withRetry(operation, config = {}, operationName = 'operation') {
+    let finalConfig = { ...exports.DEFAULT_RETRY_CONFIG, ...config };
+    const tracker = new debug_logger_1.PerformanceTracker(`Retry ${operationName}`);
+    let lastError;
+    let errorClassification = null;
+    for (let attempt = 1; attempt <= finalConfig.maxAttempts; attempt++) {
+        try {
+            (0, debug_logger_1.debugInfo)('RETRY', `🔄 [${operationName}] Attempt ${attempt}/${finalConfig.maxAttempts}`);
+            const startTime = Date.now();
+            const result = await operation();
+            const duration = Date.now() - startTime;
+            (0, debug_logger_1.debugInfo)('RETRY', `✅ [${operationName}] Success after ${duration}ms (attempt ${attempt})`);
+            debug_logger_1.networkMetrics.recordRequest(operationName, true, duration);
+            tracker.end(true);
+            return result;
+        }
+        catch (error) {
+            lastError = error;
+            const errorMessage = error?.message || error?.toString() || 'Unknown error';
+            // Classify error and potentially adjust retry strategy
+            errorClassification = (0, error_classification_1.classifyError)(error);
+            // Update config with intelligent retry settings if this is the first error
+            if (attempt === 1 && errorClassification) {
+                const intelligentConfig = (0, error_classification_1.getRetryConfigFromClassification)(errorClassification);
+                finalConfig = {
+                    ...finalConfig,
+                    ...intelligentConfig,
+                    maxAttempts: Math.min(finalConfig.maxAttempts, intelligentConfig.maxAttempts)
+                };
+                (0, debug_logger_1.debugInfo)('RETRY', `🧠 Intelligent retry strategy applied: ${errorClassification.category} (${errorClassification.retryStrategy})`);
+                (0, debug_logger_1.debugInfo)('RETRY', `📊 Adjusted config: max=${finalConfig.maxAttempts}, delay=${finalConfig.initialDelayMs}ms`);
+            }
+            (0, debug_logger_1.debugWarn)('RETRY', `⚠️ [${operationName}] Attempt ${attempt} failed:`, {
+                error: errorMessage,
+                attempt,
+                category: errorClassification.category,
+                retryable: errorClassification.isRetryable
+            });
+            debug_logger_1.networkMetrics.recordRequest(operationName, false, 0, errorMessage);
+            // Check if we've exceeded the (possibly adjusted) max attempts
+            if (attempt >= finalConfig.maxAttempts) {
+                (0, debug_logger_1.debugError)('RETRY', `❌ [${operationName}] All attempts failed. Last error:`, { error: errorMessage });
+                // Generate detailed error report
+                if (errorClassification) {
+                    const errorReport = (0, error_classification_1.createErrorReport)(error);
+                    (0, debug_logger_1.debugError)('RETRY', `📋 Error Analysis Report:\n${errorReport}`);
+                }
+                tracker.end(false);
+                break;
+            }
+            if (!errorClassification.isRetryable) {
+                (0, debug_logger_1.debugError)('RETRY', `🚫 [${operationName}] Non-retryable error (${errorClassification.category}):`, { error: errorMessage });
+                // Show troubleshooting tips for non-retryable errors
+                if (errorClassification.troubleshooting) {
+                    (0, debug_logger_1.debugInfo)('RETRY', `💡 Troubleshooting suggestions:\n   ${errorClassification.troubleshooting.join('\n   ')}`);
+                }
+                tracker.end(false);
+                break;
+            }
+            const delayMs = calculateDelay(attempt, finalConfig);
+            (0, debug_logger_1.debugInfo)('RETRY', `⏳ [${operationName}] Waiting ${delayMs}ms before retry... (${errorClassification.retryStrategy} strategy)`);
+            await sleep(delayMs);
+        }
+    }
+    throw lastError;
+}
+/**
+ * Enhanced LIT Node Client connector with retry logic and readiness validation
+ */
+async function connectLitNodeClient(litNodeClient, config = {}) {
+    const network = litNodeClient?.config?.litNetwork || 'unknown';
+    return withRetry(async () => {
+        if (!litNodeClient) {
+            throw new Error('LIT Node Client is null or undefined');
+        }
+        const startTime = Date.now();
+        (0, debug_logger_1.logConnectionAttempt)(network, 1, config.maxAttempts || exports.DEFAULT_RETRY_CONFIG.maxAttempts);
+        // First connect to the network
+        await litNodeClient.connect();
+        // Wait for client to be ready
+        (0, debug_logger_1.debugInfo)('CONNECTION', `⏳ Waiting for LIT Node Client to be ready...`);
+        const readyTimeout = 30000; // 30 seconds timeout for readiness
+        const readyStartTime = Date.now();
+        while (!litNodeClient.ready && (Date.now() - readyStartTime) < readyTimeout) {
+            await sleep(500); // Check every 500ms
+        }
+        if (!litNodeClient.ready) {
+            throw new Error(`LIT Node Client failed to become ready within ${readyTimeout}ms`);
+        }
+        const latency = Date.now() - startTime;
+        (0, debug_logger_1.debugInfo)('CONNECTION', `✅ LIT Node Client is ready (${litNodeClient.ready})`);
+        (0, debug_logger_1.logConnectionSuccess)(network, latency);
+    }, config, 'LIT Node Client Connection');
+}
+/**
+ * Enhanced LIT Contracts connector with retry logic
+ */
+async function connectLitContracts(litContracts, config = {}) {
+    return withRetry(async () => {
+        if (!litContracts) {
+            throw new Error('LIT Contracts is null or undefined');
+        }
+        console.log(`🔗 Connecting to LIT Contracts: ${litContracts.network || 'unknown'}`);
+        await litContracts.connect();
+        console.log('✅ LIT Contracts connected successfully');
+    }, config, 'LIT Contracts Connection');
+}
+/**
+ * Validate LIT Node Client connection health
+ */
+async function validateLitNodeConnection(litNodeClient) {
+    try {
+        const startTime = Date.now();
+        if (!litNodeClient) {
+            return { isValid: false, error: 'LIT Node Client is null or undefined' };
+        }
+        // Try to get the latest block hash as a health check
+        await litNodeClient.getLatestBlockhash();
+        const latencyMs = Date.now() - startTime;
+        return { isValid: true, latencyMs };
+    }
+    catch (error) {
+        return {
+            isValid: false,
+            error: error?.message || error?.toString() || 'Unknown validation error'
+        };
+    }
+}
+/**
+ * Enhanced session signature generator with retry logic and caching
+ */
+async function generateSessionSignatures(litNodeClient, sessionConfig, config = {}, pkpTokenId, litActionCid, signerAddress, network = 'datil') {
+    // If caching parameters are provided, try cache first
+    if (pkpTokenId && litActionCid && signerAddress) {
+        const { sessionSignatureCache } = await Promise.resolve().then(() => __importStar(require('./session-signature-cache')));
+        const cached = sessionSignatureCache.get(pkpTokenId, litActionCid, signerAddress, network);
+        if (cached) {
+            const sigCount = Object.keys(cached).length;
+            (0, debug_logger_1.debugInfo)('SESSION', `🔄 Using cached session signatures (${sigCount} sigs)`);
+            return cached;
+        }
+    }
+    return withRetry(async () => {
+        (0, debug_logger_1.debugInfo)('SESSION', '🔐 Generating new session signatures...');
+        const sessionSigs = await litNodeClient.getSessionSigs(sessionConfig);
+        const sigCount = Object.keys(sessionSigs).length;
+        // Cache if parameters provided
+        if (pkpTokenId && litActionCid && signerAddress) {
+            const { sessionSignatureCache } = await Promise.resolve().then(() => __importStar(require('./session-signature-cache')));
+            const expiration = new Date(sessionConfig.expiration);
+            sessionSignatureCache.set(pkpTokenId, litActionCid, signerAddress, network, sessionSigs, expiration);
+        }
+        (0, debug_logger_1.debugInfo)('SESSION', `✅ Generated ${sigCount} session signatures`);
+        return sessionSigs;
+    }, config, 'Session Signature Generation');
+}
+/**
+ * Validate LIT Node Client readiness before operations
+ */
+async function validateLitNodeReadiness(litNodeClient) {
+    if (!litNodeClient) {
+        throw new Error('LIT Node Client is null or undefined');
+    }
+    // Check if client is connected
+    if (!litNodeClient.ready) {
+        (0, debug_logger_1.debugWarn)('CONNECTION', '⚠️ LIT Node Client not ready, attempting to reconnect...');
+        await litNodeClient.connect();
+        // Wait for readiness with timeout
+        const readyTimeout = 15000; // 15 seconds
+        const startTime = Date.now();
+        while (!litNodeClient.ready && (Date.now() - startTime) < readyTimeout) {
+            await sleep(500);
+        }
+        if (!litNodeClient.ready) {
+            throw new Error('LIT Node Client is not ready for operations');
+        }
+    }
+    (0, debug_logger_1.debugInfo)('CONNECTION', '✅ LIT Node Client readiness validated');
+}
+/**
+ * Enhanced LIT Action executor with retry logic and readiness validation
+ */
+async function executeLitAction(litNodeClient, executionConfig, config = {}) {
+    const cid = executionConfig.ipfsId;
+    return withRetry(async () => {
+        const startTime = Date.now();
+        // Validate client readiness before execution
+        await validateLitNodeReadiness(litNodeClient);
+        (0, debug_logger_1.logLitActionExecution)(cid, executionConfig.jsParams);
+        (0, debug_logger_1.logRequest)('LIT_ACTION', 'executeJs', executionConfig);
+        const result = await litNodeClient.executeJs(executionConfig);
+        const duration = Date.now() - startTime;
+        if (!result.response) {
+            (0, debug_logger_1.logError)('LIT_ACTION', 'executeJs', new Error('No response from LIT Action'), duration);
+            throw new Error('No response from LIT Action');
+        }
+        (0, debug_logger_1.logResponse)('LIT_ACTION', 'executeJs', result, duration);
+        (0, debug_logger_1.logLitActionResult)(cid, true, duration, result);
+        return result;
+    }, config, 'LIT Action Execution');
+}
+/**
+ * PKP operation wrapper with enhanced error handling
+ */
+async function executePkpOperation(operation, operationName, config = {}) {
+    const pkpConfig = {
+        ...exports.DEFAULT_RETRY_CONFIG,
+        ...config,
+        retryableErrors: [
+            ...exports.DEFAULT_RETRY_CONFIG.retryableErrors,
+            'pkp validation',
+            'signing shares',
+            'resource validation',
+            'ipfs propagation'
+        ]
+    };
+    return withRetry(operation, pkpConfig, `PKP ${operationName}`);
+}
+/**
+ * Network-specific timeout configurations
+ */
+exports.NETWORK_TIMEOUTS = {
+    'datil': {
+        connection: 60000, // 60 seconds
+        operation: 120000, // 2 minutes
+        pkpValidation: 180000 // 3 minutes
+    },
+    'datil-test': {
+        connection: 30000, // 30 seconds
+        operation: 60000, // 1 minute
+        pkpValidation: 90000 // 1.5 minutes
+    }
+};
+/**
+ * Get network-specific timeout configuration
+ */
+function getNetworkTimeouts(network) {
+    return exports.NETWORK_TIMEOUTS[network] || exports.NETWORK_TIMEOUTS['datil'];
+}
+//# sourceMappingURL=connection-helpers.js.map

package/pkg-dist/utils/chunks/connection-helpers.js.map

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

package/pkg-dist/utils/chunks/debug-logger.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Enhanced Debug Logger for LIT Protocol Operations
+ * Provides detailed logging for debugging network and protocol issues
+ */
+export declare enum LogLevel {
+    ERROR = 0,
+    WARN = 1,
+    INFO = 2,
+    DEBUG = 3,
+    TRACE = 4
+}
+export interface DebugConfig {
+    level: LogLevel;
+    enableTimestamps: boolean;
+    enablePerformanceMetrics: boolean;
+    enableRequestLogging: boolean;
+    enableNetworkMetrics: boolean;
+}
+export declare const DEFAULT_DEBUG_CONFIG: DebugConfig;
+/**
+ * Configure debug logging
+ */
+export declare function configureDebugLogging(config: Partial<DebugConfig>): void;
+/**
+ * Performance metrics tracker
+ */
+export declare class PerformanceTracker {
+    private operationName;
+    private startTime;
+    private markers;
+    constructor(operationName: string);
+    mark(label: string): void;
+    end(success?: boolean): number;
+    private log;
+}
+/**
+ * Network metrics collector
+ */
+export interface NetworkMetrics {
+    requestCount: number;
+    successCount: number;
+    failureCount: number;
+    averageLatency: number;
+    lastError?: string;
+    startTime: number;
+}
+declare class NetworkMetricsCollector {
+    private metrics;
+    getMetrics(operation: string): NetworkMetrics;
+    recordRequest(operation: string, success: boolean, latency: number, error?: string): void;
+    printSummary(): void;
+}
+export declare const networkMetrics: NetworkMetricsCollector;
+/**
+ * Debug logging functions
+ */
+export declare function debugError(component: string, message: string, metadata?: any): void;
+export declare function debugWarn(component: string, message: string, metadata?: any): void;
+export declare function debugInfo(component: string, message: string, metadata?: any): void;
+export declare function debugLog(component: string, message: string, metadata?: any): void;
+export declare function debugTrace(component: string, message: string, metadata?: any): void;
+/**
+ * Request/Response logger for LIT Protocol operations
+ */
+export declare function logRequest(component: string, operation: string, params: any): void;
+export declare function logResponse(component: string, operation: string, response: any, duration: number): void;
+export declare function logError(component: string, operation: string, error: any, duration?: number): void;
+/**
+ * Network connection logger
+ */
+export declare function logConnectionAttempt(network: string, attempt: number, maxAttempts: number): void;
+export declare function logConnectionSuccess(network: string, latency: number): void;
+export declare function logConnectionFailure(network: string, error: string, attempt: number): void;
+/**
+ * PKP operation logger
+ */
+export declare function logPkpOperation(operation: string, pkpId?: string, details?: any): void;
+/**
+ * Session signature logger
+ */
+export declare function logSessionSignatures(count: number, expiration: string): void;
+/**
+ * LIT Action execution logger
+ */
+export declare function logLitActionExecution(cid: string, params: any): void;
+export declare function logLitActionResult(cid: string, success: boolean, duration: number, result?: any): void;
+/**
+ * Test lifecycle logger
+ */
+export declare function logTestStart(testName: string): PerformanceTracker;
+export declare function logTestEnd(testName: string, success: boolean, duration: number): void;
+export {};
+//# sourceMappingURL=debug-logger.d.ts.map

package/pkg-dist/utils/chunks/debug-logger.d.ts.map

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