@darksol/terminal 0.4.1 → 0.4.3

package/README.md

@@ -30,15 +30,30 @@ darksol
 # Create a wallet (AES-256-GCM encrypted)
 darksol wallet create main
 
-# Check balance
+# Check balance + multi-chain portfolio
 darksol wallet balance
+darksol portfolio
 
-# Swap tokens
+# Token prices & live monitoring
+darksol price ETH AERO VIRTUAL
+darksol watch AERO --above 2.0
+
+# Gas estimates
+darksol gas base
+
+# Swap tokens (Uniswap V3 with slippage protection)
 darksol trade swap -i ETH -o USDC -a 0.1
 
 # AI trading assistant
 darksol ai chat
 
+# Agent email
+darksol mail setup
+darksol mail send --to user@example.com --subject "Hello"
+
+# Web terminal in browser
+darksol serve
+
 # Start agent signer for OpenClaw
 darksol agent start main
 ```
@@ -58,6 +73,16 @@ darksol agent start main
 | `market` | Market intel, top movers, token analysis | x402 micropayments |
 | `oracle` | On-chain random number oracle | $0.05–$0.25 |
 | `casino` | The Clawsino — on-chain betting | $1 flat bets |
+| `portfolio` | Multi-chain balance view (5 EVM chains) | Free |
+| `gas` | Gas prices & cost estimates | Free |
+| `price` | Quick token price check (DexScreener) | Free |
+| `watch` | Live price monitoring with alerts | Free |
+| `history` | Transaction history via block explorers | Free |
+| `mail` | AgentMail — email for AI agents | Free tier |
+| `serve` | Web terminal in browser (xterm.js) | Free |
+| `facilitator` | x402 payment facilitator | Free |
+| `cards` | Prepaid Visa/MC cards | Service fees |
+| `builders` | ERC-8021 builder code directory | Free |
 | `cards` | Crypto → prepaid Visa/MC (no KYC) | 3% markup |
 | `builders` | ERC-8021 builder leaderboard | Free |
 | `facilitator` | x402 payment verification & settlement | Free |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@darksol/terminal",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "DARKSOL Terminal — unified CLI for all DARKSOL services. Market intel, trading, oracle, casino, and more.",
   "type": "module",
   "bin": {
@@ -43,7 +43,8 @@
     "open": "^11.0.0",
     "ora": "^8.1.0",
     "terminal-link": "^3.0.0",
-    "update-notifier": "^7.3.1"
+    "update-notifier": "^7.3.1",
+    "ws": "^8.19.0"
   },
   "engines": {
     "node": ">=18.0.0"

package/src/cli.js

@@ -9,6 +9,7 @@ import { showHistory } from './wallet/history.js';
 import { showGas } from './services/gas.js';
 import { watchPrice, checkPrices } from './services/watch.js';
 import { mailSetup, mailCreate, mailInboxes, mailSend, mailList, mailRead, mailReply, mailForward, mailThreads, mailDelete, mailUse, mailStats, mailStatus } from './services/mail.js';
+import { startWebShell } from './web/server.js';
 import { executeSwap } from './trading/swap.js';
 import { snipeToken, watchSnipe } from './trading/snipe.js';
 import { createDCA, listDCA, cancelDCA, runDCA } from './trading/dca.js';
@@ -25,6 +26,9 @@ import { parseIntent, startChat, adviseStrategy, analyzeToken, executeIntent } f
 import { startAgentSigner, showAgentDocs } from './wallet/agent-signer.js';
 import { listSkills, installSkill, skillInfo, uninstallSkill } from './services/skills.js';
 import { runSetupWizard, checkFirstRun } from './setup/wizard.js';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const { version: PKG_VERSION } = require('../package.json');
 
 export function cli(argv) {
   const program = new Command();
@@ -32,7 +36,7 @@ export function cli(argv) {
   program
     .name('darksol')
     .description(theme.gold('DARKSOL Terminal') + theme.dim(' — Ghost in the machine with teeth 🌑'))
-    .version('0.4.1')
+    .version(PKG_VERSION)
 ;
 
   // ═══════════════════════════════════════
@@ -398,6 +402,16 @@ export function cli(argv) {
     .description('Delete an inbox')
     .action((id) => mailDelete(id));
 
+  // ═══════════════════════════════════════
+  // WEB SHELL
+  // ═══════════════════════════════════════
+  program
+    .command('serve')
+    .description('🌐 Launch web terminal in browser')
+    .option('-p, --port <port>', 'Server port', '18791')
+    .option('--no-open', 'Don\'t auto-open browser')
+    .action((opts) => startWebShell(opts));
+
   // ═══════════════════════════════════════
   // PORTFOLIO SHORTCUT
   // ═══════════════════════════════════════
@@ -710,6 +724,8 @@ export function cli(argv) {
         ['Output', cfg.output],
         ['Slippage', `${cfg.slippage}%`],
         ['Gas Multiplier', `${cfg.gasMultiplier}x`],
+        ['Mail', cfg.mailEmail || theme.dim('(not set)')],
+        ['Version', PKG_VERSION],
         ['Config File', configPath()],
       ]);
       console.log('');
@@ -776,6 +792,42 @@ export function cli(argv) {
       }
     });
 
+  // ═══════════════════════════════════════
+  // FUZZY / NATURAL LANGUAGE FALLBACK
+  // ═══════════════════════════════════════
+  // If someone types something Commander doesn't recognize,
+  // try routing it through AI before saying "unknown command"
+  program.on('command:*', async (operands) => {
+    const input = operands.join(' ');
+    const { hasAnyLLM } = await import('./config/keys.js');
+
+    if (hasAnyLLM()) {
+      const { parseIntent } = await import('./llm/intent.js');
+      const { info, error: showError } = await import('./ui/components.js');
+
+      console.log('');
+      info(`"${input}" isn't a command — asking AI...`);
+      console.log('');
+
+      try {
+        const result = await parseIntent(input);
+        if (result && result.action !== 'error' && result.action !== 'unknown') {
+          const { executeIntent } = await import('./llm/intent.js');
+          await executeIntent(result);
+          return;
+        }
+      } catch {}
+
+      showError(`Unknown command: ${input}`);
+      info('Try: darksol help');
+    } else {
+      const { error: showError, info } = await import('./ui/components.js');
+      showError(`Unknown command: ${input}`);
+      info('Tip: Set up AI (darksol setup) for natural language commands');
+      info('Run: darksol help');
+    }
+  });
+
   program.parse(argv);
 }
 
