@megatao/sdk 1.1.0

package/cli/commands/market.ts

@@ -0,0 +1,590 @@
+/**
+ * Market Commands - View market data and analytics
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import Table from 'cli-table3';
+import { AlphaFuturesClient } from '../../src';
+import { formatUSD, formatPercentage, formatNumber, formatTAO } from '../../src/utils';
+import {
+  getClient,
+  handleError,
+  getMarketAddress,
+  listAvailableMarketAddresses,
+} from '../utils/client';
+import { createPriceChart, createVolumeChart } from '../utils/display';
+
+export function marketCommands(program: Command) {
+  const market = program
+    .command('market')
+    .alias('mkt')
+    .description('View market data and analytics');
+
+  // Price command
+  market
+    .command('price <asset>')
+    .description('Get current price and 24h statistics')
+    .option('-w, --watch', 'Watch price in real-time')
+    .option('-i, --interval <seconds>', 'Update interval (default: 5)', '5')
+    .action(async (asset, options) => {
+      const spinner = ora('Loading price data...').start();
+
+      try {
+        const client = await getClient(program.opts());
+        asset = asset.toUpperCase();
+
+        const displayPrice = async () => {
+          const marketAddress = getMarketAddress(asset);
+          const currentPrice = await client.oracle.getPrice(marketAddress);
+          // Note: Monolith doesn't have getLatestPriceData method
+          const currentTime = Math.floor(Date.now() / 1000);
+
+          if (!options.watch) spinner.stop();
+
+          console.clear();
+          console.log(chalk.bold(`\n💹 ${asset} Price Information:`));
+          console.log(`  Current Price: ${chalk.cyan(formatUSD(currentPrice))}`);
+          console.log(`  Last Update: ${new Date(currentTime * 1000).toLocaleString()}`);
+
+          // 24h statistics require external data indexing
+          console.log(chalk.bold('\n📊 24h Statistics:'));
+          console.log(`  ${chalk.yellow('⚠️  24h statistics require external indexing service')}`);
+          console.log(`  ${chalk.gray('Current implementation tracks real-time data only')}`);
+
+          if (program.opts().json) {
+            console.log(
+              '\n' +
+                JSON.stringify(
+                  {
+                    asset,
+                    price: currentPrice.toString(),
+                    timestamp: currentTime.toString(),
+                  },
+                  null,
+                  2,
+                ),
+            );
+          }
+        };
+
+        await displayPrice();
+
+        if (options.watch) {
+          const interval = parseInt(options.interval) * 1000;
+          setInterval(displayPrice, interval);
+
+          console.log(chalk.gray(`\nWatching price... (Ctrl+C to stop)`));
+
+          process.on('SIGINT', () => {
+            console.log(chalk.yellow('\n\nStopped watching'));
+            process.exit(0);
+          });
+        }
+      } catch (error) {
+        spinner.fail('Failed to load price data');
+        handleError(error, program.opts());
+      }
+    });
+
+  // Funding rate command (redirects to main funding command)
+  market
+    .command('funding [asset]')
+    .description('View funding rates (use "alpha-futures funding rate" for full features)')
+    .option('-h, --history', 'Show funding rate history')
+    .action(async (asset, options) => {
+      console.log(chalk.yellow('\n💡 Funding Rate Information:'));
+      console.log(chalk.gray('This command has been consolidated with the main funding command.'));
+      console.log(chalk.cyan('\nFor comprehensive funding rate information, use:'));
+      if (asset) {
+        console.log(chalk.white(`  alpha-futures funding rate ${asset}`));
+      } else {
+        console.log(chalk.white('  alpha-futures funding rate --all'));
+      }
+      if (options.history) {
+        console.log(chalk.white('  alpha-futures funding history'));
+      }
+    });
+
+  // Open interest command
+  market
+    .command('oi [asset]')
+    .alias('openinterest')
+    .description('View open interest statistics')
+    .option('-d, --detailed', 'Show detailed breakdown')
+    .action(async (asset, options) => {
+      const spinner = ora('Loading open interest...').start();
+
+      try {
+        const client = await getClient(program.opts());
+
+        spinner.stop();
+
+        console.log(chalk.bold('\n📊 Open Interest Statistics:'));
+
+        if (asset) {
+          asset = asset.toUpperCase();
+
+          const marketAddress = getMarketAddress(asset);
+          try {
+            const openInterest = await client.getAlpha().getMarketOpenInterest(marketAddress);
+            const totalOI = openInterest.longOI + openInterest.shortOI;
+            const longRatio =
+              totalOI > 0n ? (Number(openInterest.longOI) * 100) / Number(totalOI) : 0;
+            const shortRatio =
+              totalOI > 0n ? (Number(openInterest.shortOI) * 100) / Number(totalOI) : 0;
+
+            console.log(`\n${chalk.cyan(asset)} Open Interest:`);
+            console.log(`  Total OI: ${formatUSD(totalOI)}`);
+            console.log(`  Long OI: ${formatUSD(openInterest.longOI)} (${longRatio.toFixed(1)}%)`);
+            console.log(
+              `  Short OI: ${formatUSD(openInterest.shortOI)} (${shortRatio.toFixed(1)}%)`,
+            );
+
+            if (totalOI > 0n) {
+              const ratio = Number(openInterest.longOI) / Number(openInterest.shortOI);
+              console.log(`  Long/Short Ratio: ${ratio.toFixed(2)}`);
+
+              // Show skew indicator
+              if (longRatio > 60) {
+                console.log(`  ${chalk.red('⚠️  Long-heavy market (potential funding payments)')}`);
+              } else if (shortRatio > 60) {
+                console.log(
+                  `  ${chalk.red('⚠️  Short-heavy market (potential funding payments)')}`,
+                );
+              } else {
+                console.log(`  ${chalk.green('✅  Balanced market')}`);
+              }
+            }
+          } catch (error) {
+            console.log(`\n${chalk.cyan(asset)} Open Interest:`);
+            console.log(`  ${chalk.yellow('⚠️  Unable to fetch open interest data')}`);
+            console.log(`  ${chalk.gray('Contract may not be properly initialized')}`);
+          }
+        } else {
+          // Overview of all assets
+          const table = new Table({
+            head: ['Asset', 'Total OI', 'Long OI', 'Short OI', 'L/S Ratio', 'Skew'],
+            colWidths: [10, 15, 15, 15, 12, 10],
+          });
+
+          // Get open interest for all markets
+          const availableMarkets = listAvailableMarketAddresses();
+          const markets = Object.keys(availableMarkets);
+
+          for (const asset of markets) {
+            try {
+              const marketAddress = getMarketAddress(asset);
+              const openInterest = await client.getAlpha().getMarketOpenInterest(marketAddress);
+              const totalOI = openInterest.longOI + openInterest.shortOI;
+              const longRatio =
+                totalOI > 0n ? (Number(openInterest.longOI) * 100) / Number(totalOI) : 0;
+              const shortRatio =
+                totalOI > 0n ? (Number(openInterest.shortOI) * 100) / Number(totalOI) : 0;
+              const ratio =
+                totalOI > 0n ? Number(openInterest.longOI) / Number(openInterest.shortOI) : 0;
+
+              // Calculate skew percentage
+              const skew =
+                totalOI > 0n
+                  ? ((Number(openInterest.longOI) - Number(openInterest.shortOI)) /
+                      Number(totalOI)) *
+                    100
+                  : 0;
+              const skewDisplay = skew > 0 ? `+${skew.toFixed(1)}%` : `${skew.toFixed(1)}%`;
+
+              table.push([
+                asset,
+                formatUSD(totalOI),
+                formatUSD(openInterest.longOI),
+                formatUSD(openInterest.shortOI),
+                ratio > 0 ? ratio.toFixed(2) : 'N/A',
+                totalOI > 0n ? skewDisplay : 'N/A',
+              ]);
+            } catch (error) {
+              table.push([
+                asset,
+                chalk.gray('Error'),
+                chalk.gray('Error'),
+                chalk.gray('Error'),
+                chalk.gray('N/A'),
+                chalk.gray('N/A'),
+              ]);
+            }
+          }
+
+          console.log(table.toString());
+          console.log(chalk.gray('\n✅  Live open interest data from contract'));
+        }
+
+        if (options.detailed) {
+          console.log(chalk.bold('\n📈 OI Distribution Analysis:'));
+          console.log(
+            `  ${chalk.yellow('⚠️  Position size distribution requires event indexing')}`,
+          );
+          console.log(`  ${chalk.gray('Available: Total OI, Long/Short breakdown, Market skew')}`);
+          console.log(
+            `  ${chalk.gray('Missing: Individual position size analysis, trader distribution')}`,
+          );
+        }
+      } catch (error) {
+        spinner.fail('Failed to load open interest');
+        handleError(error, program.opts());
+      }
+    });
+
+  // Stats command
+  market
+    .command('stats')
+    .description('View protocol-wide statistics')
+    .option('-p, --period <period>', 'Time period: 24h, 7d, 30d', '24h')
+    .action(async (options) => {
+      const spinner = ora('Loading protocol statistics...').start();
+
+      try {
+        const client = await getClient(program.opts());
+        const alpha = client.getAlpha();
+
+        // Get vault stats
+        const vaultStats = await alpha.getVaultStats();
+        const totalReserves = vaultStats.totalReserves;
+        const insuranceFund = 0n; // Not available in alpha structure
+
+        spinner.stop();
+
+        console.log(chalk.bold('\n📊 Protocol Statistics:'));
+        console.log(chalk.gray(`Period: ${options.period}`));
+
+        console.log(chalk.bold('\n💰 Vault Status:'));
+        console.log(`  Total Reserves: ${formatUSD(totalReserves)}`);
+        console.log(`  Insurance Fund: ${formatUSD(insuranceFund)}`);
+        console.log(`  Utilization: ${chalk.gray('Coming soon')}`);
+
+        console.log(chalk.bold('\n📈 Trading Volume:'));
+        console.log(`  ${options.period} Volume: ${chalk.gray('Coming soon')}`);
+        console.log(`  Total Volume: ${chalk.gray('Coming soon')}`);
+        console.log(`  Active Traders: ${chalk.gray('Coming soon')}`);
+        console.log(`  Total Trades: ${chalk.gray('Coming soon')}`);
+
+        // Try to get current funding rates for context
+        try {
+          const availableMarkets = listAvailableMarketAddresses();
+          const markets = Object.keys(availableMarkets);
+
+          console.log(chalk.bold('\n🔄 Current Funding Rates:'));
+          for (const asset of markets.slice(0, 3)) {
+            // Limit to first 3 to avoid spam
+            try {
+              const marketAddress = getMarketAddress(asset);
+              const fundingRate = await alpha.getFundingRate(marketAddress);
+              console.log(`  ${asset}: ${formatPercentage(fundingRate)} (per 8h)`);
+            } catch (e) {
+              console.log(`  ${asset}: ${chalk.gray('N/A')}`);
+            }
+          }
+        } catch (e) {
+          console.log(chalk.bold('\n🔄 Funding Rates:'));
+          console.log(`  ${chalk.gray('Unable to fetch current rates')}`);
+        }
+
+        console.log(chalk.bold('\n💸 Historical Data:'));
+        console.log(`  ${chalk.yellow('⚠️  Trading volume, fees, and liquidation history')}`);
+        console.log(`  ${chalk.yellow('    require external indexing service')}`);
+        console.log(
+          `  ${chalk.gray('Available: Current vault balance, funding rates, open interest')}`,
+        );
+        console.log(
+          `  ${chalk.gray('Missing: Historical volume, fee collection, liquidation events')}`,
+        );
+      } catch (error) {
+        spinner.fail('Failed to load statistics');
+        handleError(error, program.opts());
+      }
+    });
+
+  // Orderbook command
+  market
+    .command('book <asset>')
+    .alias('orderbook')
+    .description('View orderbook for an asset')
+    .option('-d, --depth <levels>', 'Number of levels to show', '10')
+    .option('-w, --watch', 'Watch orderbook in real-time')
+    .action(async (asset, options) => {
+      const spinner = ora('Loading orderbook...').start();
+
+      try {
+        const client = await getClient(program.opts());
+        const alpha = client.getAlpha();
+
+        asset = asset.toUpperCase();
+        const depth = parseInt(options.depth);
+        const marketAddress = getMarketAddress(asset);
+
+        const displayOrderbook = async () => {
+          // Get orderbook data using the orderBook client
+          const orderBookData = await client.orderBook.getOrderBook(marketAddress);
+          const { buyOrders: bids, sellOrders: asks } = orderBookData;
+
+          if (!options.watch) spinner.stop();
+
+          // Get current price
+          const currentPrice = await client.oracle.getPrice(marketAddress);
+
+          console.clear();
+          console.log(chalk.bold(`\n📖 ${asset} Orderbook:`));
+          console.log(`  Current Price: ${formatUSD(currentPrice)}`);
+
+          // Calculate spread if we have bids and asks
+          if (bids.length > 0 && asks.length > 0) {
+            const spreadInfo = await client.orderBook.getSpread(marketAddress);
+            const spread = spreadInfo.spread;
+            const spreadPercent = (Number(spread) * 100) / Number(currentPrice);
+            console.log(`  Spread: ${formatUSD(spread)} (${spreadPercent.toFixed(3)}%)`);
+          }
+
+          console.log('');
+
+          // Create orderbook table
+          const table = new Table({
+            head: [
+              chalk.green('Bid Price'),
+              chalk.green('Size'),
+              chalk.green('Total'),
+              '│',
+              chalk.red('Ask Price'),
+              chalk.red('Size'),
+              chalk.red('Total'),
+            ],
+            colWidths: [12, 12, 12, 3, 12, 12, 12],
+            style: { 'padding-left': 0, 'padding-right': 0 },
+          });
+
+          // Process bids and asks
+          let bidTotal = 0n;
+          let askTotal = 0n;
+
+          const maxRows = Math.max(bids.length, asks.length);
+
+          for (let i = 0; i < maxRows; i++) {
+            const bidRow = ['', '', ''];
+            const askRow = ['', '', ''];
+
+            if (i < bids.length) {
+              bidTotal += bids[i].size;
+              bidRow[0] = formatUSD(bids[i].price);
+              bidRow[1] = formatUSD(bids[i].size);
+              bidRow[2] = formatUSD(bidTotal);
+            }
+
+            if (i < asks.length) {
+              askTotal += asks[i].size;
+              askRow[0] = formatUSD(asks[i].price);
+              askRow[1] = formatUSD(asks[i].size);
+              askRow[2] = formatUSD(askTotal);
+            }
+
+            table.push([...bidRow, '│', ...askRow]);
+          }
+
+          console.log(table.toString());
+
+          // Show market depth stats
+          console.log(chalk.bold('\n📊 Market Depth:'));
+          console.log(`  Total Bids: ${formatUSD(bidTotal)}`);
+          console.log(`  Total Asks: ${formatUSD(askTotal)}`);
+          console.log(
+            `  Imbalance: ${bidTotal > askTotal ? chalk.green('+' + formatUSD(bidTotal - askTotal) + ' (bid heavy)') : chalk.red('-' + formatUSD(askTotal - bidTotal) + ' (ask heavy)')}`,
+          );
+
+          if (options.watch) {
+            console.log(chalk.gray('\n⟳ Refreshing every 2 seconds... (Ctrl+C to exit)'));
+          }
+        };
+
+        await displayOrderbook();
+
+        if (options.watch) {
+          // Update every 2 seconds
+          const interval = setInterval(displayOrderbook, 2000);
+
+          // Handle exit
+          process.on('SIGINT', () => {
+            clearInterval(interval);
+            console.log(chalk.yellow('\n\nStopped watching orderbook'));
+            process.exit(0);
+          });
+        }
+      } catch (error) {
+        spinner.fail('Failed to load orderbook');
+        // If orderbook not available, show a message
+        if (
+          error.message?.includes('function') ||
+          error.message?.includes('getOrderBook') ||
+          error.message?.includes('execution reverted')
+        ) {
+          console.log(chalk.yellow('\n⚠️  Orderbook functionality not available'));
+          console.log(
+            chalk.gray('This feature requires orderbook data from the protocol contracts.'),
+          );
+          console.log(chalk.gray('You can still view market prices and funding information.'));
+        } else {
+          handleError(error, program.opts());
+        }
+      }
+    });
+
+  // Markets overview command
+  market
+    .command('list')
+    .alias('ls')
+    .description('List all available markets')
+    .option('-s, --sort <field>', 'Sort by: volume, price, change', 'volume')
+    .action(async (options) => {
+      const spinner = ora('Loading markets...').start();
+
+      try {
+        const client = await getClient(program.opts());
+        const alpha = client.getAlpha();
+
+        spinner.stop();
+
+        console.log(chalk.bold('\n📈 Available Markets:'));
+
+        const table = new Table({
+          head: ['Asset', 'Price', '24h Change', '24h Volume', 'Funding', 'OI'],
+          colWidths: [10, 15, 15, 15, 15, 15],
+        });
+
+        // Get list of all markets from environment variables
+        const availableMarkets = listAvailableMarketAddresses();
+        const markets = Object.keys(availableMarkets);
+
+        for (const asset of markets) {
+          try {
+            const marketAddress = getMarketAddress(asset);
+            const price = await client.oracle.getPrice(marketAddress);
+            const fundingRate = await alpha.getFundingRate(marketAddress);
+
+            // Get open interest
+            let openInterestDisplay = chalk.gray('N/A');
+            try {
+              const openInterest = await alpha.getMarketOpenInterest(marketAddress);
+              const totalOI = openInterest.longOI + openInterest.shortOI;
+              openInterestDisplay = formatUSD(totalOI);
+            } catch {
+              openInterestDisplay = chalk.gray('N/A');
+            }
+
+            table.push([
+              asset,
+              formatUSD(price),
+              chalk.gray('N/A'), // 24h change
+              chalk.gray('N/A'), // 24h volume
+              formatPercentage(fundingRate),
+              openInterestDisplay,
+            ]);
+          } catch (e) {
+            table.push([
+              asset,
+              chalk.gray('N/A'),
+              chalk.gray('N/A'),
+              chalk.gray('N/A'),
+              chalk.gray('N/A'),
+              chalk.gray('N/A'),
+            ]);
+          }
+        }
+
+        console.log(table.toString());
+        console.log(chalk.gray('\n✅  Live data: prices, funding rates, open interest'));
+        console.log(chalk.yellow('⚠️  24h statistics require external indexing service'));
+      } catch (error) {
+        spinner.fail('Failed to load markets');
+        handleError(error, program.opts());
+      }
+    });
+
+  // Chart command (ASCII charts)
+  market
+    .command('chart <asset>')
+    .description('Display price chart (ASCII)')
+    .option('-p, --period <period>', 'Time period: 1h, 4h, 1d, 1w', '1d')
+    .option('-t, --type <type>', 'Chart type: line, candle', 'line')
+    .action(async (asset, options) => {
+      console.log(chalk.yellow('\n⚠️  Price charts coming soon!'));
+      console.log(chalk.gray('Will display ASCII charts for quick price visualization'));
+
+      // Mock chart display
+      console.log(chalk.bold(`\n${asset.toUpperCase()} - ${options.period} Chart:`));
+      console.log(createPriceChart()); // Placeholder function
+    });
+
+  // Configuration validation command
+  market
+    .command('config')
+    .alias('env')
+    .description('Check market configuration and available assets')
+    .action(async () => {
+      try {
+        console.log(chalk.bold('\n🔧 Market Configuration Status:'));
+
+        const availableMarkets = listAvailableMarketAddresses();
+
+        if (Object.keys(availableMarkets).length === 0) {
+          console.log(chalk.red('\n❌ No market addresses found!'));
+          console.log(
+            chalk.yellow('\nPlease ensure you have set the required environment variables:'),
+          );
+          console.log('  • Available subnet markets: BITMIND, CHUTES, AFFINE, RIDGES');
+          console.log('  • All markets use contract addresses from constants');
+          return;
+        }
+
+        console.log(chalk.green('\n✅ Available Markets:'));
+        const table = new Table({
+          head: ['Asset', 'Contract Address'],
+          colWidths: [15, 45],
+        });
+
+        Object.entries(availableMarkets).forEach(([asset, address]) => {
+          table.push([chalk.cyan(asset), chalk.gray(address)]);
+        });
+
+        console.log(table.toString());
+
+        // Show environment variables being used
+        console.log(chalk.bold('\n📋 Environment Variables:'));
+        const envTable = new Table({
+          head: ['Variable', 'Value'],
+          colWidths: [30, 45],
+        });
+
+        const relevantEnvVars = Object.keys(process.env)
+          .filter(
+            (key) =>
+              key.startsWith('ALPHA_') ||
+              key.startsWith('ANVIL_ALPHA_') ||
+              key.includes('_ADDRESS'),
+          )
+          .sort();
+
+        relevantEnvVars.forEach((key) => {
+          const value = process.env[key];
+          if (value) {
+            const displayValue = value.length > 42 ? `${value.slice(0, 42)}...` : value;
+            envTable.push([chalk.cyan(key), chalk.gray(displayValue)]);
+          }
+        });
+
+        console.log(envTable.toString());
+
+        console.log(chalk.bold('\n💡 Usage Examples:'));
+        console.log('  alpha-futures market price BITMIND');
+        console.log('  alpha-futures market funding CHUTES');
+        console.log('  alpha-futures position open -a BITMIND -d long -s 1000 -m 333');
+      } catch (error) {
+        handleError(error, program.opts());
+      }
+    });
+}