solana-tui-explorer 1.0.0

package/bin/st.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+require('../index.js');

package/config.js

@@ -0,0 +1,87 @@
+// =============================================
+// SOLANA TUI EXPLORER CLI — Config
+// =============================================
+
+module.exports = {
+  // Solana Public RPC — override via SOLANA_RPC in .env for better reliability
+  SOLANA_RPC: process.env.SOLANA_RPC || 'https://api.mainnet-beta.solana.com',
+
+  // High-capacity public node for heavy Explorer queries
+  EXPLORER_RPC: 'https://solana-rpc.publicnode.com',
+
+  // DexScreener (Solana token prices — free, no key)
+  DEXSCREENER_BASE: 'https://api.dexscreener.com',
+
+  // CoinDesk Data API (major crypto prices — free tier works without key)
+  // Set COINDESK_API_KEY env var when you have one for higher rate limits.
+  COINDESK_BASE:   'https://data-api.coindesk.com',
+  COINDESK_MARKET: process.env.COINDESK_MARKET || 'coinbase',
+  COINDESK_API_KEY: process.env.COINDESK_API_KEY || '',
+  BIRDEYE_API_KEY:  process.env.BIRDEYE_API_KEY  || '',
+  RUGCHECK_API_KEY: process.env.RUGCHECK_API_KEY || '',
+  WHALE_ALERT_API_KEY: process.env.WHALE_ALERT_API_KEY || '',
+  BITQUERY_API_KEY: process.env.BITQUERY_API_KEY || '',
+  CRYPTOPANIC_API_KEY: process.env.CRYPTOPANIC_API_KEY || '',
+  COINMARKETCAP_API_KEY: process.env.COINMARKETCAP_API_KEY || '',
+  
+  // SECURE BACKEND PROXY
+  // Routes traffic through our AWS EC2 instance instead of exposing keys to clients
+  PROXY_URL: process.env.PROXY_URL || 'http://100.26.192.172:3000',
+  
+  AI_MODEL: 'llama-3.3-70b-versatile',
+  AI_SYSTEM_PROMPT: 'You are the Antigravity Solana Developer TUI AI. You act as an expert Solana systems developer, smart contract compiler, and transaction debugger. Help developers diagnose RPC simulation failures, decode hexadecimal transaction instruction error codes, explain Anchor constraints, and optimize compute units. Your responses must be concise, technical, and formatted for a terminal (no markdown headers, use plain text with accents).',
+  FAIRSCALE_API_KEY: process.env.FAIRSCALE_API_KEY || '',
+
+  // Major cryptos — fetched from CoinDesk (accurate spot prices in USD)
+  COINDESK_SYMBOLS: ['BTC', 'ETH', 'SOL'],
+
+  // Solana-native tokens — fetched from DexScreener
+  DEX_SYMBOLS: ['BONK','WIF','JUP','PYTH','RAY','ORCA','DRIFT','RENDER','POPCAT','FARTCOIN','TRUMP'],
+
+  // Combined display order (CoinDesk first, then DEX tokens)
+  MARKET_SYMBOLS: ['SOL','BTC','ETH','BONK','WIF','JUP','PYTH','RAY','ORCA','DRIFT','RENDER','POPCAT','FARTCOIN','TRUMP'],
+
+  // ── Token mint addresses on Solana (for DexScreener) ───────────
+  TOKEN_MINTS: {
+    SOL:      'So11111111111111111111111111111111111111112',
+    BTC:      '9n4nbM75f5Ui33ZbPYXn59EwSgE8CGsHtAeTH5YFeJ9E', // Portal wBTC
+    ETH:      '7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs', // Portal wETH
+    BONK:     'DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263',
+    WIF:      'EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm',
+    JUP:      'JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN',
+    PYTH:     'HZ1JovNiVvGrGNiiYvEozEVgZ58xaU3RKwX8eACQBCt3',
+    RAY:      '4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R',
+    ORCA:     'orcaEKTdK7LKz57vaAYr9QeNsVEPfiu6QeMU1kektZE',
+    DRIFT:    'DriFtupJYLTosbwoN8koMbEYSx54aFAVLddWsbksjwg7',
+    RENDER:   'rndrizKT3MK1iimdxRdWabcF7Zg7AR5T4nud4EkHBof',
+    POPCAT:   '7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr',
+    FARTCOIN: '9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump',
+    TRUMP:    '6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN',
+  },
+
+  TOKEN_NAMES: {
+    SOL:      'Solana',
+    BTC:      'Bitcoin',
+    ETH:      'Ethereum',
+    BONK:     'Bonk',
+    WIF:      'dogwifhat',
+    JUP:      'Jupiter',
+    PYTH:     'Pyth Network',
+    RAY:      'Raydium',
+    ORCA:     'Orca',
+    DRIFT:    'Drift Protocol',
+    RENDER:   'Render',
+    POPCAT:   'Popcat',
+    FARTCOIN: 'Fartcoin',
+    TRUMP:    'Official Trump',
+  },
+
+  // Refresh intervals (ms)
+  MARKET_REFRESH_MS:  30000,
+  NETWORK_REFRESH_MS: 30000,
+  TOKEN_REFRESH_MS:   30000,
+  WALLET_REFRESH_MS:  60000,
+
+  // Local testing session path
+  LITESVM_SESSION_PATH: process.env.LITESVM_SESSION_PATH || 'litesvm-session.json',
+};

