perp-cli 0.3.9 → 0.3.11

package/dist/exchanges/lighter.js

@@ -70,12 +70,16 @@ export class LighterAdapter {
                 : json.accounts[0].account_index;
         }
         // Auto-generate API key if we have PK but no API key and account exists
+        let signerReady = false;
         if (!this._apiKey && this._accountIndex >= 0) {
             try {
                 const autoKeyIndex = 2; // default for auto-setup
                 const { privateKey: apiKey } = await this.setupApiKey(autoKeyIndex);
                 this._apiKey = apiKey;
                 this._apiKeyIndex = autoKeyIndex;
+                // setupApiKey already configured the static WASM client — reuse it
+                this._signer = LighterAdapter._wasmClient;
+                signerReady = true;
                 // Save to .env for future use
                 try {
                     const { setEnvVar } = await import("../commands/init.js");
@@ -91,18 +95,19 @@ export class LighterAdapter {
                 console.error(`[lighter] API key auto-setup failed: ${msg}. Trading will be read-only. Run 'perp -e lighter manage setup-api-key' to retry.`);
             }
         }
-        // Initialize signer for trading if we have an API key
-        if (this._apiKey) {
-            const { WasmSignerClient } = await import("lighter-ts-sdk");
-            this._signer = new WasmSignerClient({});
-            await this._signer.initialize();
-            await this._signer.createClient({
+        // Initialize signer for trading if we have an API key (reuse singleton WASM client)
+        if (this._apiKey && !signerReady) {
+            const client = await LighterAdapter.getWasmClient();
+            await client.createClient({
                 url: this._baseUrl,
                 privateKey: this._apiKey,
                 chainId: this._chainId,
                 apiKeyIndex: this._apiKeyIndex,
                 accountIndex: this._accountIndex,
             });
+            this._signer = client;
+        }
+        if (this._apiKey) {
             this._readOnly = false;
         }
         // Build symbol → marketIndex map + decimals from orderBookDetails
@@ -768,11 +773,22 @@ export class LighterAdapter {
     static async getWasmClient() {
         if (LighterAdapter._wasmClient)
             return LighterAdapter._wasmClient;
-        const { WasmSignerClient } = await import("lighter-ts-sdk");
-        const client = new WasmSignerClient({});
-        await client.initialize();
-        LighterAdapter._wasmClient = client;
-        return client;
+        // Prevent Go WASM runtime from killing the process on panic
+        const origExit = process.exit;
+        process.exit = ((code) => {
+            process.exit = origExit; // restore immediately
+            throw new Error(`Lighter WASM runtime exited with code ${code}`);
+        });
+        try {
+            const { WasmSignerClient } = await import("lighter-ts-sdk");
+            const client = new WasmSignerClient({});
+            await client.initialize();
+            LighterAdapter._wasmClient = client;
+            return client;
+        }
+        finally {
+            process.exit = origExit;
+        }
     }
     /**
      * Generate a new Lighter API key pair using the WASM signer.

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { config } from "dotenv";
 import { resolve } from "path";
+import { createRequire } from "node:module";
 // Load ~/.perp/.env first (global), then CWD .env (overrides)
 config({ path: resolve(process.env.HOME || "~", ".perp", ".env") });
 config();
@@ -41,6 +42,8 @@ import { registerInitCommand, EXCHANGE_ENV_MAP, validateKey } from "./commands/i
 import { registerEnvCommands } from "./commands/env.js";
 import { loadSettings, saveSettings } from "./settings.js";
 import { setSharedApiNetwork } from "./shared-api.js";
+const _require = createRequire(import.meta.url);
+const _pkg = _require("../package.json");
 const program = new Command();
 // Resolve default exchange from settings (fallback: "pacifica")
 const _settings = loadSettings();
@@ -48,7 +51,7 @@ const _defaultExchange = _settings.defaultExchange || "pacifica";
 program
     .name("perp")
     .description("Multi-DEX Perpetual Futures CLI (Pacifica, Hyperliquid, Lighter)")
-    .version("0.3.7")
+    .version(_pkg.version)
     .option("-e, --exchange <exchange>", `Exchange: pacifica, hyperliquid, lighter (default: ${_defaultExchange})`, _defaultExchange)
     .option("-n, --network <network>", "Network: mainnet or testnet", "mainnet")
     .option("-k, --private-key <key>", "Private key")

package/dist/mcp-server.js

@@ -7,6 +7,7 @@
  * Adapters are created lazily from environment variables.
  */
 import "dotenv/config";
+import { createRequire } from "node:module";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
@@ -56,7 +57,9 @@ function err(error, meta) {
     return JSON.stringify({ ok: false, error, meta }, null, 2);
 }
 // ── MCP Server ──
-const server = new McpServer({ name: "perp-cli", version: "0.3.7" }, { capabilities: { tools: {}, resources: {} } });
+const _require = createRequire(import.meta.url);
+const _pkg = _require("../package.json");
+const server = new McpServer({ name: "perp-cli", version: _pkg.version }, { capabilities: { tools: {}, resources: {} } });
 // ============================================================
 // Market Data tools (read-only, no private key needed)
 // ============================================================

package/package.json

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

package/skills/perp-cli/SKILL.md

@@ -5,7 +5,7 @@ allowed-tools: "Bash(perp:*), Bash(npx perp-cli:*), Bash(npx -y perp-cli:*)"
 license: MIT
 metadata:
   author: hypurrquant
-  version: "0.3.9"
+  version: "0.3.10"
   mcp-server: perp-cli
 ---
 
@@ -34,14 +34,6 @@ npm install -g perp-cli
 
 CRITICAL: Do NOT use `perp init` — it is interactive and will hang.
 
-**If user provides a private key:**
-```bash
-perp --json wallet set hl <KEY>              # Hyperliquid (aliases: hl, hyperliquid)
-perp --json wallet set pac <KEY>             # Pacifica (aliases: pac, pacifica)
-perp --json wallet set lt <KEY>              # Lighter (aliases: lt, lighter)
-perp --json wallet set hl <KEY> --default    # also set as default exchange
-```
-
 **If user needs a new wallet:**
 ```bash
 perp --json wallet generate evm              # creates EVM wallet for Hyperliquid + Lighter
@@ -49,6 +41,41 @@ perp --json wallet generate solana           # creates Solana wallet for Pacific
 # IMPORTANT: Tell user the generated address so they can fund it with USDC!
 ```
 
+### Hyperliquid setup
+```bash
+perp --json wallet set hl <EVM_PRIVATE_KEY>        # register EVM key → ready to trade immediately
+perp --json wallet show                            # verify
+perp --json -e hl account info                     # check balance
+```
+No extra steps. Key is saved as `HL_PRIVATE_KEY` in .env.
+
+### Pacifica setup
+```bash
+perp --json wallet set pac <SOLANA_PRIVATE_KEY>    # register Solana key → ready to trade immediately
+perp --json wallet show                            # verify
+perp --json -e pac account info                    # check balance
+```
+No extra steps. Key is saved as `PACIFICA_PRIVATE_KEY` in .env.
+
+### Lighter setup (API key auto-generated on registration)
+```bash
+perp --json wallet set lt <EVM_PRIVATE_KEY>        # register EVM key
+#    → AUTOMATICALLY generates Lighter API key via on-chain tx
+#    → Saves to .env: LIGHTER_PRIVATE_KEY, LIGHTER_API_KEY, LIGHTER_ACCOUNT_INDEX, LIGHTER_API_KEY_INDEX
+#    → No manual API key creation needed. Do NOT ask the user to visit the Lighter website.
+perp --json wallet show                            # verify
+perp --json -e lighter account info                # check balance
+```
+Same EVM key can be used for both Hyperliquid and Lighter:
+```bash
+perp --json wallet set hl <KEY>                    # same key
+perp --json wallet set lt <KEY>                    # same key, different exchange binding
+```
+If API key auto-setup fails (rare, e.g. no ETH for gas on Lighter chain):
+```bash
+perp --json -e lighter manage setup-api-key        # manual retry
+```
+
 **Verify setup (ALWAYS do this after any wallet command):**
 ```bash
 perp --json wallet show
@@ -75,13 +102,39 @@ Symbols are auto-resolved across exchanges. Use bare symbols (e.g., `BTC`, `SOL`
 ### Common operations
 ```bash
 perp --json wallet show                      # check configured wallets
-perp --json -e hl account info               # balance & margin
-perp --json -e hl account positions          # open positions
-perp --json -e hl market list                # available markets
-perp --json -e hl market mid BTC             # BTC mid price
-perp --json arb scan --min 5                 # find funding arb opportunities (>5bps spread)
 perp --json portfolio                        # unified multi-exchange view
+perp --json arb scan --min 5                 # find funding arb opportunities (>5bps spread)
+```
+
+### Per-exchange commands (ALL 3 exchanges use the SAME commands)
+Every command below works on ALL exchanges. Just change `-e`:
+```bash
+# Account
+perp --json -e hl account info               # Hyperliquid balance & margin
+perp --json -e pac account info              # Pacifica balance & margin
+perp --json -e lighter account info          # Lighter balance & margin
+perp --json -e <EX> account positions        # open positions
+
+# Market data
+perp --json -e <EX> market list              # available markets
+perp --json -e <EX> market mid <SYM>         # mid price
+perp --json -e <EX> market book <SYM>        # orderbook depth
+
+# Trading (same syntax on ALL exchanges)
+perp --json -e <EX> trade leverage <SYM> <N> --isolated   # set leverage
+perp --json -e <EX> trade market <SYM> buy <SIZE>         # market buy
+perp --json -e <EX> trade market <SYM> sell <SIZE>        # market sell
+perp --json -e <EX> trade close <SYM>                     # close position
+perp --json -e <EX> trade check <SYM> <SIDE> <SIZE> --leverage <L>  # pre-flight
+
+# Deposit / Withdraw
+perp --json deposit hyperliquid <AMOUNT>     # deposit to HL
+perp --json deposit pacifica <AMOUNT>        # deposit to Pacifica
+perp --json deposit lighter info             # show Lighter deposit routes
+perp --json deposit lighter cctp arb <AMOUNT>  # deposit to Lighter via CCTP
+perp --json withdraw <EX> <AMOUNT>           # withdraw from exchange
 ```
+**All 3 exchanges are fully operational.** Do NOT say any exchange "requires additional setup" or "is not available" — if `wallet show` shows it configured, it's ready to trade.
 
 ### Funding arb direction (CRITICAL — do NOT reverse)
 ```