@@ -932,6 +984,7 @@ function showCommandList() {
     ['mail', 'AgentMail — email for your agent'],
     ['facilitator', 'x402 payment facilitator'],
     ['skills', 'Agent skill directory'],
+    ['serve', 'Launch web terminal in browser'],
     ['setup', 'Re-run setup wizard'],
     ['config', 'Terminal configuration'],
   ];

package/src/services/builders.js

@@ -1,4 +1,4 @@
-import fetch from 'node-fetch';
+import { fetchJSON } from '../utils/fetch.js';
 import { getServiceURL } from '../config/store.js';
 import { theme } from '../ui/theme.js';
 import { spinner, table, kvDisplay, error } from '../ui/components.js';
@@ -9,8 +9,7 @@ const getURL = () => getServiceURL('builders') || 'https://builders.darksol.net'
 export async function buildersLeaderboard(opts = {}) {
   const spin = spinner('Loading builder leaderboard...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/leaderboard?limit=${opts.limit || 20}`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/leaderboard?limit=${opts.limit || 20}`);
     spin.succeed('Leaderboard loaded');
 
     showSection('ERC-8021 BUILDER LEADERBOARD');
@@ -34,8 +33,7 @@ export async function buildersLeaderboard(opts = {}) {
 export async function buildersLookup(code) {
   const spin = spinner(`Looking up builder: ${code}...`).start();
   try {
-    const resp = await fetch(`${getURL()}/api/builders/${code}`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/builders/${code}`);
     spin.succeed('Builder found');
 
     showSection(`BUILDER — ${code}`);
@@ -49,8 +47,7 @@ export async function buildersLookup(code) {
 export async function buildersFeed(opts = {}) {
   const spin = spinner('Loading builder feed...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/feed?limit=${opts.limit || 20}`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/feed?limit=${opts.limit || 20}`);
     spin.succeed('Feed loaded');
 
     showSection('BUILDER FEED');

package/src/services/cards.js

@@ -1,7 +1,7 @@
-import fetch from 'node-fetch';
+import { fetchJSON } from '../utils/fetch.js';
 import { getServiceURL } from '../config/store.js';
 import { theme } from '../ui/theme.js';
-import { spinner, kvDisplay, error, table } from '../ui/components.js';
+import { spinner, kvDisplay, error, info, table } from '../ui/components.js';
 import { showSection } from '../ui/banner.js';
 
 const getURL = () => getServiceURL('cards') || 'https://acp.darksol.net/cards';
@@ -9,8 +9,7 @@ const getURL = () => getServiceURL('cards') || 'https://acp.darksol.net/cards';
 export async function cardsCatalog() {
   const spin = spinner('Loading card catalog...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/cards/catalog`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/cards/catalog`);
     spin.succeed('Catalog loaded');
 
     showSection('PREPAID CARDS');
@@ -29,18 +28,18 @@ export async function cardsCatalog() {
   } catch (err) {
     spin.fail('Catalog failed');
     error(err.message);
+    info('Cards service: https://acp.darksol.net/cards');
   }
 }
 
 export async function cardsOrder(provider, amount) {
   const spin = spinner('Processing card order...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/cards/order`, {
+    const data = await fetchJSON(`${getURL()}/api/cards/order`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({ provider, amount }),
     });
-    const data = await resp.json();
     spin.succeed('Order placed');
 
     showSection('CARD ORDER');
@@ -48,14 +47,14 @@ export async function cardsOrder(provider, amount) {
   } catch (err) {
     spin.fail('Order failed');
     error(err.message);
+    info('The cards order API may not be live yet. Check: https://acp.darksol.net/cards');
   }
 }
 
 export async function cardsStatus(orderId) {
   const spin = spinner('Checking order...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/cards/status?orderId=${orderId}`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/cards/status?orderId=${orderId}`);
     spin.succeed('Status loaded');
 
     showSection(`CARD ORDER — ${orderId}`);

package/src/services/casino.js

@@ -1,3 +1,4 @@
+import { fetchJSON } from '../utils/fetch.js';
 import fetch from 'node-fetch';
 import { getServiceURL } from '../config/store.js';
 import { theme } from '../ui/theme.js';
@@ -9,7 +10,7 @@ const getURL = () => getServiceURL('casino') || 'https://casino.darksol.net';
 export async function casinoBet(game, opts = {}) {
   const spin = spinner(`Placing ${game} bet...`).start();
   try {
-    const resp = await fetch(`${getURL()}/api/bet`, {
+    const data = await fetchJSON(`${getURL()}/api/bet`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({
@@ -19,7 +20,6 @@ export async function casinoBet(game, opts = {}) {
         wallet: opts.wallet,
       }),
     });
-    const data = await resp.json();
     spin.succeed('Bet placed');
 
     showSection(`CASINO — ${game.toUpperCase()}`);
@@ -40,8 +40,7 @@ export async function casinoBet(game, opts = {}) {
 export async function casinoTables() {
   const spin = spinner('Loading tables...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/tables`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/tables`);
     spin.succeed('Tables loaded');
 
     showSection('CASINO TABLES');
@@ -66,8 +65,7 @@ export async function casinoTables() {
 export async function casinoStats() {
   const spin = spinner('Loading stats...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/stats`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/stats`);
     spin.succeed('Stats loaded');
 
     showSection('CASINO STATS');
@@ -81,8 +79,7 @@ export async function casinoStats() {
 export async function casinoReceipt(id) {
   const spin = spinner(`Loading receipt ${id}...`).start();
   try {
-    const resp = await fetch(`${getURL()}/api/receipt/${id}`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/receipt/${id}`);
     spin.succeed('Receipt loaded');
 
     showSection(`CASINO RECEIPT — ${id}`);
@@ -92,3 +89,4 @@ export async function casinoReceipt(id) {
     error(err.message);
   }
 }
+

package/src/services/facilitator.js

@@ -1,4 +1,4 @@
-import fetch from 'node-fetch';
+import { fetchJSON } from '../utils/fetch.js';
 import { getServiceURL } from '../config/store.js';
 import { theme } from '../ui/theme.js';
 import { spinner, kvDisplay, error } from '../ui/components.js';
@@ -9,8 +9,7 @@ const getURL = () => getServiceURL('facilitator') || 'https://facilitator.darkso
 export async function facilitatorHealth() {
   const spin = spinner('Checking facilitator...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/health`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/health`);
     spin.succeed('Facilitator online');
 
     showSection('FACILITATOR STATUS');
@@ -24,12 +23,11 @@ export async function facilitatorHealth() {
 export async function facilitatorVerify(payment) {
   const spin = spinner('Verifying payment...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/verify`, {
+    const data = await fetchJSON(`${getURL()}/api/verify`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify(typeof payment === 'string' ? JSON.parse(payment) : payment),
     });
-    const data = await resp.json();
     spin.succeed(data.valid ? 'Payment valid' : 'Payment invalid');
 
     showSection('PAYMENT VERIFICATION');
@@ -43,12 +41,11 @@ export async function facilitatorVerify(payment) {
 export async function facilitatorSettle(payment) {
   const spin = spinner('Settling on-chain...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/settle`, {
+    const data = await fetchJSON(`${getURL()}/api/settle`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify(typeof payment === 'string' ? JSON.parse(payment) : payment),
     });
-    const data = await resp.json();
     spin.succeed('Settlement complete');
 
     showSection('SETTLEMENT');

package/src/services/oracle.js

@@ -1,3 +1,4 @@
+import { fetchJSON } from '../utils/fetch.js';
 import fetch from 'node-fetch';
 import { getServiceURL } from '../config/store.js';
 import { theme } from '../ui/theme.js';
@@ -9,8 +10,7 @@ const getURL = () => getServiceURL('oracle') || 'https://acp.darksol.net/oracle'
 export async function oracleFlip() {
   const spin = spinner('Flipping coin...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/coin`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/coin`);
     spin.succeed('Coin flipped');
     showSection('ORACLE — COIN FLIP');
     kvDisplay([
@@ -26,8 +26,7 @@ export async function oracleFlip() {
 export async function oracleDice(sides = 6) {
   const spin = spinner(`Rolling d${sides}...`).start();
   try {
-    const resp = await fetch(`${getURL()}/api/dice?sides=${sides}`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/dice?sides=${sides}`);
     spin.succeed('Dice rolled');
     showSection(`ORACLE — D${sides}`);
     kvDisplay([
@@ -44,8 +43,7 @@ export async function oracleDice(sides = 6) {
 export async function oracleNumber(min = 1, max = 100) {
   const spin = spinner(`Generating number ${min}-${max}...`).start();
   try {
-    const resp = await fetch(`${getURL()}/api/number?min=${min}&max=${max}`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/number?min=${min}&max=${max}`);
     spin.succeed('Number generated');
     showSection('ORACLE — RANDOM NUMBER');
     kvDisplay([
@@ -62,12 +60,11 @@ export async function oracleNumber(min = 1, max = 100) {
 export async function oracleShuffle(items) {
   const spin = spinner('Shuffling...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/shuffle`, {
+    const data = await fetchJSON(`${getURL()}/api/shuffle`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({ items }),
     });
-    const data = await resp.json();
     spin.succeed('Shuffled');
     showSection('ORACLE — SHUFFLE');
     console.log(theme.gold('  Result: ') + (data.result || data.value || []).join(', '));
@@ -80,8 +77,7 @@ export async function oracleShuffle(items) {
 export async function oracleHealth() {
   const spin = spinner('Checking oracle...').start();
   try {
-    const resp = await fetch(`${getURL()}/api/health`);
-    const data = await resp.json();
+    const data = await fetchJSON(`${getURL()}/api/health`);
     spin.succeed('Oracle online');
     showSection('ORACLE STATUS');
     kvDisplay(Object.entries(data).map(([k, v]) => [k, String(v)]));

package/src/trading/swap.js

@@ -18,6 +18,12 @@ const ROUTERS = {
   arbitrum: {
     uniswapV3: '0xE592427A0AEce92De3Edee1F18E0157C05861564',
   },
+  optimism: {
+    uniswapV3: '0xE592427A0AEce92De3Edee1F18E0157C05861564',
+  },
+  polygon: {
+    uniswapV3: '0xE592427A0AEce92De3Edee1F18E0157C05861564',
+  },
 };
 
 // Common token addresses per chain
@@ -38,6 +44,26 @@ const TOKENS = {
     USDT: '0xdAC17F958D2ee523a2206206994597C13D831ec7',
     DAI: '0x6B175474E89094C44Da98b954EedeAC495271d0F',
   },
+  arbitrum: {
+    ETH: ethers.ZeroAddress,
+    WETH: '0x82aF49447D8a07e3bd95BD0d56f35241523fBab1',
+    USDC: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
+    USDT: '0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9',
+    ARB: '0x912CE59144191C1204E64559FE8253a0e49E6548',
+  },
+  optimism: {
+    ETH: ethers.ZeroAddress,
+    WETH: '0x4200000000000000000000000000000000000006',
+    USDC: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85',
+    OP: '0x4200000000000000000000000000000000000042',
+  },
+  polygon: {
+    ETH: ethers.ZeroAddress,
+    WETH: '0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619',
+    WMATIC: '0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270',
+    USDC: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359',
+    USDT: '0xc2132D05D31c914a87C6611C10748AEb04B58e8F',
+  },
 };
 
 // ERC20 ABI for approvals and balance checks
@@ -66,6 +92,8 @@ const QUOTERS = {
   base: '0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a',
   ethereum: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
   arbitrum: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+  optimism: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+  polygon: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
 };
 
 // Resolve token symbol to address

package/src/ui/banner.js

@@ -2,6 +2,9 @@ import figlet from 'figlet';
 import gradient from 'gradient-string';
 import chalk from 'chalk';
 import { theme } from './theme.js';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const { version } = require('../../package.json');
 
 const darksol_gradient = gradient(['#B8860B', '#FFD700', '#FFF8DC', '#FFD700', '#B8860B']);
 
@@ -11,6 +14,9 @@ export function showBanner(opts = {}) {
     horizontalLayout: 'fitted',
   });
 
+  const vStr = `v${version}`;
+  const pad = ' '.repeat(Math.max(0, 48 - vStr.length));
+
   console.log('');
   console.log(darksol_gradient(banner));
   console.log('');
@@ -26,8 +32,8 @@ export function showBanner(opts = {}) {
   );
   console.log(
     theme.dim('  ║ ') +
-    theme.subtle(' v0.4.0') +
-    theme.dim('                                                ') +
+    theme.subtle(` ${vStr}`) +
+    theme.dim(pad) +
     theme.gold('🌑') +
     theme.dim(' ║')
   );
@@ -44,7 +50,7 @@ export function showBanner(opts = {}) {
 
 export function showMiniBanner() {
   console.log('');
-  console.log(theme.gold.bold('  🌑 DARKSOL TERMINAL') + theme.dim(' v0.4.0'));
+  console.log(theme.gold.bold('  🌑 DARKSOL TERMINAL') + theme.dim(` v${version}`));
   console.log(theme.dim('  ─────────────────────────────'));
   console.log('');
 }
@@ -58,17 +64,3 @@ export function showSection(title) {
 export function showDivider() {
   console.log(theme.dim('  ' + '─'.repeat(50)));
 }
-
-
-
-
-
-
-
-
-
-
-
-
-
-

package/src/utils/fetch.js

@@ -0,0 +1,28 @@
+import fetch from 'node-fetch';
+
+/**
+ * Fetch JSON safely — handles HTML error pages, non-JSON responses,
+ * and invalid JSON gracefully instead of crashing with cryptic errors.
+ */
+export async function fetchJSON(url, options = {}) {
+  const resp = await fetch(url, options);
+  const contentType = resp.headers.get('content-type') || '';
+  const text = await resp.text();
+
+  if (!contentType.includes('application/json') && !contentType.includes('text/json')) {
+    const preview = text.substring(0, 60).replace(/\n/g, ' ');
+    throw new Error(
+      `Expected JSON but got ${contentType.split(';')[0] || 'unknown'} (HTTP ${resp.status}). ` +
+      `Response: "${preview}..."`
+    );
+  }
+
+  try {
+    return JSON.parse(text);
+  } catch {
+    const preview = text.substring(0, 60).replace(/\n/g, ' ');
+    throw new Error(`Invalid JSON (HTTP ${resp.status}): "${preview}..."`);
+  }
+}
+
+export default fetchJSON;