perp-cli 0.11.0 → 0.12.0

package/dist/commands/dex.js

@@ -1,120 +0,0 @@
-import chalk from "chalk";
-import { HyperliquidAdapter } from "../exchanges/hyperliquid.js";
-import { printJson, jsonOk, jsonError, makeTable, formatUsd, withJsonErrors } from "../utils.js";
-export function registerDexCommands(program, getAdapter, isJson) {
-    const dex = program.command("dex").description("HIP-3 deployed perp dex commands (Hyperliquid)");
-    // ── dex list ──
-    dex
-        .command("list")
-        .description("List all available HIP-3 deployed perp dexes")
-        .action(async () => {
-        await withJsonErrors(isJson(), async () => {
-            const adapter = await getAdapter();
-            if (!(adapter instanceof HyperliquidAdapter)) {
-                if (isJson())
-                    return printJson(jsonError("INVALID_EXCHANGE", "HIP-3 dexes are only available on Hyperliquid. Use -e hyperliquid."));
-                console.error(chalk.red("\n  HIP-3 dexes are only available on Hyperliquid. Use -e hyperliquid.\n"));
-                return;
-            }
-            const dexes = await adapter.listDeployedDexes();
-            if (isJson())
-                return printJson(jsonOk(dexes));
-            if (dexes.length === 0) {
-                console.log(chalk.gray("\n  No deployed dexes found.\n"));
-                return;
-            }
-            console.log(chalk.cyan.bold("\n  HIP-3 Deployed Perp DEXes\n"));
-            const rows = dexes.map(d => [
-                chalk.white.bold(d.name),
-                chalk.gray(d.deployer.slice(0, 10) + "..."),
-                String(d.assets.length),
-                d.assets.slice(0, 5).join(", ") + (d.assets.length > 5 ? ` +${d.assets.length - 5}` : ""),
-            ]);
-            console.log(makeTable(["DEX", "Deployer", "Assets", "Markets"], rows));
-            console.log(chalk.gray(`\n  Use --dex <name> to trade on a deployed dex.\n`));
-            console.log(chalk.gray(`  Example: perp -e hyperliquid --dex xyz market list\n`));
-        });
-    });
-    // ── dex markets <dex-name> ──
-    dex
-        .command("markets <dexName>")
-        .description("List all markets on a specific HIP-3 dex")
-        .action(async (dexName) => {
-        await withJsonErrors(isJson(), async () => {
-            const adapter = await getAdapter();
-            if (!(adapter instanceof HyperliquidAdapter)) {
-                if (isJson())
-                    return printJson(jsonError("INVALID_EXCHANGE", "HIP-3 dexes are only available on Hyperliquid. Use -e hyperliquid."));
-                console.error(chalk.red("\n  HIP-3 dexes are only available on Hyperliquid. Use -e hyperliquid.\n"));
-                return;
-            }
-            // Temporarily switch dex, fetch markets, then restore
-            const prevDex = adapter.dex;
-            adapter.setDex(dexName);
-            try {
-                const markets = await adapter.getMarkets();
-                if (isJson())
-                    return printJson(jsonOk({ dex: dexName, markets }));
-                if (markets.length === 0) {
-                    console.log(chalk.gray(`\n  No markets found on dex "${dexName}".\n`));
-                    return;
-                }
-                console.log(chalk.cyan.bold(`\n  ${dexName.toUpperCase()} DEX Markets\n`));
-                const rows = markets.map(m => [
-                    chalk.white.bold(m.symbol),
-                    `$${formatUsd(m.markPrice)}`,
-                    m.fundingRate !== "0" ? `${(Number(m.fundingRate) * 100).toFixed(4)}%` : chalk.gray("-"),
-                    `$${formatUsd(m.volume24h)}`,
-                    `$${formatUsd(m.openInterest)}`,
-                    `${m.maxLeverage}x`,
-                ]);
-                console.log(makeTable(["Symbol", "Mark Price", "Funding", "24h Volume", "OI", "Max Lev"], rows));
-                console.log(chalk.gray(`\n  Trade: perp -e hyperliquid --dex ${dexName} trade market <symbol> <side> <size>\n`));
-            }
-            finally {
-                adapter.setDex(prevDex);
-            }
-        });
-    });
-    // ── dex balance <dex-name> ──
-    dex
-        .command("balance <dexName>")
-        .description("Show balance on a specific HIP-3 dex")
-        .action(async (dexName) => {
-        await withJsonErrors(isJson(), async () => {
-            const adapter = await getAdapter();
-            if (!(adapter instanceof HyperliquidAdapter)) {
-                if (isJson())
-                    return printJson(jsonError("INVALID_EXCHANGE", "HIP-3 dexes are only available on Hyperliquid. Use -e hyperliquid."));
-                console.error(chalk.red("\n  HIP-3 dexes are only available on Hyperliquid. Use -e hyperliquid.\n"));
-                return;
-            }
-            const prevDex = adapter.dex;
-            adapter.setDex(dexName);
-            try {
-                const [balance, positions] = await Promise.all([
-                    adapter.getBalance(),
-                    adapter.getPositions(),
-                ]);
-                if (isJson())
-                    return printJson(jsonOk({ dex: dexName, balance, positions }));
-                console.log(chalk.cyan.bold(`\n  ${dexName.toUpperCase()} DEX Balance\n`));
-                console.log(`  Equity:      $${formatUsd(balance.equity)}`);
-                console.log(`  Available:   $${formatUsd(balance.available)}`);
-                console.log(`  Margin Used: $${formatUsd(balance.marginUsed)}`);
-                console.log(`  uPnL:        $${formatUsd(balance.unrealizedPnl)}`);
-                if (positions.length > 0) {
-                    console.log(chalk.white.bold("\n  Positions:"));
-                    for (const p of positions) {
-                        const color = p.side === "long" ? chalk.green : chalk.red;
-                        console.log(`    ${color(p.side.toUpperCase().padEnd(5))} ${chalk.white(p.symbol.padEnd(16))} ${p.size.padEnd(10)} entry: $${Number(p.entryPrice).toFixed(2)}  pnl: $${Number(p.unrealizedPnl).toFixed(2)}`);
-                    }
-                }
-                console.log();
-            }
-            finally {
-                adapter.setDex(prevDex);
-            }
-        });
-    });
-}

