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

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.

Current release: 0.17.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 quote --from base --to arbitrum -a 0.5
darksol bridge compare --from base --to arbitrum,optimism,polygon -a 0.1
darksol bridge status 0xTxHash...
darksol bridge chains

# Privacy — RAILGUN shield/unshield
darksol privacy railgun-shield -t ETH -a 0.1        # shield ETH into private pool
darksol privacy railgun-unshield -t ETH -a 0.1 --to 0xRecipient  # unshield to address
darksol privacy score 0xYourAddress                  # analyze privacy posture

# Gas monitor with alerts
darksol gas base                                     # current gas prices
darksol gas --all                                    # all chains at once
darksol gas monitor --below 0.01 --interval 15       # alert when gas is cheap

# Transaction history export
darksol wallet export-history -f csv                 # export as CSV
darksol wallet export-history -f json --since 2026-01-01 --type out

# Quick aliases
darksol balance                                      # = wallet balance
darksol swap -i ETH -o USDC -a 0.1                   # = trade swap
darksol history                                      # = wallet history

# Tab completion (bash/zsh)
eval "$(darksol completion)"

# Token security scanner
darksol scan 0x1234...5678                          # scan a token on Base (default)
darksol scan 0x1234...5678 --chain ethereum         # scan on a specific chain
darksol scan 0x1234...5678 --json                   # JSON output for automation
darksol scan 0x1234...5678 --quick                  # skip slow checks (honeypot sim)

# Cross-DEX arbitrage
darksol arb scan --chain base                       # AI-scored DEX price comparison
darksol arb monitor --chain base --execute          # real-time block-by-block scanning
darksol arb config                                   # set thresholds, dry-run, DEXes
darksol arb add-endpoint base wss://your-quicknode   # faster with WSS endpoints
darksol arb add-pair WETH AERO                       # add pairs to scan
darksol arb stats --days 7                           # PnL history
darksol arb info                                     # setup guide + risk warnings

# AI arbitrage intelligence
darksol arb ai                                       # strategy briefing + recommendations
darksol arb discover --chain base                    # AI pair discovery
darksol arb tune --chain base                        # AI threshold optimization
darksol arb learn --chain base                       # learn from history patterns

# Set up your agent identity
darksol soul

# AI trading assistant (now with personality + memory)
darksol ai chat

# View/search persistent memories
darksol memory show
darksol memory search "preferred chain"

# Autonomous agent task (ReAct loop)
darksol agent task "check AERO price and tell me if it's above $2"
darksol agent task "analyze my portfolio" --max-steps 5
darksol agent task "swap 0.1 ETH for USDC" --allow-actions
darksol agent plan "DCA strategy for AERO"

# 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

# Telegram bot — AI chat through Telegram
darksol telegram setup
darksol telegram start
darksol telegram status
darksol telegram send 123456789 "Hello from DARKSOL"

# Background daemon — manage persistent services
darksol daemon start
darksol daemon status
darksol daemon stop

# Browser automation (requires: npm i playwright-core)
darksol browser launch --headed
darksol browser navigate https://app.uniswap.org
darksol browser screenshot swap-page.png
darksol browser click "#swap-button"
darksol browser type "#amount-input" "1.0"
darksol browser eval "document.title"
darksol browser close
darksol browser install

`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
arb           # cross-DEX arbitrage scanner
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
`scan`	Token security scanner — honeypot, rug pull, red flag detection	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
`soul`	Agent identity & personality configuration	Free
`memory`	Persistent cross-session memory store	Free
`whale`	Whale Radar — track wallets, copy-trade, live feed	Free
`dash`	Live TUI dashboard — portfolio, prices, gas, whale feed	Free
`auto`	Autonomous Trader — goal-based automated execution	Provider dependent
`agent task`	Autonomous ReAct agent loop with tool use	Provider dependent
`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 + CSV/JSON export	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
`agentcomms` / `sms`	x402-gated phone numbers + SMS checks for agents	x402 micropayments
`builders`	ERC-8021 builder directory + leaderboard	Free
`facilitator`	x402 payment verification & settlement	Free
`telegram`	Telegram bot — AI chat via Telegram Bot API	Provider dependent
`daemon`	Background service daemon (manages TG, browser, etc.)	Free
`browser`	Playwright-powered browser automation	Free
`serve`	Local interactive web terminal (xterm.js)	Free
`config`	Terminal configuration	Free

