@darksol/terminal 0.4.2 → 0.4.4

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.2",
+  "version": "0.4.4",
   "description": "DARKSOL Terminal — unified CLI for all DARKSOL services. Market intel, trading, oracle, casino, and more.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -3,7 +3,7 @@ import { showBanner, showMiniBanner, showSection } from './ui/banner.js';
 import { theme } from './ui/theme.js';
 import { kvDisplay, success, error, warn, info } from './ui/components.js';
 import { getConfig, setConfig, getAllConfig, getRPC, setRPC, configPath } from './config/store.js';
-import { createWallet, importWallet, showWallets, getBalance, useWallet, exportWallet } from './wallet/manager.js';
+import { createWallet, importWallet, showWallets, getBalance, useWallet, exportWallet, sendFunds, receiveAddress } from './wallet/manager.js';
 import { showPortfolio } from './wallet/portfolio.js';
 import { showHistory } from './wallet/history.js';
 import { showGas } from './services/gas.js';
@@ -26,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();
@@ -33,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)
 ;
 
   // ═══════════════════════════════════════
@@ -70,6 +73,20 @@ export function cli(argv) {
     .description('Set active wallet')
     .action((name) => useWallet(name));
 
+  wallet
+    .command('send')
+    .description('Send ETH or tokens')
+    .option('--to <address>', 'Recipient address')
+    .option('-a, --amount <amount>', 'Amount to send')
+    .option('-t, --token <token>', 'Token (ETH, USDC, or 0x address)', 'ETH')
+    .option('-w, --wallet <name>', 'Wallet to send from')
+    .action((opts) => sendFunds(opts));
+
+  wallet
+    .command('receive [name]')
+    .description('Show your address for receiving funds')
+    .action((name) => receiveAddress(name));
+
   wallet
     .command('export [name]')
     .description('Export wallet details')
@@ -417,6 +434,25 @@ export function cli(argv) {
     .description('Multi-chain balance view (shortcut for: wallet portfolio)')
     .action((name) => showPortfolio(name));
 
+  // ═══════════════════════════════════════
+  // SEND SHORTCUT
+  // ═══════════════════════════════════════
+  program
+    .command('send')
+    .description('Send ETH or tokens (shortcut for: wallet send)')
+    .option('--to <address>', 'Recipient address')
+    .option('-a, --amount <amount>', 'Amount')
+    .option('-t, --token <token>', 'Token (ETH, USDC, or 0x address)', 'ETH')
+    .action((opts) => sendFunds(opts));
+
+  // ═══════════════════════════════════════
+  // RECEIVE SHORTCUT
+  // ═══════════════════════════════════════
+  program
+    .command('receive')
+    .description('Show your address for receiving (shortcut for: wallet receive)')
+    .action(() => receiveAddress());
+
   // ═══════════════════════════════════════
   // GAS COMMAND
   // ═══════════════════════════════════════
@@ -721,6 +757,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('');
@@ -960,6 +998,8 @@ function showCommandList() {
   showSection('COMMANDS');
   const commands = [
     ['wallet', 'Create, import, manage wallets'],
+    ['send', 'Send ETH or tokens'],
+    ['receive', 'Show address to receive funds'],
     ['portfolio', 'Multi-chain balance view'],
     ['price', 'Quick token price check'],
     ['watch', 'Live price monitoring + alerts'],

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.2') +
-    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.2'));
+  console.log(theme.gold.bold('  🌑 DARKSOL TERMINAL') + theme.dim(` v${version}`));
   console.log(theme.dim('  ─────────────────────────────'));
   console.log('');
 }
@@ -58,20 +64,3 @@ export function showSection(title) {
 export function showDivider() {
   console.log(theme.dim('  ' + '─'.repeat(50)));
 }
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

package/src/wallet/manager.js

@@ -248,6 +248,270 @@ export function useWallet(name) {
   success(`Active wallet set to "${name}"`);
 }
 
+// ═══════════════════════════════════════
+// SEND — ETH and ERC-20 transfers
+// ═══════════════════════════════════════
+
+const COMMON_TOKENS = {
+  base:     { USDC: { addr: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', decimals: 6 } },
+  ethereum: { USDC: { addr: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', decimals: 6 }, USDT: { addr: '0xdAC17F958D2ee523a2206206994597C13D831ec7', decimals: 6 } },
+  arbitrum: { USDC: { addr: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831', decimals: 6 } },
+  optimism: { USDC: { addr: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85', decimals: 6 } },
+  polygon:  { USDC: { addr: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359', decimals: 6 } },
+};
+
+const ERC20_SEND_ABI = [
+  'function transfer(address to, uint256 amount) returns (bool)',
+  'function balanceOf(address) view returns (uint256)',
+  'function decimals() view returns (uint8)',
+  'function symbol() view returns (string)',
+];
+
+export async function sendFunds(opts = {}) {
+  const name = opts.wallet || getConfig('activeWallet');
+  if (!name) {
+    error('No active wallet. Set one: darksol wallet use <name>');
+    return;
+  }
+
+  const chain = getConfig('chain') || 'base';
+  const walletData = loadWallet(name);
+
+  // Interactive prompt if flags not provided
+  let to = opts.to;
+  let amount = opts.amount;
+  let token = opts.token || 'ETH';
+
+  console.log('');
+  showSection(`SEND — ${name}`);
+  console.log(theme.dim(`  ${walletData.address}`));
+  console.log(theme.dim(`  Chain: ${chain}`));
+  console.log('');
+
+  if (!to) {
+    ({ to } = await inquirer.prompt([{
+      type: 'input',
+      name: 'to',
+      message: theme.gold('Recipient address (0x...):'),
+      validate: (v) => {
+        if (!v.startsWith('0x') || v.length !== 42) return 'Enter a valid 0x address (42 chars)';
+        return true;
+      },
+    }]));
+  }
+
+  if (!amount) {
+    // Show available tokens
+    const tokenChoices = ['ETH'];
+    const chainTokens = COMMON_TOKENS[chain] || {};
+    Object.keys(chainTokens).forEach(t => tokenChoices.push(t));
+    tokenChoices.push('Custom token (paste address)');
+
+    ({ token } = await inquirer.prompt([{
+      type: 'list',
+      name: 'token',
+      message: theme.gold('What to send?'),
+      choices: tokenChoices,
+    }]));
+
+    if (token === 'Custom token (paste address)') {
+      ({ token } = await inquirer.prompt([{
+        type: 'input',
+        name: 'token',
+        message: theme.gold('Token contract address (0x...):'),
+        validate: (v) => v.startsWith('0x') && v.length === 42 || 'Invalid address',
+      }]));
+    }
+
+    ({ amount } = await inquirer.prompt([{
+      type: 'input',
+      name: 'amount',
+      message: theme.gold(`Amount to send (${token}):`),
+      validate: (v) => parseFloat(v) > 0 || 'Enter a positive amount',
+    }]));
+  }
+
+  // Password
+  const { password } = await inquirer.prompt([{
+    type: 'password',
+    name: 'password',
+    message: theme.gold('Wallet password:'),
+    mask: '●',
+  }]);
+
+  const spin = spinner('Preparing transaction...').start();
+
+  try {
+    const { signer, provider, address } = await getSigner(name, password);
+
+    const isETH = token.toUpperCase() === 'ETH';
+    const isSymbol = !token.startsWith('0x');
+    let tokenAddr = null;
+    let tokenDecimals = 18;
+    let tokenSymbol = token.toUpperCase();
+
+    if (!isETH) {
+      // Resolve token
+      const chainTokens = COMMON_TOKENS[chain] || {};
+      if (isSymbol && chainTokens[token.toUpperCase()]) {
+        const info = chainTokens[token.toUpperCase()];
+        tokenAddr = info.addr;
+        tokenDecimals = info.decimals;
+        tokenSymbol = token.toUpperCase();
+      } else if (token.startsWith('0x')) {
+        tokenAddr = token;
+        const contract = new ethers.Contract(tokenAddr, ERC20_SEND_ABI, provider);
+        tokenDecimals = Number(await contract.decimals());
+        tokenSymbol = await contract.symbol();
+      } else {
+        spin.fail('Unknown token');
+        error(`Token "${token}" not recognized. Use a symbol (USDC) or contract address.`);
+        return;
+      }
+    }
+
+    // Check balance
+    let balanceStr;
+    if (isETH) {
+      const balance = await provider.getBalance(address);
+      const amountWei = ethers.parseEther(amount);
+      balanceStr = `${parseFloat(ethers.formatEther(balance)).toFixed(6)} ETH`;
+      if (balance < amountWei) {
+        spin.fail('Insufficient balance');
+        error(`Need ${amount} ETH, have ${balanceStr}`);
+        return;
+      }
+    } else {
+      const contract = new ethers.Contract(tokenAddr, ERC20_SEND_ABI, provider);
+      const balance = await contract.balanceOf(address);
+      const amountParsed = ethers.parseUnits(amount, tokenDecimals);
+      balanceStr = `${parseFloat(ethers.formatUnits(balance, tokenDecimals)).toFixed(tokenDecimals > 6 ? 6 : 2)} ${tokenSymbol}`;
+      if (balance < amountParsed) {
+        spin.fail('Insufficient balance');
+        error(`Need ${amount} ${tokenSymbol}, have ${balanceStr}`);
+        return;
+      }
+    }
+
+    // Estimate gas
+    let gasEstimate;
+    const feeData = await provider.getFeeData();
+    if (isETH) {
+      gasEstimate = 21000n;
+    } else {
+      const contract = new ethers.Contract(tokenAddr, ERC20_SEND_ABI, signer);
+      gasEstimate = await contract.transfer.estimateGas(to, ethers.parseUnits(amount, tokenDecimals));
+    }
+    const gasCostWei = gasEstimate * (feeData.gasPrice || 0n);
+    const gasCostEth = parseFloat(ethers.formatEther(gasCostWei));
+
+    spin.succeed('Transaction ready');
+
+    // Confirmation
+    console.log('');
+    showSection('SEND PREVIEW');
+    kvDisplay([
+      ['From', `${name} (${address.slice(0, 6)}...${address.slice(-4)})`],
+      ['To', to],
+      ['Amount', `${amount} ${tokenSymbol}`],
+      ['Balance', balanceStr],
+      ['Est. Gas', `${gasCostEth.toFixed(6)} ETH`],
+      ['Chain', chain],
+    ]);
+    console.log('');
+
+    const { confirm } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'confirm',
+      message: theme.accent('Send this transaction?'),
+      default: false,
+    }]);
+
+    if (!confirm) {
+      warn('Transaction cancelled');
+      return;
+    }
+
+    const txSpin = spinner('Sending...').start();
+
+    let tx;
+    if (isETH) {
+      tx = await signer.sendTransaction({
+        to,
+        value: ethers.parseEther(amount),
+      });
+    } else {
+      const contract = new ethers.Contract(tokenAddr, ERC20_SEND_ABI, signer);
+      tx = await contract.transfer(to, ethers.parseUnits(amount, tokenDecimals));
+    }
+
+    txSpin.text = 'Waiting for confirmation...';
+    const receipt = await tx.wait();
+
+    txSpin.succeed(theme.success('Transaction confirmed!'));
+
+    console.log('');
+    showSection('TRANSACTION RECEIPT');
+    kvDisplay([
+      ['TX Hash', receipt.hash],
+      ['Block', receipt.blockNumber.toString()],
+      ['Gas Used', receipt.gasUsed.toString()],
+      ['Status', receipt.status === 1 ? theme.success('✓ Success') : theme.error('✗ Failed')],
+    ]);
+    console.log('');
+
+  } catch (err) {
+    spin.fail('Send failed');
+    if (err.message.includes('incorrect password') || err.message.includes('bad decrypt')) {
+      error('Wrong password');
+    } else {
+      error(err.message);
+    }
+  }
+}
+
+// ═══════════════════════════════════════
+// RECEIVE — Show address + QR-friendly display
+// ═══════════════════════════════════════
+
+export async function receiveAddress(walletName) {
+  const name = walletName || getConfig('activeWallet');
+  if (!name) {
+    error('No active wallet. Set one: darksol wallet use <name>');
+    return;
+  }
+
+  const walletData = loadWallet(name);
+  const chain = getConfig('chain') || 'base';
+
+  console.log('');
+  showSection(`RECEIVE — ${name}`);
+  console.log('');
+  console.log(theme.gold('  Your address:'));
+  console.log('');
+  console.log(theme.gold.bold(`  ${walletData.address}`));
+  console.log('');
+
+  // Visual box around address for easy copy
+  const addr = walletData.address;
+  const boxWidth = addr.length + 4;
+  console.log(theme.dim(`  ┌${'─'.repeat(boxWidth)}┐`));
+  console.log(theme.dim(`  │  `) + theme.gold(addr) + theme.dim(`  │`));
+  console.log(theme.dim(`  └${'─'.repeat(boxWidth)}┘`));
+  console.log('');
+
+  console.log(theme.dim('  This address works on ALL EVM chains:'));
+  console.log(theme.dim('  Base • Ethereum • Arbitrum • Optimism • Polygon'));
+  console.log('');
+  console.log(theme.dim(`  Active chain: ${theme.gold(chain)}`));
+  console.log(theme.dim('  Make sure the sender is on the same chain!'));
+  console.log('');
+
+  warn('Double-check the address before sharing.');
+  warn('Only send EVM-compatible tokens to this address.');
+  console.log('');
+}
+
 // Export wallet (show address only, never PK without password)
 export async function exportWallet(name) {
   if (!name) {