perp-cli 0.3.18 → 0.3.19

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perp-cli",
-  "version": "0.3.18",
+  "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.18"
+  version: "0.3.19"
 ---
 
 # perp-cli Agent Guide
@@ -153,6 +153,18 @@ If `error.retryable` is `false`, do NOT retry — fix the cause first.
 | `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
 
 - `references/commands.md` — full command reference