@gvnrdao/dh-sdk 0.0.157 → 0.0.158

package/dist/index.js

@@ -12745,47 +12745,45 @@ var init_deployment_addresses = __esm({
     };
     LOCALHOST_DEPLOYMENT = {
       network: "localhost",
-      chainId: 31337,
-      timestamp: "2026-02-16T15:23:50.854Z",
-      deployer: "",
+      chainId: 1337,
+      timestamp: "2026-02-09T10:20:16.663Z",
+      deployer: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
       contracts: {
-        UpgradeValidator: "0x8A791620dd6260079BF849Dc5567aDC3F2FdC318",
+        UpgradeValidator: "0x2279B7A0a67DB372996a5FaB50D91eAA73d2eBe6",
         UCDToken: "0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512",
         UCDController: "0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9",
-        PriceFeedConsumer: "0xB7f8BC63BbcaD18155201308C8f3540b07f84F5e",
-        UCDMintingRewards: "0x0DCd1Bf9A1b36cE34237eEaFef220932846BCD82",
-        PositionManagerCoreModule: "0x0B306BF915C4d645ff596e518fAf3F9669b97016",
-        TermManagerModule: "0x9A9f2CCfdE556A7E9Ff0848998Aa4a0CFD8863AE",
-        LoanOperationsManagerModule: "0x4ed7c70F96B99c776995fB64377f0d4aB3B0e1C1",
-        CollateralManagerModule: "0xa85233C63b9Ee964Add6F2cffe00Fd84eb32338f",
-        LiquidationManagerModule: "0x7a2088a1bFc9d81c55368AE168C2C02570cB814F",
-        CircuitBreakerModule: "0x3Aa5ebB10DC797CAC828524e59A333d0A371443c",
-        CommunityManagerModule: "0xc5a5C42992dECbae36851359345FE25997F5C42d",
-        AdminModule: "0xE6E340D132b5f46d1e472DebcD681B2aBc16e57E",
-        PositionManagerViews: "0xc6e7DF5E7b4f2A278906862b61205850344D4e7d",
-        PositionManager: "0x84eA74d481Ee0A5332c457a4d796187F6Ba67fEB",
-        OperationAuthorizationRegistry: "0x9d4454B023096f34B160D6B654540c56A1F81688",
-        PKPValidation: "0x4c5859f0F772848b2D91F1D83E2Fe57935348029"
+        PriceFeedConsumer: "0x610178dA211FEF7D417bC0e6FeD39F05609AD788",
+        UCDMintingRewards: "0xA51c1fc2f0D1a1b8494Ed1FE312d7C3a78Ed91C0",
+        PositionManagerCoreModule: "0x9A676e781A523b5d0C0e43731313A708CB607508",
+        TermManagerModule: "0x959922bE3CAee4b8Cd9a407cc3ac1C251C2007B1",
+        LoanOperationsManagerModule: "0x59b670e9fA9D0A427751Af201D676719a970857b",
+        CollateralManagerModule: "0x322813Fd9A801c5507c9de605d63CEA4f2CE6c44",
+        LiquidationManagerModule: "0x4A679253410272dd5232B3Ff7cF5dbB88f295319",
+        CircuitBreakerModule: "0x68B1D87F95878fE05B998F19b66F4baba5De1aed",
+        CommunityManagerModule: "0x09635F643e140090A9A8Dcd712eD6285858ceBef",
+        AdminModule: "0x67d269191c92Caf3cD7723F116c85e6E9bf55933",
+        PositionManagerViews: "0x3Aa5ebB10DC797CAC828524e59A333d0A371443c",
+        PositionManager: "0xc3e53F4d16Ae77Db1c982e75a937B9f60FE63690",
+        OperationAuthorizationRegistry: "0x8f86403A4DE0BB5791fa46B8e795C547942fE4Cf"
       }
     };
     LOCALHOST_CONTRACTS = {
-      UpgradeValidator: "0x8A791620dd6260079BF849Dc5567aDC3F2FdC318",
+      UpgradeValidator: "0x2279B7A0a67DB372996a5FaB50D91eAA73d2eBe6",
       UCDToken: "0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512",
       UCDController: "0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9",
-      PriceFeedConsumer: "0xB7f8BC63BbcaD18155201308C8f3540b07f84F5e",
-      UCDMintingRewards: "0x0DCd1Bf9A1b36cE34237eEaFef220932846BCD82",
-      PositionManagerCoreModule: "0x0B306BF915C4d645ff596e518fAf3F9669b97016",
-      TermManagerModule: "0x9A9f2CCfdE556A7E9Ff0848998Aa4a0CFD8863AE",
-      LoanOperationsManagerModule: "0x4ed7c70F96B99c776995fB64377f0d4aB3B0e1C1",
-      CollateralManagerModule: "0xa85233C63b9Ee964Add6F2cffe00Fd84eb32338f",
-      LiquidationManagerModule: "0x7a2088a1bFc9d81c55368AE168C2C02570cB814F",
-      CircuitBreakerModule: "0x3Aa5ebB10DC797CAC828524e59A333d0A371443c",
-      CommunityManagerModule: "0xc5a5C42992dECbae36851359345FE25997F5C42d",
-      AdminModule: "0xE6E340D132b5f46d1e472DebcD681B2aBc16e57E",
-      PositionManagerViews: "0xc6e7DF5E7b4f2A278906862b61205850344D4e7d",
-      PositionManager: "0x84eA74d481Ee0A5332c457a4d796187F6Ba67fEB",
-      OperationAuthorizationRegistry: "0x9d4454B023096f34B160D6B654540c56A1F81688",
-      PKPValidation: "0x4c5859f0F772848b2D91F1D83E2Fe57935348029"
+      PriceFeedConsumer: "0x610178dA211FEF7D417bC0e6FeD39F05609AD788",
+      UCDMintingRewards: "0xA51c1fc2f0D1a1b8494Ed1FE312d7C3a78Ed91C0",
+      PositionManagerCoreModule: "0x9A676e781A523b5d0C0e43731313A708CB607508",
+      TermManagerModule: "0x959922bE3CAee4b8Cd9a407cc3ac1C251C2007B1",
+      LoanOperationsManagerModule: "0x59b670e9fA9D0A427751Af201D676719a970857b",
+      CollateralManagerModule: "0x322813Fd9A801c5507c9de605d63CEA4f2CE6c44",
+      LiquidationManagerModule: "0x4A679253410272dd5232B3Ff7cF5dbB88f295319",
+      CircuitBreakerModule: "0x68B1D87F95878fE05B998F19b66F4baba5De1aed",
+      CommunityManagerModule: "0x09635F643e140090A9A8Dcd712eD6285858ceBef",
+      AdminModule: "0x67d269191c92Caf3cD7723F116c85e6E9bf55933",
+      PositionManagerViews: "0x3Aa5ebB10DC797CAC828524e59A333d0A371443c",
+      PositionManager: "0xc3e53F4d16Ae77Db1c982e75a937B9f60FE63690",
+      OperationAuthorizationRegistry: "0x8f86403A4DE0BB5791fa46B8e795C547942fE4Cf"
     };
     ALL_DEPLOYMENTS = {
       sepolia: SEPOLIA_DEPLOYMENT,
@@ -13121,7 +13119,7 @@ __export(src_exports, {
   ErrorCategory: () => ErrorCategory,
   ErrorSeverity: () => ErrorSeverity,
   EventHelpers: () => EventHelpers,
-  LRUCache: () => Cache,
+  LRUCache: () => LRUCache,
   LoanCreator: () => LoanCreator,
   LoanQuery: () => LoanQuery,
   LoanStatus: () => LoanStatus,
@@ -29632,7 +29630,8 @@ var PRICE_FEED_ABI = [
   "function getLatestPrice() external view returns (int256)"
 ];
 var TERM_MANAGER_ABI = [
-  "function getAvailableTerms() external view returns (uint256[] memory termIds, uint256[] memory durationDays, uint256[] memory interestRateBps)"
+  "function getAvailableTerms() external view returns (uint256[] memory termIds, uint256[] memory durationDays, uint256[] memory interestRateBps)",
+  "function getValidTermsWithFees() external view returns (uint256[] terms, uint88[] originationFees, uint88[] extensionFees)"
 ];
 var CIRCUIT_BREAKER_ABI = [
   "function isPaused() external view returns (bool)"
@@ -29944,106 +29943,333 @@ function createContractManager(config) {
 }
 
 // src/modules/cache/cache-manager.module.ts
-var Cache = class {
-  cache = /* @__PURE__ */ new Map();
+var LRUCache = class {
+  cache;
   maxSize;
   ttlMs;
-  constructor(config) {
-    this.maxSize = config.maxSize;
-    this.ttlMs = config.ttlMs;
+  debug;
+  name;
+  // Statistics
+  stats = {
+    hits: 0,
+    misses: 0,
+    evictions: 0
+  };
+  constructor(config = {}) {
+    this.cache = /* @__PURE__ */ new Map();
+    this.maxSize = config.maxSize || 1e3;
+    this.ttlMs = config.ttlMs || 6e4;
+    this.debug = config.debug || false;
+    this.name = config.name || "Cache";
+    if (this.debug) {
+      console.log(
+        `\u{1F4BE} [${this.name}] Initialized: maxSize=${this.maxSize}, ttl=${this.ttlMs}ms`
+      );
+    }
   }
   /**
    * Get value from cache
+   *
+   * Returns null if:
+   * - Key not found
+   * - Entry has expired
+   *
+   * @param key - Cache key
+   * @returns Cached value or null
    */
   get(key2) {
     const entry = this.cache.get(key2);
     if (!entry) {
-      return void 0;
+      this.stats.misses++;
+      if (this.debug) {
+        console.log(`\u274C [${this.name}] Cache MISS: ${String(key2)}`);
+      }
+      return null;
     }
-    const now2 = Date.now();
-    if (now2 - entry.timestamp > entry.ttl) {
+    if (this.isExpired(entry)) {
       this.cache.delete(key2);
-      return void 0;
+      this.stats.misses++;
+      if (this.debug) {
+        const age = Date.now() - entry.timestamp;
+        console.log(`\u23F0 [${this.name}] Cache EXPIRED: ${String(key2)} (age: ${age}ms)`);
+      }
+      return null;
+    }
+    entry.hits++;
+    entry.lastAccessed = Date.now();
+    this.cache.set(key2, entry);
+    this.stats.hits++;
+    if (this.debug) {
+      const age = Date.now() - entry.timestamp;
+      console.log(
+        `\u2705 [${this.name}] Cache HIT: ${String(key2)} (age: ${age}ms, hits: ${entry.hits})`
+      );
     }
     return entry.value;
   }
+  /**
+   * Get value from cache with Result wrapper
+   *
+   * Useful when you want to distinguish between "not found" and "expired"
+   */
+  getResult(key2) {
+    const value = this.get(key2);
+    if (value === null) {
+      return failure(
+        new SDKError({
+          message: `Cache miss for key: ${String(key2)}`,
+          category: "CACHE" /* CACHE */,
+          severity: "LOW" /* LOW */,
+          originalError: new Error("Cache miss")
+        })
+      );
+    }
+    return success(value);
+  }
   /**
    * Set value in cache
+   *
+   * If cache is full, evicts the least recently used entry
+   *
+   * @param key - Cache key
+   * @param value - Value to cache
+   * @param ttl - Optional custom TTL for this entry (ms)
    */
   set(key2, value, ttl) {
     if (this.cache.size >= this.maxSize && !this.cache.has(key2)) {
-      const firstKey = this.cache.keys().next().value;
-      if (firstKey) {
-        this.cache.delete(firstKey);
-      }
+      this.evictLRU();
     }
-    this.cache.set(key2, {
+    const entry = {
       value,
       timestamp: Date.now(),
-      ttl: ttl || this.ttlMs
-    });
+      hits: 0,
+      lastAccessed: Date.now()
+    };
+    this.cache.set(key2, entry);
+    if (this.debug) {
+      const effectiveTtl = ttl || this.ttlMs;
+      console.log(
+        `\u{1F4BE} [${this.name}] Cache SET: ${String(key2)} (ttl: ${effectiveTtl}ms, size: ${this.cache.size}/${this.maxSize})`
+      );
+    }
   }
   /**
-   * Check if key exists in cache
+   * Set value in cache with Result wrapper
+   */
+  setResult(key2, value, ttl) {
+    try {
+      this.set(key2, value, ttl);
+      return success(void 0);
+    } catch (error) {
+      return failure(
+        new SDKError({
+          message: `Failed to set cache value for key: ${String(key2)}`,
+          category: "CACHE" /* CACHE */,
+          severity: "MEDIUM" /* MEDIUM */,
+          originalError: error instanceof Error ? error : new Error(String(error))
+        })
+      );
+    }
+  }
+  /**
+   * Check if key exists in cache (without affecting stats)
    */
   has(key2) {
-    return this.get(key2) !== void 0;
+    const entry = this.cache.get(key2);
+    return entry !== void 0 && !this.isExpired(entry);
   }
   /**
-   * Delete key from cache
+   * Delete specific key from cache
    */
   delete(key2) {
-    return this.cache.delete(key2);
+    const deleted = this.cache.delete(key2);
+    if (deleted && this.debug) {
+      console.log(`\u{1F5D1}\uFE0F  [${this.name}] Cache DELETE: ${String(key2)}`);
+    }
+    return deleted;
   }
   /**
-   * Clear all cache entries
+   * Clear entire cache
    */
   clear() {
+    const previousSize = this.cache.size;
     this.cache.clear();
+    this.stats = {
+      hits: 0,
+      misses: 0,
+      evictions: 0
+    };
+    if (this.debug) {
+      console.log(`\u{1F9F9} [${this.name}] Cache CLEARED: removed ${previousSize} entries`);
+    }
+  }
+  /**
+   * Get current cache size
+   */
+  size() {
+    return this.cache.size;
   }
   /**
-   * Clean expired entries
+   * Get cache statistics
+   */
+  getStats() {
+    const entries = Array.from(this.cache.values());
+    const timestamps = entries.map((e) => e.timestamp);
+    const total = this.stats.hits + this.stats.misses;
+    const hitRate = total === 0 ? 0 : this.stats.hits / total * 100;
+    return {
+      size: this.cache.size,
+      hits: this.stats.hits,
+      misses: this.stats.misses,
+      evictions: this.stats.evictions,
+      oldestEntry: timestamps.length > 0 ? Math.min(...timestamps) : 0,
+      newestEntry: timestamps.length > 0 ? Math.max(...timestamps) : 0,
+      hitRate
+    };
+  }
+  /**
+   * Get hit rate percentage
+   */
+  getHitRate() {
+    const total = this.stats.hits + this.stats.misses;
+    return total === 0 ? 0 : this.stats.hits / total * 100;
+  }
+  /**
+   * Get all cached keys (for debugging)
+   */
+  getKeys() {
+    return Array.from(this.cache.keys());
+  }
+  /**
+   * Get all cached values (for debugging)
+   */
+  getValues() {
+    return Array.from(this.cache.values()).map((entry) => entry.value);
+  }
+  /**
+   * Get all cache entries with metadata (for debugging)
+   */
+  getEntries() {
+    return Array.from(this.cache.entries()).map(([key2, entry]) => ({
+      key: key2,
+      value: entry.value,
+      metadata: {
+        timestamp: entry.timestamp,
+        hits: entry.hits,
+        lastAccessed: entry.lastAccessed
+      }
+    }));
+  }
+  /**
+   * Clean up expired entries
+   *
+   * Useful for periodic maintenance
+   *
+   * @returns Number of entries cleaned
    */
   cleanExpired() {
     const now2 = Date.now();
-    let cleaned = 0;
+    let cleanedCount = 0;
     for (const [key2, entry] of this.cache.entries()) {
-      if (now2 - entry.timestamp > entry.ttl) {
+      if (now2 - entry.timestamp > this.ttlMs) {
         this.cache.delete(key2);
-        cleaned++;
+        cleanedCount++;
       }
     }
-    return cleaned;
+    if (cleanedCount > 0 && this.debug) {
+      console.log(`\u{1F9F9} [${this.name}] Cleaned ${cleanedCount} expired entries`);
+    }
+    return cleanedCount;
   }
   /**
-   * Get cache statistics
+   * Check if cache entry is expired
    */
-  getStats() {
-    return {
-      size: this.cache.size,
-      maxSize: this.maxSize,
-      ttlMs: this.ttlMs
-    };
+  isExpired(entry) {
+    return Date.now() - entry.timestamp > this.ttlMs;
+  }
+  /**
+   * Evict least recently used entry
+   */
+  evictLRU() {
+    let oldestKey = null;
+    let oldestAccess = Infinity;
+    for (const [key2, entry] of this.cache.entries()) {
+      if (entry.lastAccessed < oldestAccess) {
+        oldestAccess = entry.lastAccessed;
+        oldestKey = key2;
+      }
+    }
+    if (oldestKey !== null) {
+      this.cache.delete(oldestKey);
+      this.stats.evictions++;
+      if (this.debug) {
+        const timeSinceAccess = Date.now() - oldestAccess;
+        console.log(
+          `\u267B\uFE0F  [${this.name}] Cache EVICT (LRU): ${String(oldestKey)} (last accessed: ${timeSinceAccess}ms ago)`
+        );
+      }
+    }
+  }
+  /**
+   * Get or compute value
+   *
+   * If key exists in cache, returns cached value.
+   * Otherwise, computes value using provided function and caches it.
+   *
+   * @param key - Cache key
+   * @param compute - Function to compute value if not in cache
+   * @param ttl - Optional custom TTL for this entry
+   * @returns Cached or computed value
+   */
+  async getOrCompute(key2, compute, ttl) {
+    const cached = this.get(key2);
+    if (cached !== null) {
+      return cached;
+    }
+    const value = await compute();
+    this.set(key2, value, ttl);
+    return value;
+  }
+  /**
+   * Get or compute value with Result wrapper
+   */
+  async getOrComputeResult(key2, compute, ttl) {
+    const cached = this.get(key2);
+    if (cached !== null) {
+      return success(cached);
+    }
+    const result = await compute();
+    if (result.success) {
+      this.set(key2, result.value, ttl);
+    }
+    return result;
   }
 };
 var CacheManager = class {
   caches = /* @__PURE__ */ new Map();
-  debug;
-  constructor(config = {}) {
-    this.debug = config.debug || false;
+  globalConfig;
+  constructor(globalConfig = {}) {
+    this.globalConfig = globalConfig;
   }
   /**
-   * Get or create a cache instance
+   * Create or get a named cache
+   *
+   * @param name - Unique cache name
+   * @param config - Optional cache-specific configuration
+   * @returns LRU cache instance
    */
   getCache(name, config) {
-    if (this.caches.has(name)) {
-      return this.caches.get(name);
+    const existingCache = this.caches.get(name);
+    if (existingCache) {
+      return existingCache;
     }
-    const cache = new Cache(config);
+    const mergedConfig = {
+      ...this.globalConfig,
+      ...config,
+      name
+    };
+    const cache = new LRUCache(mergedConfig);
     this.caches.set(name, cache);
-    if (this.debug) {
-      console.log(`[CacheManager] Created cache: ${name}`, config);
-    }
     return cache;
   }
   /**
@@ -30058,11 +30284,11 @@ var CacheManager = class {
    * Clean expired entries from all caches
    */
   cleanAllExpired() {
-    let total = 0;
+    let totalCleaned = 0;
     for (const cache of this.caches.values()) {
-      total += cache.cleanExpired();
+      totalCleaned += cache.cleanExpired();
     }
-    return total;
+    return totalCleaned;
   }
   /**
    * Get statistics for all caches
@@ -30075,11 +30301,16 @@ var CacheManager = class {
     return stats;
   }
   /**
-   * Destroy cache manager
+   * Get list of all cache names
    */
-  destroy() {
-    this.clearAll();
-    this.caches.clear();
+  getCacheNames() {
+    return Array.from(this.caches.keys());
+  }
+  /**
+   * Delete a named cache
+   */
+  deleteCache(name) {
+    return this.caches.delete(name);
   }
 };
 function createCacheManager(config) {