package/data.js

@@ -0,0 +1,197 @@
+// =============================================
+// SOLANA TUI EXPLORER CLI — Live Data Store
+// This module holds the current live state.
+// dashboard.js calls loadMarketData(), loadNetworkData(), etc.
+// Each returns the updated store or throws on failure.
+// =============================================
+
+const API = require('./api');
+const CFG = require('./config');
+const { fetchNewsAggregated } = API;
+
+// ── Live data store ────────────────────────────────────
+const DATA = {
+  // Populated by loadMarketData()
+  market:      [],
+  topGainers:  [],
+  topLosers:   [],
+  sparklines:  {},
+  chartData:   { x: [], y: [] },
+  priceExchanges: [], // not available from DexScreener — show empty
+
+  // Populated by loadNetworkData()
+  networkStats: null,
+
+  // Populated on demand by loadWalletData(address)
+  wallet: null,
+
+  // Populated on demand by loadTokenData(mintOrSymbol)
+  token: null,
+
+  // Static/dummy — live feed is simulated from on-chain data
+  liveFeed: [
+    { type: 'SWAP',  text: 'SWAP  10,420,000 BONK → 243.8 SOL  via Jupiter  [4kXm...9nQr]'    },
+    { type: 'BUY',   text: 'BUY   2,400 WIF ($6,888) on Raydium  [7pLn...2wKs]'               },
+    { type: 'WHALE', text: 'WHALE  50,000 SOL moved from Binance  [2rMk...8vPt]'               },
+    { type: 'SWAP',  text: 'SWAP  84,200 USDC → 590 SOL  via Orca  [9sNp...5hJu]'             },
+    { type: 'ALERT', text: 'VOL SPIKE  BONK +5% in 45min — unusual activity'                   },
+    { type: 'BUY',   text: 'BUY   120,000,000 BONK ($2,809) large wallet  [6tQr...1dCv]'      },
+    { type: 'SWAP',  text: 'SWAP  500 JUP → 402 USDC  via Jupiter  [3mNk...7rQs]'             },
+    { type: 'WHALE', text: 'WHALE  15,000 SOL staked  new validator  [8vLq...1uRp]'            },
+  ],
+
+  // Explorer Tab state
+  explorer: {
+    list: [], 
+    details: null, 
+    loading: false, 
+    error: null 
+  },
+
+  // Alerts are static (no free alert API available)
+  alerts: [
+    { id: 'ALT001', token: 'SOL',  condition: 'PRICE > $150',        status: 'ACTIVE',    triggered: false, created: '04-14 09:00', triggeredAt: null        },
+    { id: 'ALT002', token: 'BONK', condition: 'VOL SPIKE > 50%/1h',  status: 'TRIGGERED', triggered: true,  created: '04-14 10:30', triggeredAt: '22:18:03'  },
+    { id: 'ALT003', token: 'WIF',  condition: 'PRICE > $3.00',       status: 'ACTIVE',    triggered: false, created: '04-14 11:15', triggeredAt: null        },
+    { id: 'ALT004', token: 'ANY',  condition: 'WHALE > $500K move',  status: 'TRIGGERED', triggered: true,  created: '04-14 08:00', triggeredAt: '21:47:22'  },
+    { id: 'ALT005', token: 'JUP',  condition: 'PRICE < $1.00',       status: 'ACTIVE',    triggered: false, created: '04-13 18:00', triggeredAt: null        },
+  ],
+
+  // Populated by loadNewsData() — live aggregated news
+  news: [],
+  newsLastUpdated: null,
+  newsLoading: false,
+};
+
+// ═════════════════════════════════════════════════════════
+// LOAD FUNCTIONS — called by dashboard.js
+// ═════════════════════════════════════════════════════════
+
+async function loadMarketData() {
+  const [result, macro] = await Promise.all([
+    API.fetchMarketData(),
+    API.fetchCMCMacroData()
+  ]);
+  DATA.market      = result.market;
+  DATA.topGainers  = result.topGainers;
+  DATA.topLosers   = result.topLosers;
+  DATA.sparklines  = result.sparklines;
+  DATA.chartData   = result.chartData;
+  DATA.macro       = macro || {
+    marketCap: 0, marketCapChange: 0, globalVolume: 0, globalVolumeChange: 0,
+    fearGreedValue: 50, fearGreedClass: 'Neutral', altcoinIndex: 35
+  };
+  return DATA;
+}
+
+async function loadNetworkData() {
+  const [epoch, tpsData, blocktimeData, validators, supply] = await Promise.all([
+    API.fetchEpochInfo(),
+    API.fetchTPS(),
+    API.fetchBlocktime(),
+    API.fetchValidators(),
+    API.fetchSupply(),
+  ]);
+
+  supply.epoch = epoch.current;
+
+  // Try to find SOL price from DexScreener if available to calculate totalStakedUsd
+  let solPrice = 145.0; // fallback default
+  try {
+    const solData = await API.fetchTokenData('So11111111111111111111111111111111111111112');
+    if (solData && solData.price) solPrice = solData.price;
+  } catch (e) {
+    // ignore
+  }
+
+  // Build networkStats in the shape dashboard.js expects
+  DATA.networkStats = {
+    epoch,
+    tps:      tpsData,
+    blocktime: blocktimeData,
+    validators,
+    supply,
+    stakeData: {
+      totalStaked:    supply.staked.toFixed(1) + 'M SOL',
+      totalStakedUsd: '$' + (supply.staked * solPrice / 1e3).toFixed(1) + 'B',
+      activeStakers:  '—',
+      uniqueWallets:  '—',
+      biggestStake:   '—',
+      medianStake:    '—',
+      meanStake:      '—',
+      filterApy:      supply.stakingApy + '%',
+      updated:        'just now',
+    },
+    // Stake graph — approximate from epoch data
+    stakeGraph: Array.from({ length: 8 }, (_, i) => ({
+      epoch: epoch.current - (7 - i) * 50,
+      sol:   parseFloat((supply.staked * (0.95 + Math.random() * 0.1)).toFixed(2)),
+    })).concat([{ epoch: epoch.current, sol: supply.staked }]),
+    stakeDistribution: [], // Would need a staking indexer
+  };
+  return DATA;
+}
+
+async function loadWalletData(address) {
+  const [result, score] = await Promise.all([
+    API.fetchWalletData(address),
+    API.fetchFairScaleScore(address)
+  ]);
+  result.fairScale = score;
+  DATA.wallet     = result;
+  return DATA;
+}
+
+async function loadTokenData(mintOrSymbol, timeframe) {
+  const [result, socials] = await Promise.all([
+    API.fetchTokenData(mintOrSymbol, timeframe),
+    API.fetchTwitterRSS(mintOrSymbol)
+  ]);
+  DATA.token = result;
+  DATA.tokenSocials = socials;
+  return DATA;
+}
+
+async function loadNewsData() {
+  DATA.newsLoading = true;
+  const [items, defaultSocials] = await Promise.all([
+    API.fetchNewsAggregated(),
+    API.fetchTwitterRSS('solana')
+  ]);
+  DATA.news = items;
+  if (defaultSocials) DATA.tokenSocials = defaultSocials;
+  DATA.newsLastUpdated = new Date();
+  DATA.newsLoading = false;
+  return DATA;
+}
+
+// ── Explorer Data Loaders ─────────────────────────────────
+async function loadExplorerList() {
+  DATA.explorer.loading = true;
+  try {
+    const list = await API.fetchLatestTransactions();
+    DATA.explorer.list = list;
+    DATA.explorer.error = null;
+  } catch (e) {
+    DATA.explorer.error = e.message;
+  }
+  DATA.explorer.loading = false;
+  return DATA;
+}
+
+async function loadExplorerDetails(signature) {
+  DATA.explorer.loading = true;
+  DATA.explorer.details = null;
+  try {
+    const details = await API.fetchTransactionDetails(signature);
+    if (details.error) throw new Error(details.error);
+    DATA.explorer.details = details;
+    DATA.explorer.error = null;
+  } catch (e) {
+    DATA.explorer.error = e.message;
+  }
+  DATA.explorer.loading = false;
+  return DATA;
+}
+
+module.exports = { DATA, loadMarketData, loadNetworkData, loadWalletData, loadTokenData, loadNewsData, loadExplorerList, loadExplorerDetails };

