JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 242
  • Score
    100M100P100Q104446F
  • License GPL-3.0-or-later

DARKSOL Terminal — unified CLI for all DARKSOL services. Market intel, trading, oracle, casino, and more.

Package Exports

  • @darksol/terminal
  • @darksol/terminal/src/cli.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@darksol/terminal) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

DARKSOL

Built by DARKSOL 🌑

@darksol/terminal

All DARKSOL services. One terminal. Zero trust required.

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 License: GPL-3.0 Node

  • Current release: 0.8.0
  • Changelog: CHANGELOG.md

Install

npm install -g @darksol/terminal

Quick Start

# Show dashboard
darksol

# Create a wallet (AES-256-GCM encrypted)
darksol wallet create main

# Check balance + multi-chain portfolio
darksol wallet balance
darksol portfolio

# Send / receive
darksol receive
darksol send --to 0xabc... --amount 10 --token USDC

# Token prices & live monitoring
darksol price ETH AERO VIRTUAL
darksol watch AERO --above 2.0

# Gas estimates
darksol gas base

# Swap tokens (LI.FI — best route across 31 DEXs, Uniswap V3 fallback)
darksol trade swap -i ETH -o USDC -a 0.1

# Cross-chain bridge (60+ chains via LI.FI)
darksol bridge send --from base --to arbitrum --token ETH -a 0.1
darksol bridge status 0xTxHash...
darksol bridge chains

# 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

darksol serve (Web Terminal UX)

darksol serve is a full interactive web terminal with keyboard-driven menus:

  • Arrow-key menus (↑/↓ + Enter) for wallet/config/trade flows
  • Interactive send — token → recipient → amount → password → on-chain transfer
  • Interactive swap — pair picker (presets + custom) → amount → password → LI.FI execution (Uniswap V3 fallback)
  • Interactive bridge — source chain → dest chain → token → amount → password → cross-chain via LI.FI
  • Interactive snipe — contract input → amount → password → fast buy
  • Wallet picker + wallet action menu (receive/send/portfolio/history/switch chain)
  • Agent signer control center (agent) with guided wallet selection + start/stop/status
  • Click-through help menu (help) with arrow-key command selection
  • AI connection check at startup (shows ready/not configured)
  • Interactive key setup from web terminal:
    • keys → select provider → paste key/host directly
    • masked input for API keys, plain input for Ollama URL
  • Local chat memory logs at ~/.darksol/chat-logs/YYYY-MM-DD.jsonl
  • Natural language fuzzy routing to AI for non-command prompts

Useful web-shell commands:

help          # clickable command menu (arrow keys + Enter)
trade         # interactive swap / snipe / bridge menu
bridge        # cross-chain bridge (LI.FI)
send          # interactive token transfer
wallet        # interactive wallet picker and actions
keys          # provider status + interactive add/update
agent         # signer start/stop/status controls
config        # interactive config menu
logs 20       # show recent AI chat log lines
ai <prompt>   # chat with trading assistant

Modules

Module Description Pricing
wallet Create/import/manage encrypted EVM wallets Free
send Send ETH or ERC-20 tokens Gas only
receive Show receive address + chain safety hints Free
trade Swap via LI.FI (31 DEXs) + Uniswap V3 fallback, snipe Gas only
bridge Cross-chain bridge via LI.FI (60 chains, 27 bridges) Gas only
dca Dollar-cost averaging engine Gas only
ai LLM-powered trading assistant & intent execution Provider dependent
agent Secure agent signer (PK-isolated proxy) Free
keys Encrypted API key vault (LLMs/data/RPCs) Free
script Execution scripts & automated strategies Free
skills Agent skill directory & installer Free
portfolio Multi-chain balance view (5 EVM chains) Free
history Transaction history via block explorers Free
gas Gas prices & cost estimates Free
price Quick token price check (DexScreener) Free
watch Live price monitoring with alerts Free
market Market intel, top movers, token analysis x402 micropayments
mail AgentMail — email for AI agents Free tier
oracle On-chain random number oracle $0.05–$0.25
casino The Clawsino — on-chain betting $1 flat bets
cards Crypto → prepaid Visa/MC cards Service fees
builders ERC-8021 builder directory + leaderboard Free
facilitator x402 payment verification & settlement Free
serve Local interactive web terminal (xterm.js) Free
config Terminal configuration Free

🔐 Secure Agent Signer

The killer feature. A PK-isolated signing proxy for AI agents (OpenClaw, etc.).

# 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.

# Interactive chat with live market data
darksol ai chat

# One-shot intent parsing (+ optional execution prompt)
darksol ai ask "buy 0.5 ETH worth of AERO on Base"

# Parse + execute directly
darksol ai execute "send 10 USDC to 0x..."

# 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, Bankr LLM Gateway, 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.

# 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, Bankr LLM Gateway, 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

# Interactive swap (prompts for pair + amount if flags omitted)
darksol trade swap

# Swap with full flags (Uniswap V3 with slippage protection)
darksol trade swap -i ETH -o USDC -a 0.1

# Non-interactive swap (for automation / cron)
darksol trade swap -i ETH -o USDC -a 0.1 -p "password" -y

# Show common pairs for current chain
darksol trade pairs

# Snipe a token (Uniswap V2, fast buy)
darksol trade snipe 0xTOKEN -a 0.05

# Snipe with gas boost + non-interactive
darksol trade snipe 0xTOKEN -a 0.05 -g 2.0 -p "password" -y

# Watch for new pairs
darksol trade watch

📊 DCA Engine

darksol dca create     # Interactive order creation
darksol dca list       # List active orders
darksol dca run        # Execute pending orders
darksol dca cancel <id>

📈 Market Intel

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.

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

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

Automation

# Non-interactive execution (for cron/OpenClaw)
darksol script run my-dca --password "mypass" --yes

🧩 Skills Directory

Install DARKSOL skills for OpenClaw agents.

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

Available skills: darksol-terminal, darksol-facilitator, darksol-prepaid-cards, random-oracle, the-clawsino

🎲 Services

# Oracle — on-chain randomness
darksol oracle flip
darksol oracle dice 20
darksol oracle number 1 100

# Casino — on-chain betting
darksol casino bet coin-flip heads
darksol casino tables
darksol casino stats

# Prepaid Cards — crypto to Visa/MC
darksol cards catalog
darksol cards order -p swype -a 50
darksol cards status <id>

# Builder Index — ERC-8021 rankings
darksol builders leaderboard
darksol builders lookup <code>

# Facilitator — x402 payments
darksol facilitator health
darksol facilitator verify <payment>

🔒 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
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)

⚙️ Configuration

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

Supported Chains

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

📚 Reference

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

🤖 OpenClaw Integration

DARKSOL Terminal is agent-native:

  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

All commands work without prompts when flags are provided.

Development

git clone https://gitlab.com/darks0l/darksol-terminal
cd darksol-terminal
npm install
npm test           # Run test suite (node:test)
node bin/darksol.js

Built with teeth. 🌑