Add Bitcoin UTXO verification table to BTC monitoring page (#145)

Display live UTXOs from Bitcoin Core with mempool.space links
for independent on-chain balance verification.

Author: TaprootFreak

src/assets/monitoring-btc.html

@@ -98,6 +98,13 @@ <h2>BTC Balance History</h2>
     <div class="loading">Loading BTC monitoring data...</div>
   </div>
 
+  <div class="section">
+    <h2>Bitcoin Core UTXOs (On-Chain Verification)</h2>
+    <div id="utxo-content">
+      <div class="loading">Loading UTXO data...</div>
+    </div>
+  </div>
+
   <script src="/monitoring/chart.min.js"></script>
   <script src="/monitoring/chartjs-adapter-date-fns.min.js"></script>
   <script src="/monitoring/btc.js"></script>

src/assets/monitoring-btc.js

@@ -198,8 +198,48 @@ function renderChart(points) {
   });
 }
 
+async function loadUtxos() {
+  var container = document.getElementById('utxo-content');
+  try {
+    var res = await fetch('/monitoring/btc/utxos');
+    if (!res.ok) throw new Error('HTTP ' + res.status);
+    var data = await res.json();
+    renderUtxos(data);
+  } catch (e) {
+    container.innerHTML = '<div class="error">Failed to load UTXOs: ' + e.message + '</div>';
+  }
+}
+
+function renderUtxos(data) {
+  var container = document.getElementById('utxo-content');
+  var html = '<table>';
+  html += '<tr><th>TXID</th><th>Vout</th><th>Address</th><th class="number">BTC</th><th class="number">Confirmations</th></tr>';
+
+  for (var i = 0; i < data.utxos.length; i++) {
+    var u = data.utxos[i];
+    var shortTxid = u.txid.substring(0, 8) + '...' + u.txid.substring(u.txid.length - 8);
+    html += '<tr>';
+    html += '<td><a href="https://mempool.space/tx/' + u.txid + '" target="_blank" rel="noopener">' + shortTxid + '</a></td>';
+    html += '<td>' + u.vout + '</td>';
+    html += '<td>' + u.address + '</td>';
+    html += '<td class="number">' + fmtBtc(u.amount) + '</td>';
+    html += '<td class="number">' + u.confirmations.toLocaleString() + '</td>';
+    html += '</tr>';
+  }
+
+  html += '<tr class="total-row">';
+  html += '<td>' + data.count + ' UTXOs</td><td></td><td></td>';
+  html += '<td class="number">' + fmtBtc(data.totalAmount) + '</td>';
+  html += '<td></td>';
+  html += '</tr>';
+  html += '</table>';
+
+  container.innerHTML = html;
+}
+
 loadData();
 loadChart('24h');
+loadUtxos();
 
 var rangeButtons = document.querySelectorAll('.range-buttons button[data-range]');
 for (var i = 0; i < rangeButtons.length; i++) {

src/integration/blockchain/bitcoin/bitcoin-client.ts

@@ -2,6 +2,14 @@ import { Config } from 'src/config/config';
 import { HttpRequestConfig, HttpService } from 'src/shared/services/http.service';
 import { LightningHelper } from '../lightning/lightning-helper';
 
+export interface UnspentUtxo {
+  txid: string;
+  vout: number;
+  address: string;
+  amount: number;
+  confirmations: number;
+}
+
 export class BitcoinClient {
   constructor(private readonly http: HttpService) {}
 
@@ -24,6 +32,23 @@ export class BitcoinClient {
     return LightningHelper.btcToSat(balanceResult);
   }
 
+  async listUnspent(): Promise<UnspentUtxo[]> {
+    const url = Config.blockchain.bitcoin.gatewayUrl;
+
+    return this.http
+      .post<{ result: UnspentUtxo[] }>(
+        url,
+        {
+          id: 1,
+          jsonrpc: '2.0',
+          method: 'listunspent',
+          params: [1, 9999999],
+        },
+        this.httpConfig(),
+      )
+      .then((r) => r.result);
+  }
+
   // --- HELPER --- //
   private httpConfig(): HttpRequestConfig {
     return {

src/subdomains/monitoring/controllers/monitoring.controller.ts

@@ -3,6 +3,8 @@ import { ApiExcludeEndpoint } from '@nestjs/swagger';
 import { Response } from 'express';
 import { readFileSync } from 'fs';
 import { join } from 'path';
+import { UnspentUtxo } from 'src/integration/blockchain/bitcoin/bitcoin-client';
+import { BitcoinService } from 'src/integration/blockchain/bitcoin/bitcoin.service';
 import { EvmTokenBalanceJson } from '../dto/monitoring.dto';
 import { MonitoringBalanceRepository } from '../repositories/monitoring-balance.repository';
 import { MonitoringEvmBalanceRepository } from '../repositories/monitoring-evm-balance.repository';
@@ -14,6 +16,7 @@ export class MonitoringController {
     private readonly monitoringRepo: MonitoringRepository,
     private readonly monitoringBalanceRepo: MonitoringBalanceRepository,
     private readonly monitoringEvmBalanceRepo: MonitoringEvmBalanceRepository,
+    private readonly bitcoinService: BitcoinService,
   ) {}
 
   @Get()
@@ -44,6 +47,14 @@ export class MonitoringController {
     );
   }
 
+  @Get('btc/utxos')
+  @ApiExcludeEndpoint()
+  async btcUtxos(): Promise<{ utxos: UnspentUtxo[]; count: number; totalAmount: number }> {
+    const utxos = await this.bitcoinService.getDefaultClient().listUnspent();
+    const totalAmount = utxos.reduce((sum, u) => sum + u.amount, 0);
+    return { utxos, count: utxos.length, totalAmount };
+  }
+
   @Get('usd')
   @ApiExcludeEndpoint()
   async usdPage(@Res() res: Response): Promise<void> {