perp-cli 0.7.8 → 0.7.9

package/dist/commands/agent.js

@@ -1,5 +1,5 @@
 import { createRequire } from "node:module";
-import { printJson, jsonOk } from "../utils.js";
+import { printJson, jsonOk, jsonError } from "../utils.js";
 import { ERROR_CODES } from "../errors.js";
 import chalk from "chalk";
 const _require = createRequire(import.meta.url);
@@ -274,7 +274,7 @@ export function registerAgentCommands(program, getAdapter, isJson) {
         }
         catch (err) {
             const msg = err instanceof Error ? err.message : String(err);
-            console.error(JSON.stringify({ error: msg }));
+            console.error(JSON.stringify(jsonError("EXEC_FAILED", msg)));
             process.exit(1);
         }
     });

package/dist/commands/bot.js

@@ -1,5 +1,5 @@
 import chalk from "chalk";
-import { printJson, jsonOk } from "../utils.js";
+import { printJson, jsonOk, jsonError } from "../utils.js";
 import { loadBotConfig, parseStrategy, quickGridConfig, quickDCAConfig, runBot, PRESETS, getPreset, getPresetsByStrategy } from "../bot/index.js";
 import { updateJobState } from "../jobs.js";
 import { runTWAP, runFundingArb, runGrid, runDCA, runTrailingStop } from "../strategies/index.js";