⚡ Lightning

Bitcoin Lightning Network — send and receive sats instantly. BIP39 mnemonics, BOLT11/12, JIT channels, and full channel management.

# Initialize and start
darksol lightning init                    # generate or import BIP39 mnemonic
darksol lightning start                  # start the node
darksol lightning stop                  # stop gracefully

# Info and balance
darksol lightning info                   # node info, pubkey, alias, channels
darksol lightning balance                # on-chain + Lightning + inbound liquidity

# Payments
darksol lightning invoice 10000          # create BOLT11 invoice for 10,000 sats
darksol lightning offer 5000            # create reusable BOLT12 offer (any amount)
darksol lightning pay lnbc100n1p0...    # pay a BOLT11 invoice or BOLT12 offer
darksol lightning decode lnbc1...        # decode an invoice or offer
darksol lightning history               # payment history
darksol lightning history <payment_id>  # single payment details

# Channel management
darksol lightning channels              # list all channels
darksol lightning open 02abc...@host:9735 100000  # open channel (min 20k sats)
darksol lightning close <channel_id>    # cooperative close
darksol lightning force-close <channel_id>  # force close (data loss risk)

# Peers
darksol lightning peers                 # list connected peers
darksol lightning connect 02abc...@host:9735  # connect to a peer

# Liquidity
darksol lightning liquidity             # inbound/outbound liquidity
darksol lightning jit-channel           # request JIT channel from LSP (instant inbound)

# Shortcut
darksol ln                               # alias for: darksol lightning

Architecture: LDK (managed mode) with Esplora chain source. BIP39 mnemonic → m/535' derivation → LDK seed. All data encrypted with AES-256-GCM.

JIT Channels: Request instant inbound liquidity from LSPs (Olympus, Voltage, Megalith) — channel opens automatically when you receive your first payment.

Supported networks: bitcoin (mainnet), testnet, signet, regtest.

🔒 Privacy

On-chain privacy analysis and RAILGUN shielded transactions. Move tokens into a private pool where they cannot be traced by address clustering or tx graph analysis.

# Privacy posture analysis
darksol privacy score 0xYourAddress                    # score + findings (0-100)
darksol privacy score 0xYourAddress --chain ethereum  # analyze on a specific chain
darksol privacy score 0xYourAddress --json            # structured JSON output

# DarkLabzRouter shield status
darksol privacy shield-status 0xYourAddress           # check if address has active shield
darksol privacy router-info                          # DarkLabzRouter contract info

# RAILGUN shielded pool — move tokens in/out of private pool
darksol privacy railgun-shield -t ETH -a 0.1        # shield 0.1 ETH into RAILGUN pool
darksol privacy railgun-shield -t USDC -a 100 -c base  # shield USDC on Base
darksol privacy railgun-shield -t 0xToken -a 50     # shield by ERC-20 contract address

darksol privacy railgun-unshield -t ETH -a 0.1 --to 0xRecipient  # unshield to address
darksol privacy railgun-unshield -t USDC -a 50 --to 0xRecipient -c base  # on Base

Privacy Score analyzes your on-chain footprint using tx history from Etherscan — counterparty count, direct transfer ratio, token diversity, contract vs EOA calls. Results: HIGH (≥80), MODERATE (60-79), LOW (40-59), EXPOSED (<40).

RAILGUN moves tokens into a shielded pool — once shielded, tokens cannot be linked to your public address via on-chain analysis. Unshield to any address when ready.

Supported chains: Base, Ethereum, Arbitrum, Polygon (ETH, USDC, and ERC-20 by address).

🐋 Whale Radar

Track any wallet across 5 chains. Get alerts on swaps, transfers, new tokens. Enable copy-trading to mirror a whale's moves automatically.

# Track a wallet
darksol whale track 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --label "vitalik" --chain ethereum

# List all tracked wallets
darksol whale list

# View recent activity
darksol whale activity 0xd8dA... --limit 20

# Enable copy-trading (mirrors swaps with your own limits)
darksol whale mirror 0xd8dA... --max 50 --slippage 2 --dry-run

