@gvnrdao/dh-lit-actions 0.0.111 → 0.0.192

package/pkg-dist/src/modules/lit-action-logger.module.d.ts

@@ -0,0 +1,55 @@
+/**
+ * LIT Action Logger Module
+ *
+ * Centralized logging and timing infrastructure for LIT Actions.
+ *
+ * Features:
+ * - Opt-in debugging via globalThis.debugAction flag
+ * - Execution ID for multi-node correlation
+ * - Step timing with automatic elapsed/remaining calculation
+ * - Timeout warnings (30s LIT Protocol limit)
+ * - Node context detection
+ * - Final execution summary
+ *
+ * Usage:
+ * ```typescript
+ * const logger = LitActionLogger.create();
+ * logger.stepStart('1', 'Fetching vault snapshot');
+ * // ... do work ...
+ * logger.stepEnd('1');
+ * logger.summary();
+ * ```
+ *
+ * Debug mode enabled when globalThis.debugAction === true
+ *
+ * Performance: When disabled (99% of cases), returns a no-op stub that does nothing.
+ */
+/**
+ * Interface for LIT Action Logger
+ */
+interface ILitActionLogger {
+    stepStart(stepId: string, description: string): void;
+    stepEnd(stepId: string, warnThresholdMs?: number): void;
+    log(stepId: string, message: string): void;
+    warn(stepId: string, message: string): void;
+    error(stepId: string, message: string): void;
+    getElapsed(): number;
+    getRemaining(): number;
+    summary(): void;
+    getExecutionId(): string;
+    isDebugEnabled(): boolean;
+}
+/**
+ * LIT Action Logger factory
+ */
+export declare class LitActionLogger {
+    /**
+     * Create logger instance
+     * Returns NoOpLogger when disabled (99% case), DebugLogger when enabled
+     * @param actionName - Name of the LIT Action (for logging context)
+     * @param debugAction - Optional override for globalThis.debugAction
+     */
+    static create(actionName?: string, debugAction?: boolean): ILitActionLogger;
+}
+export {};
+//# sourceMappingURL=lit-action-logger.module.d.ts.map

package/pkg-dist/src/modules/lit-action-logger.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lit-action-logger.module.d.ts","sourceRoot":"","sources":["../../../src/modules/lit-action-logger.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AA2BH;;GAEG;AACH,UAAU,gBAAgB;IACxB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,UAAU,IAAI,MAAM,CAAC;IACrB,YAAY,IAAI,MAAM,CAAC;IACvB,OAAO,IAAI,IAAI,CAAC;IAChB,cAAc,IAAI,MAAM,CAAC;IACzB,cAAc,IAAI,OAAO,CAAC;CAC3B;AAsKD;;GAEG;AACH,qBAAa,eAAe;IAC1B;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CACX,UAAU,GAAE,MAAqB,EACjC,WAAW,CAAC,EAAE,OAAO,GACpB,gBAAgB;CAWpB"}

package/pkg-dist/src/modules/lit-action-logger.module.js

