@darksol/terminal 0.2.1 → 0.2.2

package/README.md

@@ -9,7 +9,11 @@
 
 **All DARKSOL services. One terminal. Zero trust required.**
 
-A unified CLI for market intel, trading, on-chain oracle, casino, prepaid cards, builder indexing, and more. Encrypted wallet management. Agent-native. OpenClaw-controllable.
+A unified CLI for market intel, trading, AI-powered analysis, on-chain oracle, casino, prepaid cards, builder indexing, secure agent signing, and more. Encrypted wallet management. Agent-native. OpenClaw-controllable.
+
+[![npm](https://img.shields.io/npm/v/@darksol/terminal)](https://www.npmjs.com/package/@darksol/terminal)
+[![License: MIT](https://img.shields.io/badge/License-MIT-gold.svg)](https://opensource.org/licenses/MIT)
+[![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-green.svg)](https://nodejs.org/)
 
 ## Install
 
@@ -29,81 +33,198 @@ darksol wallet create main
 # Check balance
 darksol wallet balance
 
-# Set chain
-darksol config set chain base
-
-# Add custom RPC
-darksol config rpc base https://your-rpc-endpoint.com
-
 # Swap tokens
 darksol trade swap -i ETH -o USDC -a 0.1
 
-# Snipe a token
-darksol trade snipe 0xTOKEN_ADDRESS -a 0.05
-
-# Create DCA order
-darksol dca create
-
-# Market data
-darksol market top
-darksol market token VIRTUAL
-darksol market compare ETH AERO VIRTUAL
-
-# Oracle
-darksol oracle flip
-darksol oracle dice 20
-
-# Casino
-darksol casino bet coin-flip heads
-darksol casino tables
-
-# Execution scripts (automated trading)
-darksol script templates          # See available templates
-darksol script create             # Create from template (interactive)
-darksol script list               # List your scripts
-darksol script run my-buy-script  # Execute (requires wallet password)
-darksol script show my-script     # View details + code
-darksol script edit my-script     # Edit params/wallet/chain
-darksol script clone my-script new-script
-darksol script delete old-script
-
-# Prepaid cards
-darksol cards catalog
-
-# Builder index
-darksol builders leaderboard
+# AI trading assistant
+darksol ai chat
 
-# Facilitator
-darksol facilitator health
+# Start agent signer for OpenClaw
+darksol agent start main
 ```
 
-## Wallet Security
-
-- Private keys are **never stored in plaintext**
-- AES-256-GCM encryption with scrypt key derivation
-- Password required for every transaction
-- Keys stored in `~/.darksol/wallets/` (encrypted JSON)
-- No recovery without password — back it up
-
 ## Modules
 
 | Module | Description | Pricing |
 |--------|-------------|---------|
-| `wallet` | Create, import, manage wallets | Free |
-| `trade` | Swap, snipe, token trading | Gas only |
+| `wallet` | Create, import, manage encrypted wallets | Free |
+| `trade` | Swap (Uniswap V3), snipe (V2), token trading | Gas only |
 | `dca` | Dollar-cost averaging engine | Gas only |
-| `script` | Execution scripts & strategies | Free |
-| `market` | Market intel, top movers, analysis | x402 micropayments |
+| `ai` | LLM-powered trading assistant & analysis | Provider dependent |
+| `agent` | Secure agent signer (PK-isolated proxy) | Free |
+| `keys` | API key vault (LLMs, data, RPCs) | Free |
+| `script` | Execution scripts & automated strategies | Free |
+| `skills` | Agent skill directory & installer | Free |
+| `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 |
-| `cards` | Crypto → prepaid Visa/MC | 3% markup |
+| `cards` | Crypto → prepaid Visa/MC (no KYC) | 3% markup |
 | `builders` | ERC-8021 builder leaderboard | Free |
-| `facilitator` | x402 payment verification | Free |
+| `facilitator` | x402 payment verification & settlement | Free |
 | `config` | Terminal configuration | Free |
 
-## Execution Scripts
+---
+
+## 🔐 Secure Agent Signer
+
+**The killer feature.** A PK-isolated signing proxy for AI agents (OpenClaw, etc.).
+
+```bash
+# Start the signing proxy
+darksol agent start my-wallet
+
+# With spending limits
+darksol agent start my-wallet --max-value 0.5 --daily-limit 2.0
+
+# With contract allowlist
+darksol agent start my-wallet --allowlist 0xContract1,0xContract2
+
+# View security documentation
+darksol agent docs
+```
+
+**Why it exists:** AI agents need to sign transactions, but exposing private keys to LLMs is dangerous — prompt injection could leak the key. Existing wallets (Bankr, Phantom MCP) can't do x402 payments or real contract signing.
+
+**How it works:**
+1. You unlock your wallet ONCE with your password
+2. The key decrypts into memory (never to disk/API)
+3. A local HTTP server at `127.0.0.1:18790` exposes signing endpoints
+4. AI agents call `/send`, `/sign` — never see the key
+5. Every TX is validated against your security policy
+
+**Endpoints:**
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/address` | GET | Wallet address (safe) |
+| `/balance` | GET | ETH balance (safe) |
+| `/chain` | GET | Active chain info |
+| `/send` | POST | Sign + broadcast transaction |
+| `/sign` | POST | Sign transaction (return raw) |
+| `/sign-message` | POST | Sign EIP-191 message |
+| `/sign-typed-data` | POST | Sign EIP-712 typed data (x402) |
+| `/policy` | GET | View spending policy |
+| `/audit` | GET | Operation audit log |
+| `/health` | GET | Health check |
+
+**Security guarantees:**
+- ✅ No `/private-key` endpoint exists — literally impossible to extract
+- ✅ Loopback-only (127.0.0.1) — not accessible from network
+- ✅ One-time bearer token auth (shown only in terminal)
+- ✅ Per-TX value limits + daily spending cap
+- ✅ Contract allowlist support
+- ✅ Dangerous selectors blocked (transferOwnership, selfdestruct)
+- ✅ Full audit log of all operations
+- ✅ Prompt injection proof — the LLM cannot access what doesn't exist in any API response
+
+---
+
+## 🧠 AI Trading Assistant
+
+Natural language trading powered by multi-provider LLM support.
+
+```bash
+# Interactive chat with live market data
+darksol ai chat
 
-Automated trading strategies with full PK access. Scripts unlock your wallet at runtime and execute on-chain transactions.
+# One-shot intent parsing
+darksol ai ask "buy 0.5 ETH worth of AERO on Base"
+
+# DCA strategy recommendation
+darksol ai strategy VIRTUAL --budget 500 --timeframe "30 days"
+
+# AI-powered token analysis
+darksol ai analyze AERO
+
+# Use specific provider
+darksol ai chat --provider ollama --model llama3
+```
+
+**Supported providers:** OpenAI, Anthropic, OpenRouter, Ollama (local = free)
+
+The AI gets live market context (prices from DexScreener), knows your config (chain, slippage, wallet), and returns structured intents with confidence scores and risk warnings.
+
+---
+
+## 🔑 API Key Vault
+
+Encrypted storage for all your API keys.
+
+```bash
+# List all services and status
+darksol keys list
+
+# Add keys (encrypted with AES-256-GCM)
+darksol keys add openai
+darksol keys add coingecko
+darksol keys add alchemy
+
+# Remove a key
+darksol keys remove openai
+```
+
+**Supported services:**
+| Category | Services |
+|----------|----------|
+| LLM | OpenAI, Anthropic, OpenRouter, Ollama |
+| Data | CoinGecko Pro, DexScreener, DefiLlama |
+| RPC | Alchemy, Infura, QuickNode |
+| Trading | 1inch, ParaSwap |
+
+Keys can also come from environment variables (e.g., `OPENAI_API_KEY`).
+
+---
+
+## 💰 Trading
+
+```bash
+# Swap via Uniswap V3
+darksol trade swap -i ETH -o USDC -a 0.1
+
+# Snipe a token (Uniswap V2, fast buy)
+darksol trade snipe 0xTOKEN -a 0.05
+
+# Snipe with gas boost
+darksol trade snipe 0xTOKEN -a 0.05 -g 2.0
+
+# Watch for new pairs
+darksol trade watch
+```
+
+## 📊 DCA Engine
+
+```bash
+darksol dca create     # Interactive order creation
+darksol dca list       # List active orders
+darksol dca run        # Execute pending orders
+darksol dca cancel <id>
+```
+
+## 📈 Market Intel
+
+```bash
+darksol market top                      # Top movers on Base
+darksol market top -c ethereum          # Top movers on Ethereum
+darksol market token VIRTUAL            # Full token detail
+darksol market compare ETH AERO VIRTUAL # Side-by-side comparison
+```
+
+---
+
+## ⚡ Execution Scripts
+
+Automated trading strategies with full wallet access.
+
+```bash
+darksol script templates    # Available templates
+darksol script create       # Create from template (interactive)
+darksol script list         # List scripts
+darksol script run my-buy   # Execute (password required)
+darksol script show my-buy  # View code + params
+darksol script edit my-buy  # Edit params
+darksol script clone my-buy new-buy
+darksol script delete old
+```
 
 ### Templates
 
@@ -117,171 +238,123 @@ Automated trading strategies with full PK access. Scripts unlock your wallet at
 | `transfer` | Transfer ETH or tokens to an address |
 | `empty` | Custom script — full ethers.js context |
 
-### Script Context
-
-Every script gets:
-```javascript
-module.exports = async function({ signer, provider, ethers, config, params }) {
-  // signer   — ethers.Wallet (unlocked, connected to provider)
-  // provider — ethers.JsonRpcProvider for active chain
-  // ethers   — the ethers library
-  // config   — { chain, slippage, gasMultiplier, rpcs }
-  // params   — your custom parameters
-};
-```
-
-### Automation (OpenClaw / cron)
+### Automation
 
 ```bash
-# Run without prompts (password via flag)
+# Non-interactive execution (for cron/OpenClaw)
 darksol script run my-dca --password "mypass" --yes
-
-# JSON output for programmatic use
-darksol config set output json
 ```
 
-## Configuration
+---
+
+## 🧩 Skills Directory
 
-Config stored at `~/.config/darksol-terminal/config.json`
+Install DARKSOL skills for OpenClaw agents.
 
 ```bash
-# View all settings
-darksol config show
+darksol skills list              # Browse available skills
+darksol skills install darksol-terminal  # Install to OpenClaw
+darksol skills info darksol-terminal     # Skill details
+darksol skills uninstall darksol-terminal
+```
 
-# Set active chain
-darksol config set chain base
+**Available skills:** darksol-terminal, darksol-facilitator, darksol-prepaid-cards, random-oracle, the-clawsino
 
-# Set slippage tolerance
-darksol config set slippage 1.0
+---
 
-# Custom RPC
-darksol config rpc base https://mainnet.base.org
-darksol config rpc ethereum https://eth.llamarpc.com
-darksol config rpc arbitrum https://arb1.arbitrum.io/rpc
-```
+## 🎲 Services
 
-## Supported Chains
+```bash
+# Oracle — on-chain randomness
+darksol oracle flip
+darksol oracle dice 20
+darksol oracle number 1 100
 
-- **Base** (default)
-- Ethereum
-- Polygon
-- Arbitrum
-- Optimism
+# Casino — on-chain betting
+darksol casino bet coin-flip heads
+darksol casino tables
+darksol casino stats
 
-## OpenClaw Integration
+# Prepaid Cards — crypto to Visa/MC
+darksol cards catalog
+darksol cards order -p swype -a 50
+darksol cards status <id>
 
-DARKSOL Terminal is designed to be controlled by AI agents via OpenClaw:
+# Builder Index — ERC-8021 rankings
+darksol builders leaderboard
+darksol builders lookup <code>
 
-```bash
-# Agents can run any command non-interactively
-darksol market top --output json
-darksol wallet balance main
-darksol oracle flip
+# Facilitator — x402 payments
+darksol facilitator health
+darksol facilitator verify <payment>
 ```
 
-JSON output mode for programmatic use:
+---
+
+## 🔒 Wallet Security
+
+- Private keys **never stored in plaintext**
+- AES-256-GCM encryption with scrypt key derivation (N=2^18)
+- Password required for every transaction
+- Keys stored in `~/.darksol/wallets/` (encrypted JSON)
+- No recovery without password — back it up
+
 ```bash
-darksol config set output json
+darksol wallet create <name>     # Create new (generates keypair)
+darksol wallet import <name>     # Import from private key
+darksol wallet list              # List all wallets
+darksol wallet balance [name]    # ETH + USDC balance
+darksol wallet use <name>        # Set active wallet
+darksol wallet export [name]     # Export (password required for PK)
 ```
 
-## Helper Functions
-
-When writing custom execution scripts, you have access to powerful helper utilities:
-
-```javascript
-import {
-  // Providers & Chain
-  getProvider,           // Get ethers provider for any chain
-  CHAIN_IDS,             // { base: 8453, ethereum: 1, ... }
-  EXPLORERS,             // Block explorer URLs per chain
-  txUrl, addressUrl,     // Generate explorer links
-
-  // Tokens
-  getERC20,              // Get ERC20 contract instance
-  getFullTokenInfo,      // Name, symbol, decimals, totalSupply
-  getTokenBalance,       // Formatted balance for any token
-  ensureApproval,        // Check & approve token spending
-  TOKENS,                // All known token addresses per chain
-  getUSDC, getWETH,      // Quick chain-specific lookups
-
-  // Gas
-  estimateGasCost,       // Estimate gas in ETH
-  getBoostedGas,         // Priority gas settings for snipes
-
-  // Formatting
-  formatCompact,         // 1234567 → "1.23M"
-  formatUSD,             // Format as $1,234.56
-  formatETH,             // Format wei to ETH string
-  formatTokenAmount,     // Format with symbol
-  shortAddress,          // 0x1234...5678
-  formatDuration,        // Seconds → "2h 30m"
-
-  // Validation
-  isValidAddress,        // Check Ethereum address
-  isValidPrivateKey,     // Check private key format
-  isValidAmount,         // Check positive number
-  parseTokenAmount,      // String → bigint with decimals
-
-  // Async
-  sleep,                 // await sleep(1000)
-  retry,                 // Retry with exponential backoff
-  waitForTx,             // Wait for tx with timeout
-
-  // Price
-  quickPrice,            // DexScreener price lookup
-  hasLiquidity,          // Check minimum liquidity
-} from './utils/helpers.js';
-```
+---
 
-### Example: Custom Script Using Helpers
+## ⚙️ Configuration
 
-```javascript
-module.exports = async function({ signer, provider, ethers, config, params }) {
-  // Import helpers (available in script context)
-  const helpers = await import('@darksol/terminal/src/utils/helpers.js');
+```bash
+darksol config show              # View all settings
+darksol config set chain base    # Set active chain
+darksol config set slippage 1.0  # Slippage tolerance (%)
+darksol config rpc base https://your-rpc.com
+```
 
-  // Check if token has enough liquidity
-  const liquid = await helpers.hasLiquidity(params.token, 5000);
-  if (!liquid) throw new Error('Insufficient liquidity');
+### Supported Chains
 
-  // Get price
-  const price = await helpers.quickPrice(params.token);
-  console.log(`Price: ${helpers.formatUSD(price.price)}`);
+| Chain | ID | Default RPC |
+|-------|---:|-------------|
+| Base | 8453 | mainnet.base.org |
+| Ethereum | 1 | eth.llamarpc.com |
+| Polygon | 137 | polygon-rpc.com |
+| Arbitrum | 42161 | arb1.arbitrum.io/rpc |
+| Optimism | 10 | mainnet.optimism.io |
 
-  // Get boosted gas for priority
-  const gas = await helpers.getBoostedGas(provider, 1.5);
+---
 
-  // Execute trade with retry
-  const result = await helpers.retry(async () => {
-    const tx = await signer.sendTransaction({ ...txParams, ...gas });
-    return helpers.waitForTx(tx, 60000);
-  }, 3, 2000);
+## 📚 Reference
 
-  return { txHash: result.hash, price: price.price };
-};
+```bash
+darksol tips              # Trading + scripting tips
+darksol tips --trading    # Trading tips only
+darksol networks          # Chain reference table
+darksol quickstart        # Getting started guide
+darksol lookup 0x...      # Look up any address
 ```
 
-## Tips & Reference
-
-```bash
-# Trading tips (slippage, MEV protection, etc.)
-darksol tips --trading
+---
 
-# Script writing tips
-darksol tips --scripts
+## 🤖 OpenClaw Integration
 
-# Both
-darksol tips
+DARKSOL Terminal is agent-native:
 
-# Network reference (chains, IDs, explorers, USDC addresses)
-darksol networks
+1. **Install the skill:** `darksol skills install darksol-terminal`
+2. **Start the agent signer:** `darksol agent start my-wallet`
+3. **Run commands non-interactively** with flags (`-p`, `-y`, `--key`)
+4. **JSON output:** `darksol config set output json`
 
-# Getting started guide
-darksol quickstart
+All commands work without prompts when flags are provided.
 
-# Look up any address (auto-detects token vs wallet)
-darksol lookup 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
-```
+---
 
 ## Development
 
@@ -289,6 +362,7 @@ darksol lookup 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
 git clone https://gitlab.com/darks0l/darksol-terminal
 cd darksol-terminal
 npm install
+npm test           # Run test suite (node:test)
 node bin/darksol.js
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@darksol/terminal",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "DARKSOL Terminal — unified CLI for all DARKSOL services. Market intel, trading, oracle, casino, and more.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -16,7 +16,7 @@ import { buildersLeaderboard, buildersLookup, buildersFeed } from './services/bu
 import { createScript, listScripts, runScript, showScript, editScript, deleteScript, cloneScript, listTemplates } from './scripts/engine.js';
 import { showTradingTips, showScriptTips, showNetworkReference, showQuickStart, showWalletSummary, showTokenInfo, showTxResult } from './utils/helpers.js';
 import { addKey, removeKey, listKeys } from './config/keys.js';
-import { parseIntent, startChat, adviseStrategy, analyzeToken } from './llm/intent.js';
+import { parseIntent, startChat, adviseStrategy, analyzeToken, executeIntent } from './llm/intent.js';
 import { startAgentSigner, showAgentDocs } from './wallet/agent-signer.js';
 import { listSkills, installSkill, skillInfo, uninstallSkill } from './services/skills.js';
 
@@ -328,6 +328,21 @@ export function cli(argv) {
       }
     });
 
+  ai
+    .command('execute <prompt...>')
+    .description('Parse intent AND execute the trade')
+    .option('-p, --provider <name>', 'LLM provider')
+    .option('-m, --model <model>', 'Model name')
+    .option('--password <pw>', 'Wallet password (for non-interactive)')
+    .option('-y, --yes', 'Skip confirmation')
+    .action(async (promptParts, opts) => {
+      const prompt = promptParts.join(' ');
+      const intent = await parseIntent(prompt, opts);
+      if (intent.action !== 'error' && intent.action !== 'unknown') {
+        await executeIntent(intent, { password: opts.password, yes: opts.yes });
+      }
+    });
+
   ai
     .command('strategy <token>')
     .description('Get DCA strategy recommendation')

package/src/llm/intent.js

@@ -307,4 +307,130 @@ Provide: sentiment, liquidity assessment, risk level (1-10), key considerations.
   }
 }
 
+// ──────────────────────────────────────────────────
+// INTENT EXECUTOR — Wire AI intents into real trades
+// ──────────────────────────────────────────────────
+
+/**
+ * Execute a parsed intent (from parseIntent or ai ask)
+ * Bridges natural language → actual swap/snipe/dca/transfer
+ *
+ * @param {object} intent - Parsed intent object from parseIntent
+ * @param {object} opts - { password, confirm, yes }
+ * @returns {Promise<object>} Execution result
+ */
+export async function executeIntent(intent, opts = {}) {
+  if (!intent || intent.action === 'unknown' || intent.action === 'error') {
+    error('Cannot execute: intent not recognized');
+    return { success: false, reason: 'unknown intent' };
+  }
+
+  if (intent.confidence !== undefined && intent.confidence < 0.6) {
+    warn(`Low confidence (${(intent.confidence * 100).toFixed(0)}%) — review the intent before executing`);
+    if (!opts.yes) {
+      const inquirer = (await import('inquirer')).default;
+      const { proceed } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'proceed',
+        message: theme.accent('Execute anyway?'),
+        default: false,
+      }]);
+      if (!proceed) return { success: false, reason: 'user cancelled' };
+    }
+  }
+
+  // Show intent summary for confirmation
+  if (!opts.yes) {
+    showSection('EXECUTE INTENT');
+    kvDisplay([
+      ['Action', intent.action],
+      ['Token In', intent.tokenIn || '-'],
+      ['Token Out', intent.tokenOut || '-'],
+      ['Amount', intent.amount || '-'],
+      ['Chain', intent.chain || getConfig('chain') || 'base'],
+      ['Confidence', intent.confidence ? `${(intent.confidence * 100).toFixed(0)}%` : '-'],
+    ]);
+
+    if (intent.warnings?.length > 0) {
+      console.log('');
+      intent.warnings.forEach(w => warn(w));
+    }
+
+    console.log('');
+    const inquirer = (await import('inquirer')).default;
+    const { confirm } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'confirm',
+      message: theme.gold('Execute this trade?'),
+      default: false,
+    }]);
+    if (!confirm) return { success: false, reason: 'user cancelled' };
+  }
+
+  try {
+    switch (intent.action) {
+      case 'swap': {
+        const { executeSwap } = await import('../trading/swap.js');
+        return await executeSwap({
+          tokenIn: intent.tokenIn,
+          tokenOut: intent.tokenOut,
+          amount: intent.amount,
+          chain: intent.chain,
+          password: opts.password,
+        });
+      }
+
+      case 'snipe': {
+        const { executeSnipe } = await import('../trading/snipe.js');
+        return await executeSnipe({
+          token: intent.tokenOut || intent.tokenIn,
+          amount: intent.amount,
+          chain: intent.chain,
+          gasMultiplier: intent.gasMultiplier,
+          password: opts.password,
+        });
+      }
+
+      case 'dca': {
+        const { createDCAOrder } = await import('../trading/dca.js');
+        return await createDCAOrder({
+          token: intent.tokenOut || intent.tokenIn,
+          amount: intent.amount,
+          interval: intent.interval || '1h',
+          orders: intent.orders || 10,
+          chain: intent.chain,
+        });
+      }
+
+      case 'transfer': {
+        // Transfer intent — use execution script engine
+        info(`Transfer intent detected. Use: darksol script create (template: transfer)`);
+        info(`To: ${intent.to || 'specify address'}, Amount: ${intent.amount || 'specify amount'}`);
+        return { success: true, action: 'transfer', note: 'Use script system for transfers' };
+      }
+
+      case 'info':
+      case 'analyze': {
+        const token = intent.tokenOut || intent.tokenIn || intent.token;
+        if (token) {
+          await analyzeToken(token, opts);
+          return { success: true, action: 'analyze' };
+        }
+        info('No token specified for analysis');
+        return { success: false, reason: 'no token specified' };
+      }
+
+      default:
+        warn(`Action "${intent.action}" not yet wired for execution`);
+        if (intent.command) {
+          info(`Suggested command: ${theme.gold(intent.command)}`);
+        }
+        return { success: false, reason: `unhandled action: ${intent.action}` };
+    }
+  } catch (err) {
+    error(`Execution failed: ${err.message}`);
+    return { success: false, error: err.message };
+  }
+}
+
 export { INTENT_SYSTEM_PROMPT };

