perp-cli 0.7.6 → 0.7.8

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/bot.js

@@ -532,6 +532,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/funds.js

@@ -181,7 +181,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 {

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)) {
@@ -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 });

package/dist/commands/risk.js

@@ -4,10 +4,21 @@ import { loadRiskLimits, saveRiskLimits, assessRisk, getLiquidationDistances } f
 import { pingPacifica, pingHyperliquid, pingLighter } from "../shared-api.js";
 /** Run health check and return results + render. Exported for use by status --health. */
 export async function runHealthCheck(isJson) {
-    const [pacPing, hlPing, ltPing] = await Promise.all([
+    const pingAster = async () => {
+        const start = Date.now();
+        try {
+            const res = await fetch("https://fapi.asterdex.com/fapi/v1/time");
+            return { ok: res.ok, latencyMs: Date.now() - start, status: res.status };
+        }
+        catch {
+            return { ok: false, latencyMs: Date.now() - start, status: 0 };
+        }
+    };
+    const [pacPing, hlPing, ltPing, astPing] = await Promise.all([
         pingPacifica(),
         pingHyperliquid(),
         pingLighter(),
+        pingAster(),
     ]);
     const toPingResult = (name, p) => ({
         exchange: name,
@@ -19,6 +30,7 @@ export async function runHealthCheck(isJson) {
         toPingResult("pacifica", pacPing),
         toPingResult("hyperliquid", hlPing),
         toPingResult("lighter", ltPing),
+        toPingResult("aster", astPing),
     ];
     const allOk = checks.every(c => c.status === "ok");
     if (isJson()) {

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

@@ -57,7 +57,7 @@ export async function loadPrivateKey(exchange, pkOverride, walletName) {
         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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "perp-cli",
-  "version": "0.7.6",
-  "description": "Multi-DEX Perpetual Futures CLI - Pacifica, Hyperliquid, Lighter",
+  "version": "0.7.8",
+  "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.