@gvnrdao/dh-sdk 0.0.130 → 0.0.132

package/dist/index.js

@@ -12748,48 +12748,48 @@ var init_deployment_addresses = __esm({
     LOCALHOST_DEPLOYMENT = {
       "network": "localhost",
       "chainId": 31337,
-      "timestamp": "2025-12-05T21:33:05.298Z",
+      "timestamp": "2025-12-11T16:44:37.280Z",
       "deployer": "",
       "contracts": {
-        "UpgradeValidator": "0x0DCd1Bf9A1b36cE34237eEaFef220932846BCD82",
+        "UpgradeValidator": "0x2279B7A0a67DB372996a5FaB50D91eAA73d2eBe6",
         "UCDToken": "0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512",
         "UCDController": "0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9",
-        "PriceFeedConsumer": "0x0B306BF915C4d645ff596e518fAf3F9669b97016",
-        "BTCProofValidator": "0x9A9f2CCfdE556A7E9Ff0848998Aa4a0CFD8863AE",
-        "UCDMintingRewards": "0x3Aa5ebB10DC797CAC828524e59A333d0A371443c",
-        "PositionManagerCoreModule": "0x59b670e9fA9D0A427751Af201D676719a970857b",
-        "TermManagerModule": "0x322813Fd9A801c5507c9de605d63CEA4f2CE6c44",
-        "LoanOperationsManagerModule": "0x09635F643e140090A9A8Dcd712eD6285858ceBef",
-        "CollateralManagerModule": "0x67d269191c92Caf3cD7723F116c85e6E9bf55933",
-        "LiquidationManagerModule": "0xc3e53F4d16Ae77Db1c982e75a937B9f60FE63690",
-        "CircuitBreakerModule": "0x4A679253410272dd5232B3Ff7cF5dbB88f295319",
-        "CommunityManagerModule": "0x9E545E3C0baAB3E08CdfD552C960A1050f373042",
-        "AdminModule": "0x1613beB3B2C4f22Ee086B2b38C1476A3cE7f78E8",
-        "PositionManagerViews": "0x851356ae760d987E095750cCeb3bC6014560891C",
-        "PositionManager": "0x95401dc811bb5740090279Ba06cfA8fcF6113778",
-        "OperationAuthorizationRegistry": "0x5f3f1dBD7B74C6B46e8c44f98792A1dAf8d69154",
-        "PKPValidation": "0x82e01223d51Eb87e16A03E24687EDF0F294da6f1"
+        "PriceFeedConsumer": "0x610178dA211FEF7D417bC0e6FeD39F05609AD788",
+        "BTCProofValidator": "0xA51c1fc2f0D1a1b8494Ed1FE312d7C3a78Ed91C0",
+        "UCDMintingRewards": "0x9A676e781A523b5d0C0e43731313A708CB607508",
+        "PositionManagerCoreModule": "0x959922bE3CAee4b8Cd9a407cc3ac1C251C2007B1",
+        "TermManagerModule": "0x68B1D87F95878fE05B998F19b66F4baba5De1aed",
+        "LoanOperationsManagerModule": "0x4ed7c70F96B99c776995fB64377f0d4aB3B0e1C1",
+        "CollateralManagerModule": "0xa85233C63b9Ee964Add6F2cffe00Fd84eb32338f",
+        "LiquidationManagerModule": "0x7a2088a1bFc9d81c55368AE168C2C02570cB814F",
+        "CircuitBreakerModule": "0xc6e7DF5E7b4f2A278906862b61205850344D4e7d",
+        "CommunityManagerModule": "0xc5a5C42992dECbae36851359345FE25997F5C42d",
+        "AdminModule": "0xE6E340D132b5f46d1e472DebcD681B2aBc16e57E",
+        "PositionManagerViews": "0xc3e53F4d16Ae77Db1c982e75a937B9f60FE63690",
+        "PositionManager": "0x9E545E3C0baAB3E08CdfD552C960A1050f373042",
+        "OperationAuthorizationRegistry": "0x5eb3Bc0a489C5A8288765d2336659EbCA68FCd00",
+        "PKPValidation": "0x4c5859f0F772848b2D91F1D83E2Fe57935348029"
       }
     };
     LOCALHOST_CONTRACTS = {
-      "UpgradeValidator": "0x0DCd1Bf9A1b36cE34237eEaFef220932846BCD82",
+      "UpgradeValidator": "0x2279B7A0a67DB372996a5FaB50D91eAA73d2eBe6",
       "UCDToken": "0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512",
       "UCDController": "0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9",
-      "PriceFeedConsumer": "0x0B306BF915C4d645ff596e518fAf3F9669b97016",
-      "BTCProofValidator": "0x9A9f2CCfdE556A7E9Ff0848998Aa4a0CFD8863AE",
-      "UCDMintingRewards": "0x3Aa5ebB10DC797CAC828524e59A333d0A371443c",
-      "PositionManagerCoreModule": "0x59b670e9fA9D0A427751Af201D676719a970857b",
-      "TermManagerModule": "0x322813Fd9A801c5507c9de605d63CEA4f2CE6c44",
-      "LoanOperationsManagerModule": "0x09635F643e140090A9A8Dcd712eD6285858ceBef",
-      "CollateralManagerModule": "0x67d269191c92Caf3cD7723F116c85e6E9bf55933",
-      "LiquidationManagerModule": "0xc3e53F4d16Ae77Db1c982e75a937B9f60FE63690",
-      "CircuitBreakerModule": "0x4A679253410272dd5232B3Ff7cF5dbB88f295319",
-      "CommunityManagerModule": "0x9E545E3C0baAB3E08CdfD552C960A1050f373042",
-      "AdminModule": "0x1613beB3B2C4f22Ee086B2b38C1476A3cE7f78E8",
-      "PositionManagerViews": "0x851356ae760d987E095750cCeb3bC6014560891C",
-      "PositionManager": "0x95401dc811bb5740090279Ba06cfA8fcF6113778",
-      "OperationAuthorizationRegistry": "0x5f3f1dBD7B74C6B46e8c44f98792A1dAf8d69154",
-      "PKPValidation": "0x82e01223d51Eb87e16A03E24687EDF0F294da6f1"
+      "PriceFeedConsumer": "0x610178dA211FEF7D417bC0e6FeD39F05609AD788",
+      "BTCProofValidator": "0xA51c1fc2f0D1a1b8494Ed1FE312d7C3a78Ed91C0",
+      "UCDMintingRewards": "0x9A676e781A523b5d0C0e43731313A708CB607508",
+      "PositionManagerCoreModule": "0x959922bE3CAee4b8Cd9a407cc3ac1C251C2007B1",
+      "TermManagerModule": "0x68B1D87F95878fE05B998F19b66F4baba5De1aed",
+      "LoanOperationsManagerModule": "0x4ed7c70F96B99c776995fB64377f0d4aB3B0e1C1",
+      "CollateralManagerModule": "0xa85233C63b9Ee964Add6F2cffe00Fd84eb32338f",
+      "LiquidationManagerModule": "0x7a2088a1bFc9d81c55368AE168C2C02570cB814F",
+      "CircuitBreakerModule": "0xc6e7DF5E7b4f2A278906862b61205850344D4e7d",
+      "CommunityManagerModule": "0xc5a5C42992dECbae36851359345FE25997F5C42d",
+      "AdminModule": "0xE6E340D132b5f46d1e472DebcD681B2aBc16e57E",
+      "PositionManagerViews": "0xc3e53F4d16Ae77Db1c982e75a937B9f60FE63690",
+      "PositionManager": "0x9E545E3C0baAB3E08CdfD552C960A1050f373042",
+      "OperationAuthorizationRegistry": "0x5eb3Bc0a489C5A8288765d2336659EbCA68FCd00",
+      "PKPValidation": "0x4c5859f0F772848b2D91F1D83E2Fe57935348029"
     };
     ALL_DEPLOYMENTS = {
       sepolia: SEPOLIA_DEPLOYMENT,
@@ -12937,7 +12937,7 @@ function getSepoliaConfig() {
       operationAuthorizationRegistry: SEPOLIA_CONTRACTS.OperationAuthorizationRegistry || ""
     },
     subgraphs: {
-      diamondHandsUrl: "https://api.studio.thegraph.com/query/65258/diamond-hands/version/latest"
+      diamondHandsUrl: "https://api.studio.thegraph.com/query/65258/diamond-hands/v0.3.0-1765544881"
     },
     // litNetwork: "datil-test",
     debug: true
@@ -12991,8 +12991,14 @@ function getLocalhostConfig() {
   );
   logNetworkConfig("log", "[NetworkConfig] Localhost contracts:", {
     PositionManager: getAddress3("POSITION_MANAGER_ADDRESS", "PositionManager"),
-    PositionManagerCore: getAddress3("POSITION_MANAGER_CORE_ADDRESS", "PositionManagerCoreModule"),
-    LoanOperationsManagerModule: getAddress3("LOAN_OPERATIONS_MANAGER_ADDRESS", "LoanOperationsManagerModule"),
+    PositionManagerCore: getAddress3(
+      "POSITION_MANAGER_CORE_ADDRESS",
+      "PositionManagerCoreModule"
+    ),
+    LoanOperationsManagerModule: getAddress3(
+      "LOAN_OPERATIONS_MANAGER_ADDRESS",
+      "LoanOperationsManagerModule"
+    ),
     TermManagerModule: getAddress3("TERM_MANAGER_ADDRESS", "TermManagerModule"),
     UCDToken: getAddress3("UCD_TOKEN_ADDRESS", "UCDToken")
   });
@@ -13003,23 +13009,53 @@ function getLocalhostConfig() {
     name: "localhost",
     rpcUrls: ["http://localhost:8545"],
     contractAddresses: {
-      positionManager: getAddress3("POSITION_MANAGER_ADDRESS", "PositionManager"),
-      positionManagerCore: getAddress3("POSITION_MANAGER_CORE_ADDRESS", "PositionManagerCoreModule"),
-      positionManagerViews: getAddress3("POSITION_MANAGER_VIEWS_ADDRESS", "PositionManagerViews"),
+      positionManager: getAddress3(
+        "POSITION_MANAGER_ADDRESS",
+        "PositionManager"
+      ),
+      positionManagerCore: getAddress3(
+        "POSITION_MANAGER_CORE_ADDRESS",
+        "PositionManagerCoreModule"
+      ),
+      positionManagerViews: getAddress3(
+        "POSITION_MANAGER_VIEWS_ADDRESS",
+        "PositionManagerViews"
+      ),
       simplePsmV2: getAddress3("SIMPLE_PSM_V2_ADDRESS", "SimplePSMV2"),
-      loanOperationsManager: getAddress3("LOAN_OPERATIONS_MANAGER_ADDRESS", "LoanOperationsManagerModule"),
+      loanOperationsManager: getAddress3(
+        "LOAN_OPERATIONS_MANAGER_ADDRESS",
+        "LoanOperationsManagerModule"
+      ),
       termManager: getAddress3("TERM_MANAGER_ADDRESS", "TermManagerModule"),
-      circuitBreaker: getAddress3("CIRCUIT_BREAKER_ADDRESS", "CircuitBreakerModule"),
-      communityManager: getAddress3("COMMUNITY_MANAGER_ADDRESS", "CommunityManagerModule"),
-      liquidationManager: getAddress3("LIQUIDATION_MANAGER_ADDRESS", "LiquidationManagerModule"),
+      circuitBreaker: getAddress3(
+        "CIRCUIT_BREAKER_ADDRESS",
+        "CircuitBreakerModule"
+      ),
+      communityManager: getAddress3(
+        "COMMUNITY_MANAGER_ADDRESS",
+        "CommunityManagerModule"
+      ),
+      liquidationManager: getAddress3(
+        "LIQUIDATION_MANAGER_ADDRESS",
+        "LiquidationManagerModule"
+      ),
       ucdToken: getAddress3("UCD_TOKEN_ADDRESS", "UCDToken"),
       ucdController: getAddress3("UCD_CONTROLLER_ADDRESS", "UCDController"),
-      btcProofValidator: getAddress3("BTC_PROOF_VALIDATOR_ADDRESS", "BTCProofValidator"),
-      priceFeedConsumer: getAddress3("PRICE_FEED_CONSUMER_ADDRESS", "PriceFeedConsumer"),
-      operationAuthorizationRegistry: getAddress3("OPERATION_AUTHORIZATION_REGISTRY_ADDRESS", "OperationAuthorizationRegistry")
+      btcProofValidator: getAddress3(
+        "BTC_PROOF_VALIDATOR_ADDRESS",
+        "BTCProofValidator"
+      ),
+      priceFeedConsumer: getAddress3(
+        "PRICE_FEED_CONSUMER_ADDRESS",
+        "PriceFeedConsumer"
+      ),
+      operationAuthorizationRegistry: getAddress3(
+        "OPERATION_AUTHORIZATION_REGISTRY_ADDRESS",
+        "OperationAuthorizationRegistry"
+      )
     },
     subgraphs: {
-      diamondHandsUrl: "https://api.studio.thegraph.com/query/65258/diamond-hands/version/latest"
+      diamondHandsUrl: "https://api.studio.thegraph.com/query/65258/diamond-hands/v0.3.0-1765544881"
     },
     litNetwork: "datil",
     debug: true
@@ -41976,38 +42012,86 @@ var ContractManager = class {
       }
       const contractRunner = runner;
       const contracts = {
-        positionManager: PositionManager__factory.connect(
-          contractAddresses.positionManager,
-          contractRunner
-        ),
-        loanOperationsManager: ILoanOperationsManager__factory.connect(
-          contractAddresses.loanOperationsManager || ethers_exports.constants.AddressZero,
-          contractRunner
-        ),
-        ucdController: IUCDController__factory.connect(
-          contractAddresses.ucdToken,
-          contractRunner
-        ),
-        priceFeed: IPriceFeedConsumer__factory.connect(
-          contractAddresses.priceFeedConsumer,
-          contractRunner
-        ),
-        termManager: ITermManager__factory.connect(
-          contractAddresses.termManager || ethers_exports.constants.AddressZero,
-          contractRunner
-        ),
-        circuitBreaker: CircuitBreakerModule__factory.connect(
-          contractAddresses.circuitBreaker || ethers_exports.constants.AddressZero,
-          contractRunner
-        ),
-        communityManager: ICommunityManager__factory.connect(
-          contractAddresses.communityManager || ethers_exports.constants.AddressZero,
-          contractRunner
-        ),
-        liquidationManager: ILiquidationManager__factory.connect(
-          contractAddresses.liquidationManager || ethers_exports.constants.AddressZero,
-          contractRunner
-        )
+        positionManager: (() => {
+          try {
+            return PositionManager__factory.connect(
+              contractAddresses.positionManager,
+              contractRunner
+            );
+          } catch (error) {
+            throw new Error(`Failed to connect to PositionManager at ${contractAddresses.positionManager}: ${error}`);
+          }
+        })(),
+        loanOperationsManager: (() => {
+          try {
+            return ILoanOperationsManager__factory.connect(
+              contractAddresses.loanOperationsManager || ethers_exports.constants.AddressZero,
+              contractRunner
+            );
+          } catch (error) {
+            throw new Error(`Failed to connect to LoanOperationsManager at ${contractAddresses.loanOperationsManager}: ${error}`);
+          }
+        })(),
+        ucdController: (() => {
+          try {
+            return IUCDController__factory.connect(
+              contractAddresses.ucdToken,
+              contractRunner
+            );
+          } catch (error) {
+            throw new Error(`Failed to connect to UCDController at ${contractAddresses.ucdToken}: ${error}`);
+          }
+        })(),
+        priceFeed: (() => {
+          try {
+            return IPriceFeedConsumer__factory.connect(
+              contractAddresses.priceFeedConsumer,
+              contractRunner
+            );
+          } catch (error) {
+            throw new Error(`Failed to connect to PriceFeed at ${contractAddresses.priceFeedConsumer}: ${error}`);
+          }
+        })(),
+        termManager: (() => {
+          try {
+            return ITermManager__factory.connect(
+              contractAddresses.termManager || ethers_exports.constants.AddressZero,
+              contractRunner
+            );
+          } catch (error) {
+            throw new Error(`Failed to connect to TermManager at ${contractAddresses.termManager}: ${error}`);
+          }
+        })(),
+        circuitBreaker: (() => {
+          try {
+            return CircuitBreakerModule__factory.connect(
+              contractAddresses.circuitBreaker || ethers_exports.constants.AddressZero,
+              contractRunner
+            );
+          } catch (error) {
+            throw new Error(`Failed to connect to CircuitBreaker at ${contractAddresses.circuitBreaker}: ${error}`);
+          }
+        })(),
+        communityManager: (() => {
+          try {
+            return ICommunityManager__factory.connect(
+              contractAddresses.communityManager || ethers_exports.constants.AddressZero,
+              contractRunner
+            );
+          } catch (error) {
+            throw new Error(`Failed to connect to CommunityManager at ${contractAddresses.communityManager}: ${error}`);
+          }
+        })(),
+        liquidationManager: (() => {
+          try {
+            return ILiquidationManager__factory.connect(
+              contractAddresses.liquidationManager || ethers_exports.constants.AddressZero,
+              contractRunner
+            );
+          } catch (error) {
+            throw new Error(`Failed to connect to LiquidationManager at ${contractAddresses.liquidationManager}: ${error}`);
+          }
+        })()
       };
       this.contracts = contracts;
       return success(contracts);
@@ -43687,6 +43771,55 @@ var LoanQuery = class {
       })
     );
   }
+  /**
+   * Get loans with BTC balance data from Bitcoin network
+   * 
+   * Same as getLoans but includes actual Bitcoin balance for each position's vault.
+   * Queries BTC balances in parallel for performance.
+   *
+   * @param filters - Query filters
+   * @param pagination - Pagination parameters
+   * @returns Paginated loans response with BTC balance data
+   */
+  async getLoansWithBtc(filters = {}, pagination) {
+    const page = pagination?.page || 0;
+    const pageSize = pagination?.pageSize || this.defaultPageSize;
+    const skip = page * pageSize;
+    if (!filters.borrower) {
+      if (this.config.debug) {
+        log.info("\u26A0\uFE0F  getLoansWithBtc only supports borrower filter, falling back to getLoans");
+      }
+      return this.getLoans(filters, pagination);
+    }
+    if (this.config.debug) {
+      log.info("\u{1F50D} Querying loans with BTC balance data", { filters, page, pageSize, skip });
+    }
+    return tryCatchAsync(
+      async () => {
+        const result = await this.config.graphClient.getUserPositionsWithBtc(
+          filters.borrower,
+          pageSize,
+          skip,
+          filters.orderBy || "createdAt",
+          filters.orderDirection || "desc"
+        );
+        const enrichedLoans = await this.enrichLoansWithVaultAddresses(result.positions);
+        return {
+          loans: enrichedLoans,
+          page,
+          maxRows: pageSize,
+          totalLoans: result.total
+        };
+      },
+      (error) => new SDKError({
+        message: "Failed to query loans with BTC balance",
+        category: "SUBGRAPH" /* SUBGRAPH */,
+        severity: "MEDIUM" /* MEDIUM */,
+        originalError: error instanceof Error ? error : new Error(String(error)),
+        context: { filters, page, pageSize }
+      })
+    );
+  }
   /**
    * Enrich loans with vault addresses derived from PKP public keys
    *
@@ -44272,7 +44405,10 @@ async function getBitcoinAddressesFromPkp(pkpPublicKey) {
 var BitcoinUtils = class {
   static validateAddress(address) {
     const base58Pattern = /^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]+$/;
-    return base58Pattern.test(address) && address.length >= 26 && address.length <= 35;
+    const isBase58 = base58Pattern.test(address) && address.length >= 26 && address.length <= 35;
+    const bech32Pattern = /^(bc1|tb1|bcrt1)[a-z0-9]{39,87}$/;
+    const isBech32 = bech32Pattern.test(address);
+    return isBase58 || isBech32;
   }
   static formatTransaction(hash3, amount, recipient) {
     return {
@@ -45654,7 +45790,8 @@ var MIN_BITCOIN_PROVIDERS_FOR_CONSENSUS = 2;
 var DiamondHandsGraph = class {
   client;
   defaultPageSize;
-  constructor(config) {
+  bitcoinOps;
+  constructor(config, bitcoinOps) {
     this.client = new GraphClient({
       endpoint: config.endpoint,
       requestTimeoutMs: config.requestTimeoutMs,
@@ -45662,12 +45799,14 @@ var DiamondHandsGraph = class {
       headers: config.headers
     });
     this.defaultPageSize = config.defaultPageSize ?? 100;
+    this.bitcoinOps = bitcoinOps;
   }
   /**
    * Transform graph position data to LoanData interface
    * Converts flat graph structure to nested LoanData structure
    */
   transformGraphPositionToLoanData(graphPosition) {
+    const ucdDebt = graphPosition.ucdDebt ? Number(graphPosition.ucdDebt) : 0;
     return {
       id: graphPosition.id,
       pkpId: graphPosition.pkpId,
@@ -45680,14 +45819,16 @@ var DiamondHandsGraph = class {
       loan: {
         ucdMinted: graphPosition.ucdMinted ? Number(graphPosition.ucdMinted) : 0,
         ucdPaid: graphPosition.ucdPaid ? Number(graphPosition.ucdPaid) : 0,
-        ucdDebt: graphPosition.ucdDebt ? Number(graphPosition.ucdDebt) : 0,
+        ucdDebt,
         selectedTerm: graphPosition.selectedTerm ? Number(graphPosition.selectedTerm) : 0,
         status: graphPosition.status,
         expiryAt: graphPosition.expiryAt ? Number(graphPosition.expiryAt) : 0
       },
       collateral: {
         vaultAddress: graphPosition.vaultAddress || ""
-      }
+      },
+      // Backwards compatibility: provide ucdDebt at top level for components expecting flat structure
+      ucdDebt
     };
   }
   /**
@@ -45731,10 +45872,7 @@ var DiamondHandsGraph = class {
           }
         }
       `;
-      const result = await this.client.execute(
-        query,
-        { ...variables, skip }
-      );
+      const result = await this.client.execute(query, { ...variables, skip });
       const items = result && result["positions"] || [];
       totalCount += items.length;
       hasMore = items.length === batchSize;
@@ -45786,10 +45924,9 @@ var DiamondHandsGraph = class {
       query,
       variables
     );
-    const total = await this.getTotalCountPaginated(
-      "{ borrower: $borrower }",
-      { borrower: userAddress.toLowerCase() }
-    );
+    const total = await this.getTotalCountPaginated("{ borrower: $borrower }", {
+      borrower: userAddress.toLowerCase()
+    });
     let positions = [];
     if (result && result.user && Array.isArray(result.user.positions)) {
       positions = result.user.positions.filter((p) => p != null).map((p) => this.transformGraphPositionToLoanData(p));
@@ -45799,6 +45936,137 @@ var DiamondHandsGraph = class {
       total
     };
   }
+  /**
+   * Get user positions with enriched Bitcoin balance data
+   *
+   * Same as getUserPositions but queries actual BTC balance from Bitcoin network
+   * for each vault address in parallel.
+   *
+   * @param userAddress - User's Ethereum address
+   * @param first - Optional: max number of positions to return (default: 10)
+   * @param skip - Optional: number of positions to skip (default: 0)
+   * @param orderBy - Optional: field to order by (default: "createdAt")
+   * @param orderDirection - Optional: asc or desc (default: "desc" - most recent first)
+   * @returns Positions with actual BTC balances from Bitcoin network
+   */
+  async getUserPositionsWithBtc(userAddress, first = 10, skip = 0, orderBy = "createdAt", orderDirection = "desc") {
+    const result = await this.getUserPositions(
+      userAddress,
+      first,
+      skip,
+      orderBy,
+      orderDirection
+    );
+    if (!this.bitcoinOps) {
+      console.warn(
+        "[DiamondHandsGraph] BitcoinOperations not available - returning positions without BTC balance"
+      );
+      return result;
+    }
+    const positionsWithPkp = result.positions.filter(
+      (p) => p.pkpId && p.pkpId !== ""
+    );
+    if (positionsWithPkp.length === 0) {
+      console.log("[DiamondHandsGraph] No positions with PKP IDs to check");
+      return result;
+    }
+    console.log(
+      `[DiamondHandsGraph] Deriving Bitcoin addresses and querying balances for ${positionsWithPkp.length} positions in parallel...`
+    );
+    const balancePromises = positionsWithPkp.map(async (position) => {
+      try {
+        const pkpPublicKey = await getPKPPublicKeyFromTokenId(position.pkpId);
+        const addressResult = await this.bitcoinOps.deriveAddresses(
+          pkpPublicKey
+        );
+        if (!addressResult.success) {
+          console.warn(
+            `[DiamondHandsGraph] Failed to derive address for PKP public key ${pkpPublicKey}:`,
+            addressResult.error
+          );
+          return {
+            pkpId: position.pkpId,
+            address: null,
+            balance: null,
+            addresses: null
+          };
+        }
+        const addresses = addressResult.value;
+        const btcAddress = addresses.regtest || addresses.testnet || addresses.mainnet;
+        if (!btcAddress) {
+          console.warn(
+            `[DiamondHandsGraph] No Bitcoin address available for PKP ${position.pkpId}`
+          );
+          return {
+            pkpId: position.pkpId,
+            address: null,
+            balance: null,
+            addresses
+          };
+        }
+        const balanceResult = await this.bitcoinOps.getBalance(btcAddress);
+        if (balanceResult.success) {
+          return {
+            pkpId: position.pkpId,
+            address: btcAddress,
+            balance: balanceResult.value,
+            addresses
+          };
+        } else {
+          console.warn(
+            `[DiamondHandsGraph] Failed to get balance for ${btcAddress}:`,
+            balanceResult.error
+          );
+          return {
+            pkpId: position.pkpId,
+            address: btcAddress,
+            balance: null,
+            addresses
+          };
+        }
+      } catch (error) {
+        console.error(
+          `[DiamondHandsGraph] Error processing PKP ${position.pkpId}:`,
+          error
+        );
+        return {
+          pkpId: position.pkpId,
+          address: null,
+          balance: null,
+          addresses: null
+        };
+      }
+    });
+    const balanceResults = await Promise.all(balancePromises);
+    const balanceMap = /* @__PURE__ */ new Map();
+    balanceResults.forEach(({ pkpId, address, balance, addresses }) => {
+      balanceMap.set(pkpId, { address, balance, addresses });
+    });
+    console.log(
+      `[DiamondHandsGraph] Retrieved ${balanceResults.length} BTC balances`
+    );
+    const enrichedPositions = result.positions.map((position) => {
+      if (!position.pkpId) {
+        return position;
+      }
+      const data = balanceMap.get(position.pkpId);
+      if (!data) {
+        return position;
+      }
+      return {
+        ...position,
+        collateral: {
+          ...position.collateral,
+          vaultAddress: data.address || position.collateral?.vaultAddress || ""
+        },
+        btcBalance: data.balance || void 0
+      };
+    });
+    return {
+      positions: enrichedPositions,
+      total: result.total
+    };
+  }
   /**
    * Get position by PKP ID from subgraph
    */
@@ -45901,10 +46169,7 @@ var DiamondHandsGraph = class {
     const variables = {
       pkpId: pkpId.toLowerCase()
     };
-    const result = await this.client.execute(
-      query,
-      variables
-    );
+    const result = await this.client.execute(query, variables);
     if (!result || !result.positions) {
       return null;
     }
@@ -45981,10 +46246,7 @@ var DiamondHandsGraph = class {
     const variables = {
       positionId: positionId.toLowerCase()
     };
-    const result = await this.client.execute(
-      query,
-      variables
-    );
+    const result = await this.client.execute(query, variables);
     if (!result || !result.positions) {
       return null;
     }
@@ -46057,10 +46319,12 @@ var DiamondHandsGraph = class {
         }
       }
     `;
-    const result = await this.client.execute(
-      query,
-      { first, skip, orderBy, orderDirection }
-    );
+    const result = await this.client.execute(query, {
+      first,
+      skip,
+      orderBy,
+      orderDirection
+    });
     const total = await this.getTotalCountPaginated();
     const positions = result && result.positions || [];
     const transformedPositions = positions.map(
@@ -46102,10 +46366,13 @@ var DiamondHandsGraph = class {
         }
       }
     `;
-    const result = await this.client.execute(
-      query,
-      { first, skip, statuses, orderBy, orderDirection }
-    );
+    const result = await this.client.execute(query, {
+      first,
+      skip,
+      statuses,
+      orderBy,
+      orderDirection
+    });
     const total = await this.getTotalCountPaginated(
       "{ status_in: $statuses }",
       { statuses }
@@ -46226,7 +46493,10 @@ var DiamondHandsGraph = class {
     `;
     const first = options?.first ?? this.defaultPageSize;
     const skip = options?.skip ?? 0;
-    const result = await this.client.execute(query, { first, skip });
+    const result = await this.client.execute(
+      query,
+      { first, skip }
+    );
     return result.loanTerms || [];
   }
   /**
@@ -46248,7 +46518,10 @@ var DiamondHandsGraph = class {
         }
       }
     `;
-    const result = await this.client.execute(query, { id: id3 });
+    const result = await this.client.execute(
+      query,
+      { id: id3 }
+    );
     return result.loanTerm || null;
   }
   // ============================================================================
@@ -46365,7 +46638,13 @@ var DiamondHandsGraph = class {
    * Get PSM transactions with filters
    */
   async getPSMTransactions(filters) {
-    const { user, stablecoin, type, first = this.defaultPageSize, skip = 0 } = filters || {};
+    const {
+      user,
+      stablecoin,
+      type,
+      first = this.defaultPageSize,
+      skip = 0
+    } = filters || {};
     let whereConditions = [];
     if (user)
       whereConditions.push(`user: "${user.toLowerCase()}"`);
@@ -46425,7 +46704,10 @@ var DiamondHandsGraph = class {
       }
     `;
     const variables = { first };
-    const result = await this.client.execute(query, variables);
+    const result = await this.client.execute(
+      query,
+      variables
+    );
     return result.psmDailyMetrics || [];
   }
   // ============================================================================
@@ -46560,19 +46842,21 @@ var DiamondHandsGraph = class {
       orderDirection
     };
     const result = await this.client.execute(query, variables);
-    const payments = (result.position?.payments || []).map((p) => ({
-      id: p.id,
-      positionId,
-      payer: p.payer.id,
-      amount: p.amount,
-      type: p.type,
-      transactionHash: p.transactionHash,
-      timestamp: p.timestamp,
-      blockNumber: p.blockNumber,
-      logIndex: p.logIndex,
-      newDebt: p.newDebt,
-      newCollateralRatio: p.newCollateralRatio
-    }));
+    const payments = (result.position?.payments || []).map(
+      (p) => ({
+        id: p.id,
+        positionId,
+        payer: p.payer.id,
+        amount: p.amount,
+        type: p.type,
+        transactionHash: p.transactionHash,
+        timestamp: p.timestamp,
+        blockNumber: p.blockNumber,
+        logIndex: p.logIndex,
+        newDebt: p.newDebt,
+        newCollateralRatio: p.newCollateralRatio
+      })
+    );
     const statusUpdates = (result.position?.statusUpdates || []).map((s) => ({
       id: s.id,
       positionId,
@@ -46774,10 +47058,10 @@ function createMockTokenManager(config) {
 var import_dh_lit_ops = require("@gvnrdao/dh-lit-ops");
 
 // src/utils/telegram-messaging.utils.ts
-var import_node_telegram_bot_api = __toESM(require("node-telegram-bot-api"));
+var TelegramBot = null;
 async function sendTelegramMessage(chatId, chatToken, message, threadId) {
   try {
-    const bot = new import_node_telegram_bot_api.default(chatToken, { polling: false });
+    const bot = new TelegramBot(chatToken, { polling: false });
     const options = {
       disable_web_page_preview: true
     };
@@ -46917,13 +47201,16 @@ var DiamondHandsSDK = class _DiamondHandsSDK {
         "Diamond Hands subgraph URL is required. Please provide config.subgraphs.diamondHandsUrl"
       );
     }
-    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
-    });
+    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
+      },
+      this.bitcoinOperations
+    );
     const loanQueryResult = createLoanQuery({
       graphClient: this.graphClient,
       bitcoinOperations: this.bitcoinOperations,
@@ -47746,7 +48033,7 @@ var DiamondHandsSDK = class _DiamondHandsSDK {
         validationResponse.timestamp,
         signatureBytes
       );
-      const receipt = await tx.wait();
+      const receipt = await tx.wait(1, 3e5);
       let amountMinted;
       let positionId;
       if (receipt && receipt.logs && receipt.logs.length > 0) {