@darksol/terminal 0.5.5 → 0.5.6

package/package.json

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

package/src/llm/intent.js

@@ -9,17 +9,36 @@ import { showSection } from '../ui/banner.js';
 // INTENT SYSTEM PROMPT
 // ──────────────────────────────────────────────────
 
-const INTENT_SYSTEM_PROMPT = `You are DARKSOL Terminal's trading AI assistant. You help users execute trades, send/receive tokens, analyze markets, manage DCA strategies, and navigate the DARKSOL ecosystem.
+const INTENT_SYSTEM_PROMPT = `You are DARKSOL Terminal's trading AI assistant. You help users execute trades, send/receive tokens, analyze markets, manage DCA strategies, order prepaid cards, and navigate the DARKSOL ecosystem.
+
+You are embedded in a CLI/web terminal. Your responses become actions — when you output structured JSON, the terminal executes real on-chain transactions, card orders, and wallet operations. Be precise. Be careful. Real money is at stake.
 
 CAPABILITIES:
-- Parse natural language into structured trade/transfer commands
+- Parse natural language into structured trade/transfer/card-order commands
+- Execute swaps via Uniswap V3 (Base SwapRouter02, V1 on ETH/Arb/OP/Polygon)
+- Send ETH and ERC-20 tokens to any address
+- Snipe tokens via Uniswap V2 (Base, Ethereum)
+- Order prepaid Visa/Mastercard cards with crypto (via Trocador)
 - Analyze token prices, liquidity, and market conditions
 - Suggest DCA strategies based on user goals
 - Explain transaction results and gas costs
 - Warn about risks (low liquidity, high slippage, unverified contracts)
 
 SUPPORTED CHAINS: Base (default), Ethereum, Polygon, Arbitrum, Optimism
-KNOWN TOKENS: ETH, USDC, USDT, DAI, WETH, AERO, VIRTUAL, ARB, OP, WMATIC
+KNOWN TOKENS PER CHAIN:
+- Base: ETH, WETH, USDC, USDbC, DAI, AERO, VIRTUAL
+- Ethereum: ETH, WETH, USDC, USDT, DAI
+- Arbitrum: ETH, WETH, USDC, USDT, ARB
+- Optimism: ETH, WETH, USDC, OP
+- Polygon: MATIC/POL (native), WETH, WMATIC, USDC, USDT
+
+WEB3 KNOWLEDGE:
+- Uniswap V3 uses fee tiers: 500 (0.05%), 3000 (0.3%), 10000 (1%). Default: 3000.
+- Slippage protection: Quoter V2 gets expected output, then applies tolerance (default 0.5%).
+- Token approvals: ERC-20 tokens need approval before swapping (approve → swap is 2 TXs).
+- Gas: Base is very cheap (~$0.01-0.05/TX), Ethereum is expensive ($2-20+/TX).
+- Never send ETH/tokens to a contract address unless you know what you're doing.
+- Always verify contract addresses — don't guess or hallucinate them.
 
 USER CONTEXT:
 - Active chain: {{chain}}
@@ -50,15 +69,25 @@ ACTIONS (use the most specific one):
 
 CARDS ORDERING:
 When the user wants to order a prepaid card, you MUST collect:
-1. amount (USD denomination: 10, 25, 50, 100, 250, 500, 1000)
-2. email (delivery address for the card activation link)
-3. provider (default: "swype" for global, "mpc" or "reward" for US-only)
-4. ticker (payment crypto, default: "usdc")
-
-If the user says "order me a $50 card" but doesn't provide an email, set "needsInfo": ["email"] and ask naturally.
-If they have AgentMail configured, suggest using their agent email as an option.
-Providers: swype (Mastercard, Global), mpc (Mastercard, US), reward (Visa, US).
-Accepted crypto: usdc (default), usdt, btc, eth, sol, xmr.
+1. amount — ONLY these denominations: $10, $25, $50, $100, $250, $500, $1000
+2. email — delivery address for the card activation link
+3. provider — default "swype" (Global Mastercard). Also: "mpc" (US Mastercard), "reward" (US Visa)
+4. ticker — payment crypto, default "usdc"
+
+VERIFIED PAYMENT METHODS (ONLY these work — reject anything else):
+- usdc on base (DEFAULT — cheapest, fastest)
+- usdc on ERC20 (Ethereum — higher gas)
+- usdt on trc20 (Tron — cheap)
+- btc on Mainnet (Bitcoin)
+- eth on ERC20 (Ethereum)
+- sol on Mainnet (Solana)
+- xmr on Mainnet (Monero)
+
+⚠ DO NOT accept: eth/base, sol/sol, usdc/polygon, usdt/eth, or any combo not listed above.
+If the user asks for an unsupported combo (like "pay with ETH on Base"), tell them it's not available and suggest alternatives.
+
+If the user says "order me a $50 card" but doesn't provide an email, set "needsInfo": ["email"] and ask: "What email should I send the card activation link to?"
+If they mention AgentMail or "my email", suggest using their configured agent email.
 
 When parsing, respond with ONLY valid JSON:
 {
@@ -87,6 +116,27 @@ CONVERSATIONAL RULES:
 - Be conversational — "What email should I send the card to?" not "Error: email required"
 - If they mention AgentMail or "my email", suggest using their configured agent email
 - For cards without a specified provider, default to "swype" (global Mastercard)
+- For swaps without a specified chain, use the user's active chain ({{chain}})
+- Never hallucinate contract addresses — if you don't know it, say so
+- When a user asks "how do I..." give them the exact darksol CLI command
+
+AGENT/TOOL-USE BEHAVIOR:
+When an AI agent (like OpenClaw) is using this terminal programmatically:
+- Always return structured JSON for actionable intents
+- Include the exact "command" field so the agent can run it
+- Include "warnings" for anything risky (high value, unverified token, etc.)
+- If confidence < 0.6, ask for clarification rather than guessing
+- For card orders: validate amount is in [10,25,50,100,250,500,1000] and ticker is verified
+- For swaps: validate both tokens are known symbols or valid 0x addresses
+- For sends: validate "to" looks like a valid address (0x + 40 hex chars)
+
+ERROR GUIDANCE:
+When something fails, help the user fix it:
+- "CALL_EXCEPTION" → likely an RPC issue, suggest switching RPCs
+- "insufficient funds" → tell them their balance, suggest a lower amount
+- "coin not found" → the crypto/network combo isn't supported, list what works
+- "nonce" → pending transaction, wait and retry
+- Don't just say "error" — explain what went wrong and what to do next
 
 COMMAND MAPPING:
 - swap → darksol trade swap -i <tokenIn> -o <tokenOut> -a <amount>

package/src/services/cards.js

@@ -6,40 +6,80 @@ import { showSection } from '../ui/banner.js';
 
 const BASE = () => getServiceURL('cards') || 'https://acp.darksol.net';
 
-// Verified working ticker/network combos (tested against Trocador API)
-const VALID_CRYPTO = {
-  'usdc':  { network: 'base', display: 'USDC on Base' },
-  'usdc_base': { ticker: 'usdc', network: 'base', display: 'USDC on Base' },
-  'usdc_erc20': { ticker: 'usdc', network: 'ERC20', display: 'USDC on Ethereum' },
-  'usdt':  { network: 'trc20', display: 'USDT on Tron' },
-  'usdt_trc20': { ticker: 'usdt', network: 'trc20', display: 'USDT on Tron' },
-  'btc':   { network: 'Mainnet', display: 'Bitcoin' },
-  'eth':   { network: 'ERC20', display: 'ETH on Ethereum' },
-  'sol':   { network: 'Mainnet', display: 'Solana' },
-  'xmr':   { network: 'Mainnet', display: 'Monero' },
+// ══════════════════════════════════════════════════
+// VERIFIED CRYPTO COMBOS (tested against Trocador API 2026-03-09)
+// Only these combos are allowed — everything else is rejected before hitting the API
+// ══════════════════════════════════════════════════
+const VERIFIED_COMBOS = [
+  { ticker: 'usdc', network: 'base',    display: 'USDC on Base',     default: true },
+  { ticker: 'usdc', network: 'ERC20',   display: 'USDC on Ethereum' },
+  { ticker: 'usdt', network: 'trc20',   display: 'USDT on Tron (TRC-20)' },
+  { ticker: 'btc',  network: 'Mainnet', display: 'Bitcoin (BTC)' },
+  { ticker: 'eth',  network: 'ERC20',   display: 'Ethereum (ETH)' },
+  { ticker: 'sol',  network: 'Mainnet', display: 'Solana (SOL)' },
+  { ticker: 'xmr',  network: 'Mainnet', display: 'Monero (XMR)' },
+];
+
+// Aliases: what users might type → what Trocador expects
+const TICKER_ALIASES = {
+  'ethereum': 'eth', 'ether': 'eth',
+  'bitcoin': 'btc',
+  'solana': 'sol',
+  'monero': 'xmr',
+  'tether': 'usdt',
+  'usd coin': 'usdc', 'usd-c': 'usdc',
 };
 
-// Map user-friendly network names to Trocador-compatible ones
-const NETWORK_MAP = {
+const NETWORK_ALIASES = {
   'base': 'base',
-  'ethereum': 'ERC20', 'eth': 'ERC20', 'erc20': 'ERC20',
-  'tron': 'trc20', 'trc20': 'trc20',
-  'mainnet': 'Mainnet', 'btc': 'Mainnet', 'sol': 'Mainnet', 'xmr': 'Mainnet',
+  'ethereum': 'ERC20', 'eth': 'ERC20', 'erc20': 'ERC20', 'erc-20': 'ERC20',
+  'tron': 'trc20', 'trc20': 'trc20', 'trc-20': 'trc20',
+  'mainnet': 'Mainnet', 'main': 'Mainnet',
 };
 
+const VALID_AMOUNTS = [10, 25, 50, 100, 250, 500, 1000];
+
+/**
+ * Resolve user input to a verified ticker/network combo.
+ * Returns { ticker, network, display } or null if invalid.
+ */
 function resolveTickerNetwork(ticker, network) {
-  const t = (ticker || '').toLowerCase();
-  const n = (network || '').toLowerCase();
+  const t = TICKER_ALIASES[(ticker || '').toLowerCase()] || (ticker || '').toLowerCase();
 
-  // If just ticker provided, use known defaults
-  if (t && !n) {
-    const known = VALID_CRYPTO[t];
-    if (known) return { ticker: known.ticker || t, network: known.network };
+  // If network specified, try to match exactly
+  if (network) {
+    const n = NETWORK_ALIASES[(network || '').toLowerCase()] || network;
+    const match = VERIFIED_COMBOS.find(c => c.ticker === t && c.network === n);
+    if (match) return match;
+    // Try just the ticker with its default network
   }
 
-  // Map network to Trocador format
-  const mappedNetwork = NETWORK_MAP[n] || network;
-  return { ticker: t, network: mappedNetwork };
+  // Just ticker — find the verified default for it
+  const match = VERIFIED_COMBOS.find(c => c.ticker === t);
+  if (match) return match;
+
+  return null; // Not a verified combo
+}
+
+/**
+ * Get all verified combos (for menus / agent listings)
+ */
+export function getVerifiedCombos() {
+  return VERIFIED_COMBOS;
+}
+
+/**
+ * Get the default combo
+ */
+export function getDefaultCombo() {
+  return VERIFIED_COMBOS.find(c => c.default) || VERIFIED_COMBOS[0];
+}
+
+/**
+ * Get valid amounts
+ */
+export function getValidAmounts() {
+  return VALID_AMOUNTS;
 }
 
 export async function cardsCatalog() {
@@ -87,19 +127,40 @@ export async function cardsOrder(provider, amount, opts = {}) {
     return;
   }
 
+  // Validate amount
+  const numAmount = Number(amount);
+  if (!VALID_AMOUNTS.includes(numAmount)) {
+    error(`Invalid card amount: $${amount}. Valid amounts: ${VALID_AMOUNTS.map(a => '$' + a).join(', ')}`);
+    return;
+  }
+
+  // Validate provider
+  const validProviders = ['swype', 'mpc', 'reward'];
+  if (!validProviders.includes((provider || '').toLowerCase())) {
+    error(`Invalid provider: ${provider}. Options: swype (Global MC), mpc (US MC), reward (US Visa)`);
+    return;
+  }
+
   const spin = spinner('Processing card order...').start();
   try {
     const body = {
-      provider,
-      amount: Number(amount),
+      provider: provider.toLowerCase(),
+      amount: numAmount,
       email: opts.email,
     };
-    // Resolve ticker/network to Trocador-compatible values
+
+    // Resolve and validate crypto
     if (opts.ticker) {
       const resolved = resolveTickerNetwork(opts.ticker, opts.network);
+      if (!resolved) {
+        spin.fail('Invalid payment method');
+        error(`"${opts.ticker}${opts.network ? '/' + opts.network : ''}" is not a supported payment option.`);
+        info('Supported: ' + VERIFIED_COMBOS.map(c => c.display).join(', '));
+        return;
+      }
       body.tickerFrom = resolved.ticker;
       body.networkFrom = resolved.network;
-      info(`Payment: ${resolved.ticker.toUpperCase()} on ${resolved.network}`);
+      info(`Payment: ${resolved.display}`);
     }
 
     const data = await fetchJSON(`${BASE()}/api/cards/order`, {

package/src/web/commands.js

@@ -215,9 +215,12 @@ export async function handleMenuSelect(id, value, item, ws) {
 
     case 'cards_crypto':
       if (value === 'back') return {};
-      // Execute the order
+      // Execute the order with verified combo
       return await executeCardOrder(item?.meta || {}, ws);
 
+    case 'cards_status_check':
+      return await showCardStatus(value, ws);
+
     case 'agent_action':
       if (value === 'start') {
         const { listWallets } = await import('../wallet/keystore.js');