# Open the live feed (blessed TUI)
darksol whale feed

# Stop tracking
darksol whale stop 0xd8dA...

5-chain support: Base, Ethereum, Arbitrum, Polygon, Optimism
Swap decoding: Uniswap V2 + V3 router signatures automatically parsed
Copy-trading: Mirror whale swaps with budget caps, slippage limits, dry-run mode
Live feed: Real-time blessed terminal UI with whale events streaming
Daemon integration: Runs as a background service, feeds alerts to Telegram bot
Event system: Subscribe to whale:swap, whale:transfer, whale:newtoken, whale:mirror-executed

📊 Live Dashboard

Full-screen terminal dashboard. Portfolio, prices, gas, transactions, whale alerts — all updating in real-time.

# Launch the dashboard
darksol dash

# Custom refresh interval
darksol dash --refresh 15

# Compact mode (portfolio + prices only)
darksol dash --compact

Portfolio summary — total value, token balances, chain breakdown
Price ticker — sparkline micro-charts for tracked tokens
Gas gauge — current gas prices across all 5 chains
Recent transactions — last 10 txs from wallet history
Whale feed — live alerts when whale monitor is running
Keyboard shortcuts: q quit, r refresh, tab cycle focus, w toggle whales, 1-5 switch chains
DARKSOL gold/dark theme throughout

🤖 Autonomous Trader

Set a goal in plain English. The AI builds a strategy, monitors the market, and executes trades within your budget and risk limits. Full audit trail on every decision.

# Start an autonomous strategy
darksol auto start "accumulate ETH under 2400" --budget 500 --max-per-trade 50 --risk moderate

# DCA into memecoins
darksol auto start "DCA into BASE memecoins with >1M liquidity" --budget 200 --interval 15 --dry-run

# Check status
darksol auto status
darksol auto status auto_1741...

# View audit trail
darksol auto log auto_1741... --limit 20

# Stop a strategy
darksol auto stop auto_1741...

# List all strategies
darksol auto list

Natural language goals — parsed by LLM intent system into executable strategies
Three risk levels: conservative (5% stop-loss), moderate (10%), aggressive (20%)
Kill switches: budget exhaustion, max loss, error threshold — auto-stops immediately
Dry-run mode — test strategies without executing real trades
Full audit log — every decision, trade, and skip logged to ~/.darksol/autonomous/<id>/audit.json
Event system: auto:started, auto:trade, auto:skipped, auto:stopped, auto:budget-hit, auto:error

📱 Telegram Bot

Turn your terminal into a Telegram AI agent. Same brain (LLM + soul + memory), different mouth.

# Guided setup — walks you through BotFather
darksol telegram setup

# Start the bot (foreground, or managed by daemon)
darksol telegram start

# Check bot status
darksol telegram status

# Send a direct message
darksol telegram send <chat_id> "Hello from DARKSOL"

Setup walkthrough:

Open Telegram → search @BotFather → send /newbot
Follow BotFather's prompts to name your bot
Copy the bot token
Run darksol telegram setup → paste token → auto-validates via getMe
Token encrypted and stored in your key vault
darksol telegram start → bot goes live

Features:

