blumefi 2.5.0 → 2.6.0

package/README.md

@@ -13,8 +13,8 @@ npx blumefi faucet 0xYOUR_ADDRESS
 
 export WALLET_PRIVATE_KEY=0x...
 
-# Launch a token
-npx blumefi pad launch "Moon Cat" MCAT "The first cat on the moon"
+# Launch a token (always include --image!)
+npx blumefi pad launch "Moon Cat" MCAT "The first cat on the moon" --image https://example.com/cat.png
 
 # Buy tokens on bonding curve
 npx blumefi pad buy 0xTOKEN_ADDRESS 10
@@ -40,6 +40,7 @@ blumefi pad sell <token> <amount|all>        # Sell tokens for XRP
 blumefi pad info <token>                     # View token info and progress
 blumefi pad search <query>                   # Search tokens by name or symbol
 blumefi pad tokens                           # List recent tokens
+blumefi pad update-image <token> <url>       # Update display image (creator only)
 ```
 
 **Launch options:**

package/cli.js

@@ -7,6 +7,50 @@
 
 const API = 'https://api.blumefi.com'
 
+// ─── ANSI colors (zero deps) ───────────────────────────────────────
+
+const c = {
+  bold: s => `\x1b[1m${s}\x1b[22m`,
+  dim: s => `\x1b[2m${s}\x1b[22m`,
+  green: s => `\x1b[32m${s}\x1b[39m`,
+  yellow: s => `\x1b[33m${s}\x1b[39m`,
+  red: s => `\x1b[31m${s}\x1b[39m`,
+  white: s => `\x1b[97m${s}\x1b[39m`,
+}
+
+function progressBar(pct, width = 16) {
+  const clamped = Math.max(0, Math.min(pct || 0, 100))
+  const filled = Math.round((clamped / 100) * width)
+  const empty = width - filled
+  const colorFn = clamped < 25 ? c.dim : clamped < 75 ? c.yellow : c.green
+  return colorFn('█'.repeat(filled)) + c.dim('░'.repeat(empty))
+}
+
+function fmtPrice(price) {
+  const n = parseFloat(price)
+  if (isNaN(n) || n === 0) return '0'
+  if (n < 0.000001) return n.toExponential(2)
+  if (n < 0.01) return n.toFixed(6).replace(/0+$/, '').replace(/\.$/, '.0')
+  if (n < 1) return n.toFixed(4)
+  return n.toFixed(2)
+}
+
+function fmtNum(val) {
+  const n = parseFloat(val)
+  if (isNaN(n)) return '—'
+  return n.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 })
+}
+
+function padRight(str, len) {
+  const visible = str.replace(/\x1b\[[0-9;]*m/g, '')
+  return str + ' '.repeat(Math.max(0, len - visible.length))
+}
+
+function padLeft(str, len) {
+  const visible = str.replace(/\x1b\[[0-9;]*m/g, '')
+  return ' '.repeat(Math.max(0, len - visible.length)) + str
+}
+
 const NETWORKS = {
   mainnet: {
     chainId: 1440000,
@@ -791,7 +835,11 @@ async function cmdPadLaunch(name, symbol, desc) {
   console.log(`  Name:        ${name}`)
   console.log(`  Symbol:      ${symbol}`)
   if (description) console.log(`  Description: ${description}`)
-  if (imageURI) console.log(`  Image:       ${imageURI}`)
+  if (imageURI) {
+    console.log(`  Image:       ${imageURI}`)
+  } else {
+    console.log(`  Image:       (none — consider adding --image <url>)`)
+  }
   console.log(`  Supply:      ${viem.formatEther(totalSupply)}`)
   console.log(`  Dev alloc:   ${devPct}%`)
   console.log(`  Grad target: ${viem.formatEther(gradReserve)} XRP`)
@@ -829,6 +877,9 @@ async function cmdPadLaunch(name, symbol, desc) {
   console.log(`  Creator: ${account.address}`)
   if (tokenAddress) {
     console.log(`\n  Next steps:`)
+    if (!imageURI) {
+      console.log(`  blumefi pad update-image ${tokenAddress} <url>  Add an image`)
+    }
     console.log(`  blumefi pad buy ${tokenAddress} 10     Buy with 10 XRP`)
     console.log(`  blumefi pad info ${tokenAddress}       View token info`)
   }
@@ -964,23 +1015,34 @@ async function cmdPadInfo(tokenAddress) {
     readContract({ address: tokenAddress, abi: PAD_TOKEN_ABI, functionName: 'totalSupply', args: [] }),
   ])
 
-  const priceStr = parseFloat(viem.formatEther(currentPrice)).toFixed(10)
-  const reserveStr = parseFloat(viem.formatEther(reserveBalance)).toFixed(4)
-  const gradStr = parseFloat(viem.formatEther(gradReserve)).toFixed(0)
-  const progressPct = gradReserve > 0n ? Number(reserveBalance * 10000n / gradReserve) / 100 : 0
+  const priceVal = parseFloat(viem.formatEther(currentPrice))
+  const reserveVal = parseFloat(viem.formatEther(reserveBalance))
+  const gradVal = parseFloat(viem.formatEther(gradReserve))
+  const progressPct = gradVal > 0 ? Math.min((reserveVal / gradVal) * 100, 100) : 0
   const supplyStr = parseFloat(viem.formatEther(totalSupply)).toLocaleString()
   const curveStr = parseFloat(viem.formatEther(curveSupply)).toLocaleString()
-
-  console.log(`\n  ${name} (${symbol}) — ${chain}`)
-  console.log(`  ─────────────────────────────────────`)
-  if (desc) console.log(`  ${truncate(desc, 80)}`)
-  console.log(`  Status:      ${graduated ? 'Graduated (DEX)' : 'Bonding Curve'}`)
-  console.log(`  Price:       ${priceStr} XRP`)
-  console.log(`  Reserve:     ${reserveStr} / ${gradStr} XRP (${progressPct.toFixed(1)}%)`)
-  console.log(`  Curve sold:  ${curveStr}`)
+  const statusText = graduated
+    ? c.green('Graduated (DEX)')
+    : c.yellow('Active (bonding curve)')
+
+  console.log('')
+  console.log(c.bold(`  ${symbol}`) + c.dim(` — ${name}`))
+  console.log(c.dim(`  ${tokenAddress}  ·  ${chain}`))
+  console.log('')
+  console.log(`  Price:        ${c.white(fmtPrice(priceVal))} XRP`)
+  console.log(`  Reserve:      ${c.white(fmtNum(reserveVal))} / ${fmtNum(gradVal)} XRP`)
+  console.log(`  Progress:     ${progressBar(progressPct, 20)} ${progressPct >= 100 ? c.green(Math.round(progressPct) + '%') : c.yellow(Math.round(progressPct) + '%')}`)
+  console.log(`  Status:       ${statusText}`)
+  console.log('')
   console.log(`  Total supply: ${supplyStr}`)
-  console.log(`  Contract:    ${tokenAddress}`)
-  console.log(`  Explorer:    ${net.explorer}/address/${tokenAddress}`)
+  console.log(`  Curve supply: ${curveStr}`)
+  console.log(`  Contract:     ${c.dim(tokenAddress)}`)
+  console.log(`  Explorer:     ${c.dim(net.explorer + '/address/' + tokenAddress)}`)
+
+  if (desc) {
+    console.log('')
+    console.log(c.dim(`  ${truncate(desc, 100)}`))
+  }
 
   // Show user balance if wallet is set
   const key = process.env.WALLET_PRIVATE_KEY || process.env.PRIVATE_KEY
@@ -991,9 +1053,11 @@ async function cmdPadInfo(tokenAddress) {
       address: tokenAddress, abi: PAD_TOKEN_ABI, functionName: 'balanceOf', args: [account.address],
     })
     if (userBalance > 0n) {
-      console.log(`  Your balance: ${parseFloat(viem.formatEther(userBalance)).toLocaleString()} ${symbol}`)
+      console.log('')
+      console.log(`  Your balance: ${c.white(parseFloat(viem.formatEther(userBalance)).toLocaleString())} ${symbol}`)
     }
   }
+  console.log('')
 }
 
 async function cmdPadSearch(query) {
@@ -1034,30 +1098,153 @@ async function cmdPadSearch(query) {
   }
 }
 
+function renderTokenTable(tokens, total, chain, filter) {
+  const lines = []
+  if (!tokens.length) {
+    lines.push(c.dim(`  No tokens found (${chain}, filter: ${filter})`))
+    return lines.join('\n')
+  }
+
+  const active = tokens.filter(t => !t.graduated).length
+  const graduated = tokens.filter(t => t.graduated).length
+  const totalVol = tokens.reduce((sum, t) => sum + (parseFloat(t.volume24h) || 0), 0)
+
+  // Header banner
+  const title = 'BLUMEPAD'
+  const netLabel = chain
+  const summary = `${tokens.length} tokens · ${graduated} graduated · ${fmtNum(totalVol)} XRP 24h vol`
+  const innerWidth = 53
+  lines.push('  ' + c.dim('┌' + '─'.repeat(innerWidth) + '┐'))
+  lines.push('  ' + c.dim('│') + '  ' + c.bold(title) + ' '.repeat(innerWidth - title.length - netLabel.length - 4) + c.dim(netLabel) + '  ' + c.dim('│'))
+  lines.push('  ' + c.dim('│') + '  ' + c.dim(summary) + ' '.repeat(Math.max(0, innerWidth - summary.length - 4)) + '  ' + c.dim('│'))
+  lines.push('  ' + c.dim('└' + '─'.repeat(innerWidth) + '┘'))
+  lines.push('')
+
+  const cols = { symbol: 10, name: 20, price: 14, mcap: 12, vol: 12, progress: 26, status: 10 }
+
+  const header =
+    padRight(c.dim('Symbol'), cols.symbol) +
+    padRight(c.dim('Name'), cols.name) +
+    padLeft(c.dim('Price (XRP)'), cols.price) + '  ' +
+    padLeft(c.dim('MCap'), cols.mcap) + '  ' +
+    padLeft(c.dim('24h Vol'), cols.vol) + '  ' +
+    padRight(c.dim('Progress'), cols.progress) +
+    padRight(c.dim('Status'), cols.status)
+
+  lines.push('  ' + header)
+  lines.push('  ' + c.dim('─'.repeat(106)))
+
+  for (const t of tokens) {
+    const pct = Math.min(t.progress || 0, 100)
+    const pctStr = `${Math.round(pct)}%`
+    const bar = progressBar(pct) + ' ' + (pct >= 100 ? c.green(pctStr) : c.yellow(pctStr))
+    const status = t.graduated ? c.green('Graduated') : c.yellow('Active')
+
+    const row =
+      padRight(c.bold(t.symbol || '???'), cols.symbol) +
+      padRight((t.name || '—').slice(0, 18), cols.name) +
+      padLeft(fmtPrice(t.price), cols.price) + '  ' +
+      padLeft(fmtNum(t.marketCap), cols.mcap) + '  ' +
+      padLeft(fmtNum(t.volume24h), cols.vol) + '  ' +
+      padRight(bar, cols.progress) +
+      padRight(status, cols.status)
+
+    lines.push('  ' + row)
+  }
+
+  lines.push('')
+  if (total > tokens.length) {
+    lines.push(c.dim(`  Showing ${tokens.length} of ${total}. Use --limit to see more.`))
+    lines.push('')
+  }
+
+  return lines.join('\n')
+}
+
 async function cmdPadTokens() {
   const chain = getChain()
-  try {
-    const data = await apiFetch(`/pad/tokens?chain=${chain}&limit=20&sort=recent`)
-    const tokens = data.data || data.tokens || data || []
-    if (!Array.isArray(tokens) || !tokens.length) { console.log(`No tokens on ${chain} yet.`); return }
+  const argv = process.argv
+  const flagVal = (name, fallback) => {
+    const idx = argv.indexOf(name)
+    if (idx === -1) return fallback
+    const val = argv[idx + 1]
+    return (val && !val.startsWith('--')) ? val : fallback
+  }
+  const filter = flagVal('--filter', 'all')
+  const sort = flagVal('--sort', 'newest')
+  const limit = flagVal('--limit', '20')
+  const watchMode = argv.includes('--watch') || argv.includes('-w')
+
+  if (!watchMode) {
+    // One-shot mode (existing behavior)
+    const data = await apiFetch(`/pad/tokens?chain=${chain}&filter=${filter}&sort=${sort}&limit=${limit}&offset=0`)
+    const tokens = data.tokens || data.data || []
+    const total = data.total || tokens.length
+    console.log('')
+    console.log(renderTokenTable(tokens, total, chain, filter))
+    return
+  }
 
-    console.log(`\n  Pad Tokens (${chain}) — ${tokens.length} tokens\n`)
-    for (const t of tokens) {
-      const name = t.name || '???'
-      const symbol = t.symbol || '???'
-      const graduated = t.graduated ? ' [GRADUATED]' : ''
-      const reserve = t.reserveBalance ? ` ${parseFloat(t.reserveBalance).toFixed(1)} XRP` : ''
-      console.log(`  ${name} (${symbol})${graduated}${reserve}`)
-      console.log(`  ${t.address}`)
-      console.log()
+  // Live dashboard mode
+  const REFRESH = 5
+  const hideCursor = () => process.stdout.write('\x1b[?25l')
+  const showCursor = () => process.stdout.write('\x1b[?25h')
+  const clearScreen = () => process.stdout.write('\x1b[2J\x1b[H')
+
+  let running = true
+  const cleanup = () => {
+    running = false
+    showCursor()
+    console.log(c.dim('\n  Goodbye.\n'))
+    process.exit(0)
+  }
+  process.on('SIGINT', cleanup)
+  process.on('SIGTERM', cleanup)
+
+  hideCursor()
+
+  while (running) {
+    let output
+    try {
+      const data = await apiFetch(`/pad/tokens?chain=${chain}&filter=${filter}&sort=${sort}&limit=${limit}&offset=0`)
+      const tokens = data.tokens || data.data || []
+      const total = data.total || tokens.length
+      output = renderTokenTable(tokens, total, chain, filter)
+    } catch (err) {
+      output = c.red(`  Error fetching data: ${err.message}`) + '\n' + c.dim('  Will retry...')
+    }
+
+    clearScreen()
+    console.log('')
+    console.log(output)
+
+    const now = new Date()
+    const ts = now.toLocaleTimeString('en-US', { hour12: false })
+    console.log('')
+    console.log(c.dim(`  Updated ${ts} · Refreshing in ${REFRESH}s · Ctrl+C to exit`))
+
+    // Countdown sleep — break early if stopped
+    for (let i = 0; i < REFRESH * 10 && running; i++) {
+      await new Promise(r => setTimeout(r, 100))
     }
-  } catch {
-    // Fallback: if API doesn't have /pad/tokens, just point to the website
-    console.log(`\n  Browse tokens: https://${chain === 'mainnet' ? '' : 'testnet.'}pad.blumefi.com`)
-    console.log(`  API: ${API}/pad/tokens?chain=${chain}`)
   }
 }
 
+async function cmdPadStats() {
+  const chain = getChain()
+  const data = await apiFetch(`/pad/stats?chain=${chain}`)
+
+  console.log('')
+  console.log(c.bold('  Blumepad Stats') + c.dim(` (${chain})`))
+  console.log('')
+  console.log(`  Total tokens:   ${c.white(String(data.totalTokens ?? 0))}`)
+  console.log(`  Active:         ${c.yellow(String(data.activeTokens ?? 0))}`)
+  console.log(`  Graduated:      ${c.green(String(data.graduatedTokens ?? 0))}`)
+  console.log(`  24h Volume:     ${c.white(fmtNum(data.totalVolume24h ?? 0))} XRP`)
+  console.log(`  24h Trades:     ${c.white(String(data.totalTrades24h ?? 0))}`)
+  console.log('')
+}
+
 async function cmdPadUpdateImage(tokenAddress, imageUrl) {
   if (!tokenAddress || !imageUrl) {
     console.error('Usage: blumefi pad update-image <token_address> <image_url>')
@@ -1255,14 +1442,21 @@ Chat:
   chat profile <name> [options]    Set your display name and avatar
 
 Pad (Launchpad):
+  pad tokens                         List tokens with graduation progress
+  pad info <token>                   Detailed token view with progress bar
+  pad stats                          Aggregate launchpad stats
   pad launch <name> <symbol> [desc]  Launch a token on bonding curve
   pad buy <token> <xrp_amount>       Buy tokens with XRP
   pad sell <token> <amount|all>      Sell tokens for XRP
-  pad info <token>                   View token info and progress
   pad search <query>                 Search tokens by name or symbol
-  pad tokens                         List recent tokens
   pad update-image <token> <url>     Update token image (creator only)
 
+  Pad Options:
+    --filter <active|graduated|all>  Filter tokens (default: all)
+    --sort <newest|marketcap|progress|price>  Sort order (default: newest)
+    --limit <N>                      Number of tokens (default: 20)
+    --watch, -w                      Live dashboard (auto-refresh every 5s)
+
 Swap (DEX):
   swap <amount> <from> <to>        Swap tokens (e.g. swap 1 XRP RLUSD)
   swap quote <amount> <from> <to>  Get a quote without executing
@@ -1319,8 +1513,9 @@ async function main() {
       else if (sub === 'info' || sub === 'i') await cmdPadInfo(args[2])
       else if (sub === 'search' || sub === 'find') await cmdPadSearch(args[2])
       else if (sub === 'tokens' || sub === 'list') await cmdPadTokens()
+      else if (sub === 'stats') await cmdPadStats()
       else if (sub === 'update-image') await cmdPadUpdateImage(args[2], args[3])
-      else { console.error(`Unknown: pad ${sub}. Try: launch, buy, sell, info, tokens, update-image`); process.exit(1) }
+      else { console.error(`Unknown: pad ${sub}. Try: launch, buy, sell, info, tokens, stats, update-image`); process.exit(1) }
     } else if (cmd === 'swap') {
       if (sub === 'quote' || sub === 'q') await cmdSwapQuote(args[2], args[3], args[4])
       else if (sub === 'pools' || sub === 'p') await cmdSwapPools()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blumefi",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "description": "BlumeFi CLI — DeFi reimagined for the agentic era. Trade, chat, and interact with the Blume ecosystem from the command line.",
   "main": "cli.js",
   "bin": {