package/dist/commands/env.d.ts

@@ -1,2 +0,0 @@
-import { Command } from "commander";
-export declare function registerEnvCommands(program: Command, isJson: () => boolean): void;

package/dist/commands/env.js

@@ -1,136 +0,0 @@
-import chalk from "chalk";
-import { printJson, jsonOk } from "../utils.js";
-import { ENV_FILE, loadEnvFile, setEnvVar, EXCHANGE_ENV_MAP, validateKey } from "./init.js";
-// Resolve exchange alias → env var key
-function resolveEnvKey(nameOrKey) {
-    // Direct env var name
-    const upper = nameOrKey.toUpperCase();
-    for (const info of Object.values(EXCHANGE_ENV_MAP)) {
-        if (info.envKey === upper)
-            return { envKey: info.envKey, chain: info.chain };
-    }
-    // Exchange name alias
-    const info = EXCHANGE_ENV_MAP[nameOrKey.toLowerCase()];
-    if (info)
-        return { envKey: info.envKey, chain: info.chain };
-    // Common aliases
-    const aliases = { hl: "hyperliquid", pac: "pacifica", lt: "lighter" };
-    const aliased = aliases[nameOrKey.toLowerCase()];
-    if (aliased)
-        return resolveEnvKey(aliased);
-    return null;
-}
-export function registerEnvCommands(program, isJson) {
-    const env = program.command("env").description("Manage ~/.perp/.env configuration");
-    // ── perp env show ──
-    env
-        .command("show")
-        .description("Show current configuration")
-        .action(async () => {
-        const stored = loadEnvFile();
-        const entries = [];
-        for (const [exchange, info] of Object.entries(EXCHANGE_ENV_MAP)) {
-            const fromFile = stored[info.envKey];
-            const fromEnv = process.env[info.envKey];
-            if (fromFile) {
-                entries.push({ name: exchange, chain: info.chain, key: fromFile, source: "~/.perp/.env" });
-            }
-            else if (fromEnv) {
-                entries.push({ name: exchange, chain: info.chain, key: fromEnv, source: "environment" });
-            }
-        }
-        // Derive addresses
-        const results = [];
-        for (const entry of entries) {
-            const { valid, address } = await validateKey(entry.chain, entry.key);
-            results.push({ name: entry.name, address: valid ? address : "(invalid key)", source: entry.source });
-        }
-        if (isJson()) {
-            const data = results.map((r) => ({ exchange: r.name, address: r.address, source: r.source }));
-            return printJson(jsonOk({ envFile: ENV_FILE, exchanges: data }));
-        }
-        console.log(chalk.cyan.bold("\n  perp-cli Configuration\n"));
-        console.log(`  File: ${chalk.gray(ENV_FILE)}\n`);
-        if (results.length === 0) {
-            console.log(chalk.gray("  No keys configured. Run 'perp init' or 'perp env set <exchange> <key>'\n"));
-            return;
-        }
-        for (const { name, address, source } of results) {
-            console.log(`  ${chalk.cyan(name.padEnd(14))} ${chalk.green(address)}  ${chalk.gray(source)}`);
-        }
-        console.log();
-    });
-    // ── perp env set <exchange|key> <value> ──
-    env
-        .command("set <name> <value>")
-        .description("Set a key (exchange name or env var name)")
-        .action(async (name, value) => {
-        const resolved = resolveEnvKey(name);
-        if (resolved) {
-            // Validate the key
-            const { valid, address } = await validateKey(resolved.chain, value);
-            if (!valid) {
-                if (isJson()) {
-                    const { jsonError } = await import("../utils.js");
-                    return printJson(jsonError("INVALID_PARAMS", `Invalid ${resolved.chain} private key`));
-                }
-                console.error(chalk.red(`\n  Invalid ${resolved.chain} private key.\n`));
-                process.exit(1);
-            }
-            const normalized = resolved.chain === "evm"
-                ? (value.startsWith("0x") ? value : `0x${value}`)
-                : value;
-            setEnvVar(resolved.envKey, normalized);
-            if (isJson())
-                return printJson(jsonOk({ key: resolved.envKey, address, file: ENV_FILE }));
-            console.log(chalk.green(`\n  ${resolved.envKey} set.`));
-            console.log(`  Address: ${chalk.gray(address)}`);
-            console.log(`  File:    ${chalk.gray("~/.perp/.env")}\n`);
-        }
-        else {
-            // Raw env var (e.g. LIGHTER_API_KEY, custom vars)
-            setEnvVar(name, value);
-            if (isJson())
-                return printJson(jsonOk({ key: name, file: ENV_FILE }));
-            console.log(chalk.green(`\n  ${name} set.`));
-            console.log(`  File: ${chalk.gray("~/.perp/.env")}\n`);
-        }
-    });
-    // ── perp env remove <name> ──
-    env
-        .command("remove <name>")
-        .description("Remove a key from ~/.perp/.env")
-        .action(async (name) => {
-        const resolved = resolveEnvKey(name);
-        const envKey = resolved?.envKey || name;
-        const env = loadEnvFile();
-        if (!(envKey in env)) {
-            if (isJson()) {
-                const { jsonError } = await import("../utils.js");
-                return printJson(jsonError("NOT_FOUND", `${envKey} not found in ~/.perp/.env`));
-            }
-            console.log(chalk.gray(`\n  ${envKey} not found in ~/.perp/.env\n`));
-            return;
-        }
-        delete env[envKey];
-        // Rewrite file
-        const { writeFileSync } = await import("fs");
-        const lines = ["# perp-cli configuration", "# Generated by 'perp init' — edit freely", ""];
-        for (const [k, v] of Object.entries(env))
-            lines.push(`${k}=${v}`);
-        lines.push("");
-        writeFileSync(ENV_FILE, lines.join("\n"), { mode: 0o600 });
-        if (isJson())
-            return printJson(jsonOk({ removed: envKey }));
-        console.log(chalk.yellow(`\n  ${envKey} removed from ~/.perp/.env\n`));
-    });
-    // ── perp env path ──
-    env
-        .command("path")
-        .description("Print env file path")
-        .action(() => {
-        if (isJson())
-            return printJson(jsonOk({ path: ENV_FILE }));
-        console.log(ENV_FILE);
-    });
-}

package/dist/commands/funding.d.ts

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