@gvnrdao/dh-lit-actions 0.0.60 → 0.0.63

package/pkg-dist/src/modules/protocol-parameters.module.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * Protocol Parameters Module
+ *
+ * Fetches protocol parameters directly from smart contracts.
+ * This ensures LIT actions always use current values set by protocol governance.
+ *
+ * Parameters fetched:
+ * - Liquidation threshold (from LoanOperationsManager)
+ * - Term-specific fees (from TermManager)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProtocolParametersModule = void 0;
+exports.createProtocolParametersModule = createProtocolParametersModule;
+/**
+ * Protocol Parameters Module
+ *
+ * Fetches governance-controlled parameters from smart contracts
+ */
+class ProtocolParametersModule {
+    constructor(config) {
+        this.termManagerAddress = config.termManagerAddress;
+        this.loanOpsManagerAddress = config.loanOpsManagerAddress;
+        this.chain = config.chain;
+        this.chainId = config.chainId;
+        this.rpcUrl = config.rpcUrl;
+    }
+    /**
+     * Get liquidation threshold from LoanOperationsManager
+     *
+     * @returns Liquidation threshold in basis points
+     */
+    async getLiquidationThreshold() {
+        try {
+            // Get RPC URL - either from config (for local testing) or from Lit runtime
+            let rpcUrl;
+            if (this.rpcUrl) {
+                rpcUrl = this.rpcUrl;
+            }
+            else {
+                // @ts-ignore - Lit.Actions available in LIT runtime
+                rpcUrl = await Lit.Actions.getRpcUrl({ chain: this.chain });
+            }
+            // @ts-ignore - ethers available in LIT runtime
+            // StaticJsonRpcProvider with explicit network bypasses auto-detection (required for ngrok URLs)
+            const provider = new ethers.providers.StaticJsonRpcProvider(rpcUrl, { name: 'any', chainId: 1337 });
+            const abi = [
+                {
+                    inputs: [],
+                    name: "liquidationThreshold",
+                    outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+                    stateMutability: "view",
+                    type: "function",
+                },
+            ];
+            // @ts-ignore - ethers available in LIT runtime
+            const contract = new ethers.Contract(this.loanOpsManagerAddress, abi, provider);
+            const result = await contract.liquidationThreshold();
+            return Number(result.toString());
+        }
+        catch (error) {
+            console.error("[ProtocolParameters] Error fetching liquidation threshold:", error.message);
+            throw new Error(`Failed to fetch liquidation threshold: ${error.message}`);
+        }
+    }
+    /**
+     * Get term-specific fees from TermManager
+     *
+     * @param termMonths Loan term in months
+     * @returns Term fees (origination and extension) in basis points
+     */
+    async getTermFees(termMonths) {
+        try {
+            // Get RPC URL - either from config (for local testing) or from Lit runtime
+            let rpcUrl;
+            if (this.rpcUrl) {
+                rpcUrl = this.rpcUrl;
+            }
+            else {
+                // @ts-ignore - Lit.Actions available in LIT runtime
+                rpcUrl = await Lit.Actions.getRpcUrl({ chain: this.chain });
+            }
+            // @ts-ignore - ethers available in LIT runtime
+            // StaticJsonRpcProvider with explicit network bypasses auto-detection (required for ngrok URLs)
+            const provider = new ethers.providers.StaticJsonRpcProvider(rpcUrl, { name: 'any', chainId: 1337 });
+            const abi = [
+                {
+                    inputs: [
+                        { internalType: "uint256", name: "_termMonths", type: "uint256" },
+                    ],
+                    name: "getTermFees",
+                    outputs: [
+                        { internalType: "uint88", name: "originationFee", type: "uint88" },
+                        { internalType: "uint88", name: "extensionFee", type: "uint88" },
+                    ],
+                    stateMutability: "view",
+                    type: "function",
+                },
+            ];
+            // @ts-ignore - ethers available in LIT runtime
+            const contract = new ethers.Contract(this.termManagerAddress, abi, provider);
+            const result = await contract.getTermFees(termMonths);
+            return {
+                originationFeeBps: Number(result.originationFee?.toString?.() ??
+                    result[0]?.toString?.() ??
+                    result[0]),
+                extensionFeeBps: Number(result.extensionFee?.toString?.() ??
+                    result[1]?.toString?.() ??
+                    result[1]),
+            };
+        }
+        catch (error) {
+            console.error("[ProtocolParameters] Error fetching term fees:", error.message);
+            throw new Error(`Failed to fetch term fees: ${error.message}`);
+        }
+    }
+}
+exports.ProtocolParametersModule = ProtocolParametersModule;
+/**
+ * Factory function to create protocol parameters module
+ */
+function createProtocolParametersModule(config) {
+    return new ProtocolParametersModule(config);
+}
+//# sourceMappingURL=protocol-parameters.module.js.map