@@ -444,6 +444,10 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
             "grid-mm", "liquidation-mm", "regime-mm",
         ];
         if (sym === "ALL" && symbolRequiredStrategies.includes(strategyName)) {
+            if (isJson()) {
+                console.error(JSON.stringify(jsonError("INVALID_PARAMS", `The '${strategyName}' strategy requires a <symbol> argument`)));
+                return process.exit(1);
+            }
             console.error(chalk.red(`\n  Error: The '${strategyName}' strategy requires a <symbol> argument.`));
             console.error(chalk.gray(`  Usage: perp bot run ${strategyName} <symbol>\n`));
             return process.exit(1);
@@ -499,6 +503,10 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
         const { getStrategy, listStrategies: listStrats } = await import("../bot/strategy-registry.js");
         if (!getStrategy(strategyName)) {
             const available = listStrats();
+            if (isJson()) {
+                console.error(JSON.stringify(jsonError("INVALID_PARAMS", `Unknown strategy: "${strategyName}"`, { details: { available } })));
+                return process.exit(1);
+            }
             console.error(chalk.red(`\n  Unknown strategy: "${strategyName}"`));
             console.error(chalk.gray(`\n  Available strategies:`));
             for (const s of available)

package/dist/commands/bridge.js

@@ -201,7 +201,7 @@ export function registerBridgeCommands(program, isJson) {
         if (!gasCheck.ok) {
             const msg = gasCheck.errors.map(e => `  ✗ ${e}`).join("\n");
             if (isJson())
-                return printJson({ ok: false, error: "Insufficient gas", details: gasCheck.errors });
+                return printJson({ ok: false, error: { code: "INSUFFICIENT_BALANCE", message: "Insufficient gas for transaction", details: gasCheck.errors }, meta: { timestamp: new Date().toISOString() } });
             console.log(chalk.red("\n  Insufficient gas for bridge:\n"));
             console.log(chalk.red(msg));
             if (needsDstGas) {
@@ -343,7 +343,7 @@ export function registerBridgeCommands(program, isJson) {
         if (!gasCheck.ok) {
             const msg = gasCheck.errors.map(e => `  ✗ ${e}`).join("\n");
             if (isJson())
-                return printJson({ ok: false, error: "Insufficient gas", details: gasCheck.errors });
+                return printJson({ ok: false, error: { code: "INSUFFICIENT_BALANCE", message: "Insufficient gas for transaction", details: gasCheck.errors }, meta: { timestamp: new Date().toISOString() } });
             console.log(chalk.red("\n  Insufficient gas for bridge:\n"));
             console.log(chalk.red(msg));
             if (needsDstGas) {

package/dist/commands/funds.js

@@ -117,8 +117,13 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork) {
             const connection = new Connection(rpcUrl, "confirmed");
             const solBalance = await connection.getBalance(pacDirect.keypair.publicKey);
             if (solBalance < 5_000_000) {
-                console.error(chalk.red("  Insufficient SOL for gas. Need ~0.005 SOL."));
-                console.error(chalk.gray("  Tip: Use relayer for gasless deposits (start relayer server)\n"));
+                if (isJson()) {
+                    printJson(jsonError("INSUFFICIENT_BALANCE", "Insufficient SOL for gas. Need ~0.005 SOL."));
+                }
+                else {
+                    console.error(chalk.red("  Insufficient SOL for gas. Need ~0.005 SOL."));
+                    console.error(chalk.gray("  Tip: Use relayer for gasless deposits (start relayer server)\n"));
+                }
                 process.exit(1);
             }
             const { PublicKey } = await import("@solana/web3.js");
@@ -128,7 +133,12 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork) {
                 ? tokenAccounts.value[0].account.data.parsed.info.tokenAmount.uiAmount ?? 0
                 : 0;
             if (usdcBalance < amountNum) {
-                console.error(chalk.red(`  Insufficient USDC on Solana. Have: $${formatUsd(usdcBalance)}, need: $${formatUsd(amountNum)}`));
+                if (isJson()) {
+                    printJson(jsonError("INSUFFICIENT_BALANCE", `Insufficient USDC on Solana. Have: $${formatUsd(usdcBalance)}, need: $${formatUsd(amountNum)}`));
+                }
+                else {
+                    console.error(chalk.red(`  Insufficient USDC on Solana. Have: $${formatUsd(usdcBalance)}, need: $${formatUsd(amountNum)}`));
+                }
                 process.exit(1);
             }
             const ix = await buildDepositInstruction(pacDirect.keypair.publicKey, amountNum, network);
@@ -231,7 +241,12 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork) {
         const USDC_ARB = "0xaf88d065e77c8cC2239327C5EDb3A432268e5831";
         const ethBal = await provider.getBalance(wallet.address);
         if (ethBal < ethers.parseEther("0.0001")) {
-            console.error(chalk.red("  Insufficient ETH on Arbitrum for gas."));
+            if (isJson()) {
+                printJson(jsonError("INSUFFICIENT_BALANCE", "Insufficient ETH on Arbitrum for gas."));
+            }
+            else {
+                console.error(chalk.red("  Insufficient ETH on Arbitrum for gas."));
+            }
             process.exit(1);
         }
         const usdc = new ethers.Contract(USDC_ARB, [
@@ -241,7 +256,12 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork) {
         const amountRaw = ethers.parseUnits(amount, 6);
         const usdcBal = await usdc.balanceOf(wallet.address);
         if (usdcBal < amountRaw) {
-            console.error(chalk.red(`  Insufficient USDC. Have: $${formatUsd(Number(ethers.formatUnits(usdcBal, 6)))}`));
+            if (isJson()) {
+                printJson(jsonError("INSUFFICIENT_BALANCE", `Insufficient USDC. Have: $${formatUsd(Number(ethers.formatUnits(usdcBal, 6)))}`));
+            }
+            else {
+                console.error(chalk.red(`  Insufficient USDC. Have: $${formatUsd(Number(ethers.formatUnits(usdcBal, 6)))}`));
+            }
             process.exit(1);
         }
         try {
@@ -306,12 +326,22 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork) {
         const amountRaw = ethers.parseUnits(amount, 6);
         const ethBal = await provider.getBalance(wallet.address);
         if (ethBal < ethers.parseEther("0.003")) {
-            console.error(chalk.red("  Insufficient ETH on Ethereum for gas. Need ~0.003 ETH ($3+)."));
+            if (isJson()) {
+                printJson(jsonError("INSUFFICIENT_BALANCE", "Insufficient ETH on Ethereum for gas. Need ~0.003 ETH ($3+)."));
+            }
+            else {
+                console.error(chalk.red("  Insufficient ETH on Ethereum for gas. Need ~0.003 ETH ($3+)."));
+            }
             process.exit(1);
         }
         const usdcBal = await usdc.balanceOf(wallet.address);
         if (usdcBal < amountRaw) {
-            console.error(chalk.red(`  Insufficient USDC on Ethereum. Have: $${formatUsd(Number(ethers.formatUnits(usdcBal, 6)))}`));
+            if (isJson()) {
+                printJson(jsonError("INSUFFICIENT_BALANCE", `Insufficient USDC on Ethereum. Have: $${formatUsd(Number(ethers.formatUnits(usdcBal, 6)))}`));
+            }
+            else {
+                console.error(chalk.red(`  Insufficient USDC on Ethereum. Have: $${formatUsd(Number(ethers.formatUnits(usdcBal, 6)))}`));
+            }
             process.exit(1);
         }
         const allowance = await usdc.allowance(wallet.address, LIGHTER_CONTRACT);
@@ -399,7 +429,12 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork) {
             console.log(`  Intent address: ${intentAddress}`);
         const gasBal = await provider.getBalance(wallet.address);
         if (gasBal < ethers.parseEther("0.00005")) {
-            console.error(chalk.red(`  Insufficient gas token on ${chainInfo.name}. Need native token for gas (~$0.01).`));
+            if (isJson()) {
+                printJson(jsonError("INSUFFICIENT_BALANCE", `Insufficient gas token on ${chainInfo.name}. Need native token for gas (~$0.01).`));
+            }
+            else {
+                console.error(chalk.red(`  Insufficient gas token on ${chainInfo.name}. Need native token for gas (~$0.01).`));
+            }
             process.exit(1);
         }
         const usdc = new ethers.Contract(chainInfo.usdc, [
@@ -409,7 +444,12 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork) {
         const amountRaw = ethers.parseUnits(amount, 6);
         const usdcBal = await usdc.balanceOf(wallet.address);
         if (usdcBal < amountRaw) {
-            console.error(chalk.red(`  Insufficient USDC on ${chainInfo.name}. Have: $${formatUsd(Number(ethers.formatUnits(usdcBal, 6)))}`));
+            if (isJson()) {
+                printJson(jsonError("INSUFFICIENT_BALANCE", `Insufficient USDC on ${chainInfo.name}. Have: $${formatUsd(Number(ethers.formatUnits(usdcBal, 6)))}`));
+            }
+            else {
+                console.error(chalk.red(`  Insufficient USDC on ${chainInfo.name}. Have: $${formatUsd(Number(ethers.formatUnits(usdcBal, 6)))}`));
+            }
             process.exit(1);
         }
         if (!isJson())
@@ -534,7 +574,12 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork) {
         const balance = await adapter.getBalance();
         const available = Number(balance.available);
         if (amountNum > available) {
-            console.error(chalk.red(`  Insufficient withdrawable balance. Available: $${formatUsd(available)}`));
+            if (isJson()) {
+                printJson(jsonError("INSUFFICIENT_BALANCE", `Insufficient withdrawable balance. Available: $${formatUsd(available)}`));
+            }
+            else {
+                console.error(chalk.red(`  Insufficient withdrawable balance. Available: $${formatUsd(available)}`));
+            }
             process.exit(1);
         }
         try {

package/dist/commands/init.d.ts

@@ -5,6 +5,7 @@ declare function loadEnvFile(): Record<string, string>;
 declare function setEnvVar(key: string, value: string): void;
 export declare const EXCHANGE_ENV_MAP: Record<string, {
     envKey: string;
+    envKeySecret?: string;
     chain: "solana" | "evm" | "apikey";
     label: string;
 }>;

package/dist/commands/init.js

@@ -70,7 +70,7 @@ export const EXCHANGE_ENV_MAP = {
     pacifica: { envKey: "PACIFICA_PRIVATE_KEY", chain: "solana", label: "Pacifica (Solana)" },
     hyperliquid: { envKey: "HL_PRIVATE_KEY", chain: "evm", label: "Hyperliquid (EVM)" },
     lighter: { envKey: "LIGHTER_PRIVATE_KEY", chain: "evm", label: "Lighter (EVM)" },
-    aster: { envKey: "ASTER_API_KEY", chain: "apikey", label: "Aster (BNB Chain)" },
+    aster: { envKey: "ASTER_API_KEY", envKeySecret: "ASTER_API_SECRET", chain: "apikey", label: "Aster (BNB Chain)" },
 };
 // ── Validate keys ─────────────────────────────────────────────
 export async function validateKey(chain, key) {
@@ -146,8 +146,9 @@ export function registerInitCommand(program) {
             console.log(`    1) ${chalk.cyan("Pacifica")}    ${chalk.gray("— Solana perps (USDC on Solana)")}`);
             console.log(`    2) ${chalk.cyan("Hyperliquid")} ${chalk.gray("— EVM perps (USDC on Arbitrum)")}`);
             console.log(`    3) ${chalk.cyan("Lighter")}     ${chalk.gray("— EVM perps (USDC on Ethereum/Arb)")}`);
+            console.log(`    4) ${chalk.cyan("Aster")}       ${chalk.gray("— BNB Chain perps (API key + secret)")}`);
             console.log();
-            const exchangeChoice = await ask(rl, "  Which exchange(s)? (1,2,3 or 'all'): ");
+            const exchangeChoice = await ask(rl, "  Which exchange(s)? (1,2,3,4 or 'all'): ");
             const selected = parseExchangeChoice(exchangeChoice);
             if (selected.length === 0) {
                 console.log(chalk.red("\n  No exchanges selected.\n"));
@@ -158,6 +159,7 @@ export function registerInitCommand(program) {
             // EVM exchanges can share the same key
             const evmExchanges = selected.filter((e) => EXCHANGE_ENV_MAP[e].chain === "evm");
             const solExchanges = selected.filter((e) => EXCHANGE_ENV_MAP[e].chain === "solana");
+            const apikeyExchanges = selected.filter((e) => EXCHANGE_ENV_MAP[e].chain === "apikey");
             const newEnv = { ...env };
             if (evmExchanges.length > 0) {
                 console.log(chalk.cyan.bold("\n  EVM Private Key") + chalk.gray(` (for ${evmExchanges.join(", ")})`));
@@ -213,6 +215,34 @@ export function registerInitCommand(program) {
                     }
                 }
             }
+            if (apikeyExchanges.length > 0) {
+                for (const ex of apikeyExchanges) {
+                    const info = EXCHANGE_ENV_MAP[ex];
+                    console.log(chalk.cyan.bold(`\n  ${info.label} API Credentials`));
+                    const apiKey = await ask(rl, `  ${info.label} API key: `);
+                    if (!apiKey) {
+                        console.log(chalk.gray("  Skipped."));
+                        continue;
+                    }
+                    const { valid, address } = await validateKey("apikey", apiKey);
+                    if (!valid) {
+                        console.log(chalk.red("  Invalid API key (must be at least 16 chars), skipped."));
+                        continue;
+                    }
+                    newEnv[info.envKey] = apiKey;
+                    console.log(`  ${chalk.green("OK")} ${chalk.gray(address)}`);
+                    if (info.envKeySecret) {
+                        const secret = await ask(rl, `  ${info.label} API secret: `);
+                        if (secret) {
+                            newEnv[info.envKeySecret] = secret;
+                            console.log(`  ${chalk.green("OK")} secret saved`);
+                        }
+                        else {
+                            console.log(chalk.yellow("  No secret provided — some operations may fail."));
+                        }
+                    }
+                }
+            }
             // Default exchange
             const settings = loadSettings();
             if (selected.length === 1) {
@@ -256,7 +286,9 @@ export function registerInitCommand(program) {
 }
 function parseExchangeChoice(input) {
     const lower = input.toLowerCase().trim();
-    if (lower === "all" || lower === "1,2,3")
+    if (lower === "all" || lower === "1,2,3,4")
+        return ["pacifica", "hyperliquid", "lighter", "aster"];
+    if (lower === "1,2,3")
         return ["pacifica", "hyperliquid", "lighter"];
     const exchanges = [];
     const parts = lower.split(/[,\s]+/);
@@ -267,6 +299,8 @@ function parseExchangeChoice(input) {
             exchanges.push("hyperliquid");
         else if (p === "3" || p.startsWith("lig") || p === "lt")
             exchanges.push("lighter");
+        else if (p === "4" || p.startsWith("ast"))
+            exchanges.push("aster");
     }
     return [...new Set(exchanges)];
 }

package/dist/commands/manage.js

@@ -1,4 +1,4 @@
-import { printJson, jsonOk } from "../utils.js";
+import { printJson, jsonOk, jsonError } from "../utils.js";
 import { setEnvVar } from "./init.js";
 import chalk from "chalk";
 import { hasPacificaSdk, hasLighterAccount } from "../exchanges/capabilities.js";
@@ -19,6 +19,10 @@ export function registerManageCommands(program, getAdapter, isJson, getPacificaA
         .action(async (symbol, mode) => {
         const m = mode.toLowerCase();
         if (m !== "cross" && m !== "isolated") {
+            if (isJson()) {
+                console.error(JSON.stringify(jsonError("INVALID_PARAMS", "Mode must be cross or isolated")));
+                process.exit(1);
+            }
             console.error(chalk.red("Mode must be cross or isolated"));
             process.exit(1);
         }

package/dist/config.js

@@ -51,7 +51,7 @@ export async function loadPrivateKey(exchange, pkOverride, walletName) {
     catch {
         // wallet module not available, skip
     }
-    // 5. Legacy key file (~/.perp/<exchange>.key)
+    // 6. Legacy key file (~/.perp/<exchange>.key)
     const keyFile = resolve(process.env.HOME || "~", ".perp", `${exchange}.key`);
     if (existsSync(keyFile)) {
         return readFileSync(keyFile, "utf-8").trim();

package/dist/pacifica/constants.d.ts

@@ -12,7 +12,7 @@ export declare const TESTNET_PACIFICA_VAULT = "5SDFdHZGTZbyRYu54CgmRkCGnPHC5pYaN
 export declare const TESTNET_USDC_MINT = "USDPqRbLidFGufty2s3oizmDEKdqx7ePTqzDMbf5ZKM";
 export declare const DEFAULT_EXPIRY_WINDOW = 5000;
 export declare const USDC_DECIMALS = 6;
-export declare const BUILDER_CODE: string;
+export declare const BUILDER_CODE = "PERPCLI";
 export type Network = "mainnet" | "testnet";
 export declare function getNetworkConfig(network?: Network): {
     restUrl: string;

package/dist/pacifica/constants.js

@@ -20,7 +20,10 @@ export const DEFAULT_EXPIRY_WINDOW = 5000; // 5 seconds
 // USDC decimals
 export const USDC_DECIMALS = 6;
 // Builder code — 0% fee, used for Pacifica hackathon tracking
-export const BUILDER_CODE = process.env.PACIFICA_BUILDER_CODE || "PERPCLI";
+// The actual 3-way fallback (env → settings.referralCodes.pacifica → "PERPCLI") is
+// resolved in index.ts before constructing PacificaAdapter. This constant is only
+// a last-resort default for direct PacificaClient usage without a builderCode arg.
+export const BUILDER_CODE = "PERPCLI";
 export function getNetworkConfig(network = "mainnet") {
     if (network === "testnet") {
         return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perp-cli",
-  "version": "0.7.8",
+  "version": "0.7.9",
   "description": "Multi-DEX Perpetual Futures CLI - Pacifica, Hyperliquid, Lighter, Aster",
   "bin": {
     "perp": "dist/index.js",