package/index.js

@@ -0,0 +1,61 @@
+// Force truecolor for Blessed layout engine on Windows
+process.env.COLORTERM = 'truecolor';
+
+// Load .env FIRST — before any other require() reads process.env
+require('dotenv').config({ path: require('path').resolve(__dirname, '.env') });
+
+const { program } = require('commander');
+const chalk = require('chalk');
+const clear = require('clear');
+const { renderWallet } = require('./panels/wallet');
+const { renderToken } = require('./panels/token');
+
+const { startDashboard } = require('./panels/dashboard');
+
+program
+  .name('st')
+  .description(chalk.hex('#00FF88').bold('Solana TUI Explorer (ST) — On-Chain Developer TUI for Solana'))
+  .version('1.0.0');
+
+// Dashboard command (Full layout)
+program
+  .command('dashboard')
+  .alias('d')
+  .description('Launch the full-screen developer TUI explorer')
+  .action(() => {
+    startDashboard();
+  });
+
+// Header formatting hook (Only run if not dashboard to avoid clearing screen unexpectedly)
+program.hook('preAction', (thisCommand, actionCommand) => {
+  if (actionCommand.name() === 'dashboard') return;
+  clear();
+  console.log(chalk.hex('#00FF88')('==========================================================='));
+  console.log(chalk.white.bold('        SOLANA DEV EXPLORER') + chalk.gray(' — On-Chain Inspection TUI'));
+  console.log(chalk.hex('#00FF88')('==========================================================='));
+});
+
+// st wallet <ADDRESS>
+program
+  .command('wallet [address]')
+  .alias('w')
+  .description('Inspect any account or wallet balance and details')
+  .action((address) => {
+    renderWallet(address);
+  });
+
+// st token <SYMBOL>
+program
+  .command('token [symbol]')
+  .alias('t')
+  .description('Inspect SPL token parameters and metadata')
+  .action((symbol) => {
+    renderToken(symbol);
+  });
+
+// Fallback to dashboard view if no args provided
+if (process.argv.length === 2) {
+  process.argv.push('dashboard');
+}
+
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "solana-tui-explorer",
+  "version": "1.0.0",
+  "main": "index.js",
+  "bin": {
+    "solana-tui-explorer": "bin/st.js",
+    "st": "bin/st.js"
+  },
+  "files": [
+    "bin",
+    "panels",
+    "api.js",
+    "config.js",
+    "data.js",
+    "index.js"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/starkdevx/Solana-TUI-Explorer.git"
+  },
+  "homepage": "https://github.com/starkdevx/Solana-TUI-Explorer#readme",
+  "bugs": {
+    "url": "https://github.com/starkdevx/Solana-TUI-Explorer/issues"
+  },
+  "scripts": {
+    "start": "node ./bin/st.js",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "solana",
+    "tui",
+    "explorer",
+    "crypto",
+    "cli"
+  ],
+  "author": "Superteam Builder",
+  "license": "ISC",
+  "description": "The ultimate Information Layer for the Solana ecosystem in a beautifully designed terminal.",
+  "dependencies": {
+    "bless": "^4.0.4",
+    "blessed": "^0.1.81",
+    "blessed-contrib": "^4.11.0",
+    "chalk": "^4.1.2",
+    "clear": "^0.1.0",
+    "cli-table3": "^0.6.5",
+    "commander": "^14.0.3",
+    "dotenv": "^17.4.2",
+    "inquirer": "^8.2.7",
+    "ora": "^5.4.1"
+  }
+}