package/pkg-dist/src/modules/protocol-parameters.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-parameters.module.js","sourceRoot":"","sources":["../../../src/modules/protocol-parameters.module.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAwJH,wEAIC;AAvID;;;;GAIG;AACH,MAAa,wBAAwB;IAOnC,YAAY,MAAgC;QAC1C,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAC;QACpD,IAAI,CAAC,qBAAqB,GAAG,MAAM,CAAC,qBAAqB,CAAC;QAC1D,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,uBAAuB;QAC3B,IAAI,CAAC;YACL,2EAA2E;YAC3E,IAAI,MAAc,CAAC;YACnB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,oDAAoD;gBACpD,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAC9D,CAAC;YACD,+CAA+C;YAC/C,gGAAgG;YAChG,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,qBAAqB,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAClG,MAAM,GAAG,GAAG;gBACV;oBACE,MAAM,EAAE,EAAE;oBACV,IAAI,EAAE,sBAAsB;oBAC5B,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;oBACjE,eAAe,EAAE,MAAM;oBACvB,IAAI,EAAE,UAAU;iBACjB;aACF,CAAC;YACF,+CAA+C;YAC/C,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,QAAQ,CAClC,IAAI,CAAC,qBAAqB,EAC1B,GAAG,EACH,QAAQ,CACT,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,oBAAoB,EAAE,CAAC;YACrD,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CACX,4DAA4D,EAC5D,KAAK,CAAC,OAAO,CACd,CAAC;YACF,MAAM,IAAI,KAAK,CACb,0CAA0C,KAAK,CAAC,OAAO,EAAE,CAC1D,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CAAC,UAAkB;QAClC,IAAI,CAAC;YACH,2EAA2E;YAC3E,IAAI,MAAc,CAAC;YACnB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,oDAAoD;gBACpD,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAC9D,CAAC;YACD,+CAA+C;YAC/C,gGAAgG;YAChG,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,qBAAqB,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YACpG,MAAM,GAAG,GAAG;gBACV;oBACE,MAAM,EAAE;wBACN,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;qBAClE;oBACD,IAAI,EAAE,aAAa;oBACnB,OAAO,EAAE;wBACP,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE;wBAClE,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE;qBACjE;oBACD,eAAe,EAAE,MAAM;oBACvB,IAAI,EAAE,UAAU;iBACjB;aACF,CAAC;YACF,+CAA+C;YAC/C,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,QAAQ,CAClC,IAAI,CAAC,kBAAkB,EACvB,GAAG,EACH,QAAQ,CACT,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YACtD,OAAO;gBACL,iBAAiB,EAAE,MAAM,CACvB,MAAM,CAAC,cAAc,EAAE,QAAQ,EAAE,EAAE;oBACjC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE;oBACvB,MAAM,CAAC,CAAC,CAAC,CACZ;gBACD,eAAe,EAAE,MAAM,CACrB,MAAM,CAAC,YAAY,EAAE,QAAQ,EAAE,EAAE;oBAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE;oBACvB,MAAM,CAAC,CAAC,CAAC,CACZ;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CACX,gDAAgD,EAChD,KAAK,CAAC,OAAO,CACd,CAAC;YACF,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;CACF;AAzHD,4DAyHC;AAED;;GAEG;AACH,SAAgB,8BAA8B,CAC5C,MAAgC;IAEhC,OAAO,IAAI,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAC9C,CAAC"}

