@gvnrdao/dh-sdk 0.0.205 → 0.0.207

package/dist/index.js

@@ -12962,68 +12962,66 @@ var init_deployment_addresses = __esm({
     LOCALHOST_DEPLOYMENT = {
       network: "localhost",
       chainId: 31337,
-      timestamp: "2026-04-23T13:26:13.607Z",
+      timestamp: "2026-03-23T15:33:34.068Z",
       deployer: "",
       contracts: {
-        MessageHashBuilder: "0x84eA74d481Ee0A5332c457a4d796187F6Ba67fEB",
-        UpgradeValidator: "0x610178dA211FEF7D417bC0e6FeD39F05609AD788",
+        MessageHashBuilder: "0xE6E340D132b5f46d1e472DebcD681B2aBc16e57E",
+        UpgradeValidator: "0x8A791620dd6260079BF849Dc5567aDC3F2FdC318",
         UCDToken: "0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512",
         UCDController: "0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9",
-        PositionManagerCoreModule: "0xA51c1fc2f0D1a1b8494Ed1FE312d7C3a78Ed91C0",
-        TermManagerModule: "0x9A676e781A523b5d0C0e43731313A708CB607508",
-        LoanOperationsManagerModule: "0x3Aa5ebB10DC797CAC828524e59A333d0A371443c",
+        PositionManagerCoreModule: "0xB7f8BC63BbcaD18155201308C8f3540b07f84F5e",
+        TermManagerModule: "0x0DCd1Bf9A1b36cE34237eEaFef220932846BCD82",
+        LoanOperationsManagerModule: "0x68B1D87F95878fE05B998F19b66F4baba5De1aed",
         BTCSpendAuthorizer: "0x59b670e9fA9D0A427751Af201D676719a970857b",
         CollateralManagerModule: "0xa85233C63b9Ee964Add6F2cffe00Fd84eb32338f",
         LiquidationManagerModule: "0x7a2088a1bFc9d81c55368AE168C2C02570cB814F",
-        CircuitBreakerModule: "0x959922bE3CAee4b8Cd9a407cc3ac1C251C2007B1",
+        CircuitBreakerModule: "0x0B306BF915C4d645ff596e518fAf3F9669b97016",
         AdminModule: "0xc5a5C42992dECbae36851359345FE25997F5C42d",
-        PositionManagerViews: "0x9A9f2CCfdE556A7E9Ff0848998Aa4a0CFD8863AE",
-        PositionManager: "0xa82fF9aFd8f496c3d6ac40E2a0F282E47488CFc9",
-        OperationAuthorizationRegistry: "0x5081a39b8A5f0E35a8D959395a630b68B74Dd30f",
-        PKPValidation: "0x04C89607413713Ec9775E14b954286519d836FEf"
+        PositionManagerViews: "0x959922bE3CAee4b8Cd9a407cc3ac1C251C2007B1",
+        PositionManager: "0x84eA74d481Ee0A5332c457a4d796187F6Ba67fEB",
+        OperationAuthorizationRegistry: "0x7969c5eD335650692Bc04293B07F5BF2e7A673C0",
+        PKPValidation: "0xcbEAF3BDe82155F56486Fb5a1072cb8baAf547cc"
       },
       latestEnv: {
         UCD_TOKEN: "0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512",
         UCD_CONTROLLER: "0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9",
-        POSITION_MANAGER: "0xa82fF9aFd8f496c3d6ac40E2a0F282E47488CFc9",
-        PKP_VALIDATION_REGISTRY: "0x04C89607413713Ec9775E14b954286519d836FEf",
-        PKP_VALIDATION_CID_V1: "0x12200ba1a8948ea70b30205d738407bc9ed00ccb456bf78d8cad1a7574eafd3da24b",
-        PKP_VALIDATION_CID_V3: "0x12200ba1a8948ea70b30205d738407bc9ed00ccb456bf78d8cad1a7574eafd3da24b",
-        PKP_ETH_ADDRESS: "0xBC9de87F56856F0D424d705911c07dE213544172",
-        OPERATION_AUTHORIZATION_REGISTRY: "0x5081a39b8A5f0E35a8D959395a630b68B74Dd30f",
-        UCD_MINT_VALIDATOR_ADDRESS: "0xC6E57a5d65e43910Fe70667C97D193FAF6dDF598",
+        POSITION_MANAGER: "0x84eA74d481Ee0A5332c457a4d796187F6Ba67fEB",
+        PKP_VALIDATION_REGISTRY: "0xcbEAF3BDe82155F56486Fb5a1072cb8baAf547cc",
+        PKP_VALIDATION_CID_V1: "QmfHJKA4RnW7RepsdLmrDwKjVTzPXB2K3qMTco3JNPDexm",
+        PKP_ETH_ADDRESS: "0x9624C46073E1d1F5AB975c67Fc899536d599bb57",
+        OPERATION_AUTHORIZATION_REGISTRY: "0x7969c5eD335650692Bc04293B07F5BF2e7A673C0",
+        UCD_MINT_VALIDATOR_ADDRESS: "0x80f81afb9e6dF27afCD752ad46cD286e705e42be",
         UCD_MINT_VALIDATOR_VERSION: 1,
-        BTC_WITHDRAWAL_VALIDATOR_ADDRESS: "0xe3B7bc797fA187AB9e29266bE8E01d58Cd49A6E9",
+        BTC_WITHDRAWAL_VALIDATOR_ADDRESS: "0xa751ad81E1CAe61d6cF5Cf64839Fe8D28A1372Df",
         BTC_WITHDRAWAL_VALIDATOR_VERSION: 1,
-        UPDATE_BALANCE_VALIDATOR_ADDRESS: "0x9e1831004c7ccf088468dC18F70b1B80c6Ec0c56",
+        UPDATE_BALANCE_VALIDATOR_ADDRESS: "0x8A40C22B03348bc10df9ae0dc54346b4AE8e909c",
         UPDATE_BALANCE_VALIDATOR_VERSION: 1,
-        PROCESS_PAYMENT_VALIDATOR_ADDRESS: "0x2297DabE0220a999d01B5BB603Ff2433CF908043",
+        PROCESS_PAYMENT_VALIDATOR_ADDRESS: "0x28f50E07532d3aF677b8E0bcF220422d159b0dd6",
         PROCESS_PAYMENT_VALIDATOR_VERSION: 1,
-        EXTEND_POSITION_VALIDATOR_ADDRESS: "0x57d0f6E62b8f592dd23DEbD5F60dDEc843cd1835",
+        EXTEND_POSITION_VALIDATOR_ADDRESS: "0xc7aC43F2F907123465449575e853f5D0229898e1",
         EXTEND_POSITION_VALIDATOR_VERSION: 1,
-        POSITION_MANAGER_CORE_MODULE: "0xA51c1fc2f0D1a1b8494Ed1FE312d7C3a78Ed91C0",
-        LOAN_OPERATIONS_MANAGER_MODULE: "0x3Aa5ebB10DC797CAC828524e59A333d0A371443c",
-        TERM_MANAGER_MODULE: "0x9A676e781A523b5d0C0e43731313A708CB607508",
-        COMMUNITY_MANAGER_MODULE: ""
+        POSITION_MANAGER_CORE_MODULE: "0xB7f8BC63BbcaD18155201308C8f3540b07f84F5e",
+        LOAN_OPERATIONS_MANAGER_MODULE: "0x68B1D87F95878fE05B998F19b66F4baba5De1aed",
+        TERM_MANAGER_MODULE: "0x0DCd1Bf9A1b36cE34237eEaFef220932846BCD82"
       }
     };
     LOCALHOST_CONTRACTS = {
-      MessageHashBuilder: "0x84eA74d481Ee0A5332c457a4d796187F6Ba67fEB",
-      UpgradeValidator: "0x610178dA211FEF7D417bC0e6FeD39F05609AD788",
+      MessageHashBuilder: "0xE6E340D132b5f46d1e472DebcD681B2aBc16e57E",
+      UpgradeValidator: "0x8A791620dd6260079BF849Dc5567aDC3F2FdC318",
       UCDToken: "0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512",
       UCDController: "0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9",
-      PositionManagerCoreModule: "0xA51c1fc2f0D1a1b8494Ed1FE312d7C3a78Ed91C0",
-      TermManagerModule: "0x9A676e781A523b5d0C0e43731313A708CB607508",
-      LoanOperationsManagerModule: "0x3Aa5ebB10DC797CAC828524e59A333d0A371443c",
+      PositionManagerCoreModule: "0xB7f8BC63BbcaD18155201308C8f3540b07f84F5e",
+      TermManagerModule: "0x0DCd1Bf9A1b36cE34237eEaFef220932846BCD82",
+      LoanOperationsManagerModule: "0x68B1D87F95878fE05B998F19b66F4baba5De1aed",
       BTCSpendAuthorizer: "0x59b670e9fA9D0A427751Af201D676719a970857b",
       CollateralManagerModule: "0xa85233C63b9Ee964Add6F2cffe00Fd84eb32338f",
       LiquidationManagerModule: "0x7a2088a1bFc9d81c55368AE168C2C02570cB814F",
-      CircuitBreakerModule: "0x959922bE3CAee4b8Cd9a407cc3ac1C251C2007B1",
+      CircuitBreakerModule: "0x0B306BF915C4d645ff596e518fAf3F9669b97016",
       AdminModule: "0xc5a5C42992dECbae36851359345FE25997F5C42d",
-      PositionManagerViews: "0x9A9f2CCfdE556A7E9Ff0848998Aa4a0CFD8863AE",
-      PositionManager: "0xa82fF9aFd8f496c3d6ac40E2a0F282E47488CFc9",
-      OperationAuthorizationRegistry: "0x5081a39b8A5f0E35a8D959395a630b68B74Dd30f",
-      PKPValidation: "0x04C89607413713Ec9775E14b954286519d836FEf"
+      PositionManagerViews: "0x959922bE3CAee4b8Cd9a407cc3ac1C251C2007B1",
+      PositionManager: "0x84eA74d481Ee0A5332c457a4d796187F6Ba67fEB",
+      OperationAuthorizationRegistry: "0x7969c5eD335650692Bc04293B07F5BF2e7A673C0",
+      PKPValidation: "0xcbEAF3BDe82155F56486Fb5a1072cb8baAf547cc"
     };
     ALL_DEPLOYMENTS = {
       sepolia: SEPOLIA_DEPLOYMENT,
@@ -13349,7 +13347,7 @@ __export(src_exports, {
   ErrorSeverity: () => ErrorSeverity,
   EventHelpers: () => EventHelpers,
   LOCALHOST_CONTRACTS: () => LOCALHOST_CONTRACTS,
-  LRUCache: () => Cache,
+  LRUCache: () => LRUCache,
   LoanCreator: () => LoanCreator,
   LoanQuery: () => LoanQuery,
   LoanStatus: () => LoanStatus,
@@ -29565,8 +29563,6 @@ function validateQuantumTiming(signedTimestamp, _bufferSeconds = 30) {
 var PKP_NFT_ABI = [
   "function getPubkey(uint256 tokenId) external view returns (bytes memory)"
 ];
-var CHIPOTLE_RPC_URL = "https://yellowstone-rpc.litprotocol.com";
-var CHIPOTLE_CHAIN_ID = 175188;
 async function generateMintAuthorization(positionId, amount, chainId, signerOrPrecomputed) {
   if (typeof signerOrPrecomputed === "object" && "signature" in signerOrPrecomputed && !("signMessage" in signerOrPrecomputed)) {
     const { timestamp: timestamp2, signature: signature3 } = signerOrPrecomputed;
@@ -29666,18 +29662,14 @@ async function generatePaymentAuthorization(positionId, amount, chainId, signer)
   };
 }
 async function getPKPPublicKeyFromTokenId(pkpTokenId, provider, pkpNftContractAddress) {
-  const targetRpc = CHIPOTLE_RPC_URL;
-  const targetChainId = CHIPOTLE_CHAIN_ID;
-  let litChainProvider;
-  if (provider) {
-    const network = await provider.getNetwork();
-    if (network.chainId === targetChainId) {
-      litChainProvider = provider;
-    } else {
-      litChainProvider = new ethers_exports.providers.JsonRpcProvider(targetRpc);
-    }
-  } else {
-    litChainProvider = new ethers_exports.providers.JsonRpcProvider(targetRpc);
+  const rawHex = pkpTokenId.startsWith("0x") ? pkpTokenId.slice(2) : pkpTokenId;
+  if (rawHex.length === 64 && rawHex.startsWith("000000000000000000000000") && rawHex !== "0".repeat(64)) {
+    throw new Error(
+      `pkpId ${pkpTokenId} is a Chipotle wallet address (ABI-encoded ETH address). Chipotle PKPs are not NFTs and have no on-chain public key lookup. Ensure the PKP public key is populated in cache during position creation.`
+    );
+  }
+  if (!provider) {
+    throw new Error(`provider is required for getPKPPublicKeyFromTokenId`);
   }
   if (!pkpNftContractAddress) {
     throw new Error(
@@ -29687,7 +29679,7 @@ async function getPKPPublicKeyFromTokenId(pkpTokenId, provider, pkpNftContractAd
   const pkpNft = new ethers_exports.Contract(
     pkpNftContractAddress,
     PKP_NFT_ABI,
-    litChainProvider
+    provider
   );
   const tokenIdBN = ethers_exports.BigNumber.from(pkpTokenId);
   const pubkeyBytes = await pkpNft["getPubkey"](tokenIdBN);
@@ -30292,106 +30284,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;
+  }
+  /**
+   * 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 expired entries
+   * 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;
   }
   /**
@@ -30406,11 +30625,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
@@ -30423,11 +30642,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) {
@@ -31706,6 +31930,23 @@ function createLoanCreator(config) {
 }
 
 // src/modules/loan/loan-query.module.ts
+var POSITION_CORE_ABI = [
+  "function getPositionDetails(bytes32) view returns (tuple(bytes32 positionId, bytes32 pkpId, uint256 ucdDebt, string vaultAddress, address borrower, uint40 createdAt, uint40 lastUpdated, uint16 selectedTerm, uint40 expiryAt, bool isActive, uint8 status))"
+];
+function normalizePkpId(pkpId) {
+  const raw = pkpId.startsWith("0x") ? pkpId.slice(2) : pkpId;
+  if (raw.length === 64 && raw.startsWith("000000000000000000000000") && raw !== "0".repeat(64)) {
+    return `0x${raw.slice(24)}`;
+  }
+  return pkpId;
+}
+function padPkpIdForSubgraph(pkpId) {
+  const raw = pkpId.startsWith("0x") ? pkpId.slice(2) : pkpId;
+  if (raw.length === 40) {
+    return `0x${"0".repeat(24)}${raw}`;
+  }
+  return pkpId;
+}
 var LoanQuery = class {
   config;
   defaultPageSize;
@@ -31734,7 +31975,7 @@ var LoanQuery = class {
         const borrowerCreatedAt = typeof rawLoan.borrower === "object" && rawLoan.borrower?.createdAt ? Number(rawLoan.borrower.createdAt) : 0;
         const loanData = {
           id: rawLoan.id,
-          pkpId: rawLoan.pkpId,
+          pkpId: normalizePkpId(rawLoan.pkpId),
           borrower: {
             createdAt: borrowerCreatedAt,
             id: borrowerId
@@ -31780,6 +32021,7 @@ var LoanQuery = class {
    * @returns Loan data
    */
   async getLoanByPkpId(pkpId, enrichBalance = false) {
+    pkpId = padPkpIdForSubgraph(pkpId);
     if (this.config.debug) {
       log.info("\u{1F50D} Querying loan by PKP ID", { pkpId, enrichBalance });
     }
@@ -31802,7 +32044,7 @@ var LoanQuery = class {
         const borrowerCreatedAt = typeof rawLoan.borrower === "object" && rawLoan.borrower?.createdAt ? Number(rawLoan.borrower.createdAt) : 0;
         const loanData = {
           id: rawLoan.id,
-          pkpId: rawLoan.pkpId,
+          pkpId: normalizePkpId(rawLoan.pkpId),
           borrower: {
             createdAt: borrowerCreatedAt,
             id: borrowerId
@@ -31981,10 +32223,30 @@ var LoanQuery = class {
       await Promise.all(
         batch.map(async (loan) => {
           try {
-            const pkpPublicKey = await getPKPPublicKeyFromTokenId(
-              loan.pkpId,
-              this.config.provider
-            );
+            const rawId = loan.pkpId?.startsWith("0x") ? loan.pkpId.slice(2) : loan.pkpId;
+            const isChipotlePkpId = typeof rawId === "string" && rawId.length === 40 && !rawId.toLowerCase().startsWith("04");
+            if (isChipotlePkpId) {
+              if (this.config.positionManagerCoreAddress && this.config.provider) {
+                const pmContract = new ethers_exports.Contract(
+                  this.config.positionManagerCoreAddress,
+                  POSITION_CORE_ABI,
+                  this.config.provider
+                );
+                const pos = await pmContract["getPositionDetails"](loan.id);
+                const vaultAddr = pos.vaultAddress ?? pos[3] ?? "";
+                if (vaultAddr) {
+                  loan.collateral.vaultAddress = vaultAddr;
+                  if (this.config.debug) {
+                    log.info(`\u2705 Vault address from contract for loan ${loan.id}`, { vaultAddr });
+                  }
+                }
+              } else if (this.config.debug) {
+                log.warn(`\u26A0\uFE0F  Chipotle pkpId for loan ${loan.id} but no positionManagerCoreAddress configured`);
+              }
+              return;
+            }
+            const isUncompressedPubKey = typeof rawId === "string" && rawId.length === 130 && rawId.toLowerCase().startsWith("04");
+            const pkpPublicKey = isUncompressedPubKey ? loan.pkpId.startsWith("0x") ? loan.pkpId : `0x${loan.pkpId}` : await getPKPPublicKeyFromTokenId(loan.pkpId, this.config.provider);
             const addressesResult = await this.config.bitcoinOperations.deriveAddresses(pkpPublicKey);
             if (addressesResult.success) {
               loan.collateral.vaultAddress = addressesResult.value;
@@ -33420,6 +33682,13 @@ var GraphClient = class {
 var THE_GRAPH_MAX_BATCH_SIZE = 1e3;
 
 // src/graphs/diamond-hands.ts
+function normalizePkpId2(pkpId) {
+  const raw = pkpId.startsWith("0x") ? pkpId.slice(2) : pkpId;
+  if (raw.length === 64 && raw.startsWith("000000000000000000000000") && raw !== "0".repeat(64)) {
+    return `0x${raw.slice(24)}`;
+  }
+  return pkpId;
+}
 var DiamondHandsGraph = class {
   client;
   defaultPageSize;
@@ -33442,7 +33711,7 @@ var DiamondHandsGraph = class {
     const ucdDebt = graphPosition.ucdDebt ? Number(graphPosition.ucdDebt) : 0;
     return {
       id: graphPosition.id,
-      pkpId: graphPosition.pkpId,
+      pkpId: normalizePkpId2(graphPosition.pkpId),
       borrower: {
         createdAt: graphPosition.borrower?.createdAt ? Number(graphPosition.borrower.createdAt) : 0,
         id: graphPosition.borrower?.id || graphPosition.borrower
@@ -34704,39 +34973,6 @@ try {
 } catch (error) {
   console.warn("Telegram bot API not available:", error instanceof Error ? error.message : String(error));
 }
-async function sendTelegramMessage(chatId, chatToken, message, threadId) {
-  try {
-    if (typeof window !== "undefined") {
-      if (window.location.hostname === "localhost" || window.location.hostname === "127.0.0.1") {
-        console.log("[Browser] Telegram messaging not available - skipping notification");
-      }
-      return;
-    }
-    if (!TelegramBot) {
-      console.warn("Telegram bot API not available in this environment");
-      return;
-    }
-    const bot = new TelegramBot(chatToken, { polling: false });
-    const options = {
-      disable_web_page_preview: true
-    };
-    if (threadId !== void 0) {
-      options.message_thread_id = threadId;
-    }
-    console.log("\u{1F4F1} Sending Telegram message...");
-    console.log(`   Chat ID: ${chatId}`);
-    console.log(`   Thread ID: ${threadId || "none"}`);
-    console.log(`   Message: ${message}`);
-    const result = await bot.sendMessage(chatId, message, options);
-    console.log("\u2705 Telegram message sent successfully!");
-    console.log(`   Message ID: ${result.message_id}`);
-  } catch (error) {
-    console.error("\u274C Failed to send Telegram message:", error);
-    if (error instanceof Error) {
-      console.error(`   Error message: ${error.message}`);
-    }
-  }
-}
 function formatMintMessage(mintAmount, loanId, txHash) {
   return `${mintAmount} UCD was minted for loan id: ${loanId} Tx: https://sepolia.etherscan.io/tx/${txHash}`;
 }
@@ -35055,6 +35291,7 @@ var DiamondHandsSDK = class _DiamondHandsSDK {
       network: config.litNetwork || DEFAULT_LIT_NETWORK,
       signer: config.mode === "standalone" ? config.litOpsSigner : void 0,
       serviceEndpoint: isServiceModeConfig(config) ? config.serviceEndpoint : void 0,
+      serviceAuthToken: isServiceModeConfig(config) ? config.serviceAuthToken : void 0,
       debug: config.debug,
       litNodeConnectTimeoutMs: config.litNodeConnectTimeoutMs
       // TODO Round 2: Add litActionExecution config when added to config.i.ts interface
@@ -35112,19 +35349,21 @@ var DiamondHandsSDK = class _DiamondHandsSDK {
       );
     }
     this.pkpManager = pkpManagerResult.value;
-    const graphEndpoint = config.subgraphs?.diamondHandsUrl;
+    const serviceMode = isServiceModeConfig(config);
+    const graphEndpoint = serviceMode ? `${config.serviceEndpoint}/api/lit/graph/query` : config.subgraphs?.diamondHandsUrl;
     if (!graphEndpoint) {
       throw new Error(
         "Diamond Hands subgraph URL is required. Please provide config.subgraphs.diamondHandsUrl"
       );
     }
+    const graphHeaders = serviceMode && config.serviceAuthToken ? { Authorization: `Bearer ${config.serviceAuthToken}` } : config.graphApiKey ? { Authorization: `Bearer ${config.graphApiKey}` } : void 0;
     this.graphClient = new DiamondHandsGraph(
       {
         endpoint: graphEndpoint,
         requestTimeoutMs: config.graphOptions?.requestTimeoutMs,
         maxRetries: config.graphOptions?.maxRetries,
         defaultPageSize: config.graphOptions?.pageSize,
-        headers: config.graphApiKey ? { Authorization: `Bearer ${config.graphApiKey}` } : void 0
+        headers: graphHeaders
       },
       this.bitcoinOperations
     );
@@ -35132,6 +35371,7 @@ var DiamondHandsSDK = class _DiamondHandsSDK {
       graphClient: this.graphClient,
       bitcoinOperations: this.bitcoinOperations,
       provider: config.provider,
+      positionManagerCoreAddress: config.contractAddresses?.positionManagerCore,
       cache: this.cacheManager.getCache("loan-data", {
         maxSize: 200,
         ttlMs: 3e4
@@ -35523,6 +35763,30 @@ var DiamondHandsSDK = class _DiamondHandsSDK {
   /**
    * Check if SDK is ready for operations
    */
+  async _relayNotification(message) {
+    if (this.config.mode !== "service")
+      return;
+    const endpoint = this.config.serviceEndpoint;
+    if (!endpoint)
+      return;
+    const token = this.config.serviceAuthToken;
+    try {
+      await fetch(`${endpoint}/api/lit/notifications/send`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...token ? { Authorization: `Bearer ${token}` } : {}
+        },
+        body: JSON.stringify({ message })
+      });
+    } catch (err) {
+      if (this.config.debug) {
+        log.warn("Notification relay failed", {
+          error: err instanceof Error ? err.message : String(err)
+        });
+      }
+    }
+  }
   checkInitialized() {
     if (!this.isInitialized) {
       return failure(
@@ -35598,7 +35862,7 @@ var DiamondHandsSDK = class _DiamondHandsSDK {
       return failure(initCheck.error);
     }
     const result = await this.loanCreator.createLoan(request);
-    if (result.success && this.config.telegram && result.value.positionId) {
+    if (result.success && result.value.positionId) {
       try {
         const message = formatLoanCreationMessage(
           result.value.positionId,
@@ -35610,12 +35874,7 @@ var DiamondHandsSDK = class _DiamondHandsSDK {
             "\u{1F4F1} Attempting to send loan creation Telegram message..."
           );
         }
-        await sendTelegramMessage(
-          this.config.telegram.chatId,
-          this.config.telegram.chatToken,
-          message,
-          this.config.telegram.threadId
-        );
+        await this._relayNotification(message);
         if (this.config.debug) {
           console.log("\u2705 Loan creation Telegram message sent successfully");
         }
@@ -36789,7 +37048,7 @@ Error data: ${errorData || "none"}`
         amountMintedUCD: Number(amountMinted) / 10 ** 18
       };
       try {
-        if (this.config.telegram && result.transactionHash) {
+        if (result.transactionHash) {
           const mintAmount = result.amountMintedUCD || request.amount;
           const loanId = result.positionId || request.positionId;
           const message = formatMintMessage(
@@ -36797,12 +37056,7 @@ Error data: ${errorData || "none"}`
             loanId,
             result.transactionHash
           );
-          await sendTelegramMessage(
-            this.config.telegram.chatId,
-            this.config.telegram.chatToken,
-            message,
-            this.config.telegram.threadId
-          );
+          await this._relayNotification(message);
         }
       } catch (err) {
       }
@@ -37064,39 +37318,32 @@ Error data: ${errorData || "none"}`
       }
       if (!shouldLiquidate) {
         try {
-          if (this.config.telegram?.chatId && this.config.telegram?.chatToken) {
-            if (this.config.debug) {
-              log.info(`\u{1F4F1} Sending liquidation skipped Telegram message...`);
-            }
-            const debt = positionDetails.debt || positionDetails.ucdDebt || "0";
-            const btcPrice2 = litActionResult.btcPrice || "0";
-            const btcVaultBalance = litActionResult.btcAmountSats || positionDetails.btcVaultBalance || "0";
-            const usdPricePerBTC = Number(btcPrice2) / 1e8;
-            const btcAmount = Number(btcVaultBalance) / 1e8;
-            const btcValueUSD = btcAmount * usdPricePerBTC;
-            const debtUSD = Number(debt) / 1e18;
-            const ratio = debtUSD > 0 ? (btcValueUSD / debtUSD * 100).toFixed(2) : "0.00";
-            const message = formatLiquidationSkippedMessage(
-              request.positionId,
-              ratio,
-              `${liquidationThreshold / 100}`,
-              // Convert to percentage
-              positionDetails.vaultAddress || "unknown",
-              btcVaultBalance,
-              debt,
-              btcPrice2
-            );
-            await sendTelegramMessage(
-              this.config.telegram.chatId,
-              this.config.telegram.chatToken,
-              message,
-              this.config.telegram.threadId
+          if (this.config.debug) {
+            log.info(`\u{1F4F1} Sending liquidation skipped Telegram message...`);
+          }
+          const debt = positionDetails.debt || positionDetails.ucdDebt || "0";
+          const btcPrice2 = litActionResult.btcPrice || "0";
+          const btcVaultBalance = litActionResult.btcAmountSats || positionDetails.btcVaultBalance || "0";
+          const usdPricePerBTC = Number(btcPrice2) / 1e8;
+          const btcAmount = Number(btcVaultBalance) / 1e8;
+          const btcValueUSD = btcAmount * usdPricePerBTC;
+          const debtUSD = Number(debt) / 1e18;
+          const ratio = debtUSD > 0 ? (btcValueUSD / debtUSD * 100).toFixed(2) : "0.00";
+          const message = formatLiquidationSkippedMessage(
+            request.positionId,
+            ratio,
+            `${liquidationThreshold / 100}`,
+            // Convert to percentage
+            positionDetails.vaultAddress || "unknown",
+            btcVaultBalance,
+            debt,
+            btcPrice2
+          );
+          await this._relayNotification(message);
+          if (this.config.debug) {
+            log.info(
+              `\u2705 Liquidation skipped Telegram message sent successfully`
             );
-            if (this.config.debug) {
-              log.info(
-                `\u2705 Liquidation skipped Telegram message sent successfully`
-              );
-            }
           }
         } catch (telegramError) {
           if (this.config.debug) {
@@ -37151,32 +37398,25 @@ Error data: ${errorData || "none"}`
           });
         }
         try {
-          if (this.config.telegram?.chatId && this.config.telegram?.chatToken) {
-            if (this.config.debug) {
-              log.info(`\u{1F4F1} Sending LIT action rejection Telegram message...`);
-            }
-            const debt = positionDetails.debt || positionDetails.ucdDebt || "0";
-            const btcPrice2 = litActionResult.btcPrice || "unknown";
-            const btcVaultBalance = litActionResult.btcAmountSats || "unknown";
-            const message = formatLiquidationFailureMessage(
-              request.positionId,
-              `LIT Action rejected liquidation: ${litActionResult.reason || litActionResult.error || "Unknown error"}`,
-              positionDetails.vaultAddress || "unknown",
-              btcVaultBalance,
-              debt,
-              btcPrice2
-            );
-            await sendTelegramMessage(
-              this.config.telegram.chatId,
-              this.config.telegram.chatToken,
-              message,
-              this.config.telegram.threadId
+          if (this.config.debug) {
+            log.info(`\u{1F4F1} Sending LIT action rejection Telegram message...`);
+          }
+          const debt = positionDetails.debt || positionDetails.ucdDebt || "0";
+          const btcPrice2 = litActionResult.btcPrice || "unknown";
+          const btcVaultBalance = litActionResult.btcAmountSats || "unknown";
+          const message = formatLiquidationFailureMessage(
+            request.positionId,
+            `LIT Action rejected liquidation: ${litActionResult.reason || litActionResult.error || "Unknown error"}`,
+            positionDetails.vaultAddress || "unknown",
+            btcVaultBalance,
+            debt,
+            btcPrice2
+          );
+          await this._relayNotification(message);
+          if (this.config.debug) {
+            log.info(
+              `\u2705 LIT action rejection Telegram message sent successfully`
             );
-            if (this.config.debug) {
-              log.info(
-                `\u2705 LIT action rejection Telegram message sent successfully`
-              );
-            }
           }
         } catch (telegramError) {
           if (this.config.debug) {
@@ -37198,32 +37438,25 @@ Error data: ${errorData || "none"}`
             );
           }
           try {
-            if (this.config.telegram?.chatId && this.config.telegram?.chatToken) {
-              if (this.config.debug) {
-                log.info(`\u{1F4F1} Sending forced liquidation Telegram message...`);
-              }
-              const debt = positionDetails.debt || positionDetails.ucdDebt || "0";
-              const btcPrice2 = litActionResult.btcPrice || "unknown";
-              const btcVaultBalance = litActionResult.btcAmountSats || "unknown";
-              const message = formatLiquidationFailureMessage(
-                request.positionId,
-                `FORCED LIQUIDATION: LIT Action rejected but forceContractCall=true - proceeding with liquidation`,
-                positionDetails.vaultAddress || "unknown",
-                btcVaultBalance,
-                debt,
-                btcPrice2
-              );
-              await sendTelegramMessage(
-                this.config.telegram.chatId,
-                this.config.telegram.chatToken,
-                message,
-                this.config.telegram.threadId
+            if (this.config.debug) {
+              log.info(`\u{1F4F1} Sending forced liquidation Telegram message...`);
+            }
+            const debt = positionDetails.debt || positionDetails.ucdDebt || "0";
+            const btcPrice2 = litActionResult.btcPrice || "unknown";
+            const btcVaultBalance = litActionResult.btcAmountSats || "unknown";
+            const message = formatLiquidationFailureMessage(
+              request.positionId,
+              `FORCED LIQUIDATION: LIT Action rejected but forceContractCall=true - proceeding with liquidation`,
+              positionDetails.vaultAddress || "unknown",
+              btcVaultBalance,
+              debt,
+              btcPrice2
+            );
+            await this._relayNotification(message);
+            if (this.config.debug) {
+              log.info(
+                `\u2705 Forced liquidation Telegram message sent successfully`
               );
-              if (this.config.debug) {
-                log.info(
-                  `\u2705 Forced liquidation Telegram message sent successfully`
-                );
-              }
             }
           } catch (telegramError) {
             if (this.config.debug) {
@@ -37256,34 +37489,27 @@ Error data: ${errorData || "none"}`
             );
           }
           try {
-            if (this.config.telegram?.chatId && this.config.telegram?.chatToken) {
-              if (this.config.debug) {
-                log.info(
-                  `\u{1F4F1} Sending forced liquidation without signature Telegram message...`
-                );
-              }
-              const debt = positionDetails.debt || positionDetails.ucdDebt || "0";
-              const btcPrice2 = litActionResult.btcPrice || "unknown";
-              const btcVaultBalance = litActionResult.btcAmountSats || "unknown";
-              const message = formatLiquidationFailureMessage(
-                request.positionId,
-                "FORCED LIQUIDATION: LIT Action did not provide signature but forceContractCall=true - proceeding without signature",
-                positionDetails.vaultAddress || "unknown",
-                btcVaultBalance,
-                debt,
-                btcPrice2
+            if (this.config.debug) {
+              log.info(
+                `\u{1F4F1} Sending forced liquidation without signature Telegram message...`
               );
-              await sendTelegramMessage(
-                this.config.telegram.chatId,
-                this.config.telegram.chatToken,
-                message,
-                this.config.telegram.threadId
+            }
+            const debt = positionDetails.debt || positionDetails.ucdDebt || "0";
+            const btcPrice2 = litActionResult.btcPrice || "unknown";
+            const btcVaultBalance = litActionResult.btcAmountSats || "unknown";
+            const message = formatLiquidationFailureMessage(
+              request.positionId,
+              "FORCED LIQUIDATION: LIT Action did not provide signature but forceContractCall=true - proceeding without signature",
+              positionDetails.vaultAddress || "unknown",
+              btcVaultBalance,
+              debt,
+              btcPrice2
+            );
+            await this._relayNotification(message);
+            if (this.config.debug) {
+              log.info(
+                `\u2705 Forced liquidation without signature Telegram message sent successfully`
               );
-              if (this.config.debug) {
-                log.info(
-                  `\u2705 Forced liquidation without signature Telegram message sent successfully`
-                );
-              }
             }
           } catch (telegramError) {
             if (this.config.debug) {
@@ -37297,32 +37523,25 @@ Error data: ${errorData || "none"}`
           }
         } else {
           try {
-            if (this.config.telegram?.chatId && this.config.telegram?.chatToken) {
-              if (this.config.debug) {
-                log.info(`\u{1F4F1} Sending missing signature Telegram message...`);
-              }
-              const debt = positionDetails.debt || positionDetails.ucdDebt || "0";
-              const btcPrice2 = litActionResult.btcPrice || "unknown";
-              const btcVaultBalance = litActionResult.btcAmountSats || "unknown";
-              const message = formatLiquidationFailureMessage(
-                request.positionId,
-                "LIT Action did not provide required signature for liquidation",
-                positionDetails.vaultAddress || "unknown",
-                btcVaultBalance,
-                debt,
-                btcPrice2
-              );
-              await sendTelegramMessage(
-                this.config.telegram.chatId,
-                this.config.telegram.chatToken,
-                message,
-                this.config.telegram.threadId
+            if (this.config.debug) {
+              log.info(`\u{1F4F1} Sending missing signature Telegram message...`);
+            }
+            const debt = positionDetails.debt || positionDetails.ucdDebt || "0";
+            const btcPrice2 = litActionResult.btcPrice || "unknown";
+            const btcVaultBalance = litActionResult.btcAmountSats || "unknown";
+            const message = formatLiquidationFailureMessage(
+              request.positionId,
+              "LIT Action did not provide required signature for liquidation",
+              positionDetails.vaultAddress || "unknown",
+              btcVaultBalance,
+              debt,
+              btcPrice2
+            );
+            await this._relayNotification(message);
+            if (this.config.debug) {
+              log.info(
+                `\u2705 Missing signature Telegram message sent successfully`
               );
-              if (this.config.debug) {
-                log.info(
-                  `\u2705 Missing signature Telegram message sent successfully`
-                );
-              }
             }
           } catch (telegramError) {
             if (this.config.debug) {
@@ -37561,34 +37780,27 @@ Error data: ${errorData || "none"}`
           });
         }
         try {
-          if (this.config.telegram?.chatId && this.config.telegram?.chatToken) {
-            if (this.config.debug) {
-              log.info(`\u{1F4F1} Sending liquidation success Telegram message...`);
-            }
-            const debt = positionDetails.debt || positionDetails.ucdDebt || "0";
-            const btcPrice2 = litActionResult.btcPrice || "0";
-            const ratio = debt !== "0" ? (Number(positionDetails.btcVaultBalance || "0") * Number(btcPrice2) / Number(debt) * 100 / 1e8).toFixed(2) : "0.00";
-            const message = formatLiquidationSuccessMessage(
-              request.positionId,
-              ratio,
-              `${liquidationThreshold / 100}`,
-              // Convert to percentage
-              positionDetails.btcVault || "unknown",
-              positionDetails.btcVaultBalance || "0",
-              debt,
-              btcPrice2
-            );
-            await sendTelegramMessage(
-              this.config.telegram.chatId,
-              this.config.telegram.chatToken,
-              message,
-              this.config.telegram.threadId
+          if (this.config.debug) {
+            log.info(`\u{1F4F1} Sending liquidation success Telegram message...`);
+          }
+          const debt = positionDetails.debt || positionDetails.ucdDebt || "0";
+          const btcPrice2 = litActionResult.btcPrice || "0";
+          const ratio = debt !== "0" ? (Number(positionDetails.btcVaultBalance || "0") * Number(btcPrice2) / Number(debt) * 100 / 1e8).toFixed(2) : "0.00";
+          const message = formatLiquidationSuccessMessage(
+            request.positionId,
+            ratio,
+            `${liquidationThreshold / 100}`,
+            // Convert to percentage
+            positionDetails.btcVault || "unknown",
+            positionDetails.btcVaultBalance || "0",
+            debt,
+            btcPrice2
+          );
+          await this._relayNotification(message);
+          if (this.config.debug) {
+            log.info(
+              `\u2705 Liquidation success Telegram message sent successfully`
             );
-            if (this.config.debug) {
-              log.info(
-                `\u2705 Liquidation success Telegram message sent successfully`
-              );
-            }
           }
         } catch (telegramError) {
           if (this.config.debug) {
@@ -37620,31 +37832,24 @@ Error data: ${errorData || "none"}`
           transaction: contractError.transaction
         });
         try {
-          if (this.config.telegram?.chatId && this.config.telegram?.chatToken) {
-            if (this.config.debug) {
-              log.info(`\u{1F4F1} Sending liquidation failure Telegram message...`);
-            }
-            const debt = positionDetails.debt || positionDetails.ucdDebt || "0";
-            const btcPrice2 = litActionResult.btcPrice || "0";
-            const message = formatLiquidationFailureMessage(
-              request.positionId,
-              contractError.message || "Unknown contract error",
-              positionDetails.btcVault || "unknown",
-              positionDetails.btcVaultBalance || "0",
-              debt,
-              btcPrice2
-            );
-            await sendTelegramMessage(
-              this.config.telegram.chatId,
-              this.config.telegram.chatToken,
-              message,
-              this.config.telegram.threadId
+          if (this.config.debug) {
+            log.info(`\u{1F4F1} Sending liquidation failure Telegram message...`);
+          }
+          const debt = positionDetails.debt || positionDetails.ucdDebt || "0";
+          const btcPrice2 = litActionResult.btcPrice || "0";
+          const message = formatLiquidationFailureMessage(
+            request.positionId,
+            contractError.message || "Unknown contract error",
+            positionDetails.btcVault || "unknown",
+            positionDetails.btcVaultBalance || "0",
+            debt,
+            btcPrice2
+          );
+          await this._relayNotification(message);
+          if (this.config.debug) {
+            log.info(
+              `\u2705 Liquidation failure Telegram message sent successfully`
             );
-            if (this.config.debug) {
-              log.info(
-                `\u2705 Liquidation failure Telegram message sent successfully`
-              );
-            }
           }
         } catch (telegramError) {
           if (this.config.debug) {
@@ -37794,26 +37999,19 @@ Error data: ${errorData || "none"}`
           )} (${potentialNewExpiry}), max allowed: ${formatDate(
             maxAllowedTimestamp
           )} (${maxAllowedTimestamp})`;
-          if (this.config.telegram) {
-            try {
-              await sendTelegramMessage(
-                this.config.telegram.chatId,
-                this.config.telegram.chatToken,
-                formatLoanRenewalFailureMessage(
-                  _positionId,
-                  `Loan could not be renewed: ${errorMessage}`
-                ),
-                this.config.telegram.threadId
+          try {
+            await this._relayNotification(formatLoanRenewalFailureMessage(
+              _positionId,
+              `Loan could not be renewed: ${errorMessage}`
+            ));
+          } catch (e) {
+            if (this.config.debug) {
+              log.warn(
+                "Failed to send Telegram notification for renewal rule violation",
+                {
+                  error: e instanceof Error ? e.message : String(e)
+                }
               );
-            } catch (e) {
-              if (this.config.debug) {
-                log.warn(
-                  "Failed to send Telegram notification for renewal rule violation",
-                  {
-                    error: e instanceof Error ? e.message : String(e)
-                  }
-                );
-              }
             }
           }
           throw new Error(errorMessage);
@@ -37865,19 +38063,12 @@ Error data: ${errorData || "none"}`
           error: errorMessage
         });
       }
-      if (this.config.telegram) {
-        try {
-          await sendTelegramMessage(
-            this.config.telegram.chatId,
-            this.config.telegram.chatToken,
-            formatLoanRenewalFailureMessage(
-              _positionId,
-              `LIT Action failed: ${errorMessage}`
-            ),
-            this.config.telegram.threadId
-          );
-        } catch (e) {
-        }
+      try {
+        await this._relayNotification(formatLoanRenewalFailureMessage(
+          _positionId,
+          `LIT Action failed: ${errorMessage}`
+        ));
+      } catch (e) {
       }
       throw litError;
     }
@@ -37887,31 +38078,17 @@ Error data: ${errorData || "none"}`
     if (!litActionResult.approved) {
       const reason = litActionResult.reason ?? litActionResult.error ?? "Extension not approved";
       const errorMessage = `Extension not approved: ${reason}`;
-      if (this.config.telegram) {
-        try {
-          await sendTelegramMessage(
-            this.config.telegram.chatId,
-            this.config.telegram.chatToken,
-            formatLoanRenewalFailureMessage(_positionId, errorMessage),
-            this.config.telegram.threadId
-          );
-        } catch (e) {
-        }
+      try {
+        await this._relayNotification(formatLoanRenewalFailureMessage(_positionId, errorMessage));
+      } catch (e) {
       }
       throw new Error(errorMessage);
     }
     if (!litActionResult.signature || litActionResult.btcPrice === void 0 || litActionResult.btcPrice === null || litActionResult.availableBTCBalance === void 0 || litActionResult.availableBTCBalance === null || (litActionResult.quantumTimestamp === void 0 || litActionResult.quantumTimestamp === null) || litActionResult.proRataRenewalFee === void 0 || litActionResult.proRataRenewalFee === null) {
       const errorMessage = "LIT Action result missing required fields: signature, btcPrice, availableBTCBalance, quantumTimestamp, proRataRenewalFee";
-      if (this.config.telegram) {
-        try {
-          await sendTelegramMessage(
-            this.config.telegram.chatId,
-            this.config.telegram.chatToken,
-            formatLoanRenewalFailureMessage(_positionId, errorMessage),
-            this.config.telegram.threadId
-          );
-        } catch (e) {
-        }
+      try {
+        await this._relayNotification(formatLoanRenewalFailureMessage(_positionId, errorMessage));
+      } catch (e) {
       }
       throw new Error(errorMessage);
     }
@@ -37998,66 +38175,38 @@ Error data: ${errorData || "none"}`
           { hash: txWithProvider.hash, error: errorMessage }
         );
       }
-      if (this.config.telegram) {
-        try {
-          await sendTelegramMessage(
-            this.config.telegram.chatId,
-            this.config.telegram.chatToken,
-            formatLoanRenewalFailureMessage(
-              _positionId,
-              `Transaction confirmation failed: ${errorMessage}`
-            ),
-            this.config.telegram.threadId
-          );
-        } catch (e) {
-        }
+      try {
+        await this._relayNotification(formatLoanRenewalFailureMessage(
+          _positionId,
+          `Transaction confirmation failed: ${errorMessage}`
+        ));
+      } catch (e) {
       }
       throw waitError;
     }
     if (!receipt) {
       const error = "Transaction receipt is null - transaction may have failed";
-      if (this.config.telegram) {
-        try {
-          await sendTelegramMessage(
-            this.config.telegram.chatId,
-            this.config.telegram.chatToken,
-            formatLoanRenewalFailureMessage(_positionId, error),
-            this.config.telegram.threadId
-          );
-        } catch (e) {
-        }
+      try {
+        await this._relayNotification(formatLoanRenewalFailureMessage(_positionId, error));
+      } catch (e) {
       }
       throw new Error(error);
     }
     if (receipt.status === 0) {
       const error = `Transaction reverted (tx: ${receipt.transactionHash})`;
-      if (this.config.telegram) {
-        try {
-          await sendTelegramMessage(
-            this.config.telegram.chatId,
-            this.config.telegram.chatToken,
-            formatLoanRenewalFailureMessage(_positionId, error),
-            this.config.telegram.threadId
-          );
-        } catch (e) {
-        }
+      try {
+        await this._relayNotification(formatLoanRenewalFailureMessage(_positionId, error));
+      } catch (e) {
       }
       throw new Error(error);
     }
-    if (this.config.telegram) {
-      try {
-        await sendTelegramMessage(
-          this.config.telegram.chatId,
-          this.config.telegram.chatToken,
-          formatLoanRenewalMessage(_positionId, receipt.transactionHash),
-          this.config.telegram.threadId
-        );
-      } catch (e) {
-        if (this.config.debug) {
-          log.warn("Failed to send Telegram notification for extension", {
-            error: e instanceof Error ? e.message : String(e)
-          });
-        }
+    try {
+      await this._relayNotification(formatLoanRenewalMessage(_positionId, receipt.transactionHash));
+    } catch (e) {
+      if (this.config.debug) {
+        log.warn("Failed to send Telegram notification for extension", {
+          error: e instanceof Error ? e.message : String(e)
+        });
       }
     }
     return receipt;
@@ -38171,16 +38320,9 @@ Error data: ${errorData || "none"}`
     const initCheck = this.checkInitialized();
     if (!initCheck.success) {
       const error = `SDK not initialized: ${initCheck.error.message}`;
-      if (this.config.telegram) {
-        try {
-          await sendTelegramMessage(
-            this.config.telegram.chatId,
-            this.config.telegram.chatToken,
-            formatBalanceConfirmationFailureMessage(positionId),
-            this.config.telegram.threadId
-          );
-        } catch (e) {
-        }
+      try {
+        await this._relayNotification(formatBalanceConfirmationFailureMessage(positionId));
+      } catch (e) {
       }
       return {
         success: false,
@@ -38320,21 +38462,14 @@ Error data: ${errorData || "none"}`
           gasUsed: receipt.gasUsed.toString()
         });
       }
-      if (this.config.telegram) {
-        try {
-          const message = formatBalanceConfirmationMessage(positionId);
-          await sendTelegramMessage(
-            this.config.telegram.chatId,
-            this.config.telegram.chatToken,
-            message,
-            this.config.telegram.threadId
-          );
-        } catch (telegramError) {
-          if (this.config.debug) {
-            log.warn("\u26A0\uFE0F  Failed to send Telegram notification", {
-              error: telegramError instanceof Error ? telegramError.message : String(telegramError)
-            });
-          }
+      try {
+        const message = formatBalanceConfirmationMessage(positionId);
+        await this._relayNotification(message);
+      } catch (telegramError) {
+        if (this.config.debug) {
+          log.warn("\u26A0\uFE0F  Failed to send Telegram notification", {
+            error: telegramError instanceof Error ? telegramError.message : String(telegramError)
+          });
         }
       }
       return {
@@ -38357,17 +38492,10 @@ Error data: ${errorData || "none"}`
           positionId
         });
       }
-      if (this.config.telegram) {
-        try {
-          const message = formatBalanceConfirmationFailureMessage(positionId);
-          await sendTelegramMessage(
-            this.config.telegram.chatId,
-            this.config.telegram.chatToken,
-            message,
-            this.config.telegram.threadId
-          );
-        } catch (telegramError) {
-        }
+      try {
+        const message = formatBalanceConfirmationFailureMessage(positionId);
+        await this._relayNotification(message);
+      } catch (telegramError) {
       }
       return {
         success: false,
@@ -38916,17 +39044,12 @@ Error data: ${errorData || "none"}`
       }
       if (receipt.status === 0) {
         try {
-          if (this.config.telegram && tx.hash) {
+          if (tx.hash) {
             const message = formatPartialPaymentFailureMessage(
               request.paymentAmount,
               request.positionId
             );
-            await sendTelegramMessage(
-              this.config.telegram.chatId,
-              this.config.telegram.chatToken,
-              message,
-              this.config.telegram.threadId
-            );
+            await this._relayNotification(message);
           }
         } catch (telegramError) {
           if (this.config.debug) {
@@ -38948,18 +39071,13 @@ Error data: ${errorData || "none"}`
         log.info(`\u2705 Transaction confirmed in block ${receipt.blockNumber}`);
       }
       try {
-        if (this.config.telegram && tx.hash) {
+        if (tx.hash) {
           const message = formatPartialPaymentMessage(
             request.paymentAmount,
             request.positionId,
             tx.hash
           );
-          await sendTelegramMessage(
-            this.config.telegram.chatId,
-            this.config.telegram.chatToken,
-            message,
-            this.config.telegram.threadId
-          );
+          await this._relayNotification(message);
         }
       } catch (telegramError) {
         if (this.config.debug) {
@@ -39013,19 +39131,12 @@ Error data: ${errorData || "none"}`
         });
       }
       try {
-        if (this.config.telegram) {
-          const message = formatPartialPaymentFailureMessage(
-            request.paymentAmount,
-            request.positionId,
-            transactionHash
-          );
-          await sendTelegramMessage(
-            this.config.telegram.chatId,
-            this.config.telegram.chatToken,
-            message,
-            this.config.telegram.threadId
-          );
-        }
+        const message = formatPartialPaymentFailureMessage(
+          request.paymentAmount,
+          request.positionId,
+          transactionHash
+        );
+        await this._relayNotification(message);
       } catch (telegramError) {
         if (this.config.debug) {
           log.warn("\u26A0\uFE0F  Failed to send Telegram failure notification", {
@@ -39341,22 +39452,15 @@ Error data: ${errorData || "none"}`
             });
           }
           try {
-            if (this.config.telegram) {
-              const position2 = await this.getPosition(positionId);
-              const btcAmount = (Number(withdrawalAmount) / 1e8).toFixed(8);
-              const message = formatBTCWithdrawalFailureMessage(
-                btcAmount,
-                position2?.vaultAddress || "unknown",
-                withdrawalAddress,
-                positionId
-              );
-              await sendTelegramMessage(
-                this.config.telegram.chatId,
-                this.config.telegram.chatToken,
-                message,
-                this.config.telegram.threadId
-              );
-            }
+            const position2 = await this.getPosition(positionId);
+            const btcAmount = (Number(withdrawalAmount) / 1e8).toFixed(8);
+            const message = formatBTCWithdrawalFailureMessage(
+              btcAmount,
+              position2?.vaultAddress || "unknown",
+              withdrawalAddress,
+              positionId
+            );
+            await this._relayNotification(message);
           } catch (telegramError) {
             console.error(
               "Telegram notification failed:",
@@ -39388,22 +39492,15 @@ Error data: ${errorData || "none"}`
           });
         }
         try {
-          if (this.config.telegram) {
-            const position = await this.getPosition(positionId);
-            const btcAmount = (Number(withdrawalAmount) / 1e8).toFixed(8);
-            const message = formatBTCWithdrawalFailureMessage(
-              btcAmount,
-              position?.vaultAddress || "unknown",
-              withdrawalAddress,
-              positionId
-            );
-            await sendTelegramMessage(
-              this.config.telegram.chatId,
-              this.config.telegram.chatToken,
-              message,
-              this.config.telegram.threadId
-            );
-          }
+          const position = await this.getPosition(positionId);
+          const btcAmount = (Number(withdrawalAmount) / 1e8).toFixed(8);
+          const message = formatBTCWithdrawalFailureMessage(
+            btcAmount,
+            position?.vaultAddress || "unknown",
+            withdrawalAddress,
+            positionId
+          );
+          await this._relayNotification(message);
         } catch (telegramError) {
           console.error(
             "Telegram notification failed:",
@@ -39557,22 +39654,15 @@ Error data: ${errorData || "none"}`
           });
         }
         try {
-          if (this.config.telegram) {
-            const position = await this.getPosition(positionId);
-            const btcAmount = (Number(withdrawalAmount) / 1e8).toFixed(8);
-            const message = formatBTCWithdrawalFailureMessage(
-              btcAmount,
-              position?.vaultAddress || "unknown",
-              withdrawalAddress,
-              positionId
-            );
-            await sendTelegramMessage(
-              this.config.telegram.chatId,
-              this.config.telegram.chatToken,
-              message,
-              this.config.telegram.threadId
-            );
-          }
+          const position = await this.getPosition(positionId);
+          const btcAmount = (Number(withdrawalAmount) / 1e8).toFixed(8);
+          const message = formatBTCWithdrawalFailureMessage(
+            btcAmount,
+            position?.vaultAddress || "unknown",
+            withdrawalAddress,
+            positionId
+          );
+          await this._relayNotification(message);
         } catch (telegramError) {
           console.error(
             "Telegram notification failed:",
@@ -39612,22 +39702,15 @@ Error data: ${errorData || "none"}`
         });
       }
       try {
-        if (this.config.telegram) {
-          const position = await this.getPosition(positionId);
-          const btcAmount = (Number(withdrawalAmount) / 1e8).toFixed(8);
-          const message = formatBTCWithdrawalSuccessMessage(
-            btcAmount,
-            position?.vaultAddress || "unknown",
-            validationResponse.destinationAddress,
-            positionId
-          );
-          await sendTelegramMessage(
-            this.config.telegram.chatId,
-            this.config.telegram.chatToken,
-            message,
-            this.config.telegram.threadId
-          );
-        }
+        const position = await this.getPosition(positionId);
+        const btcAmount = (Number(withdrawalAmount) / 1e8).toFixed(8);
+        const message = formatBTCWithdrawalSuccessMessage(
+          btcAmount,
+          position?.vaultAddress || "unknown",
+          validationResponse.destinationAddress,
+          positionId
+        );
+        await this._relayNotification(message);
       } catch (telegramError) {
         console.error(
           "Telegram notification failed:",
@@ -39653,22 +39736,15 @@ Error data: ${errorData || "none"}`
         });
       }
       try {
-        if (this.config.telegram) {
-          const position = await this.getPosition(positionId);
-          const btcAmount = (Number(withdrawalAmount) / 1e8).toFixed(8);
-          const message = formatBTCWithdrawalFailureMessage(
-            btcAmount,
-            position?.vaultAddress || "unknown",
-            withdrawalAddress,
-            positionId
-          );
-          await sendTelegramMessage(
-            this.config.telegram.chatId,
-            this.config.telegram.chatToken,
-            message,
-            this.config.telegram.threadId
-          );
-        }
+        const position = await this.getPosition(positionId);
+        const btcAmount = (Number(withdrawalAmount) / 1e8).toFixed(8);
+        const message = formatBTCWithdrawalFailureMessage(
+          btcAmount,
+          position?.vaultAddress || "unknown",
+          withdrawalAddress,
+          positionId
+        );
+        await this._relayNotification(message);
       } catch (telegramError) {
         console.error(
           "Telegram notification failed:",
@@ -39732,7 +39808,34 @@ Error data: ${errorData || "none"}`
       const bitcoinNetwork = this.getBitcoinNetwork();
       const mode = chainId === 1337 || chainId === 31337 || bitcoinNetwork === "regtest" ? "dev" : "prod";
       const bitcoin = await import("bitcoinjs-lib");
-      const { witnessStackToScriptWitness } = await import("bitcoinjs-lib/src/psbt/psbtutils");
+      const encodeBitcoinVarInt = (value) => {
+        if (value < 253) {
+          return Buffer.from([value]);
+        }
+        if (value <= 65535) {
+          const buf2 = Buffer.allocUnsafe(3);
+          buf2[0] = 253;
+          buf2.writeUInt16LE(value, 1);
+          return buf2;
+        }
+        if (value <= 4294967295) {
+          const buf2 = Buffer.allocUnsafe(5);
+          buf2[0] = 254;
+          buf2.writeUInt32LE(value, 1);
+          return buf2;
+        }
+        const buf = Buffer.allocUnsafe(9);
+        buf[0] = 255;
+        buf.writeBigUInt64LE(BigInt(value), 1);
+        return buf;
+      };
+      const witnessStackToScriptWitness = (witness) => {
+        const serializedChunks = [encodeBitcoinVarInt(witness.length)];
+        for (const item of witness) {
+          serializedChunks.push(encodeBitcoinVarInt(item.length), item);
+        }
+        return Buffer.concat(serializedChunks);
+      };
       const networks2 = bitcoinNetwork === "mainnet" ? bitcoin.networks.bitcoin : bitcoinNetwork === "regtest" ? bitcoin.networks.regtest : bitcoin.networks.testnet;
       if (this.config.debug) {
         log.info("\u{1F4CB} Network configuration", {