@gvnrdao/dh-lit-ops 0.0.1

package/dist/modules/client-manager.module.d.ts

@@ -0,0 +1,64 @@
+/**
+ * LIT Client Manager
+ * Centralized management of LitNodeClient instances with connection pooling
+ */
+import { LitContracts } from "@lit-protocol/contracts-sdk";
+import { LitNodeClient } from "@lit-protocol/lit-node-client";
+import { LIT_NETWORKS_KEYS } from "@lit-protocol/types";
+import { ethers as ethers5 } from "ethers";
+export interface ClientConfig {
+    litNetwork: LIT_NETWORKS_KEYS;
+    debug?: boolean;
+    alertWhenUnauthorized?: boolean;
+    minNodeCount?: number;
+}
+export declare class LitClientManager {
+    private clients;
+    private debug;
+    private defaultConfig;
+    private maxIdleTime;
+    private cleanupInterval;
+    constructor(defaultConfig: ClientConfig);
+    /**
+     * Get or create a LitNodeClient instance
+     * Uses singleton pattern per network configuration
+     */
+    getClient(config?: Partial<ClientConfig>): Promise<LitNodeClient>;
+    /**
+     * Get or create LitContracts instance (cached per client)
+     */
+    getContracts(signer: ethers5.Signer, config?: Partial<ClientConfig>): Promise<LitContracts>;
+    /**
+     * Release a reference to a client
+     * Decrements reference count for cleanup purposes
+     */
+    releaseClient(config?: Partial<ClientConfig>): void;
+    /**
+     * Force disconnect and cleanup all clients
+     * Also stops the cleanup timer to prevent Jest from hanging
+     */
+    disconnectAll(): Promise<void>;
+    /**
+     * Get connection statistics
+     */
+    getStats(): {
+        totalClients: number;
+        clientsByNetwork: Record<string, {
+            refCount: number;
+            lastUsed: number;
+        }>;
+    };
+    /**
+     * Private: Generate client key for caching
+     */
+    private getClientKey;
+    /**
+     * Private: Start cleanup timer for idle clients
+     */
+    private startCleanupTimer;
+    /**
+     * Private: Cleanup clients that have been idle too long
+     */
+    private cleanupIdleClients;
+}
+//# sourceMappingURL=client-manager.module.d.ts.map

package/dist/modules/client-manager.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-manager.module.d.ts","sourceRoot":"","sources":["../../src/modules/client-manager.module.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,QAAQ,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAUD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,KAAK,CAAU;IAEvB,OAAO,CAAC,aAAa,CAAe;IAGpC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,eAAe,CAA+B;gBAE1C,aAAa,EAAE,YAAY;IAMvC;;;OAGG;IACG,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAuDvE;;OAEG;IACG,YAAY,CAChB,MAAM,EAAE,OAAO,CAAC,MAAM,EACtB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,OAAO,CAAC,YAAY,CAAC;IA8CxB;;;OAGG;IACH,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAenD;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAiCpC;;OAEG;IACH,QAAQ,IAAI;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC1E;IAmBD;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;YACW,kBAAkB;CA6BjC"}

