mybitduit 0.0.1

package/README.md

@@ -0,0 +1,82 @@
+# mybitduit
+
+> **bit + duit** — your Solana money terminal. A beautiful, simple, non-custodial
+> tool to check prices (and, later, view your wallet and swap) — on the web and
+> right inside your terminal.
+
+Two faces, one brain: a [`core/`](core) price engine shared by a CLI and a website.
+
+## CLI
+
+A full-screen, live money terminal in any shell.
+
+### Just type `mybitduit`
+
+Install once, then it's a real command on your machine:
+
+```bash
+git clone <repo> && cd mybitduit
+npm install
+npm install -g .     # (or: npm link) — registers the `mybitduit` command
+
+mybitduit            # → launches the full-screen terminal
+```
+
+That's the whole dev experience: **`mybitduit` and it starts.** Run it with no
+args in a real terminal and you get the interactive app; pipe it or run it in a
+non-TTY (CI, scripts) and the same command prints the top 10 and exits.
+
+### One-shot / scriptable
+
+```bash
+mybitduit price sol btc eth   # print prices once, exit
+mybitduit top                 # top 10 by market cap, exit
+mybitduit watch <address>     # read-only Solana wallet (add --json)
+mybitduit help                # all commands + env vars
+```
+
+### Inside the full-screen app
+
+- **Home** — arrow keys `↑↓` + `↵` through the menu, or type a command at the `›`
+  prompt: a coin (`sol`), `live`, `wallet`, `watch <address>`, `about`, `q`.
+- **Live** — top-10 list + 7-day ASCII chart. `↑↓` / `j k` select, `r` refresh,
+  `esc` home, `q` quit. Auto-refreshes every 60s.
+- **Wallet** — paste any Solana address to read its balances and USD value.
+  Read-only: it never sees a key. `r` refresh, `n` new address, `esc` home.
+- **About** — the roadmap.
+
+### Optional env
+
+- `COINGECKO_API_KEY` — free CoinGecko demo key → higher price rate limits.
+- `SOLANA_RPC_URL` — your own RPC (e.g. Helius) for faster, unthrottled wallet reads.
+
+### Install without cloning (once published to npm)
+
+```bash
+npm install -g mybitduit          # the dev way
+# or
+curl -fsSL https://mybitduit.com/install.sh | sh   # the everyone way
+```
+
+[`install.sh`](install.sh) checks Node 18+, installs globally, and fixes PATH if
+npm's global bin dir isn't on it — so `mybitduit` just works in a new terminal.
+(Serve it from `web/public/install.sh` when the site deploys.)
+
+## Web
+
+`web/` will hold the single-file `mybitduit.com` site — the same engine, rendered
+as a browser terminal. Deploys to GitHub Pages + custom domain (like qrdurian).
+
+## Roadmap
+
+See [BUSINESS_PLAN.md](BUSINESS_PLAN.md). Short version:
+
+- **Phase 0 — prices** ✅ *(CLI live; web next)* — no wallet, no risk
+- **Phase 1 — wallet view** ✅ *(CLI: read any address; web: Phantom next)* — read balances, non-custodial.
+- **Phase 2 — swaps via Jupiter** — your wallet signs, we never hold funds.
+- **Phase 3 — fiat on-ramp** — partner handles cash↔crypto + compliance.
+
+## Principle
+
+**Non-custodial, always.** mybitduit never holds anyone's money — it shows info,
+or asks *your* wallet to approve an action. No licenses, no custody risk.

package/cli/mybitduit.mjs

