@darksol/terminal 0.1.0

package/README.md

@@ -0,0 +1,198 @@
+<p align="center">
+  <img src="assets/darksol-banner.png" alt="DARKSOL" width="600" />
+</p>
+<h3 align="center">Built by DARKSOL 🌑</h3>
+
+---
+
+# @darksol/terminal
+
+**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.
+
+## Install
+
+```bash
+npm install -g @darksol/terminal
+```
+
+## Quick Start
+
+```bash
+# Show dashboard
+darksol
+
+# Create a wallet (AES-256-GCM encrypted)
+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
+
+# Facilitator
+darksol facilitator health
+```
+
+## 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 |
+| `dca` | Dollar-cost averaging engine | Gas only |
+| `script` | Execution scripts & strategies | Free |
+| `market` | Market intel, top movers, 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 |
+| `builders` | ERC-8021 builder leaderboard | Free |
+| `facilitator` | x402 payment verification | Free |
+| `config` | Terminal configuration | Free |
+
+## Execution Scripts
+
+Automated trading strategies with full PK access. Scripts unlock your wallet at runtime and execute on-chain transactions.
+
+### Templates
+
+| Template | Description |
+|----------|-------------|
+| `buy-token` | Buy a token with ETH at current price |
+| `sell-token` | Sell a % of token balance for ETH |
+| `limit-buy` | Watch price and buy at target (polling) |
+| `stop-loss` | Auto-sell if value drops below threshold |
+| `multi-buy` | Buy multiple tokens in one execution |
+| `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)
+
+```bash
+# Run without prompts (password via flag)
+darksol script run my-dca --password "mypass" --yes
+
+# JSON output for programmatic use
+darksol config set output json
+```
+
+## Configuration
+
+Config stored at `~/.config/darksol-terminal/config.json`
+
+```bash
+# View all settings
+darksol config show
+
+# Set active chain
+darksol config set chain base
+
+# 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
+```
+
+## Supported Chains
+
+- **Base** (default)
+- Ethereum
+- Polygon
+- Arbitrum
+- Optimism
+
+## OpenClaw Integration
+
+DARKSOL Terminal is designed to be controlled by AI agents via OpenClaw:
+
+```bash
+# Agents can run any command non-interactively
+darksol market top --output json
+darksol wallet balance main
+darksol oracle flip
+```
+
+JSON output mode for programmatic use:
+```bash
+darksol config set output json
+```
+
+## Development
+
+```bash
+git clone https://gitlab.com/darks0l/darksol-terminal
+cd darksol-terminal
+npm install
+node bin/darksol.js
+```
+
+---
+
+Built with teeth. 🌑

package/bin/darksol.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { cli } from '../src/cli.js';
+
+cli(process.argv);

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@darksol/terminal",
+  "version": "0.1.0",
+  "description": "DARKSOL Terminal — unified CLI for all DARKSOL services. Market intel, trading, oracle, casino, and more.",
+  "type": "module",
+  "bin": {
+    "darksol": "./bin/darksol.js"
+  },
+  "main": "./src/cli.js",
+  "scripts": {
+    "start": "node bin/darksol.js",
+    "dev": "node bin/darksol.js dashboard",
+    "test": "node --test tests/*.test.js"
+  },
+  "keywords": ["darksol", "crypto", "trading", "cli", "x402", "base", "ethereum", "defi"],
+  "author": "DARKSOL <chris00claw@gmail.com>",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "ethers": "^6.13.0",
+    "boxen": "^8.0.1",
+    "ora": "^8.1.0",
+    "cli-table3": "^0.6.5",
+    "inquirer": "^12.0.0",
+    "figlet": "^1.8.0",
+    "gradient-string": "^3.0.0",
+    "conf": "^13.0.1",
+    "nanospinner": "^1.1.0",
+    "node-fetch": "^3.3.2",
+    "blessed": "^0.1.81",
+    "blessed-contrib": "^4.11.0",
+    "terminal-link": "^3.0.0",
+    "update-notifier": "^7.3.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/cli.js

@@ -0,0 +1,434 @@
+import { Command } from 'commander';
+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 { executeSwap } from './trading/swap.js';
+import { snipeToken, watchSnipe } from './trading/snipe.js';
+import { createDCA, listDCA, cancelDCA, runDCA } from './trading/dca.js';
+import { topMovers, tokenDetail, compareTokens } from './services/market.js';
+import { oracleFlip, oracleDice, oracleNumber, oracleShuffle, oracleHealth } from './services/oracle.js';
+import { casinoBet, casinoTables, casinoStats, casinoReceipt } from './services/casino.js';
+import { cardsCatalog, cardsOrder, cardsStatus } from './services/cards.js';
+import { facilitatorHealth, facilitatorVerify, facilitatorSettle } from './services/facilitator.js';
+import { buildersLeaderboard, buildersLookup, buildersFeed } from './services/builders.js';
+import { createScript, listScripts, runScript, showScript, editScript, deleteScript, cloneScript, listTemplates } from './scripts/engine.js';
+
+export function cli(argv) {
+  const program = new Command();
+
+  program
+    .name('darksol')
+    .description(theme.gold('DARKSOL Terminal') + theme.dim(' — Ghost in the machine with teeth 🌑'))
+    .version('0.1.0')
+;
+
+  // ═══════════════════════════════════════
+  // WALLET COMMANDS
+  // ═══════════════════════════════════════
+  const wallet = program
+    .command('wallet')
+    .description('Wallet management — create, import, list, balance');
+
+  wallet
+    .command('create [name]')
+    .description('Create a new wallet')
+    .option('-c, --chain <chain>', 'Target chain', 'base')
+    .action((name, opts) => createWallet(name, opts));
+
+  wallet
+    .command('import [name]')
+    .description('Import wallet from private key')
+    .option('-c, --chain <chain>', 'Target chain', 'base')
+    .action((name, opts) => importWallet(name, opts));
+
+  wallet
+    .command('list')
+    .description('List all wallets')
+    .action(() => showWallets());
+
+  wallet
+    .command('balance [name]')
+    .description('Check wallet balance')
+    .action((name) => getBalance(name));
+
+  wallet
+    .command('use <name>')
+    .description('Set active wallet')
+    .action((name) => useWallet(name));
+
+  wallet
+    .command('export [name]')
+    .description('Export wallet details')
+    .action((name) => exportWallet(name));
+
+  // ═══════════════════════════════════════
+  // TRADING COMMANDS
+  // ═══════════════════════════════════════
+  const trade = program
+    .command('trade')
+    .description('Trading — swap, snipe, DCA');
+
+  trade
+    .command('swap')
+    .description('Swap tokens via DEX')
+    .requiredOption('-i, --in <token>', 'Token to sell (symbol or address)')
+    .requiredOption('-o, --out <token>', 'Token to buy (symbol or address)')
+    .requiredOption('-a, --amount <amount>', 'Amount to swap')
+    .option('-s, --slippage <percent>', 'Max slippage %', '0.5')
+    .option('-w, --wallet <name>', 'Wallet to use')
+    .action((opts) => executeSwap({
+      tokenIn: opts.in,
+      tokenOut: opts.out,
+      amount: opts.amount,
+      slippage: parseFloat(opts.slippage),
+      wallet: opts.wallet,
+    }));
+
+  trade
+    .command('snipe <token>')
+    .description('Snipe a token — fast buy with ETH')
+    .requiredOption('-a, --amount <eth>', 'ETH amount to spend')
+    .option('-s, --slippage <percent>', 'Max slippage %', '1')
+    .option('-g, --gas <multiplier>', 'Gas priority multiplier', '1.5')
+    .option('-w, --wallet <name>', 'Wallet to use')
+    .action((token, opts) => snipeToken(token, opts.amount, {
+      slippage: parseFloat(opts.slippage),
+      gas: parseFloat(opts.gas),
+      wallet: opts.wallet,
+    }));
+
+  trade
+    .command('watch')
+    .description('Watch for new pairs (snipe monitor)')
+    .option('--auto', 'Auto-snipe mode (dangerous)')
+    .option('-a, --amount <eth>', 'Auto-snipe amount')
+    .action((opts) => watchSnipe(opts));
+
+  // ═══════════════════════════════════════
+  // DCA COMMANDS
+  // ═══════════════════════════════════════
+  const dca = program
+    .command('dca')
+    .description('Dollar-cost averaging');
+
+  dca
+    .command('create')
+    .description('Create a new DCA order')
+    .action(() => createDCA());
+
+  dca
+    .command('list')
+    .description('List DCA orders')
+    .action(() => listDCA());
+
+  dca
+    .command('cancel <id>')
+    .description('Cancel a DCA order')
+    .action((id) => cancelDCA(id));
+
+  dca
+    .command('run')
+    .description('Execute pending DCA orders')
+    .action(() => runDCA());
+
+  // ═══════════════════════════════════════
+  // MARKET COMMANDS
+  // ═══════════════════════════════════════
+  const market = program
+    .command('market')
+    .description('Market intel — prices, movers, analysis');
+
+  market
+    .command('top')
+    .description('Top movers on chain')
+    .option('-c, --chain <chain>', 'Chain to scan')
+    .option('-l, --limit <n>', 'Number of results', '15')
+    .action((opts) => topMovers(opts.chain, { limit: parseInt(opts.limit) }));
+
+  market
+    .command('token <query>')
+    .description('Token detail — price, volume, liquidity')
+    .action((query) => tokenDetail(query));
+
+  market
+    .command('compare <tokens...>')
+    .description('Compare multiple tokens side by side')
+    .action((tokens) => compareTokens(tokens));
+
+  // ═══════════════════════════════════════
+  // ORACLE COMMANDS
+  // ═══════════════════════════════════════
+  const oracle = program
+    .command('oracle')
+    .description('On-chain random oracle');
+
+  oracle
+    .command('flip')
+    .description('Coin flip')
+    .action(() => oracleFlip());
+
+  oracle
+    .command('dice [sides]')
+    .description('Roll dice')
+    .action((sides) => oracleDice(parseInt(sides) || 6));
+
+  oracle
+    .command('number [min] [max]')
+    .description('Random number in range')
+    .action((min, max) => oracleNumber(parseInt(min) || 1, parseInt(max) || 100));
+
+  oracle
+    .command('shuffle <items...>')
+    .description('Shuffle a list')
+    .action((items) => oracleShuffle(items));
+
+  oracle
+    .command('health')
+    .description('Oracle status')
+    .action(() => oracleHealth());
+
+  // ═══════════════════════════════════════
+  // CASINO COMMANDS
+  // ═══════════════════════════════════════
+  const casino = program
+    .command('casino')
+    .description('The Clawsino — on-chain betting');
+
+  casino
+    .command('bet <game> [choice]')
+    .description('Place a bet (coin-flip, dice, hilo, slots)')
+    .option('-n, --number <n>', 'Number for dice over/under')
+    .option('-w, --wallet <addr>', 'Wallet address')
+    .action((game, choice, opts) => casinoBet(game, { choice, ...opts }));
+
+  casino
+    .command('tables')
+    .description('View game tables')
+    .action(() => casinoTables());
+
+  casino
+    .command('stats')
+    .description('House stats')
+    .action(() => casinoStats());
+
+  casino
+    .command('receipt <id>')
+    .description('Verify bet receipt')
+    .action((id) => casinoReceipt(id));
+
+  // ═══════════════════════════════════════
+  // CARDS COMMANDS
+  // ═══════════════════════════════════════
+  const cards = program
+    .command('cards')
+    .description('Prepaid cards — crypto to Visa/MC');
+
+  cards
+    .command('catalog')
+    .description('Available card providers')
+    .action(() => cardsCatalog());
+
+  cards
+    .command('order')
+    .description('Order a prepaid card')
+    .requiredOption('-p, --provider <name>', 'Card provider')
+    .requiredOption('-a, --amount <usd>', 'Card amount in USD')
+    .action((opts) => cardsOrder(opts.provider, parseFloat(opts.amount)));
+
+  cards
+    .command('status <orderId>')
+    .description('Check order status')
+    .action((id) => cardsStatus(id));
+
+  // ═══════════════════════════════════════
+  // BUILDERS COMMANDS
+  // ═══════════════════════════════════════
+  const builders = program
+    .command('builders')
+    .description('ERC-8021 builder index');
+
+  builders
+    .command('leaderboard')
+    .description('Builder leaderboard')
+    .option('-l, --limit <n>', 'Number of results', '20')
+    .action((opts) => buildersLeaderboard({ limit: parseInt(opts.limit) }));
+
+  builders
+    .command('lookup <code>')
+    .description('Builder profile')
+    .action((code) => buildersLookup(code));
+
+  builders
+    .command('feed')
+    .description('Recent builder transactions')
+    .option('-l, --limit <n>', 'Number of results', '20')
+    .action((opts) => buildersFeed({ limit: parseInt(opts.limit) }));
+
+  // ═══════════════════════════════════════
+  // FACILITATOR COMMANDS
+  // ═══════════════════════════════════════
+  const facilitator = program
+    .command('facilitator')
+    .description('x402 payment facilitator');
+
+  facilitator
+    .command('health')
+    .description('Facilitator status')
+    .action(() => facilitatorHealth());
+
+  facilitator
+    .command('verify <payment>')
+    .description('Verify a payment off-chain')
+    .action((payment) => facilitatorVerify(payment));
+
+  facilitator
+    .command('settle <payment>')
+    .description('Settle payment on-chain')
+    .action((payment) => facilitatorSettle(payment));
+
+  // ═══════════════════════════════════════
+  // SCRIPT COMMANDS
+  // ═══════════════════════════════════════
+  const script = program
+    .command('script')
+    .description('Execution scripts — automated trading strategies');
+
+  script
+    .command('create')
+    .description('Create a new execution script')
+    .action(() => createScript());
+
+  script
+    .command('list')
+    .description('List all scripts')
+    .action(() => listScripts());
+
+  script
+    .command('run <name>')
+    .description('Execute a script')
+    .option('-p, --password <pw>', 'Wallet password (for automation)')
+    .option('-y, --yes', 'Skip confirmation')
+    .option('-v, --verbose', 'Show full error traces')
+    .action((name, opts) => runScript(name, opts));
+
+  script
+    .command('show <name>')
+    .description('Show script details and code')
+    .action((name) => showScript(name));
+
+  script
+    .command('edit <name>')
+    .description('Edit script parameters')
+    .action((name) => editScript(name));
+
+  script
+    .command('delete <name>')
+    .description('Delete a script')
+    .action((name) => deleteScript(name));
+
+  script
+    .command('clone <name> [newName]')
+    .description('Clone a script')
+    .action((name, newName) => cloneScript(name, newName));
+
+  script
+    .command('templates')
+    .description('List available script templates')
+    .action(() => listTemplates());
+
+  // ═══════════════════════════════════════
+  // CONFIG COMMANDS
+  // ═══════════════════════════════════════
+  const config = program
+    .command('config')
+    .description('Terminal configuration');
+
+  config
+    .command('show')
+    .description('Show current config')
+    .action(() => {
+      showMiniBanner();
+      showSection('CONFIGURATION');
+      const cfg = getAllConfig();
+      kvDisplay([
+        ['Active Wallet', cfg.activeWallet || theme.dim('(none)')],
+        ['Chain', cfg.chain],
+        ['Output', cfg.output],
+        ['Slippage', `${cfg.slippage}%`],
+        ['Gas Multiplier', `${cfg.gasMultiplier}x`],
+        ['Config File', configPath()],
+      ]);
+      console.log('');
+      showSection('RPC ENDPOINTS');
+      kvDisplay(Object.entries(cfg.rpcs).map(([k, v]) => [k, v]));
+      console.log('');
+      showSection('SERVICE URLS');
+      kvDisplay(Object.entries(cfg.services).map(([k, v]) => [k, v]));
+      console.log('');
+    });
+
+  config
+    .command('set <key> <value>')
+    .description('Set config value')
+    .action((key, value) => {
+      setConfig(key, value);
+      success(`${key} = ${value}`);
+    });
+
+  config
+    .command('rpc <chain> <url>')
+    .description('Set custom RPC endpoint')
+    .action((chain, url) => {
+      setRPC(chain, url);
+      success(`RPC for ${chain}: ${url}`);
+    });
+
+  // ═══════════════════════════════════════
+  // DASHBOARD (default)
+  // ═══════════════════════════════════════
+  program
+    .command('dashboard', { isDefault: true })
+    .description('Show DARKSOL Terminal dashboard')
+    .action(async () => {
+      showBanner();
+
+      const cfg = getAllConfig();
+      const wallet = cfg.activeWallet;
+
+      showSection('STATUS');
+      kvDisplay([
+        ['Wallet', wallet || theme.dim('Not set — run: darksol wallet create')],
+        ['Chain', cfg.chain],
+        ['Slippage', `${cfg.slippage}%`],
+      ]);
+
+      console.log('');
+      showSection('COMMANDS');
+      const commands = [
+        ['wallet', 'Create, import, manage wallets'],
+        ['trade', 'Swap tokens, snipe, trading'],
+        ['dca', 'Dollar-cost averaging orders'],
+        ['script', 'Execution scripts & strategies'],
+        ['market', 'Market intel & token data'],
+        ['oracle', 'On-chain random oracle'],
+        ['casino', 'The Clawsino — betting'],
+        ['cards', 'Prepaid Visa/MC cards'],
+        ['builders', 'ERC-8021 builder index'],
+        ['facilitator', 'x402 payment facilitator'],
+        ['config', 'Terminal configuration'],
+      ];
+
+      commands.forEach(([cmd, desc]) => {
+        console.log(`  ${theme.gold(cmd.padEnd(16))} ${theme.dim(desc)}`);
+      });
+
+      console.log('');
+      console.log(theme.dim('  Run any command with --help for details'));
+      console.log(theme.dim('  Example: darksol trade swap --help'));
+      console.log('');
+    });
+
+  program.parse(argv);
+}