perp-cli 0.6.4 → 0.7.2

package/dist/bot/strategy-registry.js

@@ -0,0 +1,14 @@
+/**
+ * Strategy registry for bot engine.
+ * Strategies register here — engine uses registry to resolve by name.
+ */
+const registry = new Map();
+export function registerStrategy(name, factory) {
+    registry.set(name.toLowerCase(), factory);
+}
+export function getStrategy(name) {
+    return registry.get(name.toLowerCase());
+}
+export function listStrategies() {
+    return [...registry.keys()];
+}

package/dist/bot/strategy-types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Strategy interface for Bot Engine v2.
+ * All trading strategies implement this interface.
+ */
+import type { ExchangeAdapter, ExchangeKline } from "../exchanges/index.js";
+import type { MarketSnapshot } from "./conditions.js";
+export interface EnrichedSnapshot extends MarketSnapshot {
+    klines: ExchangeKline[];
+    orderbook: {
+        bids: [string, string][];
+        asks: [string, string][];
+    };
+    openInterest: string;
+}
+export type StrategyAction = {
+    type: "place_order";
+    side: "buy" | "sell";
+    price: string;
+    size: string;
+    orderType: "limit" | "market";
+    reduceOnly?: boolean;
+    tif?: string;
+} | {
+    type: "cancel_order";
+    orderId: string;
+} | {
+    type: "cancel_all";
+} | {
+    type: "edit_order";
+    orderId: string;
+    price: string;
+    size: string;
+} | {
+    type: "set_leverage";
+    leverage: number;
+    marginMode?: "cross" | "isolated";
+} | {
+    type: "noop";
+};
+export interface StrategyContext {
+    adapter: ExchangeAdapter;
+    symbol: string;
+    config: Record<string, unknown>;
+    state: Map<string, unknown>;
+    tick: number;
+    log: (msg: string) => void;
+}
+export interface ParamDef {
+    name: string;
+    type: "number" | "string" | "boolean";
+    required: boolean;
+    default?: unknown;
+    description: string;
+}
+export interface Strategy {
+    readonly name: string;
+    describe(): {
+        description: string;
+        params: ParamDef[];
+    };
+    init(ctx: StrategyContext, snapshot: EnrichedSnapshot): Promise<void>;
+    onTick(ctx: StrategyContext, snapshot: EnrichedSnapshot): Promise<StrategyAction[]>;
+    onStop(ctx: StrategyContext): Promise<StrategyAction[]>;
+}

package/dist/bot/strategy-types.js

@@ -0,0 +1,5 @@
+/**
+ * Strategy interface for Bot Engine v2.
+ * All trading strategies implement this interface.
+ */
+export {};

package/dist/bot/trade-journal.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Trade journal: JSONL-based persistent trade log
+ * Stores: { timestamp, strategy, symbol, side, size, price, pnl, fees, holdingPeriod }
+ * Location: ~/.perp/trade-journal.jsonl
+ */
+export interface JournalEntry {
+    timestamp: number;
+    strategy: string;
+    symbol: string;
+    exchange: string;
+    side: "buy" | "sell";
+    size: string;
+    entryPrice: string;
+    exitPrice?: string;
+    pnl?: number;
+    fees?: number;
+    holdingPeriodMs?: number;
+    tags?: string[];
+}
+export declare function appendJournal(entry: JournalEntry): void;
+export declare function readJournal(filter?: {
+    strategy?: string;
+    symbol?: string;
+    from?: number;
+    to?: number;
+}): JournalEntry[];
+export declare function clearJournal(): void;

package/dist/bot/trade-journal.js