@@ -0,0 +1,553 @@
+#!/usr/bin/env node
+/* ============================================================
+   mybitduit — Solana money terminal (CLI)
+   - `mybitduit`                 → full-screen app: home menu →
+                                    live top-10 list + ASCII charts
+   - `mybitduit price sol btc`   → print once and exit (scriptable)
+   - `mybitduit top`             → print top 10 once and exit
+   Phase 0: prices only. No wallet, no keys, no risk.
+   ============================================================ */
+import { fetchPrices, fetchTopCoins, downsample, fmtPrice, fmtChange } from '../core/prices.mjs';
+import { fetchPortfolio, isValidSolanaAddress } from '../core/portfolio.mjs';
+
+const VOID = '#07090d', GREEN = '#00ff9c', DIM = '#5f7a6e', INK = '#cfeede',
+      RED = '#ff4fa3', AMBER = '#ffc24b', BORDER = '#27352f', LOGO = '#2a7d5c';
+
+/* ---- tiny ANSI helpers (one-shot mode, no deps) ---- */
+const truecolor = (r, g, b) => (s) => `\x1b[38;2;${r};${g};${b}m${s}\x1b[0m`;
+const A = {
+  green: truecolor(0, 255, 156),
+  red: truecolor(255, 79, 163),
+  dim: truecolor(95, 122, 110),
+  ink: truecolor(207, 238, 222),
+  bold: (s) => `\x1b[1m${s}\x1b[0m`,
+};
+
+function shortNum(x) {
+  if (x == null) return '—';
+  const a = Math.abs(x);
+  if (a >= 1000) return (x / 1000).toFixed(a >= 100000 ? 0 : 1) + 'k';
+  if (a >= 1) return x.toFixed(2);
+  if (a > 0) return Number(x.toPrecision(2)).toString();
+  return '0';
+}
+
+/** y-axis formatter whose precision adapts to the series range (fixes "1,1,1,1"). */
+function axisFormatter(series, height) {
+  const min = Math.min(...series), max = Math.max(...series);
+  const span = Math.max(Math.abs(max - min), Math.abs(max) * 1e-6, 1e-9);
+  let dec = Math.ceil(-Math.log10(span / height)) + 1;
+  dec = Math.max(0, Math.min(8, dec));
+  return (x) => {
+    const s = '$' + Number(x).toLocaleString('en-US', {
+      minimumFractionDigits: dec,
+      maximumFractionDigits: dec,
+    });
+    return ('           ' + s).slice(-11);
+  };
+}
+
+async function oneShot(symbols) {
+  let rows;
+  try {
+    rows = await fetchPrices(symbols);
+  } catch (e) {
+    console.error(A.red('✗ ' + e.message));
+    process.exit(1);
+  }
+  console.log(A.bold(A.green('mybitduit')) + A.dim(' // prices'));
+  for (const r of rows) {
+    const sym = r.symbol.padEnd(6);
+    const priceStr = (r.price == null ? '—' : '$' + fmtPrice(r.price)).padEnd(14);
+    const color = r.change == null ? A.dim : r.change >= 0 ? A.green : A.red;
+    console.log('  ' + A.bold(A.ink(sym)) + color(priceStr) + color(fmtChange(r.change)));
+  }
+}
+
+async function oneShotTop() {
+  let coins;
+  try {
+    coins = await fetchTopCoins(10);
+  } catch (e) {
+    console.error(A.red('✗ ' + e.message));
+    process.exit(1);
+  }
+  console.log(A.bold(A.green('mybitduit')) + A.dim(' // top 10 by market cap'));
+  for (const c of coins) {
+    const rank = String(c.rank).padStart(2);
+    const sym = c.symbol.slice(0, 8).padEnd(9);
+    const name = c.name.slice(0, 16).padEnd(17);
+    const price = ('$' + fmtPrice(c.price)).padEnd(13);
+    const color = c.change == null ? A.dim : c.change >= 0 ? A.green : A.red;
+    console.log(' ' + A.dim(rank) + ' ' + A.bold(A.ink(sym)) + A.dim(name) + color(price + fmtChange(c.change)));
+  }
+}
+
+async function watchCmd(address, asJson) {
+  let p;
+  try {
+    p = await fetchPortfolio(address);
+  } catch (e) {
+    if (asJson) console.log(JSON.stringify({ error: e.message }));
+    else console.error(A.red('✗ ' + e.message));
+    process.exit(1);
+  }
+  if (asJson) {
+    console.log(JSON.stringify(p, null, 2));
+    return;
+  }
+  const short = p.address.slice(0, 4) + '…' + p.address.slice(-4);
+  const chg = p.change24h == null ? '' : (p.change24h >= 0 ? A.green : A.red)(fmtChange(p.change24h) + ' (24h)');
+  const amtStr = (n) => (n >= 1 ? fmtPrice(n) : Number(n.toPrecision(4)).toString());
+  console.log(A.bold(A.green('mybitduit')) + A.dim(' // wallet ' + short));
+  console.log('  ' + A.bold(A.ink('total'.padEnd(11))) + A.bold(('$' + fmtPrice(p.total)).padEnd(15)) + chg);
+  console.log(A.dim('  ' + '─'.repeat(34)));
+  const LIMIT = 12;
+  const top = p.holdings.slice(0, LIMIT);
+  for (const h of top) {
+    const sym = h.symbol.slice(0, 10).padEnd(11);
+    const amt = amtStr(h.amount).padEnd(15);
+    const val = h.price != null ? '$' + fmtPrice(h.value) : '—';
+    const c = h.change == null ? '' : (h.change >= 0 ? A.green : A.red)('  ' + fmtChange(h.change));
+    console.log('  ' + A.ink(sym) + A.dim(amt) + (h.price != null ? A.ink(val) : A.dim(val)) + c);
+  }
+  const more = p.holdings.length - top.length;
+  if (more > 0) console.log(A.dim(`  +${more} more holding(s)`));
+  if (p.hiddenCount > 0) console.log(A.dim(`  +${p.hiddenCount} dust / unpriced token(s) hidden`));
+  console.log(A.dim('  via ' + p.rpc.replace(/^https?:\/\//, '')));
+}
+
+/* ---- full-screen interactive app (Ink) ---- */
+async function tui() {
+  const React = (await import('react')).default;
+  const { render, Box, Text, useApp, useInput } = await import('ink');
+  const htm = (await import('htm')).default;
+  const asciichart = (await import('asciichart')).default;
+  const { useState, useEffect, useRef } = React;
+  const html = htm.bind(React.createElement);
+
+  // hand-drawn coin logo (bit + duit = money)
+  const COIN = [
+    '  ▗▄▄▄▄▖  ',
+    ' ▟▛    ▜▙ ',
+    '▐▌  $$  ▐▌',
+    '▐▌  $$  ▐▌',
+    ' ▜▙    ▟▛ ',
+    '  ▝▀▀▀▀▘  ',
+  ];
+
+  const MENU = [
+    { label: 'Live prices · top 10', hint: '↵', action: 'live' },
+    { label: 'Wallet · read-only', hint: 'w', action: 'wallet' },
+    { label: 'About / roadmap', hint: 'a', action: 'about' },
+    { label: 'Quit', hint: 'q', action: 'quit' },
+  ];
+
+  // take over the screen (alternate buffer) so we get the full black canvas
+  process.stdout.write('\x1b[?1049h\x1b[2J\x1b[H');
+  const restore = () => process.stdout.write('\x1b[?1049l');
+  process.on('exit', restore);
+
+  function App() {
+    const { exit } = useApp();
+    const [screen, setScreen] = useState('home'); // home | live | about
+    const [menuSel, setMenuSel] = useState(0);
+    const [buf, setBuf] = useState('');
+    const [toast, setToast] = useState('');
+    const [coins, setCoins] = useState([]);
+    const [loaded, setLoaded] = useState(false);
+    const [sel, setSel] = useState(0);
+    const [err, setErr] = useState('');
+    const [retryAt, setRetryAt] = useState(0);
+    const [updated, setUpdated] = useState('');
+    const [cols, setCols] = useState(process.stdout.columns || 100);
+    const [rows, setRows] = useState(process.stdout.rows || 32);
+    const [tick, setTick] = useState(0);
+    const retryRef = useRef(null);
+    const RETRY_MS = 12000;
+
+    // wallet (read-only portfolio) state
+    const [walletInput, setWalletInput] = useState('');
+    const [walletData, setWalletData] = useState(null);
+    const [walletErr, setWalletErr] = useState('');
+    const [walletLoading, setWalletLoading] = useState(false);
+
+    const quit = () => { restore(); exit(); };
+
+    async function loadWallet(addr) {
+      const a = String(addr || '').trim();
+      if (!isValidSolanaAddress(a)) { setWalletErr('that doesn’t look like a Solana address'); return; }
+      setScreen('wallet'); setWalletLoading(true); setWalletErr(''); setWalletData(null);
+      try {
+        setWalletData(await fetchPortfolio(a));
+      } catch (e) {
+        setWalletErr(e.message);
+      } finally {
+        setWalletLoading(false);
+      }
+    }
+
+    async function load() {
+      try {
+        const data = await fetchTopCoins(10);
+        setCoins(data); setLoaded(true); setErr(''); setRetryAt(0);
+        setUpdated(new Date().toLocaleTimeString());
+        if (retryRef.current) { clearTimeout(retryRef.current); retryRef.current = null; }
+      } catch (e) {
+        setErr(e.message);
+        if (retryRef.current) clearTimeout(retryRef.current);
+        setRetryAt(Date.now() + RETRY_MS);
+        retryRef.current = setTimeout(load, RETRY_MS);
+      }
+    }
+
+    useEffect(() => {
+      load();
+      const t = setInterval(() => setTick((x) => x + 1), 120);
+      const refresh = setInterval(load, 60000);
+      const onResize = () => {
+        setCols(process.stdout.columns || 100);
+        setRows(process.stdout.rows || 32);
+      };
+      process.stdout.on('resize', onResize);
+      return () => {
+        clearInterval(t); clearInterval(refresh);
+        if (retryRef.current) clearTimeout(retryRef.current);
+        process.stdout.off('resize', onResize);
+      };
+    }, []);
+
+    function activate(action) {
+      setToast('');
+      if (action === 'live') return setScreen('live');
+      if (action === 'about') return setScreen('about');
+      if (action === 'wallet') { setWalletErr(''); return setScreen('wallet'); }
+      if (action === 'quit') return quit();
+    }
+
+    function runCommand(raw) {
+      const c = raw.trim().toLowerCase();
+      setBuf('');
+      if (!c) return activate(MENU[menuSel].action);
+      if (['q', 'quit', 'exit'].includes(c)) return quit();
+      if (['about', 'roadmap'].includes(c)) return setScreen('about');
+      if (['live', 'prices', 'top', 'p'].includes(c)) return setScreen('live');
+      const parts = c.split(/\s+/);
+      if (['wallet', 'watch', 'w'].includes(parts[0])) {
+        if (parts[1]) return loadWallet(raw.trim().split(/\s+/)[1]);
+        setWalletErr(''); return setScreen('wallet');
+      }
+      const idx = coins.findIndex((x) => x.symbol.toLowerCase() === c || x.id === c);
+      if (idx >= 0) { setSel(idx); return setScreen('live'); }
+      setToast(`"${c}" not in top 10 — coin search coming soon`);
+    }
+
+    useInput((input, key) => {
+      if (key.ctrl && input === 'c') return quit();
+      if (screen === 'home') {
+        if (key.upArrow) return setMenuSel((s) => (s + MENU.length - 1) % MENU.length);
+        if (key.downArrow) return setMenuSel((s) => (s + 1) % MENU.length);
+        if (key.return) return runCommand(buf);
+        if (key.backspace || key.delete) return setBuf((b) => b.slice(0, -1));
+        if (input && !key.ctrl && !key.meta && !key.tab && !key.escape) return setBuf((b) => b + input);
+        return;
+      }
+      // wallet address entry: capture every printable key (base58 includes q/b/r)
+      if (screen === 'wallet' && !walletData && !walletLoading) {
+        if (key.escape) { setWalletInput(''); setWalletErr(''); return setScreen('home'); }
+        if (key.return) { const a = walletInput; setWalletInput(''); return loadWallet(a); }
+        if (key.backspace || key.delete) return setWalletInput((b) => b.slice(0, -1));
+        if (input && !key.ctrl && !key.meta && !key.tab) return setWalletInput((b) => b + input);
+        return;
+      }
+      // live / about / wallet-result
+      if (key.escape || input === 'b') { setToast(''); return setScreen('home'); }
+      if (input === 'q') return quit();
+      if (input === 'r') {
+        if (screen === 'wallet' && walletData) return loadWallet(walletData.address);
+        return load();
+      }
+      if (screen === 'wallet' && input === 'n') { setWalletData(null); setWalletErr(''); return; }
+      if (screen === 'live') {
+        if (key.upArrow || input === 'k') return setSel((s) => Math.max(0, s - 1));
+        if (key.downArrow || input === 'j') return setSel((s) => Math.min(coins.length - 1, s + 1));
+      }
+    });
+
+    const cursorOn = tick % 2 === 0;
+    const retryTxt = retryAt ? ` · retrying in ${Math.max(0, Math.ceil((retryAt - Date.now()) / 1000))}s` : '';
+    const statusTxt = err
+      ? `✗ ${err}${retryTxt} · press r`
+      : toast || 'non-custodial · nothing leaves your machine · prices via coingecko';
+
+    const Shell = (children) =>
+      html`<${Box} flexDirection="column" width=${cols} height=${rows} backgroundColor=${VOID} paddingX=${2} paddingTop=${1}>
+        ${children}
+      <//>`;
+
+    /* ---------------- HOME ---------------- */
+    if (screen === 'home') {
+      const menu = MENU.map((m, i) => {
+        const s = i === menuSel;
+        return html`<${Box} key=${i} width=${44}>
+          <${Text} bold=${s} color=${s ? GREEN : INK}>${(s ? '▸ ' : '  ') + '[ ' + m.label}<//>
+          <${Box} flexGrow=${1}><//>
+          <${Text} color=${DIM}>${m.hint + ' ]'}<//>
+        <//>`;
+      });
+
+      return Shell(html`
+        <${Box} flexGrow=${1}><//>
+        <${Box} justifyContent="center">
+          <${Box} borderStyle="round" borderColor=${BORDER} paddingX=${3} paddingY=${1}>
+            <${Box} flexDirection="column" marginRight=${3}>
+              ${COIN.map((l, i) => html`<${Text} key=${i} color=${LOGO}>${l}<//>`)}
+            <//>
+            <${Box} flexDirection="column">
+              <${Box}>
+                <${Text} bold color=${INK}>mybitduit<//>
+                <${Text} color=${DIM}>   Beta 0.0.1<//>
+              <//>
+              <${Text} color=${DIM}>your non-custodial solana money terminal<//>
+              <${Box} marginTop=${1}><${Text} bold color=${AMBER}>live · prices + read-only wallet<//><//>
+              <${Text} color=${DIM}>Top 10 + 7d charts, and any wallet by address. Swaps next.<//>
+              <${Box} flexDirection="column" marginTop=${1}>
+                ${menu}
+              <//>
+            <//>
+          <//>
+        <//>
+        <${Box} flexGrow=${1}><//>
+        <${Box}><${Text} color=${err ? RED : DIM}>${statusTxt}<//><//>
+        <${Box} borderStyle="round" borderColor=${BORDER} paddingX=${1} marginTop=${0}>
+          <${Text} color=${GREEN}>${'› '}<//>
+          <${Text} color=${INK}>${buf}<//>
+          <${Text} color=${buf ? INK : DIM}>${buf ? (cursorOn ? '▌' : ' ') : 'type a coin (sol) or ↑↓ ↵'}<//>
+          <${Box} flexGrow=${1}><//>
+          <${Text} color=${DIM}>mybitduit · prices<//>
+        <//>
+        <${Box} justifyContent="flex-end"><${Text} color=${DIM}>Beta<//><//>
+      `);
+    }
+
+    /* ---------------- ABOUT ---------------- */
+    if (screen === 'about') {
+      const lines = [
+        ['Phase 0 — prices', 'live · top 10 + 7d charts'],
+        ['Phase 1 — wallet view', 'live · read any address, no key (web: Phantom next)'],
+        ['Phase 2 — swaps (Jupiter)', 'your wallet signs · we never hold funds'],
+        ['Phase 3 — fiat on-ramp', 'buy with card via a partner'],
+      ];
+      return Shell(html`
+        <${Box} flexGrow=${1}><//>
+        <${Box} justifyContent="center">
+          <${Box} flexDirection="column" borderStyle="round" borderColor=${BORDER} paddingX=${3} paddingY=${1} width=${64}>
+            <${Box}><${Text} bold color=${INK}>mybitduit<//><${Text} color=${DIM}> · roadmap<//><//>
+            <${Text} color=${DIM}>bit + duit · a non-custodial Solana money terminal<//>
+            <${Box} flexDirection="column" marginTop=${1}>
+              ${lines.map((l, i) => html`<${Box} key=${i}>
+                <${Box} width=${28}><${Text} color=${i <= 1 ? GREEN : INK}>${(i <= 1 ? '▸ ' : '  ') + l[0]}<//><//>
+                <${Text} color=${DIM}>${l[1]}<//>
+              <//>`)}
+            <//>
+            <${Box} marginTop=${1}><${Text} color=${AMBER}>principle: <//><${Text} color=${DIM}>we never hold your money.<//><//>
+          <//>
+        <//>
+        <${Box} flexGrow=${1}><//>
+        <${Box} justifyContent="flex-end"><${Text} color=${DIM}>esc / b back · q quit<//><//>
+      `);
+    }
+
+    /* ---------------- WALLET (read-only portfolio) ---------------- */
+    if (screen === 'wallet') {
+      // loading
+      if (walletLoading) {
+        const w = 24, pos = tick % w;
+        const barr = Array.from({ length: w }, (_, i) =>
+          i === pos || i === (pos + 1) % w ? '█' : '░').join('');
+        return Shell(html`
+          <${Box} flexGrow=${1}><//>
+          <${Box} justifyContent="center">
+            <${Box} flexDirection="column" alignItems="center">
+              ${COIN.map((l, i) => html`<${Text} key=${i} color=${LOGO}>${l}<//>`)}
+              <${Box} marginTop=${1}><${Text} color=${DIM}>reading wallet · on-chain<//><//>
+              <${Box}><${Text} color=${GREEN}>[${barr}]<//><//>
+            <//>
+          <//>
+          <${Box} flexGrow=${1}><//>
+          <${Box} justifyContent="flex-end"><${Text} color=${DIM}>read-only · we never see a key<//><//>
+        `);
+      }
+      // result
+      if (walletData) {
+        const p = walletData;
+        const short = p.address.slice(0, 4) + '…' + p.address.slice(-4);
+        const amtStr = (n) => (n >= 1 ? fmtPrice(n) : Number(n.toPrecision(4)).toString());
+        const top = p.holdings.slice(0, 12);
+        const more = p.holdings.length - top.length;
+        return Shell(html`
+          <${Box} marginBottom=${1}>
+            <${Text} bold color=${GREEN}>mybitduit<//>
+            <${Text} color=${DIM}> // wallet ${short} · read-only<//>
+          <//>
+          <${Box} justifyContent="center">
+            <${Box} flexDirection="column" borderStyle="round" borderColor=${BORDER} paddingX=${2} paddingY=${1} width=${66}>
+              <${Box}>
+                <${Box} width=${14}><${Text} bold color=${INK}>total<//><//>
+                <${Text} bold color=${INK}>$${fmtPrice(p.total)}<//>
+                <${Text} color=${p.change24h == null ? DIM : p.change24h >= 0 ? GREEN : RED}>${p.change24h == null ? '' : '  ' + fmtChange(p.change24h) + ' 24h'}<//>
+              <//>
+              <${Box}><${Text} color=${BORDER}>${'─'.repeat(60)}<//><//>
+              ${top.map((h, i) => html`<${Box} key=${i}>
+                <${Box} width=${10}><${Text} color=${h.price != null ? INK : DIM}>${h.symbol.slice(0, 9)}<//><//>
+                <${Box} width=${16}><${Text} color=${DIM}>${amtStr(h.amount)}<//><//>
+                <${Box} width=${12}><${Text} color=${h.price != null ? INK : DIM}>${h.price != null ? '$' + fmtPrice(h.value) : '—'}<//><//>
+                <${Text} color=${h.change == null ? DIM : h.change >= 0 ? GREEN : RED}>${fmtChange(h.change)}<//>
+              <//>`)}
+              ${more > 0 && html`<${Box}><${Text} color=${DIM}>+${more} more holding(s)<//><//>`}
+              ${p.hiddenCount > 0 && html`<${Box}><${Text} color=${DIM}>+${p.hiddenCount} dust / unpriced hidden<//><//>`}
+            <//>
+          <//>
+          <${Box} flexGrow=${1}><//>
+          <${Box}><${Text} color=${DIM}>via ${p.rpc.replace(/^https?:\/\//, '')}<//><//>
+          <${Box} justifyContent="flex-end"><${Text} color=${DIM}>r refresh · n new address · esc home · q quit<//><//>
+        `);
+      }
+      // address entry
+      return Shell(html`
+        <${Box} flexGrow=${1}><//>
+        <${Box} justifyContent="center">
+          <${Box} flexDirection="column" borderStyle="round" borderColor=${BORDER} paddingX=${3} paddingY=${1} width=${68}>
+            <${Box}><${Text} bold color=${INK}>wallet<//><${Text} color=${DIM}> · read-only portfolio<//><//>
+            <${Text} color=${DIM}>paste a Solana address — we only ever look, never touch a key.<//>
+            <${Box} borderStyle="round" borderColor=${walletErr ? RED : BORDER} paddingX=${1} marginTop=${1}>
+              <${Text} color=${GREEN}>${'› '}<//>
+              <${Text} color=${INK}>${walletInput || ''}<//>
+              <${Text} color=${walletInput ? INK : DIM}>${walletInput ? (cursorOn ? '▌' : ' ') : 'e.g. a base58 address, then ↵'}<//>
+            <//>
+            ${walletErr && html`<${Box} marginTop=${1}><${Text} color=${RED}>✗ ${walletErr}<//><//>`}
+          <//>
+        <//>
+        <${Box} flexGrow=${1}><//>
+        <${Box} justifyContent="flex-end"><${Text} color=${DIM}>↵ look up · esc home<//><//>
+      `);
+    }
+
+    /* ---------------- LIVE (loading) ---------------- */
+    if (screen === 'live' && !loaded) {
+      const w = 24, pos = tick % w;
+      const barr = Array.from({ length: w }, (_, i) =>
+        i === pos || i === (pos + 1) % w ? '█' : '░').join('');
+      return Shell(html`
+        <${Box} flexGrow=${1}><//>
+        <${Box} justifyContent="center">
+          <${Box} flexDirection="column" alignItems="center">
+            ${COIN.map((l, i) => html`<${Text} key=${i} color=${LOGO}>${l}<//>`)}
+            <${Box} marginTop=${1}><${Text} color=${DIM}>loading top 10 markets<//><//>
+            <${Box}><${Text} color=${GREEN}>[${barr}]<//><//>
+            ${err && html`<${Box} marginTop=${1}><${Text} color=${RED}>✗ ${err}${retryTxt}<//><//>`}
+          <//>
+        <//>
+        <${Box} flexGrow=${1}><//>
+        <${Box} justifyContent="flex-end"><${Text} color=${DIM}>esc back · q quit<//><//>
+      `);
+    }
+
+    /* ---------------- LIVE (data) ---------------- */
+    const cur = coins[Math.min(sel, coins.length - 1)];
+    const LEFT_W = 46;
+    const chartPoints = Math.max(16, Math.min(72, cols - LEFT_W - 18));
+    const series = downsample(cur.spark, chartPoints);
+    const first = cur.spark[0], last = cur.spark[cur.spark.length - 1];
+    const up = last >= first;
+    const chartColor = up ? GREEN : RED;
+    const pct7d = first ? ((last - first) / first) * 100 : null;
+    let chartLines = ['(no chart data)'];
+    if (series && series.length > 1) {
+      try {
+        chartLines = asciichart.plot(series, { height: 12, format: axisFormatter(series, 12) }).split('\n');
+      } catch (e) {
+        chartLines = ['(chart unavailable)'];
+      }
+    }
+    const hi = Math.max(...cur.spark), lo = Math.min(...cur.spark);
+
+    return Shell(html`
+      <${Box} marginBottom=${1}>
+        <${Text} bold color=${GREEN}>mybitduit<//>
+        <${Text} color=${DIM}> // live · top 10 · ${updated}<//>
+        ${err && html`<${Text} color=${RED}>  (stale: ${err})<//>`}
+      <//>
+      <${Box}>
+        <${Box} flexDirection="column" width=${LEFT_W} borderStyle="round" borderColor=${BORDER} paddingX=${1}>
+          ${coins.map((c, i) => {
+            const s = i === sel;
+            return html`<${Box} key=${c.id}>
+              <${Text} color=${s ? GREEN : DIM}>${s ? '▸' : ' '} <//>
+              <${Box} width=${3}><${Text} color=${DIM}>${String(c.rank)}<//><//>
+              <${Box} width=${7}><${Text} bold color=${s ? GREEN : INK}>${c.symbol.slice(0, 6)}<//><//>
+              <${Box} width=${12}><${Text} color=${s ? INK : DIM}>${c.name.slice(0, 11)}<//><//>
+              <${Box} width=${10}><${Text} color=${INK}>$${fmtPrice(c.price)}<//><//>
+              <${Text} color=${c.change == null ? DIM : c.change >= 0 ? GREEN : RED}>${fmtChange(c.change)}<//>
+            <//>`;
+          })}
+        <//>
+        <${Box} flexDirection="column" flexGrow=${1} borderStyle="round" borderColor=${BORDER} paddingX=${1} marginLeft=${1}>
+          <${Box}>
+            <${Text} bold color=${INK}>${cur.symbol}<//>
+            <${Text} color=${DIM}> / USD · 7d  <//>
+            <${Text} color=${chartColor}>${pct7d == null ? '' : fmtChange(pct7d)}<//>
+          <//>
+          ${chartLines.map((l, i) => html`<${Text} key=${i} color=${chartColor}>${l}<//>`)}
+          <${Box} marginTop=${1}>
+            <${Text} color=${INK}>now $${fmtPrice(cur.price)}  <//>
+            <${Text} color=${cur.change == null ? DIM : cur.change >= 0 ? GREEN : RED}>${fmtChange(cur.change)}<//>
+            <${Text} color=${DIM}>   7d $${shortNum(lo)}–$${shortNum(hi)}<//>
+          <//>
+        <//>
+      <//>
+      <${Box} marginTop=${1}>
+        <${Text} color=${DIM}>↑↓ / j k select · r refresh · esc home · q quit<//>
+      <//>
+    `);
+  }
+
+  render(html`<${App} />`);
+}
+
+/* ---- help ---- */
+function printHelp() {
+  const b = A.bold, g = A.green, d = A.dim, k = A.ink;
+  console.log(b(g('mybitduit')) + d('  // your non-custodial Solana money terminal'));
+  console.log('');
+  console.log(d('  USAGE'));
+  console.log('    ' + k('mybitduit') + d('                     full-screen live terminal (no args)'));
+  console.log('    ' + k('mybitduit price ') + d('sol btc eth') + d('     print prices once, then exit'));
+  console.log('    ' + k('mybitduit top') + d('                 print top 10 by market cap, exit'));
+  console.log('    ' + k('mybitduit watch ') + d('<address>') + d('     read-only Solana wallet (add --json)'));
+  console.log('    ' + k('mybitduit help') + d('                this'));
+  console.log('');
+  console.log(d('  ENV (optional)'));
+  console.log('    ' + k('COINGECKO_API_KEY') + d('   free demo key → higher price rate limits'));
+  console.log('    ' + k('SOLANA_RPC_URL') + d('      your own RPC (e.g. Helius) for wallet reads'));
+  console.log('');
+  console.log(d('  Non-custodial, always. We show info or ask your wallet to sign — never hold funds.'));
+}
+
+/* ---- entry ---- */
+const args = process.argv.slice(2);
+const wantsTui = args.length === 0 || args[0] === 'tui';
+if (['help', '--help', '-h'].includes(args[0])) {
+  printHelp();
+} else if (wantsTui && process.stdout.isTTY) {
+  tui();
+} else if (wantsTui) {
+  oneShotTop();
+} else if (args[0] === 'top') {
+  oneShotTop();
+} else if (args[0] === 'watch') {
+  watchCmd(args[1], args.includes('--json'));
+} else {
+  const symbols = (args[0] === 'price' ? args.slice(1) : args).filter(Boolean);
+  oneShot(symbols.length ? symbols : ['sol', 'btc', 'eth']);
+}

package/core/portfolio.mjs

@@ -0,0 +1,131 @@
+/* ============================================================
+   mybitduit — read-only Solana portfolio engine
+   Given a wallet ADDRESS (never a key), returns SOL + SPL token
+   holdings with USD values and a weighted 24h change.
+   - RPC: env SOLANA_RPC_URL (e.g. a Helius URL) else public mainnet.
+   - Prices: Jupiter Price API v3 (no key).
+   100% read-only and non-custodial — we only ever look.
+   ============================================================ */
+
+const SOL_MINT = 'So11111111111111111111111111111111111111112';
+const TOKEN_PROGRAMS = [
+  'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA', // SPL Token
+  'TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb', // Token-2022
+];
+
+// common Solana mints → ticker (values come from Jupiter regardless of this map)
+const KNOWN = {
+  [SOL_MINT]: 'SOL',
+  EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v: 'USDC',
+  Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB: 'USDT',
+  JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN: 'JUP',
+  DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263: 'BONK',
+  jtojtomepa8beP8AuQc6eXt5FriJwfFMwQx2v2f9mCL: 'JTO',
+  EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm: 'WIF',
+  mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So: 'mSOL',
+  'So11111111111111111111111111111111111111112': 'SOL',
+};
+
+export function isValidSolanaAddress(a) {
+  return typeof a === 'string' && /^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(a);
+}
+
+function rpcUrl() {
+  return (typeof process !== 'undefined' && process.env && process.env.SOLANA_RPC_URL) ||
+    'https://api.mainnet-beta.solana.com';
+}
+
+async function rpc(method, params) {
+  const r = await fetch(rpcUrl(), {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ jsonrpc: '2.0', id: 1, method, params }),
+  });
+  if (!r.ok) throw new Error(`RPC ${method} failed (${r.status})`);
+  const j = await r.json();
+  if (j.error) throw new Error(`RPC ${method}: ${j.error.message || 'error'}`);
+  return j.result;
+}
+
+async function jupPrices(mints) {
+  const out = {};
+  for (let i = 0; i < mints.length; i += 80) {
+    const chunk = mints.slice(i, i + 80);
+    try {
+      const r = await fetch(`https://lite-api.jup.ag/price/v3?ids=${chunk.join(',')}`, {
+        headers: { accept: 'application/json' },
+      });
+      if (r.ok) Object.assign(out, await r.json());
+    } catch {
+      /* price fetch best-effort */
+    }
+  }
+  return out;
+}
+
+const shortMint = (m) => m.slice(0, 4) + '…' + m.slice(-4);
+
+/**
+ * @returns {address, sol, total, change24h|null, holdings:[{symbol,mint,amount,price,value,change}], hiddenCount, rpc}
+ */
+export async function fetchPortfolio(address) {
+  if (!isValidSolanaAddress(address)) throw new Error('not a valid Solana address');
+
+  const [bal, ...tokenSets] = await Promise.all([
+    rpc('getBalance', [address]),
+    ...TOKEN_PROGRAMS.map((pid) =>
+      rpc('getTokenAccountsByOwner', [address, { programId: pid }, { encoding: 'jsonParsed' }]).catch(
+        () => ({ value: [] }),
+      ),
+    ),
+  ]);
+
+  const solAmount = (bal?.value || 0) / 1e9;
+
+  const byMint = {};
+  for (const set of tokenSets) {
+    for (const it of set?.value || []) {
+      const info = it.account?.data?.parsed?.info;
+      const amt = info?.tokenAmount?.uiAmount;
+      if (info?.mint && amt > 0) byMint[info.mint] = (byMint[info.mint] || 0) + amt;
+    }
+  }
+
+  const mints = [SOL_MINT, ...Object.keys(byMint)];
+  const prices = await jupPrices(mints);
+
+  const holdings = [];
+  const solP = prices[SOL_MINT];
+  holdings.push({
+    symbol: 'SOL', mint: SOL_MINT, amount: solAmount,
+    price: solP?.usdPrice ?? null, value: solAmount * (solP?.usdPrice ?? 0),
+    change: solP?.priceChange24h ?? null,
+  });
+  for (const [mint, amount] of Object.entries(byMint)) {
+    const p = prices[mint];
+    const price = p?.usdPrice ?? null;
+    holdings.push({
+      symbol: mint === SOL_MINT ? 'wSOL' : KNOWN[mint] || shortMint(mint), mint, amount,
+      price, value: price != null ? amount * price : 0,
+      change: p?.priceChange24h ?? null,
+    });
+  }
+
+  const shown = holdings
+    .filter((h) => h.mint === SOL_MINT || h.value >= 0.01)
+    .sort((a, b) => b.value - a.value);
+  const hiddenCount = holdings.length - shown.length;
+  const total = shown.reduce((s, h) => s + (h.value || 0), 0);
+
+  // weighted 24h change across priced holdings
+  let prev = 0, cur = 0;
+  for (const h of shown) {
+    if (h.value && h.change != null) {
+      prev += h.value / (1 + h.change / 100);
+      cur += h.value;
+    }
+  }
+  const change24h = prev > 0 ? ((cur - prev) / prev) * 100 : null;
+
+  return { address, sol: solAmount, total, change24h, holdings: shown, hiddenCount, rpc: rpcUrl() };
+}

package/core/prices.mjs

@@ -0,0 +1,112 @@
+/* ============================================================
+   mybitduit — shared price engine
+   One brain, two faces (CLI + web). No API key needed for v1:
+   uses CoinGecko's free public endpoint.
+   ============================================================ */
+
+// short ticker -> CoinGecko id. Unknown symbols fall back to the
+// raw input as an id, so `price <coingecko-id>` still works.
+export const SYMBOL_TO_ID = {
+  sol: 'solana',
+  btc: 'bitcoin',
+  eth: 'ethereum',
+  usdc: 'usd-coin',
+  usdt: 'tether',
+  bonk: 'bonk',
+  jup: 'jupiter-exchange-solana',
+};
+
+export function resolveId(sym) {
+  const s = String(sym).toLowerCase();
+  return SYMBOL_TO_ID[s] || s;
+}
+
+// Optional free CoinGecko "Demo" API key (https://www.coingecko.com/en/api)
+// raises rate limits. Set COINGECKO_API_KEY in the env; harmless if absent.
+function cgHeaders() {
+  const h = { accept: 'application/json' };
+  const key =
+    typeof process !== 'undefined' && process.env ? process.env.COINGECKO_API_KEY : '';
+  if (key) h['x-cg-demo-api-key'] = key;
+  return h;
+}
+
+/**
+ * Fetch USD prices + 24h change for a list of symbols.
+ * Returns: [{ symbol, id, price|null, change|null }]
+ */
+export async function fetchPrices(symbols) {
+  const list = [...new Set(symbols.map((s) => String(s).toLowerCase()))];
+  const ids = list.map(resolveId);
+  const url =
+    'https://api.coingecko.com/api/v3/simple/price' +
+    `?ids=${encodeURIComponent(ids.join(','))}` +
+    '&vs_currencies=usd&include_24hr_change=true';
+
+  const res = await fetch(url, { headers: cgHeaders() });
+  if (!res.ok) {
+    if (res.status === 429) throw new Error('rate limited — try again shortly');
+    throw new Error(`price fetch failed (${res.status})`);
+  }
+  const data = await res.json();
+  return list.map((sym, i) => {
+    const d = data[ids[i]];
+    return {
+      symbol: sym.toUpperCase(),
+      id: ids[i],
+      price: d?.usd ?? null,
+      change: d?.usd_24h_change ?? null,
+    };
+  });
+}
+
+/**
+ * Fetch the top N coins by market cap, including a 7-day sparkline.
+ * Returns: [{ rank, symbol, name, id, price, change, spark:[...] }]
+ */
+export async function fetchTopCoins(n = 10) {
+  const url =
+    'https://api.coingecko.com/api/v3/coins/markets' +
+    '?vs_currency=usd&order=market_cap_desc' +
+    `&per_page=${n}&page=1&sparkline=true&price_change_percentage=24h`;
+
+  const res = await fetch(url, { headers: cgHeaders() });
+  if (!res.ok) {
+    if (res.status === 429) throw new Error('rate limited — try again shortly');
+    throw new Error(`market fetch failed (${res.status})`);
+  }
+  const data = await res.json();
+  if (!Array.isArray(data)) throw new Error('rate limited — try again shortly');
+  return data.map((c, i) => ({
+    rank: c.market_cap_rank ?? i + 1,
+    symbol: String(c.symbol || '').toUpperCase(),
+    name: c.name || c.id,
+    id: c.id,
+    price: c.current_price ?? null,
+    change: c.price_change_percentage_24h ?? null,
+    spark: c.sparkline_in_7d?.price || [],
+  }));
+}
+
+/** Evenly downsample a number array to `target` points (for fitting a chart). */
+export function downsample(arr, target) {
+  if (!arr || arr.length <= target) return arr || [];
+  const out = [];
+  const step = (arr.length - 1) / (target - 1);
+  for (let i = 0; i < target; i++) out.push(arr[Math.round(i * step)]);
+  return out;
+}
+
+/* ---- formatting helpers (shared so CLI + web look identical) ---- */
+export function fmtPrice(n) {
+  if (n == null) return '—';
+  if (n >= 1) return n.toLocaleString('en-US', { maximumFractionDigits: 2 });
+  // sub-$1 tokens: show enough significant digits (e.g. BONK)
+  return Number(n.toPrecision(4)).toString();
+}
+
+export function fmtChange(c) {
+  if (c == null) return '';
+  const arrow = c >= 0 ? '▲' : '▼';
+  return `${arrow} ${Math.abs(c).toFixed(2)}%`;
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "mybitduit",
+  "version": "0.0.1",
+  "description": "mybitduit — your non-custodial Solana money terminal (web + CLI). bit + duit.",
+  "type": "module",
+  "bin": { "mybitduit": "cli/mybitduit.mjs" },
+  "files": ["cli/", "core/", "README.md"],
+  "preferGlobal": true,
+  "keywords": ["solana", "crypto", "cli", "terminal", "prices", "wallet", "non-custodial"],
+  "license": "MIT",
+  "scripts": {
+    "start": "node cli/mybitduit.mjs",
+    "cli": "node cli/mybitduit.mjs",
+    "prices": "node cli/mybitduit.mjs price sol btc eth"
+  },
+  "dependencies": {
+    "asciichart": "^1.5.25",
+    "htm": "^3.1.1",
+    "ink": "^5.0.1",
+    "react": "^18.3.1"
+  },
+  "engines": { "node": ">=18" }
+}