package/pkg-dist/src/modules/quantum-time.module.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Quantum Time Window Utilities for LIT Actions
+ *
+ * PRIMARY WORKFLOW FOR LIT ACTIONS:
+ *
+ * ```typescript
+ * // 1. Wait for safe quantum moment (waits if in dead zone)
+ * await waitForSafeQuantumMoment();
+ *
+ * // 2. Validate signature timestamp (throws if invalid)
+ * validateQuantumTimestamp(timestampOnSignature);
+ * ```
+ *
+ * The macro validateQuantumTimestamp() combines waiting + validation:
+ * - Ensures LIT Action only validates when NOT in dead zone
+ * - Ensures signature is from current quantum (prevents replay attacks)
+ * - Throws error if validation fails
+ *
+ * Dead Zone Protection (16 seconds: 8+8):
+ * - Protects against clock desynchronization
+ * - Protects against Ethereum miner timestamp manipulation (±15s)
+ * - Ensures deterministic validation across all validators
+ *
+ * See QUANTUM_TIME_WINDOW.md for full documentation.
+ */
+/**
+ * Calculate quantum window start for given timestamp
+ *
+ * @param timestamp - Unix timestamp in seconds
+ * @returns Quantum window start timestamp
+ */
+export declare function getQuantumStart(timestamp: number): number;
+/**
+ * Calculate quantum window end for given timestamp
+ *
+ * @param timestamp - Unix timestamp in seconds
+ * @returns Quantum window end timestamp
+ */
+export declare function getQuantumEnd(timestamp: number): number;
+/**
+ * Get current quantum timestamp (start of current quantum)
+ *
+ * Use this for signing operations.
+ *
+ * @returns Current quantum start timestamp
+ */
+export declare function getCurrentQuantumTimestamp(): number;
+/**
+ * Check if currently in dead zone (last 8s before boundary + first 8s after boundary)
+ *
+ * Dead zone = seconds 92-99 OR 0-7 of each quantum
+ *
+ * @param now - Current Unix timestamp (defaults to Date.now()/1000)
+ * @returns True if in dead zone
+ */
+export declare function isInDeadZone(now?: number): boolean;
+/**
+ * Get seconds remaining in current quantum
+ *
+ * @param now - Current Unix timestamp (defaults to Date.now()/1000)
+ * @returns Seconds until quantum expires
+ */
+export declare function getSecondsRemainingInQuantum(now?: number): number;
+/**
+ * Wait for safe quantum moment (LIT Actions use)
+ *
+ * LIT Actions must wait during dead zone to ensure deterministic validation.
+ * Waits until second 8 of next quantum (first safe second).
+ *
+ * Decision logic:
+ * - If in dead zone: Wait until second 8 of next quantum
+ * - Otherwise: Proceed immediately
+ *
+ * @returns Promise that resolves when safe to operate
+ */
+export declare function waitForSafeQuantumMoment(): Promise<void>;
+/**
+ * Validate timestamp is from current quantum (throws on invalid)
+ *
+ * This is the PRIMARY macro for LIT Actions validation.
+ *
+ * Usage:
+ * 1. Wait for safe moment: await waitForSafeQuantumMoment()
+ * 2. Validate signature: validateQuantumTimestamp(signatureTimestamp)
+ *
+ * @param timestampOnSignature - Timestamp from signed message
+ * @param now - Current Unix timestamp (defaults to Date.now()/1000)
+ * @throws Error if timestamp is not from current quantum
+ */
+export declare function validateQuantumTimestamp(timestampOnSignature: number, now?: number): void;
+/**
+ * Check if timestamp is valid (boolean version - does not throw)
+ *
+ * Rules:
+ * 1. Must be current quantum (not previous, not future)
+ *
+ * NOTE: Dead zone doesn't invalidate timestamps - only affects WHEN we validate.
+ * LIT Actions should WAIT during dead zone, but can validate any timestamp from current quantum.
+ *
+ * @param signatureTimestamp - Timestamp from signed message
+ * @param now - Current Unix timestamp (defaults to Date.now()/1000)
+ * @returns True if valid
+ */
+export declare function isTimestampValid(signatureTimestamp: number, now?: number): boolean;
+/**
+ * Get next quantum timestamp
+ *
+ * @param now - Current Unix timestamp (defaults to Date.now()/1000)
+ * @returns Next quantum timestamp
+ */
+export declare function getNextQuantumTimestamp(now?: number): number;
+/**
+ * Get quantum info for debugging
+ *
+ * @param now - Current Unix timestamp (defaults to Date.now()/1000)
+ * @returns Quantum information object
+ */
+export declare function getQuantumInfo(now?: number): {
+    currentTime: number;
+    currentQuantum: number;
+    timeInQuantum: number;
+    secondsRemaining: number;
+    isInDeadZone: boolean;
+    nextQuantum: number;
+};
+/**
+ * Get safe quantum info (async - waits if needed)
+ *
+ * This is useful for debugging but not typically needed in LIT Actions.
+ * LIT Actions should use waitForSafeQuantumMoment() + validateQuantumTimestamp().
+ *
+ * @returns Promise resolving to quantum information for safe operation
+ */
+export declare function getSafeQuantumInfo(): Promise<{
+    currentTime: number;
+    currentQuantum: number;
+    timeInQuantum: number;
+    secondsRemaining: number;
+    isInDeadZone: boolean;
+    nextQuantum: number;
+}>;
+/**
+ * Format quantum info for debugging
+ *
+ * @param now - Current Unix timestamp (defaults to Date.now()/1000)
+ * @returns Human-readable quantum info
+ */
+export declare function formatQuantumInfo(now?: number): string;
+//# sourceMappingURL=quantum-time.module.d.ts.map

