@raintree-technology/perps 0.1.0

package/dist/commands/ui/terminal.js

@@ -0,0 +1,255 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from "react";
+import { Box, Text, render, useApp, useInput } from "ink";
+import { getContext, getOutputOptions, getSelectedExchange } from "../../cli/program.js";
+import { output, outputError } from "../../cli/output.js";
+import { AppShell, MetricStrip, Panel, Table, colors, toBar, } from "../../cli/ink/index.js";
+import { getExchangeAdapter } from "../../lib/exchange.js";
+import { getExchangeCredentials } from "../../lib/config.js";
+import { parsePositiveInt } from "../../lib/validate.js";
+import { withJsonContract } from "../../lib/contracts.js";
+const DEFAULT_INTERVAL_MS = 1_500;
+const MIN_INTERVAL_MS = 200;
+const ROW_LIMIT = 12;
+function toFiniteNumber(input) {
+    const parsed = Number.parseFloat(input);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+function formatCurrency(value, decimals = 2) {
+    return value.toLocaleString("en-US", {
+        minimumFractionDigits: decimals,
+        maximumFractionDigits: decimals,
+    });
+}
+function rowSignal(changePct, fundingPct) {
+    if (changePct > 1 && fundingPct < 0.025)
+        return "LONG";
+    if (changePct < -1 && fundingPct > -0.025)
+        return "SHORT";
+    return "FLAT";
+}
+function signalColor(signal) {
+    if (signal === "LONG")
+        return colors.profit;
+    if (signal === "SHORT")
+        return colors.loss;
+    return colors.muted;
+}
+function parseTickerRow(ticker) {
+    const price = toFiniteNumber(ticker.markPrice) ?? toFiniteNumber(ticker.lastPrice);
+    if (!price || price <= 0) {
+        return null;
+    }
+    const changePct = toFiniteNumber(ticker.change24h) ?? 0;
+    const fundingRate = toFiniteNumber(ticker.fundingRate) ?? 0;
+    const volume24h = toFiniteNumber(ticker.volume24h) ?? 0;
+    const bid = toFiniteNumber(ticker.bid);
+    const ask = toFiniteNumber(ticker.ask);
+    const spreadBps = bid && ask && bid > 0 && ask > 0 ? ((ask - bid) / ((ask + bid) / 2)) * 10_000 : null;
+    const fundingPct = fundingRate * 100;
+    return {
+        market: ticker.market,
+        price,
+        changePct,
+        fundingPct,
+        volumeM: volume24h / 1_000_000,
+        spreadBps,
+        signal: rowSignal(changePct, fundingPct),
+    };
+}
+function sortRows(rows) {
+    return rows
+        .sort((left, right) => right.volumeM - left.volumeM)
+        .slice(0, ROW_LIMIT);
+}
+function TerminalDashboard({ intervalMs, exchangeId, networkLabel, pollSnapshot, }) {
+    const [state, setState] = useState({
+        startedAt: Date.now(),
+        rows: [],
+        latencyMs: 0,
+        lastUpdated: null,
+        polls: 0,
+        lastError: null,
+    });
+    const { exit } = useApp();
+    useInput((input, key) => {
+        if (input.toLowerCase() === "q" || key.escape || (key.ctrl && input.toLowerCase() === "c")) {
+            exit();
+        }
+    });
+    useEffect(() => {
+        let cancelled = false;
+        const poll = async () => {
+            try {
+                const snapshot = await pollSnapshot();
+                if (cancelled)
+                    return;
+                setState((previous) => ({
+                    ...previous,
+                    rows: snapshot.rows,
+                    latencyMs: snapshot.latencyMs,
+                    lastUpdated: snapshot.updatedAt,
+                    polls: previous.polls + 1,
+                    lastError: null,
+                }));
+            }
+            catch (err) {
+                if (cancelled)
+                    return;
+                const message = err instanceof Error ? err.message : String(err);
+                setState((previous) => ({
+                    ...previous,
+                    polls: previous.polls + 1,
+                    lastError: message,
+                }));
+            }
+        };
+        void poll();
+        const timer = setInterval(() => {
+            void poll();
+        }, intervalMs);
+        return () => {
+            cancelled = true;
+            clearInterval(timer);
+        };
+    }, [intervalMs, pollSnapshot]);
+    const uptimeSec = Math.floor((Date.now() - state.startedAt) / 1_000);
+    const activeSignals = state.rows.filter((row) => row.signal !== "FLAT").length;
+    const metrics = [
+        { label: "Exchange", value: exchangeId, tone: "neutral" },
+        { label: "Network", value: networkLabel, tone: networkLabel === "testnet" ? "warning" : "info" },
+        { label: "Markets", value: String(state.rows.length), tone: "neutral" },
+        { label: "Signals", value: String(activeSignals), tone: activeSignals > 0 ? "info" : "neutral" },
+        {
+            label: "Latency",
+            value: state.latencyMs > 0 ? `${state.latencyMs}ms` : "--",
+            tone: state.latencyMs > 1_800 ? "danger" : state.latencyMs > 900 ? "warning" : "success",
+        },
+        { label: "Uptime", value: `${uptimeSec}s`, tone: "neutral" },
+    ];
+    const columns = useMemo(() => [
+        { key: "market", header: "Market" },
+        {
+            key: "price",
+            header: "Price",
+            align: "right",
+            render: (value) => _jsxs(Text, { children: ["$", formatCurrency(value)] }),
+        },
+        {
+            key: "changePct",
+            header: "24h %",
+            align: "right",
+            render: (value) => {
+                const change = value;
+                const sign = change >= 0 ? "+" : "";
+                return (_jsxs(Text, { color: change >= 0 ? colors.profit : colors.loss, children: [sign, change.toFixed(2), "%"] }));
+            },
+        },
+        {
+            key: "fundingPct",
+            header: "Funding",
+            align: "right",
+            render: (value) => {
+                const funding = value;
+                const sign = funding >= 0 ? "+" : "";
+                return (_jsxs(Text, { color: funding >= 0 ? colors.profit : colors.loss, children: [sign, funding.toFixed(4), "%"] }));
+            },
+        },
+        {
+            key: "volumeM",
+            header: "Vol(M)",
+            align: "right",
+            render: (value) => _jsx(Text, { children: formatCurrency(value, 1) }),
+        },
+        {
+            key: "spreadBps",
+            header: "Spread(bps)",
+            align: "right",
+            render: (value) => {
+                const spread = value;
+                if (spread === null) {
+                    return _jsx(Text, { color: colors.muted, children: "--" });
+                }
+                return _jsx(Text, { children: spread.toFixed(2) });
+            },
+        },
+        {
+            key: "signal",
+            header: "Signal",
+            align: "right",
+            render: (value) => {
+                const signal = value;
+                return _jsx(Text, { color: signalColor(signal), children: signal });
+            },
+        },
+    ], []);
+    const movers = useMemo(() => [...state.rows]
+        .sort((left, right) => Math.abs(right.changePct) - Math.abs(left.changePct))
+        .slice(0, 3), [state.rows]);
+    const maxMove = Math.max(1, ...movers.map((row) => Math.abs(row.changePct)));
+    return (_jsxs(AppShell, { title: "Perps Terminal", subtitle: "Live market tape and signal monitor", status: [
+            { label: "LIVE", tone: "success" },
+            { label: `POLL ${state.polls}`, tone: "neutral" },
+        ], lastUpdated: state.lastUpdated ?? undefined, shortcuts: [
+            { key: "q", label: "quit" },
+            { key: "esc", label: "quit" },
+        ], children: [_jsx(MetricStrip, { metrics: metrics }), _jsx(Box, { flexDirection: "column", marginBottom: 1, children: _jsx(Panel, { title: "Momentum", subtitle: "Top absolute movers from live tape", tone: "info", children: movers.length === 0 ? (_jsx(Text, { color: colors.muted, children: "Waiting for market snapshot..." })) : (movers.map((row) => (_jsxs(Box, { children: [_jsx(Text, { color: colors.muted, children: row.market.padEnd(10) }), _jsx(Text, { children: " " }), _jsx(Text, { children: toBar(Math.abs(row.changePct), maxMove, 18, row.changePct >= 0 ? "+" : "-", ".") }), _jsxs(Text, { color: row.changePct >= 0 ? colors.profit : colors.loss, children: [" ", row.changePct >= 0 ? "+" : "", row.changePct.toFixed(2), "%"] })] }, row.market)))) }) }), _jsx(Panel, { title: "Market Tape", subtitle: "Top markets by 24h volume", children: state.rows.length === 0 ? (_jsx(Text, { color: colors.muted, children: "Waiting for market snapshot..." })) : (_jsx(Table, { data: state.rows, columns: columns })) }), state.lastError && (_jsx(Box, { marginTop: 1, children: _jsx(Panel, { title: "Last Error", tone: "danger", children: _jsx(Text, { color: colors.loss, children: state.lastError }) }) }))] }));
+}
+export function registerUITerminalCommand(ui) {
+    ui
+        .command("terminal")
+        .alias("live")
+        .description("Run a live terminal dashboard (market data by default)")
+        .option("-i, --interval <ms>", "Refresh interval in milliseconds", String(DEFAULT_INTERVAL_MS))
+        .action(async function (options) {
+        const ctx = getContext(this);
+        const outputOpts = getOutputOptions(this);
+        const exchangeId = getSelectedExchange(this);
+        try {
+            const intervalMs = parsePositiveInt(options.interval, "interval", DEFAULT_INTERVAL_MS);
+            if (intervalMs < MIN_INTERVAL_MS) {
+                throw new Error(`interval must be >= ${MIN_INTERVAL_MS}ms`);
+            }
+            if (outputOpts.json) {
+                output(withJsonContract("ui.terminal.preview", {
+                    command: "ui terminal",
+                    exchange: exchangeId,
+                    network: ctx.config.testnet ? "testnet" : "mainnet",
+                    intervalMs,
+                    interactive: false,
+                }), outputOpts);
+                return;
+            }
+            const adapter = getExchangeAdapter();
+            const credentials = getExchangeCredentials(ctx.config, exchangeId);
+            await adapter.connect({
+                testnet: ctx.config.testnet,
+                rpcUrl: credentials.fullnodeUrl,
+                wsUrl: credentials.wsUrl,
+                credentials,
+            });
+            const pollSnapshot = async () => {
+                const startedAt = Date.now();
+                const tickers = await adapter.getTickers();
+                const rows = sortRows(tickers.map(parseTickerRow).filter((row) => !!row));
+                return {
+                    rows,
+                    latencyMs: Date.now() - startedAt,
+                    updatedAt: new Date(),
+                };
+            };
+            try {
+                const { waitUntilExit, unmount } = render(_jsx(TerminalDashboard, { intervalMs: intervalMs, exchangeId: exchangeId, networkLabel: ctx.config.testnet ? "testnet" : "mainnet", pollSnapshot: pollSnapshot }));
+                await waitUntilExit();
+                unmount();
+            }
+            finally {
+                await adapter.disconnect();
+            }
+        }
+        catch (err) {
+            outputError(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+}

package/dist/commands/upgrade.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerUpgradeCommand(program: Command): void;

package/dist/commands/upgrade.js

@@ -0,0 +1,98 @@
+import { createRequire } from "module";
+import { getOutputOptions } from "../cli/program.js";
+import { output, outputSuccess } from "../cli/output.js";
+const require = createRequire(import.meta.url);
+const pkg = require("../../package.json");
+async function fetchLatestVersion(packageName) {
+    const response = await fetch(`https://registry.npmjs.org/${encodeURIComponent(packageName)}`);
+    if (response.status === 404) {
+        return null;
+    }
+    if (!response.ok) {
+        throw new Error(`Failed to fetch package info: ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return data["dist-tags"]?.latest ?? null;
+}
+function compareVersions(current, latest) {
+    const currentParts = current.split(".").map(Number);
+    const latestParts = latest.split(".").map(Number);
+    for (let i = 0; i < Math.max(currentParts.length, latestParts.length); i++) {
+        const currentPart = currentParts[i] ?? 0;
+        const latestPart = latestParts[i] ?? 0;
+        if (latestPart > currentPart)
+            return true;
+        if (latestPart < currentPart)
+            return false;
+    }
+    return false;
+}
+export function registerUpgradeCommand(program) {
+    program
+        .command("upgrade")
+        .description("Check for updates and show upgrade instructions")
+        .action(async function () {
+        const outputOpts = getOutputOptions(this);
+        const current = pkg.version;
+        const packageName = pkg.name;
+        let latest;
+        try {
+            latest = await fetchLatestVersion(packageName);
+        }
+        catch (err) {
+            if (outputOpts.json) {
+                output({ error: err instanceof Error ? err.message : String(err) }, outputOpts);
+            }
+            else {
+                console.error("Failed to check for updates:", err instanceof Error ? err.message : String(err));
+            }
+            process.exit(1);
+        }
+        if (!latest) {
+            const unpublishedResult = {
+                current,
+                latest: null,
+                updateAvailable: false,
+                packagePublished: false,
+                packageName,
+            };
+            if (outputOpts.json) {
+                output(unpublishedResult, outputOpts);
+            }
+            else {
+                console.log(`Current version: ${current}`);
+                outputSuccess(`Package "${packageName}" is not published to npm yet.`);
+                console.log("");
+                console.log("To publish the first release, run:");
+                console.log(`  npm publish --access public`);
+            }
+            return;
+        }
+        const updateAvailable = compareVersions(current, latest);
+        const result = {
+            current,
+            latest,
+            updateAvailable,
+            packagePublished: true,
+            packageName,
+        };
+        if (outputOpts.json) {
+            output(result, outputOpts);
+        }
+        else {
+            console.log(`Current version: ${current}`);
+            console.log(`Latest version:  ${latest}`);
+            if (updateAvailable) {
+                console.log(``);
+                outputSuccess("Update available!");
+                console.log(``);
+                console.log(`To upgrade, run:`);
+                console.log(`  npm install -g ${packageName}@latest`);
+            }
+            else {
+                console.log(``);
+                outputSuccess("You are running the latest version.");
+            }
+        }
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { createProgram } from "./cli/program.js";
+const program = createProgram();
+program.parse();

package/dist/lib/agent/audit.d.ts

@@ -0,0 +1,12 @@
+export interface AgentAuditEvent {
+    action: string;
+    status: "ok" | "error";
+    exchange?: string;
+    market?: string;
+    idempotencyKey?: string;
+    paymentId?: string;
+    requestHash?: string;
+    traceId?: string;
+    details?: Record<string, unknown>;
+}
+export declare function appendAgentAuditEvent(event: AgentAuditEvent): void;

package/dist/lib/agent/audit.js

@@ -0,0 +1,13 @@
+import { appendFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { AGENT_AUDIT_LOG_PATH } from "../paths.js";
+import { ensurePrivateDir, hardenPrivateFile, PRIVATE_FILE_MODE } from "../fs-security.js";
+export function appendAgentAuditEvent(event) {
+    ensurePrivateDir(dirname(AGENT_AUDIT_LOG_PATH));
+    const line = JSON.stringify({
+        timestamp: Date.now(),
+        ...event,
+    });
+    appendFileSync(AGENT_AUDIT_LOG_PATH, `${line}\n`, { encoding: "utf8", mode: PRIVATE_FILE_MODE });
+    hardenPrivateFile(AGENT_AUDIT_LOG_PATH);
+}

package/dist/lib/agent/gateway.d.ts

@@ -0,0 +1,13 @@
+import { type Server } from "node:http";
+export interface AgentGatewayOptions {
+    host: string;
+    port: number;
+    defaultExchange: string;
+    defaultTestnet: boolean;
+    allowMainnetExecution: boolean;
+}
+export declare function createAgentGateway(options: AgentGatewayOptions): {
+    server: Server;
+    start: () => Promise<void>;
+    stop: () => Promise<void>;
+};