@darksol/terminal 0.2.0 → 0.2.1

package/package.json

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

package/skill/SKILL.md

@@ -0,0 +1,177 @@
+---
+name: darksol-terminal
+description: "DARKSOL Terminal — unified CLI for trading, wallets, execution scripts, AI-powered market analysis, secure agent signing, and all DARKSOL services. Use when: (1) swapping/sniping tokens on Base/Ethereum/L2s, (2) managing encrypted wallets, (3) running automated trading scripts, (4) DCA strategies, (5) market intel lookups, (6) on-chain oracle/casino/cards, (7) natural language trading via LLM, (8) signing transactions securely for x402/contracts without exposing private keys."
+---
+
+# DARKSOL Terminal
+
+**All DARKSOL services. One terminal. Zero trust required. 🌑**
+
+## Install
+
+```bash
+npm install -g @darksol/terminal
+```
+
+## Quick Reference
+
+### Wallet Management
+```bash
+darksol wallet create <name>           # Create new wallet (AES-256-GCM encrypted)
+darksol wallet import <name>           # Import from private key
+darksol wallet list                    # List all wallets
+darksol wallet balance [name]          # Check ETH + USDC balance
+darksol wallet use <name>              # Set active wallet
+darksol wallet export [name]           # Export details (password required for PK)
+```
+
+### Trading
+```bash
+darksol trade swap -i ETH -o USDC -a 0.1      # Swap via Uniswap V3
+darksol trade snipe <token> -a 0.05            # Fast buy with gas boost
+darksol trade snipe <token> -a 0.05 -g 2.0     # Snipe with 2x gas priority
+darksol trade watch                             # Monitor new pairs
+```
+
+### DCA (Dollar-Cost Averaging)
+```bash
+darksol dca create                     # Interactive DCA order creation
+darksol dca list                       # List active DCA orders
+darksol dca run                        # Execute pending orders
+darksol dca cancel <id>                # Cancel an order
+```
+
+### AI Trading Assistant
+```bash
+darksol ai chat                        # Interactive AI trading chat
+darksol ai ask "buy 0.5 ETH of AERO"  # Parse natural language trade intent
+darksol ai strategy VIRTUAL -b 500     # DCA strategy recommendation
+darksol ai analyze AERO                # AI-powered token analysis
+```
+
+### Execution Scripts
+```bash
+darksol script templates               # List available templates
+darksol script create                  # Create from template (buy, sell, limit-buy, stop-loss, etc.)
+darksol script list                    # List saved scripts
+darksol script run <name>              # Execute (requires wallet password)
+darksol script run <name> -p "pw" -y   # Non-interactive (for automation/cron)
+darksol script show <name>             # View code + params
+darksol script edit <name>             # Edit params/wallet/chain
+darksol script clone <name> <new>      # Clone a script
+darksol script delete <name>           # Delete a script
+```
+
+Script templates: `buy-token`, `sell-token`, `limit-buy`, `stop-loss`, `multi-buy`, `transfer`, `empty` (custom)
+
+### 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
+```
+
+### Secure Agent Signer (for OpenClaw / AI agents)
+```bash
+darksol agent start <wallet>           # Start signing proxy
+darksol agent start <wallet> --max-value 0.5 --daily-limit 2.0
+darksol agent docs                     # Full security documentation
+```
+
+The agent signer creates a local HTTP server at `127.0.0.1:18790` that signs transactions without exposing the private key. AI agents authenticate with a one-time bearer token.
+
+**Endpoints:**
+- `GET /address` — wallet address
+- `GET /balance` — ETH balance
+- `POST /send` — sign + broadcast transaction
+- `POST /sign-message` — sign EIP-191 message (x402)
+- `POST /sign-typed-data` — sign EIP-712 typed data (x402)
+- `GET /policy` — spending limits
+- `GET /audit` — operation log
+
+### Oracle
+```bash
+darksol oracle flip                    # Coin flip
+darksol oracle dice 20                 # Roll d20
+darksol oracle number 1 100            # Random 1-100
+darksol oracle shuffle a b c d         # Shuffle list
+```
+
+### Casino
+```bash
+darksol casino bet coin-flip heads     # Place a bet
+darksol casino tables                  # View games
+darksol casino stats                   # House stats
+darksol casino receipt <id>            # Verify on-chain
+```
+
+### Prepaid Cards
+```bash
+darksol cards catalog                  # Available providers
+darksol cards order -p swype -a 50     # Order a card
+darksol cards status <id>              # Check order
+```
+
+### Builder Index
+```bash
+darksol builders leaderboard           # ERC-8021 builder rankings
+darksol builders lookup <code>         # Builder profile
+darksol builders feed                  # Recent transactions
+```
+
+### Facilitator
+```bash
+darksol facilitator health             # Status
+darksol facilitator verify <payment>   # Verify off-chain
+darksol facilitator settle <payment>   # Settle on-chain (free)
+```
+
+### API Keys
+```bash
+darksol keys list                      # Show all services + status
+darksol keys add openai                # Add OpenAI key
+darksol keys add coingecko             # Add CoinGecko Pro key
+darksol keys add alchemy               # Add Alchemy RPC key
+darksol keys remove <service>          # Remove a key
+```
+
+Supported: `openai`, `anthropic`, `openrouter`, `ollama`, `coingecko`, `dexscreener`, `alchemy`, `infura`, `quicknode`, `oneinch`, `paraswap`
+
+### Configuration
+```bash
+darksol config show                    # View all settings
+darksol config set chain base          # Set active chain
+darksol config set slippage 1.0        # Set slippage %
+darksol config rpc base https://...    # Custom RPC endpoint
+```
+
+### Reference
+```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 address on-chain
+```
+
+## Supported Chains
+- **Base** (default) — chain ID 8453
+- **Ethereum** — chain ID 1
+- **Polygon** — chain ID 137
+- **Arbitrum** — chain ID 42161
+- **Optimism** — chain ID 10
+
+## Agent Integration Notes
+
+- All commands work non-interactively with flags (`-p`, `-y`, `--key`, etc.)
+- Set `darksol config set output json` for programmatic JSON responses
+- Scripts can be executed via cron: `darksol script run my-dca -p "pass" -y`
+- The agent signer is the recommended way to give AI agents wallet access
+- Helper functions available at `@darksol/terminal/src/utils/helpers.js`
+
+## Security
+- Private keys encrypted with AES-256-GCM + scrypt KDF
+- Agent signer: PK never exposed, loopback-only, bearer auth, spending limits
+- Dangerous contract calls (transferOwnership, selfdestruct) blocked by default
+- Full audit logging on all signing operations

package/src/cli.js

@@ -18,6 +18,7 @@ import { showTradingTips, showScriptTips, showNetworkReference, showQuickStart,
 import { addKey, removeKey, listKeys } from './config/keys.js';
 import { parseIntent, startChat, adviseStrategy, analyzeToken } from './llm/intent.js';
 import { startAgentSigner, showAgentDocs } from './wallet/agent-signer.js';
+import { listSkills, installSkill, skillInfo, uninstallSkill } from './services/skills.js';
 
 export function cli(argv) {
   const program = new Command();
@@ -385,6 +386,33 @@ export function cli(argv) {
     .description('Show agent signer security documentation')
     .action(() => showAgentDocs());
 
+  // ═══════════════════════════════════════
+  // SKILLS COMMANDS
+  // ═══════════════════════════════════════
+  const skills = program
+    .command('skills')
+    .description('DARKSOL skills directory — install agent skills');
+
+  skills
+    .command('list')
+    .description('List all available DARKSOL skills')
+    .action(() => listSkills());
+
+  skills
+    .command('install <name>')
+    .description('Install a skill to OpenClaw')
+    .action((name) => installSkill(name));
+
+  skills
+    .command('info <name>')
+    .description('Show skill details')
+    .action((name) => skillInfo(name));
+
+  skills
+    .command('uninstall <name>')
+    .description('Uninstall a skill')
+    .action((name) => uninstallSkill(name));
+
   // ═══════════════════════════════════════
   // TIPS & REFERENCE COMMANDS
   // ═══════════════════════════════════════
@@ -572,6 +600,7 @@ export function cli(argv) {
         ['cards', 'Prepaid Visa/MC cards'],
         ['builders', 'ERC-8021 builder index'],
         ['facilitator', 'x402 payment facilitator'],
+        ['skills', 'Agent skill directory & install'],
         ['config', 'Terminal configuration'],
         ['tips', 'Trading & scripting tips'],
         ['networks', 'Chain reference & explorers'],

package/src/services/skills.js

@@ -0,0 +1,229 @@
+import fetch from 'node-fetch';
+import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync, cpSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+import { theme } from '../ui/theme.js';
+import { spinner, kvDisplay, success, error, warn, info, table } from '../ui/components.js';
+import { showSection } from '../ui/banner.js';
+
+const OPENCLAW_SKILLS_DIR = join(homedir(), '.openclaw', 'skills');
+
+// ──────────────────────────────────────────────────
+// DARKSOL SKILL CATALOG
+// ──────────────────────────────────────────────────
+
+const SKILL_CATALOG = [
+  {
+    name: 'darksol-terminal',
+    description: 'DARKSOL Terminal — unified CLI for trading, wallets, scripts, AI assistant, agent signing',
+    version: '0.2.0',
+    source: 'local',  // bundled with the package
+    category: 'trading',
+    installed: () => existsSync(join(OPENCLAW_SKILLS_DIR, 'darksol-terminal', 'SKILL.md')),
+  },
+  {
+    name: 'darksol-facilitator',
+    description: 'Free on-chain x402 payment facilitator — verify and settle micropayments',
+    version: '1.0.0',
+    source: 'url',
+    url: 'https://facilitator.darksol.net/skill/SKILL.md',
+    category: 'payments',
+    installed: () => existsSync(join(OPENCLAW_SKILLS_DIR, 'darksol-facilitator', 'SKILL.md')),
+  },
+  {
+    name: 'darksol-prepaid-cards',
+    description: 'Crypto → prepaid Visa/MC cards, no KYC, agent-native REST API',
+    version: '1.0.0',
+    source: 'url',
+    url: 'https://acp.darksol.net/dist/darksol-prepaid-cards.skill',
+    skillMdUrl: 'https://acp.darksol.net/cards/skill/SKILL.md',
+    category: 'payments',
+    installed: () => existsSync(join(OPENCLAW_SKILLS_DIR, 'darksol-prepaid-cards', 'SKILL.md')),
+  },
+  {
+    name: 'random-oracle',
+    description: 'On-chain random oracle — verifiable randomness via x402',
+    version: '1.0.0',
+    source: 'url',
+    url: 'https://acp.darksol.net/oracle/skill/SKILL.md',
+    category: 'oracle',
+    installed: () => existsSync(join(OPENCLAW_SKILLS_DIR, 'random-oracle', 'SKILL.md')),
+  },
+  {
+    name: 'the-clawsino',
+    description: 'On-chain agent casino — coin flip, dice, hi-lo, slots via x402',
+    version: '1.0.0',
+    source: 'url',
+    url: 'https://casino.darksol.net/skill/SKILL.md',
+    category: 'gaming',
+    installed: () => existsSync(join(OPENCLAW_SKILLS_DIR, 'the-clawsino', 'SKILL.md')),
+  },
+];
+
+// ──────────────────────────────────────────────────
+// LIST SKILLS
+// ──────────────────────────────────────────────────
+
+export function listSkills() {
+  showSection('DARKSOL SKILLS DIRECTORY');
+
+  const rows = SKILL_CATALOG.map(s => {
+    const isInstalled = s.installed();
+    return [
+      isInstalled ? theme.success('● ') + theme.gold(s.name) : theme.dim('○ ') + s.name,
+      s.description.slice(0, 55) + (s.description.length > 55 ? '...' : ''),
+      s.version,
+      isInstalled ? theme.success('Installed') : theme.dim('Available'),
+    ];
+  });
+
+  table(['Skill', 'Description', 'Version', 'Status'], rows);
+
+  console.log('');
+  info('Install: darksol skills install <name>');
+  info('Info:    darksol skills info <name>');
+  info('Skills install to: ' + OPENCLAW_SKILLS_DIR);
+}
+
+// ──────────────────────────────────────────────────
+// INSTALL SKILL
+// ──────────────────────────────────────────────────
+
+export async function installSkill(name) {
+  const skill = SKILL_CATALOG.find(s => s.name === name);
+
+  if (!skill) {
+    error(`Unknown skill: ${name}`);
+    info('Available: ' + SKILL_CATALOG.map(s => s.name).join(', '));
+    return;
+  }
+
+  if (skill.installed()) {
+    warn(`${name} is already installed`);
+    const inquirer = (await import('inquirer')).default;
+    const { reinstall } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'reinstall',
+      message: theme.gold('Reinstall / update?'),
+      default: false,
+    }]);
+    if (!reinstall) return;
+  }
+
+  const spin = spinner(`Installing ${name}...`).start();
+
+  try {
+    const targetDir = join(OPENCLAW_SKILLS_DIR, name);
+    mkdirSync(targetDir, { recursive: true });
+
+    if (skill.source === 'local') {
+      // Copy from the npm package's bundled skill directory
+      const __dirname = dirname(fileURLToPath(import.meta.url));
+      const bundledSkillDir = join(__dirname, '..', '..', 'skill');
+
+      if (existsSync(join(bundledSkillDir, 'SKILL.md'))) {
+        const skillContent = readFileSync(join(bundledSkillDir, 'SKILL.md'), 'utf8');
+        writeFileSync(join(targetDir, 'SKILL.md'), skillContent);
+      } else {
+        throw new Error('Bundled SKILL.md not found in package');
+      }
+    } else if (skill.source === 'url') {
+      // Fetch from remote
+      const url = skill.skillMdUrl || skill.url;
+      const resp = await fetch(url);
+      if (!resp.ok) throw new Error(`Failed to fetch: ${resp.status}`);
+      const content = await resp.text();
+
+      // Handle .skill files (may be a zip or just SKILL.md content)
+      if (url.endsWith('.skill')) {
+        // .skill files are typically just the SKILL.md content
+        writeFileSync(join(targetDir, 'SKILL.md'), content);
+      } else {
+        writeFileSync(join(targetDir, 'SKILL.md'), content);
+      }
+    }
+
+    spin.succeed(`${name} installed`);
+
+    showSection(`INSTALLED: ${name}`);
+    kvDisplay([
+      ['Name', name],
+      ['Version', skill.version],
+      ['Category', skill.category],
+      ['Location', targetDir],
+    ]);
+    console.log('');
+    success('Skill is now available to OpenClaw and other agents');
+
+  } catch (err) {
+    spin.fail(`Failed to install ${name}`);
+    error(err.message);
+  }
+}
+
+// ──────────────────────────────────────────────────
+// SKILL INFO
+// ──────────────────────────────────────────────────
+
+export async function skillInfo(name) {
+  const skill = SKILL_CATALOG.find(s => s.name === name);
+
+  if (!skill) {
+    error(`Unknown skill: ${name}`);
+    return;
+  }
+
+  const isInstalled = skill.installed();
+
+  showSection(`SKILL: ${name}`);
+  kvDisplay([
+    ['Name', skill.name],
+    ['Description', skill.description],
+    ['Version', skill.version],
+    ['Category', skill.category],
+    ['Status', isInstalled ? theme.success('Installed') : theme.dim('Not installed')],
+    ['Source', skill.source === 'local' ? 'Bundled with @darksol/terminal' : skill.url || 'Remote'],
+  ]);
+
+  if (isInstalled) {
+    const skillPath = join(OPENCLAW_SKILLS_DIR, name, 'SKILL.md');
+    console.log('');
+    console.log(theme.dim(`  Location: ${skillPath}`));
+  }
+
+  console.log('');
+  if (!isInstalled) {
+    info(`Install: darksol skills install ${name}`);
+  }
+}
+
+// ──────────────────────────────────────────────────
+// UNINSTALL SKILL
+// ──────────────────────────────────────────────────
+
+export async function uninstallSkill(name) {
+  const skill = SKILL_CATALOG.find(s => s.name === name);
+  const skillDir = join(OPENCLAW_SKILLS_DIR, name);
+
+  if (!existsSync(skillDir)) {
+    error(`${name} is not installed`);
+    return;
+  }
+
+  const inquirer = (await import('inquirer')).default;
+  const { confirm } = await inquirer.prompt([{
+    type: 'confirm',
+    name: 'confirm',
+    message: theme.accent(`Uninstall ${name}?`),
+    default: false,
+  }]);
+
+  if (!confirm) return;
+
+  const { rmSync } = await import('fs');
+  rmSync(skillDir, { recursive: true, force: true });
+  success(`${name} uninstalled`);
+}
+
+export { SKILL_CATALOG, OPENCLAW_SKILLS_DIR };

package/src/ui/banner.js

@@ -26,7 +26,7 @@ export function showBanner(opts = {}) {
   );
   console.log(
     theme.dim('  ║ ') +
-    theme.subtle(' v0.2.0') +
+    theme.subtle(' v0.2.1') +
     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.0'));
+  console.log(theme.gold.bold('  🌑 DARKSOL TERMINAL') + theme.dim(' v0.2.1'));
   console.log(theme.dim('  ─────────────────────────────'));
   console.log('');
 }
@@ -60,3 +60,4 @@ export function showDivider() {
 }
 
 
+