@@ -0,0 +1,53 @@
+/**
+ * Trade journal: JSONL-based persistent trade log
+ * Stores: { timestamp, strategy, symbol, side, size, price, pnl, fees, holdingPeriod }
+ * Location: ~/.perp/trade-journal.jsonl
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync, unlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
+function journalPath() {
+    return join(homedir(), ".perp", "trade-journal.jsonl");
+}
+function ensureDir(filePath) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+export function appendJournal(entry) {
+    const path = journalPath();
+    ensureDir(path);
+    appendFileSync(path, JSON.stringify(entry) + "\n", "utf-8");
+}
+export function readJournal(filter) {
+    const path = journalPath();
+    if (!existsSync(path))
+        return [];
+    const lines = readFileSync(path, "utf-8").split("\n").filter(Boolean);
+    const entries = [];
+    for (const line of lines) {
+        try {
+            const entry = JSON.parse(line);
+            if (filter?.strategy && entry.strategy !== filter.strategy)
+                continue;
+            if (filter?.symbol && entry.symbol !== filter.symbol)
+                continue;
+            if (filter?.from !== undefined && entry.timestamp < filter.from)
+                continue;
+            if (filter?.to !== undefined && entry.timestamp > filter.to)
+                continue;
+            entries.push(entry);
+        }
+        catch {
+            // skip malformed lines
+        }
+    }
+    return entries;
+}
+export function clearJournal() {
+    const path = journalPath();
+    if (existsSync(path)) {
+        unlinkSync(path);
+    }
+}

package/dist/bot/tui/BotDashboard.d.ts

@@ -0,0 +1,56 @@
+export interface ExchangeBalance {
+    exchange: string;
+    equity: string;
+    available: string;
+}
+export interface BotTuiState {
+    phase: string;
+    equity: number;
+    peakEquity: number;
+    dailyPnl: number;
+    fills: number;
+    totalPnl: number;
+    runtime: number;
+    strategy: string;
+    symbol: string;
+    exchange: string;
+    price: number;
+    volume24h: number;
+    openInterest: string;
+    fundingRate: number;
+    volatility24h: number;
+    positions: Position[];
+    openOrders: OpenOrder[];
+    strategyState: Record<string, unknown>;
+    tick: number;
+    exchangeBalances?: ExchangeBalance[];
+}
+export interface Position {
+    symbol: string;
+    side: string;
+    size: string;
+    entryPrice: string;
+    markPrice: string;
+    unrealizedPnl: string;
+    exchange?: string;
+}
+export interface OpenOrder {
+    orderId: string;
+    side: string;
+    price: string;
+    size: string;
+    type: string;
+}
+export interface LogEntry {
+    time: string;
+    message: string;
+}
+export type StateListener = (state: BotTuiState) => void;
+export type LogListener = (entry: LogEntry) => void;
+export interface DashboardProps {
+    initialState: BotTuiState;
+    onQuit: () => void;
+    onPause: () => void;
+    subscribe: (onState: StateListener, onLog: LogListener) => () => void;
+}
+export declare function BotDashboard({ initialState, onQuit, onPause, subscribe }: DashboardProps): import("react/jsx-runtime").JSX.Element;

package/dist/bot/tui/BotDashboard.js

@@ -0,0 +1,94 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useState, useEffect, useCallback } from "react";
+import { Box, Text, useApp, useInput } from "ink";
+// ── Helpers ──
+function formatDuration(sec) {
+    if (sec < 60)
+        return `${sec}s`;
+    const m = Math.floor(sec / 60);
+    if (m < 60)
+        return `${m}m${sec % 60}s`;
+    const h = Math.floor(m / 60);
+    return `${h}h${m % 60}m`;
+}
+function pnlColor(val) {
+    if (val > 0)
+        return "green";
+    if (val < 0)
+        return "red";
+    return "white";
+}
+function phaseIndicator(phase) {
+    switch (phase) {
+        case "monitoring": return "[ MONITORING ]";
+        case "entering": return "[  ENTERING  ]";
+        case "running": return "[   RUNNING   ]";
+        case "exiting": return "[   EXITING   ]";
+        case "paused": return "[   PAUSED   ]";
+        case "stopped": return "[  STOPPED   ]";
+        default: return `[ ${phase.toUpperCase()} ]`;
+    }
+}
+function phaseColor(phase) {
+    switch (phase) {
+        case "monitoring": return "cyan";
+        case "entering": return "yellow";
+        case "running": return "green";
+        case "exiting": return "yellow";
+        case "paused": return "gray";
+        case "stopped": return "red";
+        default: return "cyan";
+    }
+}
+const MAX_LOG_LINES = 15;
+// ── Component ──
+export function BotDashboard({ initialState, onQuit, onPause, subscribe }) {
+    const { exit } = useApp();
+    const [state, setState] = useState(initialState);
+    const [logs, setLogs] = useState([]);
+    const [paused, setPaused] = useState(false);
+    useEffect(() => {
+        const unsubscribe = subscribe((newState) => setState(newState), (entry) => setLogs((prev) => [...prev.slice(-(MAX_LOG_LINES - 1)), entry]));
+        return unsubscribe;
+    }, [subscribe]);
+    const handleQuit = useCallback(() => {
+        onQuit();
+        exit();
+    }, [onQuit, exit]);
+    useInput((input, key) => {
+        if (input === "q" || (key.ctrl && input === "c")) {
+            handleQuit();
+        }
+        if (input === "p") {
+            setPaused((v) => !v);
+            onPause();
+        }
+    });
+    const drawdown = state.peakEquity - state.equity;
+    const drawdownPct = state.peakEquity > 0 ? (drawdown / state.peakEquity) * 100 : 0;
+    const bidOrders = state.openOrders.filter((o) => o.side.toLowerCase() === "buy");
+    const askOrders = state.openOrders.filter((o) => o.side.toLowerCase() === "sell");
+    const hasMultiExchange = (state.exchangeBalances?.length ?? 0) > 1;
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsxs(Box, { flexDirection: "row", justifyContent: "space-between", marginBottom: 1, children: [_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, color: "cyan", children: [state.strategy, " | ", state.symbol, " | ", state.exchange] }), _jsxs(Text, { color: "gray", children: ["Runtime: ", formatDuration(state.runtime), " | Tick: ", state.tick] })] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: phaseColor(state.phase), children: phaseIndicator(state.phase) }) })] }), _jsxs(Box, { borderStyle: "single", borderColor: "gray", paddingX: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs(Text, { children: ["Price: ", _jsxs(Text, { bold: true, color: "white", children: ["$", state.price.toFixed(2)] })] }), _jsxs(Text, { color: "gray", children: ["Vol24h: ", _jsxs(Text, { color: "white", children: [state.volatility24h.toFixed(1), "%"] })] }), _jsxs(Text, { color: "gray", children: ["FR: ", _jsxs(Text, { color: state.fundingRate >= 0 ? "green" : "red", children: [(state.fundingRate * 100).toFixed(4), "%"] })] }), _jsxs(Text, { color: "gray", children: ["OI: ", _jsx(Text, { color: "white", children: state.openInterest })] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "cyan", bold: true, children: "Account" }), _jsxs(Text, { children: ["Equity: ", _jsxs(Text, { bold: true, color: "white", children: ["$", state.equity.toFixed(2)] }), _jsxs(Text, { color: "gray", children: [" (peak: $", state.peakEquity.toFixed(2), ")"] })] }), _jsxs(Text, { children: ["Daily P&L: ", _jsxs(Text, { bold: true, color: pnlColor(state.dailyPnl), children: ["$", state.dailyPnl.toFixed(2)] })] })] }), _jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: " " }), _jsxs(Text, { children: ["Drawdown: ", _jsxs(Text, { bold: true, color: drawdown > 0 ? "red" : "green", children: ["$", drawdown.toFixed(2), " (", drawdownPct.toFixed(1), "%)"] })] }), _jsxs(Text, { children: ["Fills: ", _jsx(Text, { bold: true, color: "white", children: state.fills }), _jsx(Text, { color: "gray", children: " | Total P&L: " }), _jsxs(Text, { bold: true, color: pnlColor(state.totalPnl), children: ["$", state.totalPnl.toFixed(2)] })] })] })] }), state.exchangeBalances && state.exchangeBalances.length > 1 && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: "cyan", bold: true, children: "Exchange Balances" }), _jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { color: "gray", children: pad("Exchange", 16) }), _jsx(Text, { color: "gray", children: pad("Equity", 14) }), _jsx(Text, { color: "gray", children: "Available" })] }), state.exchangeBalances.map((eb, i) => (_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { color: "white", children: pad(eb.exchange, 16) }), _jsx(Text, { color: "white", children: pad(`$${parseFloat(eb.equity).toFixed(2)}`, 14) }), _jsxs(Text, { color: "gray", children: ["$", parseFloat(eb.available).toFixed(2)] })] }, i)))] })), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: "cyan", bold: true, children: "Positions" }), state.positions.length === 0 ? (_jsx(Text, { color: "gray", children: "  No open positions" })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", children: [hasMultiExchange && _jsx(Text, { color: "gray", children: pad("Exchange", 14) }), _jsx(Text, { color: "gray", children: pad("Symbol", 10) }), _jsx(Text, { color: "gray", children: pad("Side", 6) }), _jsx(Text, { color: "gray", children: pad("Size", 12) }), _jsx(Text, { color: "gray", children: pad("Entry", 12) }), _jsx(Text, { color: "gray", children: pad("Mark", 12) }), _jsx(Text, { color: "gray", children: "uPnL" })] }), state.positions.map((p, i) => {
+                                const upnl = parseFloat(p.unrealizedPnl);
+                                return (_jsxs(Box, { flexDirection: "row", children: [hasMultiExchange && _jsx(Text, { color: "cyan", children: pad(p.exchange ?? "—", 14) }), _jsx(Text, { color: "white", children: pad(p.symbol, 10) }), _jsx(Text, { color: p.side.toLowerCase() === "long" ? "green" : "red", children: pad(p.side, 6) }), _jsx(Text, { color: "white", children: pad(p.size, 12) }), _jsx(Text, { color: "white", children: pad(p.entryPrice, 12) }), _jsx(Text, { color: "white", children: pad(p.markPrice, 12) }), _jsxs(Text, { color: pnlColor(upnl), children: ["$", upnl.toFixed(2)] })] }, i));
+                            })] }))] }), _jsxs(Box, { marginTop: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs(Box, { flexDirection: "column", width: "50%", children: [_jsxs(Text, { color: "green", bold: true, children: ["Bids (", bidOrders.length, ")"] }), bidOrders.length === 0 ? (_jsx(Text, { color: "gray", children: "  --" })) : (bidOrders.slice(0, 8).map((o, i) => (_jsxs(Text, { color: "green", children: [pad(o.price, 12), " ", pad(o.size, 10), " ", o.type] }, i))))] }), _jsxs(Box, { flexDirection: "column", width: "50%", children: [_jsxs(Text, { color: "red", bold: true, children: ["Asks (", askOrders.length, ")"] }), askOrders.length === 0 ? (_jsx(Text, { color: "gray", children: "  --" })) : (askOrders.slice(0, 8).map((o, i) => (_jsxs(Text, { color: "red", children: [pad(o.price, 12), " ", pad(o.size, 10), " ", o.type] }, i))))] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: "cyan", bold: true, children: "Strategy State" }), _jsxs(Box, { flexDirection: "row", flexWrap: "wrap", children: [Object.entries(state.strategyState).slice(0, 12).map(([k, v]) => (_jsxs(Box, { marginRight: 2, children: [_jsxs(Text, { color: "gray", children: [k, ": "] }), _jsx(Text, { color: "white", children: String(v) })] }, k))), Object.keys(state.strategyState).length === 0 && (_jsx(Text, { color: "gray", children: "  --" }))] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", borderStyle: "single", borderColor: "gray", paddingX: 1, height: MAX_LOG_LINES + 2, children: [_jsx(Text, { color: "cyan", bold: true, children: "Log" }), logs.length === 0 ? (_jsx(Text, { color: "gray", children: "  Waiting for events..." })) : (logs.map((entry, i) => (_jsxs(Text, { children: [_jsxs(Text, { color: "gray", children: [entry.time, " "] }), _jsx(Text, { children: colorizeLog(entry.message) })] }, i))))] }), _jsx(Box, { marginTop: 1, flexDirection: "row", justifyContent: "center", children: _jsxs(Text, { color: "gray", children: ["[", _jsx(Text, { color: "white", bold: true, children: "Q" }), "]uit  [", _jsx(Text, { color: "white", bold: true, children: "P" }), "]", paused ? "resume" : "ause"] }) })] }));
+}
+// ── Utility ──
+function pad(s, width) {
+    return s.length >= width ? s.slice(0, width) : s + " ".repeat(width - s.length);
+}
+function colorizeLog(msg) {
+    // Strip ANSI codes for TUI since ink handles colors
+    const clean = msg.replace(/\x1b\[[0-9;]*m/g, "");
+    if (clean.includes("ERROR") || clean.includes("✗") || clean.includes("failed")) {
+        return _jsx(Text, { color: "red", children: clean });
+    }
+    if (clean.includes("WARNING") || clean.includes("⚠")) {
+        return _jsx(Text, { color: "yellow", children: clean });
+    }
+    if (clean.includes("✓") || clean.includes("started") || clean.includes("profit")) {
+        return _jsx(Text, { color: "green", children: clean });
+    }
+    return _jsx(Text, { color: "gray", children: clean });
+}

package/dist/bot/tui/index.d.ts

@@ -0,0 +1,6 @@
+export { BotDashboard } from "./BotDashboard.js";
+export type { BotTuiState, ExchangeBalance, Position, OpenOrder, LogEntry, StateListener, LogListener, DashboardProps } from "./BotDashboard.js";
+import type { DashboardProps } from "./BotDashboard.js";
+export declare function startDashboard(props: DashboardProps): {
+    unmount: () => void;
+};

package/dist/bot/tui/index.js

@@ -0,0 +1,8 @@
+export { BotDashboard } from "./BotDashboard.js";
+import { render } from "ink";
+import React from "react";
+import { BotDashboard } from "./BotDashboard.js";
+export function startDashboard(props) {
+    const { unmount } = render(React.createElement(BotDashboard, props));
+    return { unmount };
+}

package/dist/bridge-engine.d.ts

@@ -77,7 +77,6 @@ export declare function getDebridgeQuote(srcChain: string, dstChain: string, amo
  */
 export declare function executeDebridgeBridge(bridgeQuote: BridgeQuote, signerKey: string): Promise<BridgeResult>;
 export declare const CCTP_DOMAINS: Record<string, number>;