package/dist/modules/client-manager.module.js

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * LIT Client Manager
+ * Centralized management of LitNodeClient instances with connection pooling
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LitClientManager = void 0;
+const contracts_sdk_1 = require("@lit-protocol/contracts-sdk");
+const lit_node_client_1 = require("@lit-protocol/lit-node-client");
+class LitClientManager {
+    constructor(defaultConfig) {
+        this.clients = new Map();
+        // Connection pool settings
+        this.maxIdleTime = 30 * 60 * 1000; // 30 minutes
+        this.cleanupInterval = null;
+        this.defaultConfig = defaultConfig;
+        this.debug = defaultConfig.debug || false;
+        // Don't start cleanup timer immediately - start it when first client is created
+    }
+    /**
+     * Get or create a LitNodeClient instance
+     * Uses singleton pattern per network configuration
+     */
+    async getClient(config) {
+        const finalConfig = { ...this.defaultConfig, ...config };
+        const clientKey = this.getClientKey(finalConfig);
+        let managed = this.clients.get(clientKey);
+        if (!managed) {
+            // Start cleanup timer when we create the first client
+            if (this.clients.size === 0 && !this.cleanupInterval) {
+                this.startCleanupTimer();
+            }
+            if (this.debug) {
+                console.log(`🔌 Creating new LitNodeClient for ${finalConfig.litNetwork}`);
+            }
+            const client = new lit_node_client_1.LitNodeClient({
+                litNetwork: finalConfig.litNetwork,
+                debug: finalConfig.debug,
+                alertWhenUnauthorized: finalConfig.alertWhenUnauthorized,
+                minNodeCount: finalConfig.minNodeCount,
+            });
+            await client.connect();
+            managed = {
+                client,
+                contracts: null,
+                lastUsed: Date.now(),
+                refCount: 0,
+                network: finalConfig.litNetwork,
+            };
+            this.clients.set(clientKey, managed);
+            if (this.debug) {
+                console.log(`✅ LitNodeClient connected for ${finalConfig.litNetwork}`);
+            }
+        }
+        else {
+            if (this.debug) {
+                console.log(`🔄 Reusing existing LitNodeClient for ${finalConfig.litNetwork}`);
+            }
+        }
+        // Update usage tracking
+        managed.lastUsed = Date.now();
+        managed.refCount++;
+        return managed.client;
+    }
+    /**
+     * Get or create LitContracts instance (cached per client)
+     */
+    async getContracts(signer, config) {
+        const finalConfig = { ...this.defaultConfig, ...config };
+        const clientKey = this.getClientKey(finalConfig);
+        let managed = this.clients.get(clientKey);
+        if (!managed) {
+            // Get client first (will create if needed)
+            await this.getClient(config);
+            managed = this.clients.get(clientKey);
+        }
+        // Create contracts instance if not cached
+        if (!managed.contracts) {
+            if (this.debug) {
+                console.log(`🔌 Creating new LitContracts for ${finalConfig.litNetwork}`);
+            }
+            managed.contracts = new contracts_sdk_1.LitContracts({
+                signer,
+                network: finalConfig.litNetwork,
+                debug: finalConfig.debug,
+            });
+            await managed.contracts.connect();
+            if (this.debug) {
+                console.log(`✅ LitContracts connected for ${finalConfig.litNetwork}`);
+            }
+        }
+        else {
+            if (this.debug) {
+                console.log(`🔄 Reusing existing LitContracts for ${finalConfig.litNetwork}`);
+            }
+        }
+        // Update usage tracking
+        managed.lastUsed = Date.now();
+        managed.refCount++;
+        return managed.contracts;
+    }
+    /**
+     * Release a reference to a client
+     * Decrements reference count for cleanup purposes
+     */
+    releaseClient(config) {
+        const finalConfig = { ...this.defaultConfig, ...config };
+        const clientKey = this.getClientKey(finalConfig);
+        const managed = this.clients.get(clientKey);
+        if (managed && managed.refCount > 0) {
+            managed.refCount--;
+            if (this.debug) {
+                console.log(`📉 Released client reference for ${finalConfig.litNetwork} (refs: ${managed.refCount})`);
+            }
+        }
+    }
+    /**
+     * Force disconnect and cleanup all clients
+     * Also stops the cleanup timer to prevent Jest from hanging
+     */
+    async disconnectAll() {
+        if (this.debug) {
+            console.log(`🔌 Disconnecting ${this.clients.size} LIT clients...`);
+        }
+        for (const [key, managed] of this.clients.entries()) {
+            try {
+                await managed.client.disconnect();
+                if (this.debug) {
+                    console.log(`✅ Disconnected client: ${key}`);
+                }
+            }
+            catch (error) {
+                if (this.debug) {
+                    console.error(`❌ Error disconnecting client ${key}:`, error);
+                }
+            }
+        }
+        this.clients.clear();
+        // Stop the cleanup timer to prevent Jest from hanging
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+            if (this.debug) {
+                console.log(`✅ Cleanup timer stopped`);
+            }
+        }
+        if (this.debug) {
+            console.log(`✅ All LIT clients disconnected and cleaned up`);
+        }
+    }
+    /**
+     * Get connection statistics
+     */
+    getStats() {
+        const clientsByNetwork = {};
+        for (const [key, managed] of this.clients.entries()) {
+            clientsByNetwork[managed.network] = {
+                refCount: managed.refCount,
+                lastUsed: managed.lastUsed,
+            };
+        }
+        return {
+            totalClients: this.clients.size,
+            clientsByNetwork,
+        };
+    }
+    /**
+     * Private: Generate client key for caching
+     */
+    getClientKey(config) {
+        return `${config.litNetwork}-${config.debug}-${config.minNodeCount}`;
+    }
+    /**
+     * Private: Start cleanup timer for idle clients
+     */
+    startCleanupTimer() {
+        this.cleanupInterval = setInterval(() => {
+            this.cleanupIdleClients();
+        }, 5 * 60 * 1000); // Check every 5 minutes
+    }
+    /**
+     * Private: Cleanup clients that have been idle too long
+     */
+    async cleanupIdleClients() {
+        const now = Date.now();
+        const toRemove = [];
+        for (const [key, managed] of this.clients.entries()) {
+            // Only cleanup if no references and idle for too long
+            if (managed.refCount === 0 && now - managed.lastUsed > this.maxIdleTime) {
+                toRemove.push(key);
+            }
+        }
+        for (const key of toRemove) {
+            const managed = this.clients.get(key);
+            if (managed) {
+                try {
+                    await managed.client.disconnect();
+                    this.clients.delete(key);
+                    if (this.debug) {
+                        console.log(`🧹 Cleaned up idle client: ${key}`);
+                    }
+                }
+                catch (error) {
+                    if (this.debug) {
+                        console.error(`❌ Error cleaning up client ${key}:`, error);
+                    }
+                }
+            }
+        }
+    }
+}
+exports.LitClientManager = LitClientManager;
+//# sourceMappingURL=client-manager.module.js.map