package/src/ui/banner.js

@@ -26,7 +26,7 @@ export function showBanner(opts = {}) {
   );
   console.log(
     theme.dim('  ║ ') +
-    theme.subtle(' v0.2.1') +
+    theme.subtle(' v0.2.2') +
     theme.dim('                                                ') +
     theme.gold('🌑') +
     theme.dim(' ║')
@@ -44,7 +44,7 @@ export function showBanner(opts = {}) {
 
 export function showMiniBanner() {
   console.log('');
-  console.log(theme.gold.bold('  🌑 DARKSOL TERMINAL') + theme.dim(' v0.2.1'));
+  console.log(theme.gold.bold('  🌑 DARKSOL TERMINAL') + theme.dim(' v0.2.2'));
   console.log(theme.dim('  ─────────────────────────────'));
   console.log('');
 }
@@ -61,3 +61,4 @@ export function showDivider() {
 
 
 
+

package/tests/cli.test.js

@@ -1,72 +0,0 @@
-import test, { before, after } from 'node:test';
-import assert from 'node:assert/strict';
-import { spawnSync } from 'node:child_process';
-import { mkdtempSync, mkdirSync, rmSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-
-function runCli(args, env) {
-  return spawnSync(process.execPath, ['bin/darksol.js', ...args], {
-    cwd: process.cwd(),
-    encoding: 'utf8',
-    env,
-  });
-}
-
-let tempRoot;
-let env;
-
-before(() => {
-  tempRoot = mkdtempSync(join(tmpdir(), 'darksol-cli-'));
-  const home = join(tempRoot, 'home');
-  const appData = join(tempRoot, 'appdata');
-  const localAppData = join(tempRoot, 'localappdata');
-  mkdirSync(home, { recursive: true });
-  mkdirSync(appData, { recursive: true });
-  mkdirSync(localAppData, { recursive: true });
-
-  env = {
-    ...process.env,
-    HOME: home,
-    USERPROFILE: home,
-    APPDATA: appData,
-    LOCALAPPDATA: localAppData,
-    FORCE_COLOR: '0',
-  };
-});
-
-after(() => {
-  rmSync(tempRoot, { recursive: true, force: true });
-});
-
-test('CLI help output renders', (t) => {
-  const res = runCli(['--help'], env);
-  if (res.error && res.error.code === 'EPERM') {
-    t.skip('Child process spawn not permitted in this environment');
-    return;
-  }
-  assert.equal(res.status, 0, res.stderr);
-  assert.match(res.stdout, /Usage:/);
-  assert.match(res.stdout, /\bwallet\b/);
-  assert.match(res.stdout, /\btrade\b/);
-  assert.match(res.stdout, /\bscript\b/);
-  assert.match(res.stdout, /\bconfig\b/);
-});
-
-test('command registration includes trade and script subcommands', (t) => {
-  const tradeHelp = runCli(['trade', '--help'], env);
-  if (tradeHelp.error && tradeHelp.error.code === 'EPERM') {
-    t.skip('Child process spawn not permitted in this environment');
-    return;
-  }
-  assert.equal(tradeHelp.status, 0, tradeHelp.stderr);
-  assert.match(tradeHelp.stdout, /\bswap\b/);
-  assert.match(tradeHelp.stdout, /\bsnipe\b/);
-  assert.match(tradeHelp.stdout, /\bwatch\b/);
-
-  const scriptHelp = runCli(['script', '--help'], env);
-  assert.equal(scriptHelp.status, 0, scriptHelp.stderr);
-  assert.match(scriptHelp.stdout, /\bcreate\b/);
-  assert.match(scriptHelp.stdout, /\brun\b/);
-  assert.match(scriptHelp.stdout, /\btemplates\b/);
-});

package/tests/config.test.js

@@ -1,75 +0,0 @@
-import test, { before, after } from 'node:test';
-import assert from 'node:assert/strict';
-import { mkdtempSync, mkdirSync, rmSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-
-function importFresh(relativePath) {
-  const url = new URL(`${relativePath}?t=${Date.now()}-${Math.random()}`, import.meta.url);
-  return import(url);
-}
-
-function setTempEnv(tempRoot) {
-  const home = join(tempRoot, 'home');
-  const appData = join(tempRoot, 'appdata');
-  const localAppData = join(tempRoot, 'localappdata');
-  mkdirSync(home, { recursive: true });
-  mkdirSync(appData, { recursive: true });
-  mkdirSync(localAppData, { recursive: true });
-
-  const prev = {
-    HOME: process.env.HOME,
-    USERPROFILE: process.env.USERPROFILE,
-    APPDATA: process.env.APPDATA,
-    LOCALAPPDATA: process.env.LOCALAPPDATA,
-  };
-
-  process.env.HOME = home;
-  process.env.USERPROFILE = home;
-  process.env.APPDATA = appData;
-  process.env.LOCALAPPDATA = localAppData;
-
-  return prev;
-}
-
-function restoreEnv(prev) {
-  for (const key of Object.keys(prev)) {
-    if (prev[key] === undefined) delete process.env[key];
-    else process.env[key] = prev[key];
-  }
-}
-
-let tempRoot;
-let prevEnv;
-let store;
-
-before(async () => {
-  tempRoot = mkdtempSync(join(tmpdir(), 'darksol-config-'));
-  prevEnv = setTempEnv(tempRoot);
-  store = await importFresh('../src/config/store.js');
-});
-
-after(() => {
-  restoreEnv(prevEnv);
-  rmSync(tempRoot, { recursive: true, force: true });
-});
-
-test('get/set config values', () => {
-  assert.equal(store.getConfig('chain'), 'base');
-  store.setConfig('chain', 'ethereum');
-  assert.equal(store.getConfig('chain'), 'ethereum');
-  const all = store.getAllConfig();
-  assert.equal(all.chain, 'ethereum');
-});
-
-test('RPC management works for getRPC/setRPC', () => {
-  const defaultBaseRpc = store.getRPC('base');
-  assert.ok(typeof defaultBaseRpc === 'string' && defaultBaseRpc.startsWith('http'));
-
-  const custom = 'https://rpc.example.invalid';
-  store.setRPC('base', custom);
-  assert.equal(store.getRPC('base'), custom);
-
-  store.setConfig('chain', 'base');
-  assert.equal(store.getRPC(), custom);
-});

package/tests/dca.test.js

@@ -1,141 +0,0 @@
-import test, { before, after } from 'node:test';
-import assert from 'node:assert/strict';
-import { mkdtempSync, mkdirSync, rmSync, readFileSync, writeFileSync, existsSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import inquirer from 'inquirer';
-
-function importFresh(relativePath) {
-  const url = new URL(`${relativePath}?t=${Date.now()}-${Math.random()}`, import.meta.url);
-  return import(url);
-}
-
-function setTempEnv(tempRoot) {
-  const home = join(tempRoot, 'home');
-  const appData = join(tempRoot, 'appdata');
-  const localAppData = join(tempRoot, 'localappdata');
-  mkdirSync(home, { recursive: true });
-  mkdirSync(appData, { recursive: true });
-  mkdirSync(localAppData, { recursive: true });
-
-  const prev = {
-    HOME: process.env.HOME,
-    USERPROFILE: process.env.USERPROFILE,
-    APPDATA: process.env.APPDATA,
-    LOCALAPPDATA: process.env.LOCALAPPDATA,
-  };
-
-  process.env.HOME = home;
-  process.env.USERPROFILE = home;
-  process.env.APPDATA = appData;
-  process.env.LOCALAPPDATA = localAppData;
-
-  return { prev, home };
-}
-
-function restoreEnv(prev) {
-  for (const key of Object.keys(prev)) {
-    if (prev[key] === undefined) delete process.env[key];
-    else process.env[key] = prev[key];
-  }
-}
-
-async function withPromptQueue(queue, fn) {
-  const original = inquirer.prompt;
-  let idx = 0;
-  inquirer.prompt = async () => {
-    if (idx >= queue.length) {
-      throw new Error('Prompt queue exhausted');
-    }
-    return queue[idx++];
-  };
-  try {
-    await fn();
-  } finally {
-    inquirer.prompt = original;
-  }
-}
-
-let tempRoot;
-let prevEnv;
-let tempHome;
-let dca;
-let store;
-
-before(async () => {
-  tempRoot = mkdtempSync(join(tmpdir(), 'darksol-dca-'));
-  const env = setTempEnv(tempRoot);
-  prevEnv = env.prev;
-  tempHome = env.home;
-  store = await importFresh('../src/config/store.js');
-  dca = await importFresh('../src/trading/dca.js');
-  store.setConfig('chain', 'base');
-});
-
-after(() => {
-  restoreEnv(prevEnv);
-  rmSync(tempRoot, { recursive: true, force: true });
-});
-
-test('DCA create/cancel/run CRUD in temp directory', async () => {
-  await withPromptQueue(
-    [
-      {
-        tokenIn: 'ETH',
-        tokenOut: 'USDC',
-        amountPerOrder: '0.1',
-        interval: 3600,
-        totalOrders: '2',
-      },
-      { confirm: true },
-    ],
-    async () => {
-      await dca.createDCA();
-    },
-  );
-
-  const candidates = [
-    join(tempHome, '.darksol', 'dca', 'orders.json'),
-    join(process.env.HOME || '', '.darksol', 'dca', 'orders.json'),
-    join(process.env.USERPROFILE || '', '.darksol', 'dca', 'orders.json'),
-  ];
-  const ordersPath = candidates.find((p) => p && existsSync(p));
-  assert.ok(ordersPath, 'orders.json should exist');
-  let orders = JSON.parse(readFileSync(ordersPath, 'utf8'));
-  assert.equal(orders.length, 1);
-  assert.equal(orders[0].status, 'active');
-
-  await dca.cancelDCA(orders[0].id);
-  orders = JSON.parse(readFileSync(ordersPath, 'utf8'));
-  assert.equal(orders[0].status, 'cancelled');
-
-  await withPromptQueue(
-    [
-      {
-        tokenIn: 'ETH',
-        tokenOut: 'USDC',
-        amountPerOrder: '0.2',
-        interval: 3600,
-        totalOrders: '1',
-      },
-      { confirm: true },
-    ],
-    async () => {
-      await dca.createDCA();
-    },
-  );
-
-  orders = JSON.parse(readFileSync(ordersPath, 'utf8'));
-  const active = orders.find((o) => o.status === 'active');
-  assert.ok(active);
-  active.nextExecution = new Date(Date.now() - 1000).toISOString();
-  writeFileSync(ordersPath, JSON.stringify(orders, null, 2));
-
-  await dca.runDCA({ password: 'unused-in-simulated-run' });
-  orders = JSON.parse(readFileSync(ordersPath, 'utf8'));
-  const ran = orders.find((o) => o.id === active.id);
-  assert.equal(ran.executedOrders, 1);
-  assert.equal(ran.status, 'completed');
-  assert.equal(ran.history.length, 1);
-  assert.equal(ran.history[0].status, 'simulated');
-});

package/tests/keystore.test.js

@@ -1,94 +0,0 @@
-import test, { before, after } from 'node:test';
-import assert from 'node:assert/strict';
-import { mkdtempSync, mkdirSync, rmSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-
-function importFresh(relativePath) {
-  const url = new URL(`${relativePath}?t=${Date.now()}-${Math.random()}`, import.meta.url);
-  return import(url);
-}
-
-function setTempEnv(tempRoot) {
-  const home = join(tempRoot, 'home');
-  const appData = join(tempRoot, 'appdata');
-  const localAppData = join(tempRoot, 'localappdata');
-  mkdirSync(home, { recursive: true });
-  mkdirSync(appData, { recursive: true });
-  mkdirSync(localAppData, { recursive: true });
-
-  const prev = {
-    HOME: process.env.HOME,
-    USERPROFILE: process.env.USERPROFILE,
-    APPDATA: process.env.APPDATA,
-    LOCALAPPDATA: process.env.LOCALAPPDATA,
-  };
-
-  process.env.HOME = home;
-  process.env.USERPROFILE = home;
-  process.env.APPDATA = appData;
-  process.env.LOCALAPPDATA = localAppData;
-
-  return { prev, home };
-}
-
-function restoreEnv(prev) {
-  for (const key of Object.keys(prev)) {
-    if (prev[key] === undefined) delete process.env[key];
-    else process.env[key] = prev[key];
-  }
-}
-
-let tempRoot;
-let prevEnv;
-let keystore;
-
-before(async () => {
-  tempRoot = mkdtempSync(join(tmpdir(), 'darksol-keystore-'));
-  const env = setTempEnv(tempRoot);
-  prevEnv = env.prev;
-  keystore = await importFresh('../src/wallet/keystore.js');
-});
-
-after(() => {
-  restoreEnv(prevEnv);
-  rmSync(tempRoot, { recursive: true, force: true });
-});
-
-test('encrypt/decrypt roundtrip', () => {
-  const privateKey = '0x' + '11'.repeat(32);
-  const password = 'strong-password-123';
-  const encrypted = keystore.encryptKey(privateKey, password);
-  const decrypted = keystore.decryptKey(encrypted, password);
-  assert.equal(decrypted, privateKey);
-});
-
-test('decrypt with wrong password throws', () => {
-  const encrypted = keystore.encryptKey('0x' + '22'.repeat(32), 'correct-password');
-  assert.throws(() => keystore.decryptKey(encrypted, 'wrong-password'));
-});
-
-test('wallet CRUD in temp home directory', () => {
-  const name = 'alice';
-  const address = '0x1234567890abcdef1234567890abcdef12345678';
-  const encrypted = keystore.encryptKey('0x' + '33'.repeat(32), 'wallet-pass');
-
-  const walletFile = keystore.saveWallet(name, address, encrypted, { chain: 'base' });
-  assert.ok(walletFile.startsWith(keystore.WALLET_DIR));
-  assert.equal(keystore.walletExists(name), true);
-
-  const loaded = keystore.loadWallet(name);
-  assert.equal(loaded.name, name);
-  assert.equal(loaded.address, address);
-  assert.equal(loaded.chain, 'base');
-  assert.ok(loaded.createdAt);
-
-  const wallets = keystore.listWallets();
-  assert.equal(wallets.length, 1);
-  assert.equal(wallets[0].name, name);
-  assert.equal(wallets[0].address, address);
-
-  keystore.deleteWallet(name);
-  assert.equal(keystore.walletExists(name), false);
-  assert.throws(() => keystore.loadWallet(name), /not found/i);
-});

package/tests/scripts.test.js

@@ -1,136 +0,0 @@
-import test, { before, after } from 'node:test';
-import assert from 'node:assert/strict';
-import { mkdtempSync, mkdirSync, rmSync, readFileSync, existsSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import inquirer from 'inquirer';
-
-function importFresh(relativePath) {
-  const url = new URL(`${relativePath}?t=${Date.now()}-${Math.random()}`, import.meta.url);
-  return import(url);
-}
-
-function setTempEnv(tempRoot) {
-  const home = join(tempRoot, 'home');
-  const appData = join(tempRoot, 'appdata');
-  const localAppData = join(tempRoot, 'localappdata');
-  mkdirSync(home, { recursive: true });
-  mkdirSync(appData, { recursive: true });
-  mkdirSync(localAppData, { recursive: true });
-
-  const prev = {
-    HOME: process.env.HOME,
-    USERPROFILE: process.env.USERPROFILE,
-    APPDATA: process.env.APPDATA,
-    LOCALAPPDATA: process.env.LOCALAPPDATA,
-  };
-
-  process.env.HOME = home;
-  process.env.USERPROFILE = home;
-  process.env.APPDATA = appData;
-  process.env.LOCALAPPDATA = localAppData;
-
-  return { prev, home };
-}
-
-function restoreEnv(prev) {
-  for (const key of Object.keys(prev)) {
-    if (prev[key] === undefined) delete process.env[key];
-    else process.env[key] = prev[key];
-  }
-}
-
-async function withPromptQueue(queue, fn) {
-  const original = inquirer.prompt;
-  let idx = 0;
-  inquirer.prompt = async () => {
-    if (idx >= queue.length) {
-      throw new Error('Prompt queue exhausted');
-    }
-    return queue[idx++];
-  };
-  try {
-    await fn();
-  } finally {
-    inquirer.prompt = original;
-  }
-}
-
-let tempRoot;
-let prevEnv;
-let tempHome;
-let engine;
-let store;
-
-before(async () => {
-  tempRoot = mkdtempSync(join(tmpdir(), 'darksol-scripts-'));
-  const env = setTempEnv(tempRoot);
-  prevEnv = env.prev;
-  tempHome = env.home;
-  store = await importFresh('../src/config/store.js');
-  engine = await importFresh('../src/scripts/engine.js');
-  store.setConfig('activeWallet', 'test-wallet');
-  store.setConfig('chain', 'base');
-});
-
-after(() => {
-  restoreEnv(prevEnv);
-  rmSync(tempRoot, { recursive: true, force: true });
-});
-
-test('script templates have expected structure', () => {
-  for (const [key, tmpl] of Object.entries(engine.TEMPLATES)) {
-    assert.ok(key.length > 0);
-    assert.equal(typeof tmpl.name, 'string');
-    assert.equal(typeof tmpl.description, 'string');
-    assert.ok(Array.isArray(tmpl.params));
-    assert.equal(typeof tmpl.template, 'string');
-    assert.match(tmpl.template, /module\.exports\s*=\s*async function/);
-  }
-});
-
-test('script CRUD works in temp directory', async () => {
-  await withPromptQueue(
-    [
-      { templateKey: 'empty' },
-      { scriptName: 'alpha' },
-      { walletName: 'test-wallet' },
-    ],
-    async () => {
-      await engine.createScript();
-    },
-  );
-
-  const scriptsDir = join(tempHome, '.darksol', 'scripts');
-  const alphaPath = join(scriptsDir, 'alpha.json');
-  assert.equal(existsSync(alphaPath), true);
-
-  const alpha = JSON.parse(readFileSync(alphaPath, 'utf8'));
-  assert.equal(alpha.name, 'alpha');
-  assert.equal(alpha.template, 'empty');
-  assert.equal(alpha.wallet, 'test-wallet');
-  assert.equal(alpha.chain, 'base');
-  assert.deepEqual(alpha.params, {});
-
-  await engine.cloneScript('alpha', 'beta');
-  const betaPath = join(scriptsDir, 'beta.json');
-  assert.equal(existsSync(betaPath), true);
-
-  await withPromptQueue(
-    [
-      { what: 'description' },
-      { desc: 'updated description' },
-    ],
-    async () => {
-      await engine.editScript('alpha');
-    },
-  );
-
-  const edited = JSON.parse(readFileSync(alphaPath, 'utf8'));
-  assert.equal(edited.description, 'updated description');
-
-  await withPromptQueue([{ confirm: true }], async () => {
-    await engine.deleteScript('beta');
-  });
-  assert.equal(existsSync(betaPath), false);
-});

package/tests/trading.test.js

@@ -1,21 +0,0 @@
-import test from 'node:test';
-import assert from 'node:assert/strict';
-import { ethers } from 'ethers';
-import { resolveToken } from '../src/trading/swap.js';
-
-test('resolveToken resolves known symbols', () => {
-  assert.equal(resolveToken('ETH', 'base'), ethers.ZeroAddress);
-  assert.equal(resolveToken('usdc', 'base'), '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913');
-  assert.equal(resolveToken('WETH', 'ethereum'), '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2');
-});
-
-test('resolveToken accepts direct token addresses', () => {
-  const address = '0x1234567890abcdef1234567890abcdef12345678';
-  assert.equal(resolveToken(address, 'base'), address);
-});
-
-test('resolveToken handles unknown symbols and chain fallback', () => {
-  assert.equal(resolveToken('NOT_A_TOKEN', 'base'), null);
-  assert.equal(resolveToken('USDC', 'unknown-chain'), '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913');
-  assert.equal(resolveToken('0xabc', 'base'), null);
-});

package/tests/ui.test.js

@@ -1,27 +0,0 @@
-import test from 'node:test';
-import assert from 'node:assert/strict';
-import { formatPrice, formatChange, formatAddress } from '../src/ui/components.js';
-
-function stripAnsi(value) {
-  return String(value).replace(/\x1B\[[0-9;]*m/g, '');
-}
-
-test('formatPrice formats values and handles invalid inputs', () => {
-  assert.equal(formatPrice(12.3456), '$12.35');
-  assert.equal(formatPrice(0.001234), '$0.001234');
-  assert.equal(stripAnsi(formatPrice('invalid')), 'N/A');
-});
-
-test('formatChange formats positive/negative/zero values', () => {
-  assert.equal(stripAnsi(formatChange(2.3456)), '+2.35%');
-  assert.equal(stripAnsi(formatChange(-2.3456)), '-2.35%');
-  assert.equal(stripAnsi(formatChange(0)), '+0.00%');
-  assert.equal(stripAnsi(formatChange('x')), 'N/A');
-});
-
-test('formatAddress shortens addresses predictably', () => {
-  const addr = '0x1234567890abcdef1234567890abcdef12345678';
-  assert.equal(formatAddress(addr), '0x1234...5678');
-  assert.equal(formatAddress(addr, 8), '0x123456...5678');
-  assert.equal(stripAnsi(formatAddress('')), 'N/A');
-});