perp-cli 0.3.17 → 0.3.18

package/dist/__tests__/cross-chain-margin.test.js

@@ -225,8 +225,8 @@ describe("computeAutoSize", () => {
             bids: [["99", "10000"]], // $990K depth
         });
         const size = await computeAutoSize(longAdapter, shortAdapter, "BTC", 5.0);
-        // Default maxPositionUsd is 5000
-        expect(size).toBeLessThanOrEqual(5000);
+        // Default maxPositionUsd is 100000
+        expect(size).toBeLessThanOrEqual(100000);
     });
 });
 // ── Rebalance computation ──

package/dist/exchanges/lighter.js

@@ -97,15 +97,29 @@ export class LighterAdapter {
         }
         // 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;
+            // Clean & validate API key before passing to WASM (Go hex decoder gives cryptic errors on non-hex)
+            let cleanKey = this._apiKey.trim().replace(/['"` \t\n\r.]/g, "");
+            if (cleanKey.startsWith("0x"))
+                cleanKey = cleanKey.slice(2);
+            if (cleanKey.length > 0 && !/^[0-9a-fA-F]+$/.test(cleanKey)) {
+                console.error(`[lighter] API key contains invalid chars (expected hex). Check LIGHTER_API_KEY in ~/.perp/.env or run 'perp -e lighter manage setup-api-key' to regenerate.`);
+                this._apiKey = "";
+            }
+            else if (cleanKey.length === 0) {
+                this._apiKey = "";
+            }
+            else {
+                this._apiKey = cleanKey;
+                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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perp-cli",
-  "version": "0.3.17",
+  "version": "0.3.18",
   "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.17"
+  version: "0.3.18"
 ---
 
 # perp-cli Agent Guide
@@ -138,10 +138,20 @@ Close both: perp --json -e <EX1> trade close <SYM> & perp --json -e <EX2> trade
 
 Responses: `{ "ok": true, "data": {...} }` or `{ "ok": false, "error": { "code": "...", "retryable": true/false } }`
 
-- **Retryable** (wait 5s, max 3 retries): `RATE_LIMITED`, `EXCHANGE_UNREACHABLE`, `TIMEOUT`
-- **Non-retryable**: `INSUFFICIENT_BALANCE`, `SYMBOL_NOT_FOUND`, `RISK_VIOLATION` — fix the cause, don't retry
-- **Lighter `invalid signature`**: `perp --json -e lighter manage setup-api-key`
-- If `error.retryable` is `false`, do NOT retry. Report to user.
+If `error.retryable` is `false`, do NOT retry — fix the cause first.
+
+| Error | Action |
+|-------|--------|
+| `RATE_LIMITED` | wait 5s, retry (max 3) |
+| `EXCHANGE_UNREACHABLE` | wait 10s, retry. 3x fail → skip that exchange |
+| `TIMEOUT` | wait 5s, retry (max 3) |
+| `INSUFFICIENT_BALANCE` | reduce size or bridge funds to that exchange |
+| `SYMBOL_NOT_FOUND` | `perp --json -e <EX> market list` to verify symbol |
+| `RISK_VIOLATION` | check `risk limits`, ask user to adjust if needed |
+| `SIZE_TOO_SMALL` | `perp --json -e <EX> market info <SYM>` for min order size |
+| `MARGIN_INSUFFICIENT` | reduce leverage or close existing positions |
+| `DUPLICATE_ORDER` | already submitted — check positions, don't retry |
+| Lighter `invalid signature` | check ~/.perp/.env or `perp --json -e lighter manage setup-api-key` |
 
 ## References