package/dist/modules/client-manager.module.js.map

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

package/dist/modules/lit-ops.module.d.ts

@@ -0,0 +1,261 @@
+/**
+ * LIT-OPS Main Module
+ * Diamond Hands Protocol - LIT Protocol Operations
+ *
+ * Main LitOps class providing decoupled LIT Protocol operations supporting:
+ * - Standalone mode: User pays LIT tokens directly
+ * - Service mode: Backend service handles LIT token costs
+ */
+import { ethers as ethers5 } from "ethers";
+import { LitOpsConfig } from "../interfaces";
+export declare class LitOps {
+    private config;
+    private clientManager;
+    private pkpManager;
+    private actionExecutor;
+    private pkpSigner;
+    private pkpMacroUtils;
+    private pkpMinter;
+    private pkpAuthorizer;
+    private authManager;
+    private sessionManager;
+    constructor(config: LitOpsConfig);
+    /**
+     * Create a new PKP
+     */
+    createPKP(signer?: ethers5.Signer, litActionCid?: string): Promise<import("../interfaces").PKPCreationResult>;
+    /**
+     * Validate a PKP
+     */
+    validatePKP(pkpId: string, signer?: ethers5.Signer): Promise<import("../interfaces").PKPValidationResult>;
+    /**
+     * Burn a PKP
+     */
+    burnPKP(pkpId: string, signer?: ethers5.Signer, reason?: string): Promise<import("../interfaces").PKPBurnResult>;
+    /**
+     * Execute a LIT Action from CID
+     */
+    executeActionFromCID(cid: string, pkpPublicKey: string, params: Record<string, any>, signer?: ethers5.Signer): Promise<import("../interfaces").LitActionExecutionResult>;
+    /**
+     * Execute a LIT Action from code
+     */
+    executeActionFromCode(code: string, pkpPublicKey: string, params: Record<string, any>, signer?: ethers5.Signer): Promise<import("../interfaces").LitActionExecutionResult>;
+    /**
+     * Sign a message using PKP via LIT Action (Golden Implementation)
+     * This is the main PKP signing method that can create PKP if needed
+     *
+     * If pkpPublicKey is empty, it will:
+     * 1. Create a new PKP
+     * 2. Authorize the LIT Action
+     * 3. Burn the PKP for immutability
+     * 4. Sign the message
+     *
+     * If pkpPublicKey is provided, it will directly sign with existing PKP
+     */
+    signMessageWithPKP(message: string, pkpPublicKey: string, litActionCid: string, signer: ethers5.Signer, pkpEthAddress?: string): Promise<import("./pkp-signer.module").PKPSigningResult>;
+    /**
+     * Create PKP with full workflow (Create + Authorize + Burn)
+     * This method provides the complete PKP creation workflow suitable for production use.
+     * Returns all necessary data for subsequent signing operations.
+     *
+     * @param litActionCid - The LIT Action CID to authorize for this PKP
+     * @param signer - The wallet to use for PKP creation and transactions
+     * @returns Complete PKP data including tokenId, publicKey, ethAddress, etc.
+     */
+    createProductionPKP(litActionCid: string, signer: ethers5.Signer): Promise<import("./pkp-macros.module").PKPCompleteWorkflowResult>;
+    /**
+     * Sign message with existing PKP data
+     * This method takes the result from createProductionPKP and signs a message.
+     * Perfect for two-step workflow: create PKP, then sign multiple messages.
+     *
+     * @param message - The message to sign
+     * @param pkpData - PKP data from createProductionPKP or compatible interface
+     * @param litActionCid - The LIT Action CID to use for signing
+     * @param signer - The wallet to use for session signatures
+     * @returns Signature result with verification data
+     */
+    signWithExistingPKP(message: string, pkpData: {
+        publicKey: string;
+        ethAddress: string;
+        permittedActions: string[];
+    }, litActionCid: string, signer: ethers5.Signer): Promise<import("./pkp-signer.module").PKPSigningResult>;
+    /**
+     * Get configuration
+     */
+    getConfig(): LitOpsConfig;
+    /**
+     * Get client status
+     */
+    getStatus(): {
+        config: LitOpsConfig;
+        client: {
+            totalClients: number;
+            clientsByNetwork: Record<string, {
+                refCount: number;
+                lastUsed: number;
+            }>;
+        };
+    };
+    /**
+     * Validate PKP Security via LIT Action
+     *
+     * This method executes the pkp-validator LIT Action to validate that a PKP is:
+     * - Created (exists on-chain)
+     * - Immutable (transferred to burn address)
+     * - Has only one authorized action
+     * - Authorized for the expected CID
+     *
+     * @param targetPkpTokenId - The PKP token ID to validate
+     * @param expectedCid - The expected CID in hex format (0x...)
+     * @param signerPkp - The PKP to use for signing the LIT Action (should be PKP_VALIDATOR_PKP)
+     * @param signer - The wallet to use for session signatures
+     * @returns PKP validation result with signature verification
+     */
+    validatePKPSecurity(targetPkpTokenId: string, expectedCid: string, signerPkp: {
+        tokenId: string;
+        publicKey: string;
+        ethAddress: string;
+    }, signer: ethers5.Signer): Promise<{
+        success: boolean;
+        signature?: string;
+        error?: string;
+        signatureValid: boolean;
+        pkpAddress?: string;
+        recoveredAddress?: string;
+        validationResult?: {
+            exists: boolean;
+            isImmutable: boolean;
+            hasOnlyOneAction: boolean;
+            matchesExpectedCID: boolean;
+            allValid: boolean;
+        };
+    }>;
+    /**
+     * Ultimate PKP Macro: Create and Validate PKP to LIT Action
+     *
+     * This is the ultimate PKP security macro that combines:
+     * 1. PKP creation
+     * 2. LIT Action authorization
+     * 3. PKP immutability (burn to dead address)
+     * 4. PKP security validation via pkp-validator LIT Action
+     *
+     * Returns complete PKP data and cryptographic proof of security.
+     *
+     * @param litActionCid - The LIT Action CID to authorize for this PKP
+     * @param signer - Optional signer (required for standalone mode, not used in service mode)
+     * @returns Complete PKP creation and validation result with audit trail
+     */
+    createAndValidatePkpToLitAction(litActionCid: string, signer?: ethers5.Signer): Promise<{
+        success: boolean;
+        error?: string;
+        timestamp: number;
+        duration: number;
+        targetCid: string;
+        pkpData: {
+            tokenId: string;
+            publicKey: string;
+            ethAddress: string;
+            mintTransactionHash: string;
+            verified: boolean;
+            owner: string;
+            authTransactionHash: string;
+            isPermitted: boolean;
+            permittedActions: string[];
+            burnTransactionHash?: string;
+            burned?: boolean;
+            workflow: string;
+            timestamp: number;
+            duration: number;
+        };
+        validationResult: {
+            success: boolean;
+            signature?: string;
+            error?: string;
+            signatureValid: boolean;
+            pkpAddress?: string;
+            recoveredAddress?: string;
+            validationResult?: {
+                exists: boolean;
+                isImmutable: boolean;
+                hasOnlyOneAction: boolean;
+                matchesExpectedCID: boolean;
+                allValid: boolean;
+            };
+        };
+        auditTrail: {
+            steps: Array<{
+                step: number;
+                description: string;
+                timestamp: number;
+                duration: number;
+                success: boolean;
+                data?: any;
+            }>;
+            totalDuration: number;
+        };
+    }>;
+    /**
+     * Production method: Create a new Diamond Hands Loan PKP
+     *
+     * This is the main method that will be called in production.
+     * Creates a new PKP specifically for Diamond Hands loans, using the
+     * authorization dummy CID from dh-lit-actions package.
+     *
+     * @param signer - Optional signer (required for standalone mode, not used in service mode)
+     * @returns Complete PKP creation and validation result
+     */
+    getNewDiamondHandsLoanPkp(signer?: ethers5.Wallet): Promise<{
+        success: boolean;
+        error?: string;
+        timestamp: number;
+        duration: number;
+        targetCid: string;
+        pkpData: {
+            tokenId: string;
+            publicKey: string;
+            ethAddress: string;
+            mintTransactionHash: string;
+            verified: boolean;
+            owner: string;
+            authTransactionHash: string;
+            isPermitted: boolean;
+            permittedActions: string[];
+            burnTransactionHash?: string;
+            burned?: boolean;
+            workflow: string;
+            timestamp: number;
+            duration: number;
+        };
+        validationResult: {
+            success: boolean;
+            signature?: string;
+            error?: string;
+            signatureValid: boolean;
+            pkpAddress?: string;
+            recoveredAddress?: string;
+            validationResult?: {
+                exists: boolean;
+                isImmutable: boolean;
+                hasOnlyOneAction: boolean;
+                matchesExpectedCID: boolean;
+                allValid: boolean;
+            };
+        };
+        auditTrail: {
+            steps: Array<{
+                step: number;
+                description: string;
+                timestamp: number;
+                duration: number;
+                success: boolean;
+                data?: any;
+            }>;
+            totalDuration: number;
+        };
+    }>;
+    /**
+     * Cleanup - disconnect all clients
+     */
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=lit-ops.module.d.ts.map

package/dist/modules/lit-ops.module.d.ts.map

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