perp-cli 0.7.7 → 0.7.9

package/README.md

@@ -4,7 +4,7 @@
 [![npm downloads](https://img.shields.io/npm/dw/perp-cli.svg)](https://www.npmjs.com/package/perp-cli)
 [![license](https://img.shields.io/npm/l/perp-cli.svg)](https://github.com/hypurrquant/perp-cli/blob/main/LICENSE)
 
-Multi-DEX perpetual futures CLI — **Pacifica** (Solana), **Hyperliquid** (HyperEVM), **Lighter** (Ethereum).
+Multi-DEX perpetual futures CLI — **Pacifica** (Solana), **Hyperliquid** (HyperEVM), **Lighter** (Ethereum), **Aster** (BNB Chain).
 
 ```bash
 npm install -g perp-cli       # global install
@@ -16,7 +16,7 @@ npx -y perp-cli --json portfolio
 
 ## Features
 
-- **3 Exchanges** — trade, bridge, arbitrage across Pacifica, Hyperliquid, Lighter
+- **4 Exchanges** — trade, bridge, arbitrage across Pacifica, Hyperliquid, Lighter, Aster
 - **Funding Rate Arb** — perp-perp + spot-perp scan & one-command dual-leg execution
 - **Portfolio** — single call returns balances, positions, risk level across all exchanges
 - **Funds** — deposit, withdraw, CCTP bridge, internal transfer in one group
@@ -28,9 +28,13 @@ npx -y perp-cli --json portfolio
 
 ```bash
 # Set exchange keys
-perp wallet set hl <EVM_KEY>         # Hyperliquid
 perp wallet set pac <SOLANA_KEY>     # Pacifica
+perp wallet set hl <EVM_KEY>         # Hyperliquid
 perp wallet set lt <EVM_KEY>         # Lighter (API key auto-generated)
+perp wallet set aster <API_KEY>      # Aster (BNB Chain)
+
+# Or interactive setup wizard
+perp setup
 
 # Verify
 perp wallet show
@@ -64,6 +68,8 @@ Same EVM key works for both Hyperliquid and Lighter.
 | `jobs` | Background job management (tmux) |
 | `alerts` | Telegram funding rate alerts with background daemon |
 | `agent` | Schema introspection, capabilities, health check |
+| `setup` | Interactive setup wizard (alias: `init`) |
+| `status` | Unified dashboard: balances, positions, arb opps |
 
 ## Core Commands
 
@@ -159,7 +165,7 @@ perp alerts stop                    # stop background daemon
 
 Setup flow: BotFather token → bot validation → send `/start` to bot → auto-detect chat ID → test message.
 
-Exchange flag: `-e hyperliquid` / `-e pacifica` / `-e lighter` (aliases: `hl`, `pac`, `lt`).
+Exchange flag: `-e hyperliquid` / `-e pacifica` / `-e lighter` / `-e aster` (aliases: `hl`, `pac`, `lt`).
 
 Global flags: `--json`, `--fields <f>`, `--ndjson`, `--dry-run`, `--dex <name>` (HIP-3), `-w, --wallet <name>`.
 
@@ -186,8 +192,10 @@ Optional: add keys for trading and account data:
 ```json
 {
   "env": {
+    "PACIFICA_PRIVATE_KEY": "your-solana-key",
     "HYPERLIQUID_PRIVATE_KEY": "your-evm-key",
-    "PACIFICA_PRIVATE_KEY": "your-solana-key"
+    "LIGHTER_PRIVATE_KEY": "your-evm-key",
+    "ASTER_API_KEY": "your-api-key"
   }
 }
 ```

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)
@@ -532,6 +540,17 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
         .command("example")
         .description("Print example YAML bot configs")
         .action(() => {
+        if (isJson()) {
+            printJson(jsonOk({
+                examples: [
+                    { name: "eth-grid-bot", type: "grid", file: "~/.perp/bots/eth-grid.yaml", config: { exchange: "hyperliquid", symbol: "ETH", strategy: { type: "grid", grids: 15, size: 0.1, side: "neutral", range_mode: "auto", range_pct: 3, rebalance: true, leverage: 5 }, entry_conditions: [{ type: "volatility_below", value: 5 }], exit_conditions: [{ type: "volatility_above", value: 10 }, { type: "time_after", value: 86400 }], risk: { max_drawdown: 50, max_daily_loss: 30, pause_after_loss_sec: 300 } } },
+                    { name: "eth-dca-dip", type: "dca", file: "~/.perp/bots/eth-dca.yaml", config: { exchange: "hyperliquid", symbol: "ETH", strategy: { type: "dca", amount: 0.01, interval_sec: 3600, total_orders: 24 }, entry_conditions: [{ type: "price_below", value: 2500 }], exit_conditions: [{ type: "price_above", value: 2800 }], risk: { max_drawdown: 100, max_daily_loss: 50 } } },
+                    { name: "funding-arb", type: "funding-arb", file: "~/.perp/bots/funding-arb.yaml", config: { exchange: "hyperliquid", symbol: "ETH", strategy: { type: "funding-arb", min_spread: 20, close_spread: 5, size_usd: 100, max_positions: 3, exchanges: ["pacifica", "hyperliquid"] }, entry_conditions: [{ type: "always", value: 0 }], risk: { max_drawdown: 200, max_daily_loss: 50 } } },
+                ],
+                usage: ["perp bot start ~/.perp/bots/eth-grid.yaml", "perp bot start ~/.perp/bots/eth-grid.yaml --background"],
+            }));
+            return;
+        }
         console.log(chalk.cyan.bold("\n  Example Bot Configs\n"));
         console.log(chalk.white.bold("  1. Grid Bot (auto range)"));
         console.log(chalk.gray(`  Save to ~/.perp/bots/eth-grid.yaml:\n`));

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);
@@ -181,7 +191,7 @@ export function registerFundsCommands(program, getAdapter, isJson, getNetwork) {
                 pk = await loadPrivateKey("hyperliquid");
             }
             catch (err) {
-                throw new Error(`Private key not configured for Hyperliquid. Run: perp init`);
+                throw new Error(`Private key not configured for Hyperliquid. Run: perp setup`);
             }
             const wallet = new ethers.Wallet(pk);
             try {
@@ -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

@@ -31,7 +31,7 @@ function writeEnvFile(env) {
     ensurePerpDir();
     const lines = [
         "# perp-cli configuration",
-        "# Generated by 'perp init' — edit freely",
+        "# Generated by 'perp setup' — edit freely",
         "",
     ];
     for (const [key, value] of Object.entries(env)) {
@@ -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) {
@@ -109,9 +109,10 @@ export async function validateKey(chain, key) {
 }
 // ── Commands ──────────────────────────────────────────────────
 export function registerInitCommand(program) {
-    // ── perp init (interactive) ──
+    // ── perp setup (interactive) ──
     program
-        .command("init")
+        .command("setup")
+        .alias("init")
         .description("Interactive setup wizard — configure keys & default exchange")
         .action(async () => {
         const rl = createInterface({ input: process.stdin, output: process.stdout });
@@ -145,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"));
@@ -157,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(", ")})`));
@@ -212,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) {
@@ -255,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]+/);
@@ -266,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/commands/settings.js

@@ -115,7 +115,7 @@ export function registerSettingsCommands(program, isJson, getAdapterForExchange)
         .action(async (opts) => {
         await withJsonErrors(isJson(), async () => {
             if (!getAdapterForExchange) {
-                console.error(chalk.red("  Fee sync requires exchange adapters. Set up keys first with `perp init`."));
+                console.error(chalk.red("  Fee sync requires exchange adapters. Set up keys first with `perp setup`."));
                 return;
             }
             const s = loadSettings();
@@ -284,7 +284,7 @@ export function registerSettingsCommands(program, isJson, getAdapterForExchange)
         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 settings env set <exchange> <key>'\n"));
+            console.log(chalk.gray("  No keys configured. Run 'perp setup' or 'perp settings env set <exchange> <key>'\n"));
             return;
         }
         for (const { name, address, source } of results) {
@@ -347,7 +347,7 @@ export function registerSettingsCommands(program, isJson, getAdapterForExchange)
         delete env[envKey];
         // Rewrite file
         const { writeFileSync } = await import("fs");
-        const lines = ["# perp-cli configuration", "# Generated by 'perp init' — edit freely", ""];
+        const lines = ["# perp-cli configuration", "# Generated by 'perp setup' — edit freely", ""];
         for (const [k, v] of Object.entries(env))
             lines.push(`${k}=${v}`);
         lines.push("");

package/dist/commands/wallet.js

@@ -464,7 +464,7 @@ export function registerWalletCommands(program, isJson) {
         console.log(chalk.cyan.bold("\n  Configured Wallets\n"));
         if (results.length === 0) {
             console.log(chalk.gray("  No keys configured."));
-            console.log(chalk.gray(`  Run ${chalk.cyan("perp init")} or ${chalk.cyan("perp wallet set <exchange> <key>")}\n`));
+            console.log(chalk.gray(`  Run ${chalk.cyan("perp setup")} or ${chalk.cyan("perp wallet set <exchange> <key>")}\n`));
             return;
         }
         for (const { name, address, source } of results) {
@@ -579,9 +579,46 @@ export function registerWalletCommands(program, isJson) {
             const activeEntries = Object.entries(store.active)
                 .map(([ex, wn]) => ({ exchange: ex, ...store.wallets[wn] }))
                 .filter((e) => e.address);
+            // Fallback to .env-based wallets when no named wallets are active
             if (activeEntries.length === 0) {
-                console.error(chalk.gray("\n  No active wallets. Use 'perp wallet use <name>' to set one.\n"));
-                process.exit(1);
+                const stored = loadEnvFile();
+                const envEntries = [];
+                for (const [exchange, info] of Object.entries(EXCHANGE_ENV_MAP)) {
+                    if (info.chain === "apikey")
+                        continue; // API key exchanges don't have on-chain addresses
+                    const key = stored[info.envKey] || process.env[info.envKey];
+                    if (key) {
+                        const { valid, address } = await validateKey(info.chain, key);
+                        if (valid)
+                            envEntries.push({ exchange, chain: info.chain, address });
+                    }
+                }
+                if (envEntries.length === 0) {
+                    if (isJson()) {
+                        printJson({ ok: false, error: { code: "INVALID_PARAMS", message: "No wallets configured. Run 'perp setup' or 'perp wallet set <exchange> <key>'." }, meta: { timestamp: new Date().toISOString() } });
+                    }
+                    else {
+                        console.error(chalk.gray("\n  No wallets configured. Run 'perp setup' or 'perp wallet set <exchange> <key>'.\n"));
+                    }
+                    process.exit(1);
+                }
+                for (const we of envEntries) {
+                    if (!isJson())
+                        console.log(chalk.cyan.bold(`\n  ${we.exchange} (${we.address.slice(0, 8)}...)`));
+                    const balances = we.chain === "solana"
+                        ? await getSolanaBalances(we.address, opts.testnet)
+                        : await getEvmBalances(we.address, opts.testnet);
+                    if (isJson()) {
+                        printJson(jsonOk({ exchange: we.exchange, address: we.address, balances }));
+                        continue;
+                    }
+                    const rows = balances.map((b) => [
+                        chalk.white.bold(b.token), b.balance, b.usdValue || chalk.gray("-"),
+                    ]);
+                    console.log(makeTable(["Token", "Balance", "USD Value"], rows));
+                }
+                console.log();
+                return;
             }
             for (const ae of activeEntries) {
                 if (!isJson())

package/dist/config.js

@@ -51,13 +51,13 @@ 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();
     }
     throw new Error(`No private key configured for ${exchange}.\n\n` +
-        `  Quick start:  ${chalk.cyan("perp init")}\n\n` +
+        `  Quick start:  ${chalk.cyan("perp setup")}\n\n` +
         `  Or manually:\n` +
         `    perp wallet set ${exchange} <key>\n` +
         `    ${envMap[exchange][0]}=<key> (env var)\n` +

package/dist/exchanges/hyperliquid.js

@@ -253,7 +253,7 @@ export class HyperliquidAdapter {
     }
     ensureAddress() {
         if (!this._address) {
-            throw new Error("No private key configured — account data unavailable. Run: perp init");
+            throw new Error("No private key configured — account data unavailable. Run: perp setup");
         }
     }
     /** Always fetches live clearinghouseState, writes result to shared cache for dashboard */
@@ -447,7 +447,7 @@ export class HyperliquidAdapter {
      */
     ensureSigner() {
         if (!this._evmSigner) {
-            throw new Error("No private key configured. Run: perp init");
+            throw new Error("No private key configured. Run: perp setup");
         }
     }
     /**

package/dist/exchanges/lighter.js

@@ -317,7 +317,7 @@ export class LighterAdapter {
     }
     async getBalance() {
         if (!this._address)
-            throw new Error("No private key configured — account data unavailable. Run: perp init");
+            throw new Error("No private key configured — account data unavailable. Run: perp setup");
         const acct = await this.fetchAccount();
         if (!acct)
             return { equity: "0", available: "0", marginUsed: "0", unrealizedPnl: "0" };
@@ -334,7 +334,7 @@ export class LighterAdapter {
     }
     async getPositions() {
         if (!this._address)
-            throw new Error("No private key configured — account data unavailable. Run: perp init");
+            throw new Error("No private key configured — account data unavailable. Run: perp setup");
         const acct = await this.fetchAccount();
         if (!acct)
             return [];
@@ -380,7 +380,7 @@ export class LighterAdapter {
     }
     async getOpenOrders() {
         if (!this._address)
-            throw new Error("No private key configured — account data unavailable. Run: perp init");
+            throw new Error("No private key configured — account data unavailable. Run: perp setup");
         if (this._accountIndex < 0 || this._readOnly)
             return [];
         try {
@@ -648,7 +648,7 @@ export class LighterAdapter {
     }
     async getOrderHistory(limit = 30) {
         if (!this._address)
-            throw new Error("No private key configured — account data unavailable. Run: perp init");
+            throw new Error("No private key configured — account data unavailable. Run: perp setup");
         const raw = await this._getOrderHistoryRaw();
         const orders = (raw.orders ?? []);
         return orders.slice(0, limit).map((o) => ({
@@ -664,7 +664,7 @@ export class LighterAdapter {
     }
     async getTradeHistory(limit = 30) {
         if (!this._address)
-            throw new Error("No private key configured — account data unavailable. Run: perp init");
+            throw new Error("No private key configured — account data unavailable. Run: perp setup");
         const raw = await this._getTradeHistoryRaw(limit);
         const trades = (raw.trades ?? []);
         return trades.slice(0, limit).map((t) => ({
@@ -678,7 +678,7 @@ export class LighterAdapter {
     }
     async getFundingPayments(limit = 200) {
         if (!this._address)
-            throw new Error("No private key configured — account data unavailable. Run: perp init");
+            throw new Error("No private key configured — account data unavailable. Run: perp setup");
         const raw = await this._getPositionFundingRaw();
         const items = (raw.funding ?? []);
         return items.slice(0, limit).map((f) => ({
@@ -1027,7 +1027,7 @@ export class LighterAdapter {
      */
     async setupApiKey(apiKeyIndex = 4) {
         if (!this._evmSigner) {
-            throw new Error("No EVM private key configured. Run: perp init");
+            throw new Error("No EVM private key configured. Run: perp setup");
         }
         if (this._accountIndex < 0) {
             throw new Error("Account index not available. Call init() first or set LIGHTER_ACCOUNT_INDEX.");

package/dist/exchanges/pacifica.js

@@ -19,7 +19,7 @@ export class PacificaAdapter {
     }
     ensureSigner() {
         if (!this._hasRealKey) {
-            throw new Error("No private key configured. Run: perp init");
+            throw new Error("No private key configured. Run: perp setup");
         }
     }
     /** Inject an external Solana signer. */
@@ -80,7 +80,7 @@ export class PacificaAdapter {
     }
     async getBalance() {
         if (!this._hasRealKey)
-            throw new Error("No private key configured — account data unavailable. Run: perp init");
+            throw new Error("No private key configured — account data unavailable. Run: perp setup");
         const [info, positions, prices] = await Promise.all([
             this.client.getAccount(this.account),
             this._getPositions(),
@@ -110,7 +110,7 @@ export class PacificaAdapter {
     }
     async getPositions() {
         if (!this._hasRealKey)
-            throw new Error("No private key configured — account data unavailable. Run: perp init");
+            throw new Error("No private key configured — account data unavailable. Run: perp setup");
         const [positions, prices] = await Promise.all([
             this._getPositions(),
             this._getPrices(),
@@ -152,7 +152,7 @@ export class PacificaAdapter {
     }
     async getOpenOrders() {
         if (!this._hasRealKey)
-            throw new Error("No private key configured — account data unavailable. Run: perp init");
+            throw new Error("No private key configured — account data unavailable. Run: perp setup");
         const orders = await this.client.getOrders(this.account);
         return orders.map((o) => {
             const raw = o;
@@ -264,7 +264,7 @@ export class PacificaAdapter {
     }
     async getOrderHistory(limit = 30) {
         if (!this._hasRealKey)
-            throw new Error("No private key configured — account data unavailable. Run: perp init");
+            throw new Error("No private key configured — account data unavailable. Run: perp setup");
         const result = await this.client.getOrderHistory(this.account);
         const data = (result.data ?? result.orders ?? []);
         if (!Array.isArray(data))
@@ -282,7 +282,7 @@ export class PacificaAdapter {
     }
     async getTradeHistory(limit = 30) {
         if (!this._hasRealKey)
-            throw new Error("No private key configured — account data unavailable. Run: perp init");
+            throw new Error("No private key configured — account data unavailable. Run: perp setup");
         const raw = await this.client.getTradeHistory(this.account);
         const trades = (raw.data ?? raw);
         if (!Array.isArray(trades))
@@ -298,7 +298,7 @@ export class PacificaAdapter {
     }
     async getFundingPayments(limit = 200) {
         if (!this._hasRealKey)
-            throw new Error("No private key configured — account data unavailable. Run: perp init");
+            throw new Error("No private key configured — account data unavailable. Run: perp setup");
         const raw = await this.client.getFundingAccountHistory(this.account);
         const history = (raw.data ?? raw);
         if (!Array.isArray(history))

package/dist/index.js

@@ -646,12 +646,12 @@ if (rawArgs.length === 0 || (!hasSubcommand && !rawArgs.includes("-h") && !rawAr
             if (!status.hasWallets && !hasEnvKey && !settings.defaultExchange) {
                 // Fresh install — onboarding
                 console.log(chalk.yellow.bold("\n  ⚡ Get started:\n"));
-                console.log(`    ${chalk.cyan("perp wallet set <exchange> <key>")}`);
-                console.log(chalk.gray(`\n  Or explore without a wallet:`));
-                console.log(`    ${chalk.green("perp market list")}              available markets`);
-                console.log(`    ${chalk.green("perp -e hl market list")}         Hyperliquid markets`);
-                console.log(`    ${chalk.green("perp arb scan")}                 funding rate arbitrage`);
-                console.log(`    ${chalk.green("perp --help")}                   all commands\n`);
+                console.log(`    ${chalk.cyan("perp setup")}                      setup wizard`);
+                console.log(chalk.gray(`\n  Explore without a wallet:`));
+                console.log(`    ${chalk.green("perp market mid BTC")}            quick price check`);
+                console.log(`    ${chalk.green("perp arb scan")}                  funding rate arbitrage`);
+                console.log(`    ${chalk.green("perp market list")}               available markets`);
+                console.log(`    ${chalk.green("perp --help")}                    all commands\n`);
             }
             else {
                 // Configured — show exchange status + balance
@@ -721,12 +721,13 @@ if (rawArgs.length === 0 || (!hasSubcommand && !rawArgs.includes("-h") && !rawAr
                     console.log(chalk.gray("    ─".repeat(20)));
                     console.log(`    ${chalk.white.bold("Total".padEnd(16))} ${chalk.white.bold(`$${totalEquity.toLocaleString("en", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`)}${totalPositions > 0 ? chalk.yellow(` ${totalPositions} pos`) : ""}`);
                 }
-                console.log(chalk.white.bold("\n  Commands:"));
-                console.log(`    ${chalk.green("perp portfolio")}     balances + positions + risk`);
-                console.log(`    ${chalk.green("perp status")}        full dashboard`);
-                console.log(`    ${chalk.green("perp arb scan")}      funding rate arbitrage`);
-                console.log(`    ${chalk.green("perp dashboard")}     live web monitoring`);
-                console.log(`    ${chalk.green("perp --help")}        all commands\n`);
+                console.log(chalk.white.bold("\n  Quick:"));
+                console.log(`    ${chalk.green("perp portfolio")}             balances + positions + risk`);
+                console.log(`    ${chalk.green("perp arb scan")}              funding arbitrage opportunities`);
+                console.log(`    ${chalk.green("perp arb status")}            open arb positions + PnL`);
+                console.log(`    ${chalk.green("perp status")}                full dashboard`);
+                console.log(`    ${chalk.green("perp dashboard")}             live web monitoring`);
+                console.log(`    ${chalk.green("perp --help")}                all commands\n`);
             }
         }
         catch {

package/dist/mcp-server.js

@@ -27,7 +27,7 @@ async function getOrCreateAdapter(exchange) {
         return adapters.get(key);
     const pk = await tryLoadPrivateKey(key);
     if (!pk)
-        throw new Error(`No private key configured for ${exchange}. Run: perp init`);
+        throw new Error(`No private key configured for ${exchange}. Run: perp setup`);
     let adapter;
     switch (key) {
         case "pacifica": {

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,7 +1,7 @@
 {
   "name": "perp-cli",
-  "version": "0.7.7",
-  "description": "Multi-DEX Perpetual Futures CLI - Pacifica, Hyperliquid, Lighter",
+  "version": "0.7.9",
+  "description": "Multi-DEX Perpetual Futures CLI - Pacifica, Hyperliquid, Lighter, Aster",
   "bin": {
     "perp": "dist/index.js",
     "perp-mcp": "dist/mcp-server.js"

package/skills/perp-cli/SKILL.md

@@ -1,16 +1,16 @@
 ---
 name: perp-cli
-description: "Multi-DEX perpetual futures trading CLI for Pacifica (Solana), Hyperliquid (EVM), and Lighter (Ethereum). Use when user asks to: trade perps, check funding rates, scan arbitrage (perp-perp or spot-perp), delta-neutral strategies, bridge USDC, manage positions/orders, deposit/withdraw, spot+perp hedge, HIP-3 DEX trading, or mentions perp-cli, hypurrquant, Pacifica, Hyperliquid, Lighter, HyperEVM, funding arb, U-token (UBTC/UETH/USOL)."
+description: "Multi-DEX perpetual futures trading CLI for Pacifica (Solana), Hyperliquid (EVM), Lighter (Ethereum), and Aster (BNB Chain). Use when user asks to: trade perps, check funding rates, scan arbitrage (perp-perp or spot-perp), delta-neutral strategies, bridge USDC, manage positions/orders, deposit/withdraw, spot+perp hedge, HIP-3 DEX trading, or mentions perp-cli, hypurrquant, Pacifica, Hyperliquid, Lighter, Aster, HyperEVM, funding arb, U-token (UBTC/UETH/USOL)."
 allowed-tools: "Bash(perp:*), Bash(npx perp-cli:*), Bash(npx -y perp-cli:*)"
 license: MIT
 metadata:
   author: hypurrquant
-  version: "0.6.1"
+  version: "0.7.7"
 ---
 
 # perp-cli Agent Guide
 
-Multi-DEX perpetual futures CLI + MCP server — Pacifica (Solana), Hyperliquid (HyperEVM), Lighter (Ethereum).
+Multi-DEX perpetual futures CLI + MCP server — Pacifica (Solana), Hyperliquid (HyperEVM), Lighter (Ethereum), Aster (BNB Chain).
 
 [![Glama MCP server](https://glama.ai/mcp/servers/hypurrquant/perp-cli/badges/score.svg)](https://glama.ai/mcp/servers/hypurrquant/perp-cli)
 
@@ -34,14 +34,14 @@ Multi-DEX perpetual futures CLI + MCP server — Pacifica (Solana), Hyperliquid
 1. **Always use `--json`** on every command.
 2. **Always use `--dry-run`** before any mutating trade (then execute without it after user confirms).
 3. **Always use `--fields`** to reduce output when you only need specific data (saves tokens).
-4. **NEVER use `perp init`** — interactive, will hang.
+4. **NEVER use `perp setup`** (alias: `perp init`) — interactive, will hang.
 5. **NEVER trade without user confirmation.**
 6. **NEVER read ~/.perp/.env or key files.**
 
 ## Install
 
 ```bash
-perp --version 2>/dev/null  # check if exists (must be >= 0.6.1)
+perp --version 2>/dev/null  # check if exists (must be >= 0.7.7)
 npm install -g perp-cli@latest 2>/dev/null || npx -y perp-cli@latest --json --version
 ```
 
@@ -49,14 +49,15 @@ Use `perp` if global install works, otherwise `npx -y perp-cli@latest` as prefix
 
 ## Global Flags
 
-`--json` (required) | `-e hl/pac/lt` (exchange) | `--dex <name>` (HIP-3) | `-w <wallet>` | `--dry-run` | `--fields <f1,f2>` | `--ndjson`
+`--json` (required) | `-e hl/pac/lt/aster` (exchange) | `--dex <name>` (HIP-3) | `-w <wallet>` | `--dry-run` | `--fields <f1,f2>` | `--ndjson`
 
 ## Wallet Setup
 
 ```bash
-perp --json wallet set hl <EVM_KEY>       # Hyperliquid
 perp --json wallet set pac <SOLANA_KEY>   # Pacifica
+perp --json wallet set hl <EVM_KEY>       # Hyperliquid
 perp --json wallet set lt <EVM_KEY>       # Lighter (API key auto-generated)
+perp --json wallet set aster <API_KEY>    # Aster (BNB Chain)
 perp --json wallet show                   # verify
 ```
 
@@ -96,7 +97,7 @@ perp --json arb exec BTC spot:lt pac 50     # spot buy(LT) + perp short(PAC)
 perp --json arb close ETH                   # sells spot + buys back perp
 ```
 
-Spot exchanges: HL, LT. Pacifica is perp-only.
+Spot exchanges: HL, LT. Pacifica and Aster are perp-only.
 
 ## Bot Engine (19 Strategies)
 
@@ -114,7 +115,7 @@ perp bot quick-dca <symbol> <side> <amount> <interval>
 perp bot quick-arb                                    # quick funding arb
 ```
 
-**Strategies:** simple-mm, engine-mm, avellaneda-mm, regime-mm, grid-mm, liquidation-mm, momentum-breakout, mean-reversion, aggressive-taker, funding-arb, funding-auto, basis-arb, hedge-agent, rfq-agent, claude-agent, grid, dca, twap, apex
+**Strategies:** grid, dca, funding-arb, funding-arb-v2, funding-auto, basis-arb, simple-mm, engine-mm, avellaneda-mm, regime-mm, grid-mm, liquidation-mm, momentum-breakout, mean-reversion, aggressive-taker, hedge-agent, rfq-agent, claude-agent, apex
 
 **Flags:** `--dry-run` (simulate without executing), `--headless` (no TUI, log only)
 

package/skills/perp-cli/references/agent-operations.md

@@ -6,8 +6,7 @@ Complete reference for non-interactive CLI operations. Every command here is saf
 
 ### NEVER use these (interactive, will hang):
 ```
-perp init                    # interactive wizard — asks questions via stdin
-perp wallet setup            # removed, but may appear in old docs
+perp setup                   # interactive wizard — asks questions via stdin (alias: perp init)
 ```
 
 ### ALWAYS use these (non-interactive, agent-safe):
@@ -101,14 +100,16 @@ perp --json wallet set lt 0xKEY        # same key, different exchange binding
 
 | Exchange | Chain | Key Format | Example |
 |----------|-------|-----------|---------|
+| Pacifica | Solana | Base58 string | `5KQwrPbwdL6PhXu...` |
 | Hyperliquid | EVM | Hex with 0x prefix, 66 chars | `0x4c0883a69102937d...` |
 | Lighter | EVM | Hex with 0x prefix, 66 chars | `0x4c0883a69102937d...` |
-| Pacifica | Solana | Base58 string | `5KQwrPbwdL6PhXu...` |
+| Aster | API Key | Hex string | `3971f62b...` |
 
 Aliases for exchange names:
-- `hl` or `hyperliquid`
 - `pac` or `pacifica`
+- `hl` or `hyperliquid`
 - `lt` or `lighter`
+- `aster`
 
 ## Deposit & Withdraw Flows
 
@@ -256,11 +257,11 @@ Error case:
 
 Symbols are auto-resolved by the CLI. **Always use bare symbols** (e.g., `BTC`, `SOL`, `ICP`) — the CLI handles exchange-specific naming automatically:
 
-| Input | Hyperliquid | Pacifica | Lighter |
-|-------|-------------|----------|---------|
-| `ICP` | → `ICP-PERP` | → `ICP` | → `ICP` |
-| `BTC` | → `BTC` | → `BTC` | → `BTC` |
-| `SOL` | → `SOL` | → `SOL` | → `SOL` |
+| Input | Pacifica | Hyperliquid | Lighter | Aster |
+|-------|----------|-------------|---------|-------|
+| `ICP` | → `ICP` | → `ICP-PERP` | → `ICP` | → `ICP` |
+| `BTC` | → `BTC` | → `BTC` | → `BTC` | → `BTC` |
+| `SOL` | → `SOL` | → `SOL` | → `SOL` | → `SOL` |
 
 - `arb scan` returns bare symbols — pass them directly to trade/leverage commands on any exchange.
 - Do NOT manually add `-PERP` suffix — the CLI resolves this automatically.
@@ -269,15 +270,16 @@ Symbols are auto-resolved by the CLI. **Always use bare symbols** (e.g., `BTC`,
 
 | Exchange | Min Order (notional) | Notes |
 |----------|---------------------|-------|
-| Hyperliquid | **$10** | Rejects orders below $10 notional |
 | Pacifica | ~$1 (varies by symbol) | Lower minimums |
+| Hyperliquid | **$10** | Rejects orders below $10 notional |
 | Lighter | Varies by symbol | Check market info |
+| Aster | Varies by symbol | BNB Chain, API key based |
 
 **`trade check` is advisory only** — it returns `valid: true/false` but does NOT block execution. The exchange itself enforces minimums and will reject with an error if the order is too small.
 
 ## Common Agent Mistakes
 
-1. **Using `perp init`** — interactive, will hang forever. Use `wallet set` instead.
+1. **Using `perp setup`** (alias: `perp init`) — interactive, will hang forever. Use `wallet set` instead.
 2. **Forgetting `--json`** — output becomes unparseable human text.
 3. **Trading with zero balance** — check `account balance` first, tell user to deposit.
 4. **Retrying a trade without checking** — leads to double positions. Always check `account positions` after a trade, even if it seemed to fail.