@@ -0,0 +1,184 @@
+"use strict";
+/**
+ * LIT Action Logger Module
+ *
+ * Centralized logging and timing infrastructure for LIT Actions.
+ *
+ * Features:
+ * - Opt-in debugging via globalThis.debugAction flag
+ * - Execution ID for multi-node correlation
+ * - Step timing with automatic elapsed/remaining calculation
+ * - Timeout warnings (30s LIT Protocol limit)
+ * - Node context detection
+ * - Final execution summary
+ *
+ * Usage:
+ * ```typescript
+ * const logger = LitActionLogger.create();
+ * logger.stepStart('1', 'Fetching vault snapshot');
+ * // ... do work ...
+ * logger.stepEnd('1');
+ * logger.summary();
+ * ```
+ *
+ * Debug mode enabled when globalThis.debugAction === true
+ *
+ * Performance: When disabled (99% of cases), returns a no-op stub that does nothing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LitActionLogger = void 0;
+/**
+ * No-op logger stub for when debugging is disabled
+ * Zero overhead - all methods are empty
+ */
+class NoOpLogger {
+    stepStart(_stepId, _description) { }
+    stepEnd(_stepId, _warnThresholdMs) { }
+    log(_stepId, _message) { }
+    warn(_stepId, _message) { }
+    error(_stepId, _message) { }
+    getElapsed() {
+        return 0;
+    }
+    getRemaining() {
+        return 30000;
+    }
+    summary() { }
+    getExecutionId() {
+        return "";
+    }
+    isDebugEnabled() {
+        return false;
+    }
+}
+/**
+ * Full logger implementation for when debugging is enabled
+ */
+class DebugLogger {
+    constructor(actionName) {
+        this.stepStartTimes = new Map();
+        this.stepDurations = new Map();
+        this.TIMEOUT_MS = 30000; // 30 seconds LIT Action timeout
+        this.actionName = actionName;
+        this.executionStartTime = Date.now();
+        // Generate unique execution ID for multi-node correlation
+        const timestamp = Date.now();
+        const random = Math.random().toString(36).substring(2, 9);
+        this.executionId = `exec_${timestamp}_${random}`;
+        this.logHeader();
+    }
+    /**
+     * Log action header with execution context
+     */
+    logHeader() {
+        console.log(`[${this.actionName}] ========================================`);
+        console.log(`[${this.actionName}] Execution started`);
+        console.log(`[${this.actionName}] Execution ID: ${this.executionId}`);
+        // Detect if running in LIT node context vs browser
+        const isLitNode = typeof globalThis.litNodeContext !== "undefined";
+        if (isLitNode) {
+            console.log(`[${this.actionName}] Context: LIT Node`);
+            console.log(`[${this.actionName}] Node: ${globalThis.litNodeContext?.nodeAddress || "unknown"}`);
+        }
+        else {
+            console.log(`[${this.actionName}] Context: Browser/Test`);
+        }
+        console.log(`[${this.actionName}] ========================================`);
+    }
+    stepStart(stepId, description) {
+        this.stepStartTimes.set(stepId, Date.now());
+        const elapsed = Date.now() - this.executionStartTime;
+        const remaining = this.TIMEOUT_MS - elapsed;
+        console.log(`[Step ${stepId}] ${description}...`);
+        console.log(`[Step ${stepId}] Elapsed: ${elapsed}ms | Remaining: ${remaining}ms`);
+    }
+    stepEnd(stepId, warnThresholdMs = 5000) {
+        const startTime = this.stepStartTimes.get(stepId);
+        if (!startTime) {
+            console.warn(`[Step ${stepId}] ⚠️  stepEnd called without matching stepStart`);
+            return;
+        }
+        const duration = Date.now() - startTime;
+        this.stepDurations.set(stepId, duration);
+        console.log(`[Step ${stepId}] Duration: ${duration}ms`);
+        // Warn if step took longer than threshold
+        if (duration > warnThresholdMs) {
+            console.warn(`⚠️  [Step ${stepId}] Took ${duration}ms (> ${warnThresholdMs}ms threshold)`);
+        }
+        // Warn if approaching timeout
+        const elapsed = Date.now() - this.executionStartTime;
+        const remaining = this.TIMEOUT_MS - elapsed;
+        if (remaining < 5000) {
+            console.warn(`⚠️  [Step ${stepId}] Time remaining: ${remaining}ms (approaching timeout)`);
+        }
+    }
+    log(stepId, message) {
+        console.log(`[Step ${stepId}] ${message}`);
+    }
+    warn(stepId, message) {
+        console.warn(`⚠️  [Step ${stepId}] ${message}`);
+    }
+    error(stepId, message) {
+        console.error(`❌ [Step ${stepId}] ${message}`);
+    }
+    getElapsed() {
+        return Date.now() - this.executionStartTime;
+    }
+    getRemaining() {
+        return this.TIMEOUT_MS - this.getElapsed();
+    }
+    summary() {
+        const totalDuration = Date.now() - this.executionStartTime;
+        const remaining = this.TIMEOUT_MS - totalDuration;
+        console.log(`[${this.actionName}] ========================================`);
+        console.log(`[${this.actionName}] Execution Summary`);
+        console.log(`[${this.actionName}] Execution ID: ${this.executionId}`);
+        console.log(`[${this.actionName}] Total time: ${(totalDuration / 1000).toFixed(2)}s`);
+        console.log(`[${this.actionName}] Time remaining: ${remaining}ms`);
+        // Log step timing breakdown
+        if (this.stepDurations.size > 0) {
+            console.log(`[${this.actionName}] Step breakdown:`);
+            for (const [stepId, duration] of this.stepDurations.entries()) {
+                const percent = ((duration / totalDuration) * 100).toFixed(1);
+                console.log(`[${this.actionName}]   Step ${stepId}: ${duration}ms (${percent}%)`);
+            }
+        }
+        // Warnings for slow execution
+        if (totalDuration > 20000) {
+            console.warn(`⚠️  [${this.actionName}] Slow execution: ${(totalDuration / 1000).toFixed(2)}s (${remaining}ms remaining)`);
+        }
+        if (remaining < 5000) {
+            console.warn(`⚠️  [${this.actionName}] CRITICAL: Only ${remaining}ms remaining before timeout!`);
+        }
+        console.log(`[${this.actionName}] ========================================`);
+    }
+    getExecutionId() {
+        return this.executionId;
+    }
+    isDebugEnabled() {
+        return true;
+    }
+}
+/**
+ * LIT Action Logger factory
+ */
+class LitActionLogger {
+    /**
+     * Create logger instance
+     * Returns NoOpLogger when disabled (99% case), DebugLogger when enabled
+     * @param actionName - Name of the LIT Action (for logging context)
+     * @param debugAction - Optional override for globalThis.debugAction
+     */
+    static create(actionName = "LIT Action", debugAction) {
+        const debugEnabled = debugAction ?? globalThis.debugAction ?? false;
+        if (debugEnabled) {
+            return new DebugLogger(actionName);
+        }
+        else {
+            // Return lightweight no-op stub - zero overhead for 99% of executions
+            return new NoOpLogger();
+        }
+    }
+}
+exports.LitActionLogger = LitActionLogger;
+//# sourceMappingURL=lit-action-logger.module.js.map

