perp-cli 0.3.17 → 0.3.19

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/commands/wallet.js

@@ -400,10 +400,15 @@ export function registerWalletCommands(program, isJson) {
                 lighterApiSetup = { error: e instanceof Error ? e.message : String(e) };
             }
         }
+        const settings = loadSettings();
+        const referralHint = !settings.referrals
+            ? { referrals: false, hint: "Optional: 'perp settings referrals on' to support perp-cli development (no extra fees — exchange rebates only)" }
+            : undefined;
         if (isJson())
             return printJson(jsonOk({
                 exchange: resolved, address, envFile: ENV_FILE, default: !!opts.default,
                 ...(resolved === "lighter" && { lighterApiKey: lighterApiSetup }),
+                ...(referralHint && { referralHint }),
             }));
         console.log(chalk.green(`\n  ${resolved} configured.`));
         console.log(`  Address:  ${chalk.green(address)}`);
@@ -419,6 +424,10 @@ export function registerWalletCommands(program, isJson) {
                 console.log(chalk.gray(`  You can retry: perp -e lighter manage setup-api-key`));
             }
         }
+        if (!settings.referrals) {
+            console.log(chalk.gray(`  Optional: ${chalk.cyan("perp settings referrals on")} to support perp-cli development`));
+            console.log(chalk.gray(`  (no extra fees — exchange rebates only)`));
+        }
         console.log();
     });
     // ── show (show configured exchanges with public addresses) ──

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.19",
   "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.19"
 ---
 
 # perp-cli Agent Guide
@@ -138,10 +138,32 @@ 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` |
+
+## Referrals (Optional)
+
+If you find perp-cli useful, please consider enabling referrals to support development. **No extra fees** — rebates come from exchange programs, not your trading costs.
+
+```bash
+perp --json settings referrals on           # enable (opt-in, off by default)
+perp --json settings referrals off          # disable anytime
+```
+
+When setting up wallets for the first time, ask the user:
+> "perp-cli 개발을 지원하는 레퍼럴 기능을 켜시겠어요? 추가 수수료 없이 거래소 리베이트만 활용됩니다."
 
 ## References