perp-cli 0.12.8 → 0.12.10

package/dist/config.js

@@ -74,15 +74,16 @@ export async function loadPrivateKey(exchange, pkOverride, walletName) {
         // settings module not available, skip
     }
     // 3. Exchange-specific env vars
-    // v0.12.4: Aster's ASTER_API_KEY entry is removed — the legacy HMAC
-    // signing path was retired in Plan v3.0. Aster onboarding is now via
-    // `perp wallet agent approve aster` (off-chain agent wallet); the runtime
-    // adapter pulls credentials from the agent store, not the env.
+    // v0.12.4 retired the legacy HMAC ASTER_API_KEY/SECRET path.
+    // v0.12.6 restored Aster as a normal EVM exchange in EXCHANGE_ENV_MAP
+    // (setup wizard / wallet show), but missed this map — leaving Tier 3
+    // env-PK loading broken. v0.12.10 restores ASTER_PRIVATE_KEY here so
+    // `tryLoadPrivateKey("aster")` finds the env value, mirroring HL/LT.
     const envMap = {
         pacifica: ["PACIFICA_PRIVATE_KEY", "pk"],
         hyperliquid: ["HYPERLIQUID_PRIVATE_KEY", "HL_PRIVATE_KEY"],
         lighter: ["LIGHTER_PRIVATE_KEY"],
-        aster: [],
+        aster: ["ASTER_PRIVATE_KEY"],
     };
     for (const envVar of envMap[exchange]) {
         if (process.env[envVar])

package/dist/exchanges/hyperliquid.js

@@ -383,6 +383,15 @@ export class HyperliquidAdapter {
                 return "portfolio";
             if (raw === "disabled")
                 return "standard";
+            // "default" is the implicit pre-set value HL returns when a user has
+            // never invoked `userSetAbstraction`. Per HL docs the four modes are
+            // Standard / Unified / Portfolio / (legacy) DEX abstraction. The set
+            // API only accepts the latter three; Standard is the de-facto baseline
+            // for unset accounts. Map "default" → "standard" so accounting branches
+            // pick the perp clearinghouse path. Users can opt into unified explicitly
+            // via `wallet manage account-mode unified`.
+            if (raw === "default")
+                return "standard";
             throw new PerpError("INVALID_PARAMS", `UNKNOWN_ACCOUNT_MODE: HL returned unrecognized userAbstraction mode: ${JSON.stringify(raw)}`, { remediation: "Check app.hyperliquid.xyz Settings → Account Mode" });
         });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perp-cli",
-  "version": "0.12.8",
+  "version": "0.12.10",
   "description": "Multi-DEX Perpetual Futures CLI - Pacifica, Hyperliquid, Lighter, Aster",
   "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.12.8"
+  version: "0.12.10"
 ---
 
 # perp-cli Agent Guide
@@ -41,7 +41,7 @@ Multi-DEX perpetual futures CLI + MCP server — Pacifica (Solana), Hyperliquid
 ## Install
 
 ```bash
-perp --version 2>/dev/null  # check if exists (must be >= 0.12.8)
+perp --version 2>/dev/null  # check if exists (must be >= 0.12.10)
 npm install -g perp-cli@latest 2>/dev/null || npx -y perp-cli@latest --json --version
 ```