package/pkg-dist/src/modules/lit-action-logger.module.js.map

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

package/pkg-dist/src/modules/price-oracle.module.d.ts

@@ -1,22 +1,60 @@
 import { IPriceOracle, PriceSourceConfig } from "../interfaces/chunks/price-oracle.i";
 export declare class PriceOracleModule implements IPriceOracle {
     private sources;
+    private mode?;
     constructor(priceProvidersOrConfig?: Array<{
         name: string;
         apiKey?: string;
-    }> | any, legacySources?: PriceSourceConfig[]);
+        apiSecret?: string;
+    }> | any, legacySources?: PriceSourceConfig[], mode?: "dev" | "prod");
     /**
-     * Build price sources from config or use defaults
+     * Validate provider count based on mode
+     * - Production: Requires at least 3 providers for consensus
+     * - Development: Allows as few as 1 provider for testing
+     */
+    private validateProviderCount;
+    /**
+     * Build price sources from config
+     * All providers are treated equally - no special priority for any provider
      */
     private buildSources;
     /**
      * Create CryptoCompare price source
+     * Requires API key for access
      */
     private createCryptoCompareSource;
+    /**
+     * Create shared fetch helper with timeout
+     * LIT runtime rejects custom User-Agent headers
+     */
+    private createFetchJson;
+    /**
+     * Get default free providers (no API keys required)
+     */
     private getDefaultSources;
+    /**
+     * Create CoinGecko price source
+     */
+    private createCoinGeckoSource;
+    /**
+     * Create Binance price source
+     */
+    private createBinanceSource;
+    /**
+     * Create Coinbase price source
+     */
+    private createCoinbaseSource;
     /**
      * Get BTC price in USD with 8 decimals
-     * Fetches from real price sources in priority order
+     *
+     * CRITICAL OPTIMIZATION: Queries all sources in parallel with Promise.race()
+     * This prevents timeout when multiple sources fail sequentially.
+     *
+     * Master's Wisdom: "The fastest path to truth is asking all at once"
+     * - All sources queried simultaneously
+     * - First successful response wins
+     * - No waiting for slow/failed providers
+     * - Total time = fastest provider, not sum of all attempts
      */
     getBTCPrice(): Promise<bigint>;
     /**

package/pkg-dist/src/modules/price-oracle.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"price-oracle.module.d.ts","sourceRoot":"","sources":["../../../src/modules/price-oracle.module.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,iBAAiB,EAClB,MAAM,qCAAqC,CAAC;AAM7C,qBAAa,iBAAkB,YAAW,YAAY;IACpD,OAAO,CAAC,OAAO,CAAsB;gBAGnC,sBAAsB,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,GAAG,EACvE,aAAa,CAAC,EAAE,iBAAiB,EAAE;IAerC;;OAEG;IACH,OAAO,CAAC,YAAY;IAsBpB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAyDjC,OAAO,CAAC,iBAAiB;IAmFzB;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IA+CpC;;;;;;;;;;;;;;;OAeG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;CAqH9C"}
+{"version":3,"file":"price-oracle.module.d.ts","sourceRoot":"","sources":["../../../src/modules/price-oracle.module.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,iBAAiB,EAClB,MAAM,qCAAqC,CAAC;AAM7C,qBAAa,iBAAkB,YAAW,YAAY;IACpD,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,IAAI,CAAC,CAAiB;gBAG5B,sBAAsB,CAAC,EACnB,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAC5D,GAAG,EACP,aAAa,CAAC,EAAE,iBAAiB,EAAE,EACnC,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM;IAuBvB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;;OAGG;IACH,OAAO,CAAC,YAAY;IAwDpB;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IA6DjC;;;OAGG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA+B7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoC3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiC5B;;;;;;;;;;;OAWG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IA+JpC;;;;;;;;;;;;;;;OAeG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;CA+G9C"}