package/pkg-dist/src/modules/quantum-time.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quantum-time.module.d.ts","sourceRoot":"","sources":["../../../src/modules/quantum-time.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAOH;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAGnD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAKlD;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAIjE;AACD;;;;;;;;;;;GAWG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CA4B9D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,oBAAoB,EAAE,MAAM,EAC5B,GAAG,CAAC,EAAE,MAAM,GACX,IAAI,CAWN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,kBAAkB,EAAE,MAAM,EAC1B,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAgBT;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB,CAcA;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAMD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBtD"}

package/pkg-dist/src/modules/quantum-time.module.js

@@ -0,0 +1,240 @@
+"use strict";
+/**
+ * Quantum Time Window Utilities for LIT Actions
+ *
+ * PRIMARY WORKFLOW FOR LIT ACTIONS:
+ *
+ * ```typescript
+ * // 1. Wait for safe quantum moment (waits if in dead zone)
+ * await waitForSafeQuantumMoment();
+ *
+ * // 2. Validate signature timestamp (throws if invalid)
+ * validateQuantumTimestamp(timestampOnSignature);
+ * ```
+ *
+ * The macro validateQuantumTimestamp() combines waiting + validation:
+ * - Ensures LIT Action only validates when NOT in dead zone
+ * - Ensures signature is from current quantum (prevents replay attacks)
+ * - Throws error if validation fails
+ *
+ * Dead Zone Protection (16 seconds: 8+8):
+ * - Protects against clock desynchronization
+ * - Protects against Ethereum miner timestamp manipulation (±15s)
+ * - Ensures deterministic validation across all validators
+ *
+ * See QUANTUM_TIME_WINDOW.md for full documentation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getQuantumStart = getQuantumStart;
+exports.getQuantumEnd = getQuantumEnd;
+exports.getCurrentQuantumTimestamp = getCurrentQuantumTimestamp;
+exports.isInDeadZone = isInDeadZone;
+exports.getSecondsRemainingInQuantum = getSecondsRemainingInQuantum;
+exports.waitForSafeQuantumMoment = waitForSafeQuantumMoment;
+exports.validateQuantumTimestamp = validateQuantumTimestamp;
+exports.isTimestampValid = isTimestampValid;
+exports.getNextQuantumTimestamp = getNextQuantumTimestamp;
+exports.getQuantumInfo = getQuantumInfo;
+exports.getSafeQuantumInfo = getSafeQuantumInfo;
+exports.formatQuantumInfo = formatQuantumInfo;
+const constants_1 = require("../constants");
+/**
+ * Calculate quantum window start for given timestamp
+ *
+ * @param timestamp - Unix timestamp in seconds
+ * @returns Quantum window start timestamp
+ */
+function getQuantumStart(timestamp) {
+    return (Math.floor(timestamp / constants_1.QUANTUM_WINDOW_SECONDS) * constants_1.QUANTUM_WINDOW_SECONDS);
+}
+/**
+ * Calculate quantum window end for given timestamp
+ *
+ * @param timestamp - Unix timestamp in seconds
+ * @returns Quantum window end timestamp
+ */
+function getQuantumEnd(timestamp) {
+    return getQuantumStart(timestamp) + constants_1.QUANTUM_WINDOW_SECONDS;
+}
+/**
+ * Get current quantum timestamp (start of current quantum)
+ *
+ * Use this for signing operations.
+ *
+ * @returns Current quantum start timestamp
+ */
+function getCurrentQuantumTimestamp() {
+    const now = Math.floor(Date.now() / 1000);
+    return getQuantumStart(now);
+}
+/**
+ * Check if currently in dead zone (last 8s before boundary + first 8s after boundary)
+ *
+ * Dead zone = seconds 92-99 OR 0-7 of each quantum
+ *
+ * @param now - Current Unix timestamp (defaults to Date.now()/1000)
+ * @returns True if in dead zone
+ */
+function isInDeadZone(now) {
+    const currentTime = now ?? Math.floor(Date.now() / 1000);
+    const timeInQuantum = currentTime % constants_1.QUANTUM_WINDOW_SECONDS;
+    // Last 8 seconds OR first 8 seconds
+    return timeInQuantum >= 92 || timeInQuantum < 8;
+}
+/**
+ * Get seconds remaining in current quantum
+ *
+ * @param now - Current Unix timestamp (defaults to Date.now()/1000)
+ * @returns Seconds until quantum expires
+ */
+function getSecondsRemainingInQuantum(now) {
+    const currentTime = now ?? Math.floor(Date.now() / 1000);
+    const timeInQuantum = currentTime % constants_1.QUANTUM_WINDOW_SECONDS;
+    return constants_1.QUANTUM_WINDOW_SECONDS - timeInQuantum;
+}
+/**
+ * Wait for safe quantum moment (LIT Actions use)
+ *
+ * LIT Actions must wait during dead zone to ensure deterministic validation.
+ * Waits until second 8 of next quantum (first safe second).
+ *
+ * Decision logic:
+ * - If in dead zone: Wait until second 8 of next quantum
+ * - Otherwise: Proceed immediately
+ *
+ * @returns Promise that resolves when safe to operate
+ */
+async function waitForSafeQuantumMoment() {
+    const now = Math.floor(Date.now() / 1000);
+    const timeInQuantum = now % constants_1.QUANTUM_WINDOW_SECONDS;
+    if (!isInDeadZone(now)) {
+        return; // Safe to proceed immediately
+    }
+    // Calculate wait time to reach second 8 of next quantum
+    let waitSeconds;
+    if (timeInQuantum >= 92) {
+        // In dead zone before boundary (seconds 92-99)
+        // Wait to second 8 of next quantum
+        waitSeconds = 100 - timeInQuantum + 8;
+    }
+    else {
+        // In dead zone after boundary (seconds 0-7)
+        // Wait until second 8
+        waitSeconds = 8 - timeInQuantum;
+    }
+    console.log(`[Quantum] Waiting ${waitSeconds}s for safe moment (current time in quantum: ${timeInQuantum}s)`);
+    await new Promise((resolve) => setTimeout(resolve, waitSeconds * 1000));
+    console.log(`[Quantum] Safe quantum ready: ${getCurrentQuantumTimestamp()}`);
+}
+/**
+ * Validate timestamp is from current quantum (throws on invalid)
+ *
+ * This is the PRIMARY macro for LIT Actions validation.
+ *
+ * Usage:
+ * 1. Wait for safe moment: await waitForSafeQuantumMoment()
+ * 2. Validate signature: validateQuantumTimestamp(signatureTimestamp)
+ *
+ * @param timestampOnSignature - Timestamp from signed message
+ * @param now - Current Unix timestamp (defaults to Date.now()/1000)
+ * @throws Error if timestamp is not from current quantum
+ */
+function validateQuantumTimestamp(timestampOnSignature, now) {
+    const currentTime = now ?? Math.floor(Date.now() / 1000);
+    const currentQuantum = getQuantumStart(currentTime);
+    const signatureQuantum = getQuantumStart(timestampOnSignature);
+    // Must be current quantum
+    if (signatureQuantum !== currentQuantum) {
+        throw new Error(`[Quantum] Invalid timestamp: signature from quantum ${signatureQuantum}, current quantum is ${currentQuantum}`);
+    }
+}
+/**
+ * Check if timestamp is valid (boolean version - does not throw)
+ *
+ * Rules:
+ * 1. Must be current quantum (not previous, not future)
+ *
+ * NOTE: Dead zone doesn't invalidate timestamps - only affects WHEN we validate.
+ * LIT Actions should WAIT during dead zone, but can validate any timestamp from current quantum.
+ *
+ * @param signatureTimestamp - Timestamp from signed message
+ * @param now - Current Unix timestamp (defaults to Date.now()/1000)
+ * @returns True if valid
+ */
+function isTimestampValid(signatureTimestamp, now) {
+    const currentTime = now ?? Math.floor(Date.now() / 1000);
+    const currentQuantum = getQuantumStart(currentTime);
+    const signatureQuantum = getQuantumStart(signatureTimestamp);
+    // Must be current quantum
+    if (signatureQuantum !== currentQuantum) {
+        console.error(`[Quantum] Signature not from current quantum:`, `\n  Current: ${currentQuantum}`, `\n  Signature: ${signatureQuantum}`);
+        return false;
+    }
+    return true;
+}
+/**
+ * Get next quantum timestamp
+ *
+ * @param now - Current Unix timestamp (defaults to Date.now()/1000)
+ * @returns Next quantum timestamp
+ */
+function getNextQuantumTimestamp(now) {
+    const currentTime = now ?? Math.floor(Date.now() / 1000);
+    const currentQuantum = getQuantumStart(currentTime);
+    return currentQuantum + constants_1.QUANTUM_WINDOW_SECONDS;
+}
+/**
+ * Get quantum info for debugging
+ *
+ * @param now - Current Unix timestamp (defaults to Date.now()/1000)
+ * @returns Quantum information object
+ */
+function getQuantumInfo(now) {
+    const currentTime = now ?? Math.floor(Date.now() / 1000);
+    const currentQuantum = getQuantumStart(currentTime);
+    const timeInQuantum = currentTime % constants_1.QUANTUM_WINDOW_SECONDS;
+    const secondsRemaining = constants_1.QUANTUM_WINDOW_SECONDS - timeInQuantum;
+    return {
+        currentTime,
+        currentQuantum,
+        timeInQuantum,
+        secondsRemaining,
+        isInDeadZone: isInDeadZone(currentTime),
+        nextQuantum: getNextQuantumTimestamp(currentTime),
+    };
+}
+/**
+ * Get safe quantum info (async - waits if needed)
+ *
+ * This is useful for debugging but not typically needed in LIT Actions.
+ * LIT Actions should use waitForSafeQuantumMoment() + validateQuantumTimestamp().
+ *
+ * @returns Promise resolving to quantum information for safe operation
+ */
+async function getSafeQuantumInfo() {
+    // Wait for safe moment if needed
+    await waitForSafeQuantumMoment();
+    // Now get info (guaranteed to be outside dead zone)
+    return getQuantumInfo();
+}
+/**
+ * Format quantum info for debugging
+ *
+ * @param now - Current Unix timestamp (defaults to Date.now()/1000)
+ * @returns Human-readable quantum info
+ */
+function formatQuantumInfo(now) {
+    const info = getQuantumInfo(now);
+    const startDate = new Date(info.currentQuantum * 1000).toISOString();
+    const endDate = new Date((info.currentQuantum + constants_1.QUANTUM_WINDOW_SECONDS) * 1000).toISOString();
+    return [
+        `Quantum Window:`,
+        `  Start: ${startDate} (${info.currentQuantum})`,
+        `  End: ${endDate} (${info.currentQuantum + constants_1.QUANTUM_WINDOW_SECONDS})`,
+        `  Duration: ${constants_1.QUANTUM_WINDOW_SECONDS}s`,
+        `  Time in quantum: ${info.timeInQuantum}s`,
+        `  Remaining: ${info.secondsRemaining}s`,
+        `  In Dead Zone: ${info.isInDeadZone}`,
+    ].join("\n");
+}
+//# sourceMappingURL=quantum-time.module.js.map

package/pkg-dist/src/modules/quantum-time.module.js.map

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