-export declare const EVM_TOKEN_MINTER_V2 = "0xfd78EE919681417d192449715b2594ab58f5D002";
 /**
  * Get a CCTP V2 bridge quote. Supports EVM ↔ EVM, Solana ↔ EVM, and → HyperCore.
  *

package/dist/bridge-engine.js

@@ -433,7 +433,6 @@ export const CCTP_DOMAINS = {
 // EVM V2 contracts — ALL EVM chains use the same V2 proxy addresses (per Circle docs)
 const EVM_TOKEN_MESSENGER_V2 = "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d";
 const EVM_MESSAGE_TRANSMITTER_V2 = "0x81D40F21F12A8F0E3252Bccb954D722d4c464B64";
-export const EVM_TOKEN_MINTER_V2 = "0xfd78EE919681417d192449715b2594ab58f5D002";
 // Populate per-chain lookups (all EVM chains share identical V2 addresses)
 const EVM_CCTP_CHAINS = Object.keys(CCTP_DOMAINS).filter(c => c !== "solana");
 const CCTP_TOKEN_MESSENGER = Object.fromEntries(EVM_CCTP_CHAINS.map(c => [c, EVM_TOKEN_MESSENGER_V2]));

package/dist/cache.d.ts

@@ -6,7 +6,6 @@
  */
 export declare const TTL_ACCOUNT = 5000;
 export declare const TTL_MARKET = 30000;
-export declare const TTL_META = 300000;
 export declare function getCached<T>(key: string): T | null;
 export declare function setCached<T>(key: string, data: T, ttlMs: number): void;
 /**

package/dist/cache.js

@@ -11,7 +11,6 @@ const CACHE_DIR = join(tmpdir(), "perp-cli-cache");
 // TTL presets
 export const TTL_ACCOUNT = 5_000; // 5s — balance, positions, orders
 export const TTL_MARKET = 30_000; // 30s — funding rates, prices, markets
-export const TTL_META = 300_000; // 5min — dex universe, static metadata
 let dirReady = false;
 function ensureDir() {
     if (dirReady)

package/dist/commands/account.d.ts

@@ -1,3 +1,3 @@
 import { Command } from "commander";
-import type { ExchangeAdapter } from "../exchanges/interface.js";
+import type { ExchangeAdapter } from "../exchanges/index.js";
 export declare function registerAccountCommands(program: Command, getAdapter: () => Promise<ExchangeAdapter>, isJson: () => boolean, getAdapterForExchange?: (exchange: string) => Promise<ExchangeAdapter>): void;