Per-chat session memory (remembers conversation context)
Soul system prompt (your agent's personality carries over)
Built-in commands: /start, /help, /status
Typing indicators while LLM processes
Rate limiting (1 req/sec per chat)
429 auto-retry for Telegram API limits
Daemon-aware: runs foreground solo, or as a managed service

🖥️ Background Daemon

One process to rule them all. Manages persistent services (Telegram bot, browser, future channels).

darksol daemon start              # Detached background process
darksol daemon status             # PID, uptime, active services
darksol daemon stop               # Graceful shutdown
darksol daemon restart            # Stop + start
darksol daemon start --port 9999  # Custom health port

Health endpoint: http://localhost:18792/health — returns uptime, version, active services list.

Service registry: Services (Telegram, browser, etc.) register with the daemon for managed lifecycle. Start once, everything runs.

🌐 Browser Automation

Playwright-powered browser control — automate dApps, scrape data, take screenshots.

# Install browser binary (one-time)
darksol browser install

# Launch and control
darksol browser launch --headed --type chromium
darksol browser navigate https://app.uniswap.org
darksol browser screenshot swap-page.png
darksol browser click "#connect-wallet"
darksol browser type "#search" "AERO"
darksol browser eval "document.title"
darksol browser status
darksol browser close

Requires: npm install playwright-core (optional dependency — only needed if you use browser features).

Features:

Chromium, Firefox, or WebKit
Headless (default) or headed mode
Named profiles with persistent cookies/sessions (~/.darksol/browser/profiles/)
IPC via named pipes — CLI commands talk to a running browser instance
Web shell integration (browser command in darksol serve)
Daemon-managed when running

🔐 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:

You unlock your wallet ONCE with your password
The key decrypts into memory (never to disk/API)
A local HTTP server at 127.0.0.1:18790 exposes signing endpoints
AI agents call /send, /sign — never see the key
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

👤 Agent Soul System

Give your terminal agent a name, personality, and persistent memory.

# First-run setup (or run anytime)
darksol soul

# View current identity
darksol soul show

# Reset and reconfigure
darksol soul reset

What it does:

Your name — the agent addresses you personally
Agent name — name your AI (default: Darksol)
Tone — professional, casual, hacker, friendly, sarcastic, or custom freeform
Persists across sessions — your agent remembers who it is
Auto-injected into every LLM call as a system prompt

Session memory: Conversations maintain context (up to 20 turns). When the limit is hit, older turns are summarized by the LLM — no hard context cliff.

Persistent memory: Important facts, preferences, and decisions are auto-extracted and stored to disk (~/.darksol/memory/). Your agent learns over time.

# View recent memories
darksol memory show --limit 20

# Search memories
darksol memory search "slippage preference"

# Export / clear
darksol memory export my-memories.json
darksol memory clear

🧠 AI Trading Assistant

Natural language trading powered by multi-provider LLM support — now with soul personality and memory context.

# 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, NVIDIA NIM, Bankr LLM Gateway, MiniMax, 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, NVIDIA NIM, Bankr LLM Gateway, MiniMax, 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).

🔍 Token Scanner

Scan any ERC-20 token for security red flags before trading.

# Full scan on Base (default)
darksol scan 0x1234...5678

# Scan on a specific chain
darksol scan 0x1234...5678 --chain ethereum

# Quick scan (skip honeypot simulation)
darksol scan 0x1234...5678 --quick

# JSON output for automation
darksol scan 0x1234...5678 --json

8 security checks:

Contract Verification — is source code verified on the block explorer?
Ownership Status — is ownership renounced or still active?
Honeypot Detection — simulates buy+sell via Uniswap V3 Quoter
Liquidity Analysis — finds Uniswap V3 pools, estimates USD depth
Holder Concentration — top holder analysis, flags concentrated supply
Proxy Detection — checks for EIP-1967 upgradeable proxy pattern
Mint Function — scans bytecode for mint capability
Token Info — name, symbol, decimals, total supply, deployer

Risk levels: LOW / MEDIUM / HIGH / CRITICAL with actionable recommendations.

AI integration: Ask "is this token safe?" or "scan 0x..." in darksol chat.

Chains: Base, Ethereum, Arbitrum, Optimism, Polygon.

💰 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, darksol-agentcomms, random-oracle, the-clawsino

🎲 Services

# Oracle — on-chain randomness (x402, $0.05 USDC on Base)
darksol oracle flip                        # coin flip
darksol oracle dice 20                     # roll a d20
darksol oracle number 1 100               # random integer in range
darksol oracle shuffle A B C D            # random shuffle
darksol oracle health                     # check oracle status + signer

# 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                     # browse available card providers
darksol cards order swype 50 --email you@example.com  # order a $50 card
darksol cards status <trade_id>           # check order status

# AgentComms — x402 SMS rails for autonomous agents
darksol agentcomms health                 # service status
darksol agentcomms countries              # available disposable-number countries
darksol agentcomms buy --country US       # request a disposable number
darksol agentcomms messages <number_id>   # check incoming SMS
darksol sms premium-search --area-code 317 # durable-line inventory shortcut

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

Install the skill: darksol skills install darksol-terminal
Start the agent signer: darksol agent start my-wallet
Run commands non-interactively with flags (-p, -y, --key)
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. 🌑