perp-cli 0.3.13 → 0.3.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -781,6 +781,7 @@ export class LighterAdapter {
|
|
|
781
781
|
// Walk up to package root: dist/esm/index.js → 3 levels
|
|
782
782
|
const sdkRoot = dirname(dirname(dirname(fileURLToPath(sdkEntry))));
|
|
783
783
|
const wasmPath = join(sdkRoot, "wasm", "lighter-signer.wasm");
|
|
784
|
+
const wasmExecPath = join(sdkRoot, "wasm", "wasm_exec.js");
|
|
784
785
|
// Prevent Go WASM runtime from killing the process on panic
|
|
785
786
|
const origExit = process.exit;
|
|
786
787
|
process.exit = ((code) => {
|
|
@@ -789,7 +790,7 @@ export class LighterAdapter {
|
|
|
789
790
|
});
|
|
790
791
|
try {
|
|
791
792
|
const { WasmSignerClient } = await import("lighter-ts-sdk");
|
|
792
|
-
const client = new WasmSignerClient({ wasmPath });
|
|
793
|
+
const client = new WasmSignerClient({ wasmPath, wasmExecPath });
|
|
793
794
|
await client.initialize();
|
|
794
795
|
LighterAdapter._wasmClient = client;
|
|
795
796
|
return client;
|
package/package.json
CHANGED
package/skills/perp-cli/SKILL.md
CHANGED
|
@@ -1,307 +1,115 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: perp-cli
|
|
3
|
-
description: "Multi-DEX perpetual futures trading CLI for Pacifica (Solana), Hyperliquid (EVM), and Lighter (Ethereum). Use when user asks to trade perps, check funding rates, bridge USDC, manage positions, scan arbitrage opportunities, or mentions perp-cli, hypurrquant, Pacifica, Hyperliquid, or Lighter exchanges.
|
|
3
|
+
description: "Multi-DEX perpetual futures trading CLI for Pacifica (Solana), Hyperliquid (EVM), and Lighter (Ethereum). Use when user asks to trade perps, check funding rates, bridge USDC, manage positions, scan arbitrage opportunities, or mentions perp-cli, hypurrquant, Pacifica, Hyperliquid, or Lighter exchanges."
|
|
4
4
|
allowed-tools: "Bash(perp:*), Bash(npx perp-cli:*), Bash(npx -y perp-cli:*)"
|
|
5
5
|
license: MIT
|
|
6
6
|
metadata:
|
|
7
7
|
author: hypurrquant
|
|
8
|
-
version: "0.3.
|
|
9
|
-
mcp-server: perp-cli
|
|
8
|
+
version: "0.3.14"
|
|
10
9
|
---
|
|
11
10
|
|
|
12
11
|
# perp-cli Agent Guide
|
|
13
12
|
|
|
14
13
|
Multi-DEX perpetual futures CLI — Pacifica (Solana), Hyperliquid (HyperEVM), Lighter (Ethereum).
|
|
15
14
|
|
|
16
|
-
##
|
|
15
|
+
## Rules
|
|
17
16
|
|
|
18
|
-
1. **
|
|
19
|
-
2. **NEVER use
|
|
20
|
-
3. **
|
|
21
|
-
4. **NEVER
|
|
22
|
-
5. **
|
|
23
|
-
6. **Use ISOLATED margin for arb.** Set `perp --json manage margin <SYM> isolated` before opening positions. Cross margin can cascade liquidations.
|
|
24
|
-
7. **Monitor positions continuously.** Run `perp --json risk status` and `perp --json -e <EX> account positions` every 15 minutes while positions are open.
|
|
25
|
-
8. **NEVER read ~/.perp/.env or any key files directly.** Private keys are managed by the CLI internally. Use `perp --json wallet show` to check wallet status. Never attempt to read, cat, or access key files — this is a security violation.
|
|
17
|
+
1. **Always use `--json`** on every command.
|
|
18
|
+
2. **NEVER use `perp init`** — interactive, will hang. Use `wallet set` instead.
|
|
19
|
+
3. **NEVER trade without user confirmation.** Show order details and wait for approval.
|
|
20
|
+
4. **NEVER read ~/.perp/.env or key files.** Use `perp --json wallet show`.
|
|
21
|
+
5. **Risk first.** Run `perp --json risk status` before and during any operation.
|
|
26
22
|
|
|
27
|
-
##
|
|
23
|
+
## Install
|
|
28
24
|
|
|
29
25
|
```bash
|
|
30
26
|
npm install -g perp-cli
|
|
31
27
|
```
|
|
28
|
+
No sudo: `npm install -g perp-cli --prefix ~/.npm-global && export PATH="$HOME/.npm-global/bin:$PATH"`
|
|
32
29
|
|
|
33
|
-
|
|
34
|
-
```bash
|
|
35
|
-
npm config set prefix ~/.npm-global
|
|
36
|
-
npm install -g perp-cli --prefix ~/.npm-global
|
|
37
|
-
export PATH="$HOME/.npm-global/bin:$PATH"
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
## Step 2: Configure Wallet
|
|
41
|
-
|
|
42
|
-
CRITICAL: Do NOT use `perp init` — it is interactive and will hang.
|
|
43
|
-
|
|
44
|
-
**If user needs a new wallet:**
|
|
45
|
-
```bash
|
|
46
|
-
perp --json wallet generate evm # creates EVM wallet for Hyperliquid + Lighter
|
|
47
|
-
perp --json wallet generate solana # creates Solana wallet for Pacifica
|
|
48
|
-
# IMPORTANT: Tell user the generated address so they can fund it with USDC!
|
|
49
|
-
```
|
|
30
|
+
## Wallet Setup
|
|
50
31
|
|
|
51
|
-
### Hyperliquid setup
|
|
52
32
|
```bash
|
|
53
|
-
perp --json wallet set hl <
|
|
54
|
-
perp --json wallet
|
|
55
|
-
perp --json
|
|
33
|
+
perp --json wallet set hl <EVM_KEY> # Hyperliquid
|
|
34
|
+
perp --json wallet set pac <SOLANA_KEY> # Pacifica
|
|
35
|
+
perp --json wallet set lt <EVM_KEY> # Lighter (API key auto-generated)
|
|
36
|
+
perp --json wallet show # verify
|
|
56
37
|
```
|
|
57
|
-
|
|
38
|
+
Same EVM key works for both HL and Lighter. Lighter API key is created automatically on first use.
|
|
58
39
|
|
|
59
|
-
|
|
60
|
-
```bash
|
|
61
|
-
perp --json wallet set pac <SOLANA_PRIVATE_KEY> # register Solana key → ready to trade immediately
|
|
62
|
-
perp --json wallet show # verify
|
|
63
|
-
perp --json -e pac account info # check balance
|
|
64
|
-
```
|
|
65
|
-
No extra steps. Key is saved as `PACIFICA_PRIVATE_KEY` in .env.
|
|
66
|
-
|
|
67
|
-
### Lighter setup (API key auto-generated on registration)
|
|
68
|
-
```bash
|
|
69
|
-
perp --json wallet set lt <EVM_PRIVATE_KEY> # register EVM key
|
|
70
|
-
# → AUTOMATICALLY generates Lighter API key via on-chain tx
|
|
71
|
-
# → Saves to .env: LIGHTER_PRIVATE_KEY, LIGHTER_API_KEY, LIGHTER_ACCOUNT_INDEX, LIGHTER_API_KEY_INDEX
|
|
72
|
-
# → No manual API key creation needed. Do NOT ask the user to visit the Lighter website.
|
|
73
|
-
perp --json wallet show # verify
|
|
74
|
-
perp --json -e lighter account info # check balance
|
|
75
|
-
```
|
|
76
|
-
Same EVM key can be used for both Hyperliquid and Lighter:
|
|
77
|
-
```bash
|
|
78
|
-
perp --json wallet set hl <KEY> # same key
|
|
79
|
-
perp --json wallet set lt <KEY> # same key, different exchange binding
|
|
80
|
-
```
|
|
81
|
-
If API key auto-setup fails (rare, e.g. no ETH for gas on Lighter chain):
|
|
82
|
-
```bash
|
|
83
|
-
perp --json -e lighter manage setup-api-key # manual retry
|
|
84
|
-
```
|
|
85
|
-
|
|
86
|
-
**Verify setup (ALWAYS do this after any wallet command):**
|
|
87
|
-
```bash
|
|
88
|
-
perp --json wallet show
|
|
89
|
-
# Success: { "ok": true, "data": { "exchanges": [{ "exchange": "hyperliquid", "address": "0x..." }] } }
|
|
90
|
-
# Empty: { "ok": true, "data": { "exchanges": [] } } ← wallet not configured yet
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
## Step 3: Use
|
|
94
|
-
|
|
95
|
-
### Exchange selection
|
|
96
|
-
```bash
|
|
97
|
-
perp --json -e hyperliquid ... # Hyperliquid (EVM)
|
|
98
|
-
perp --json -e pacifica ... # Pacifica (Solana)
|
|
99
|
-
perp --json -e lighter ... # Lighter (Ethereum)
|
|
100
|
-
```
|
|
101
|
-
If a default exchange is set, `-e` can be omitted.
|
|
102
|
-
|
|
103
|
-
### Symbol naming
|
|
104
|
-
Symbols are auto-resolved across exchanges. Use bare symbols (e.g., `BTC`, `SOL`, `ICP`) everywhere — the CLI handles exchange-specific naming:
|
|
105
|
-
- **Hyperliquid**: `ICP` → `ICP-PERP` (auto-resolved, `-PERP` suffix added)
|
|
106
|
-
- **Pacifica / Lighter**: bare symbols as-is
|
|
107
|
-
- `arb scan` returns bare symbols — pass them directly to any exchange command.
|
|
108
|
-
|
|
109
|
-
### Common operations
|
|
110
|
-
```bash
|
|
111
|
-
perp --json wallet show # check configured wallets
|
|
112
|
-
perp --json portfolio # unified multi-exchange view
|
|
113
|
-
perp --json arb scan --min 5 # find funding arb opportunities (>5bps spread)
|
|
114
|
-
```
|
|
40
|
+
## Core Commands
|
|
115
41
|
|
|
116
|
-
### Per-exchange commands (ALL 3 exchanges use the SAME commands)
|
|
117
|
-
Every command below works on ALL exchanges. Just change `-e`:
|
|
118
42
|
```bash
|
|
119
43
|
# Account
|
|
120
|
-
perp --json -e
|
|
121
|
-
perp --json -e
|
|
122
|
-
perp --json
|
|
123
|
-
perp --json -e <EX> account positions # open positions
|
|
44
|
+
perp --json -e <EX> account info # balance, equity, margin
|
|
45
|
+
perp --json -e <EX> account positions # open positions
|
|
46
|
+
perp --json portfolio # unified multi-exchange view
|
|
124
47
|
|
|
125
|
-
# Market
|
|
126
|
-
perp --json -e <EX> market list
|
|
127
|
-
perp --json -e <EX> market mid <SYM>
|
|
128
|
-
perp --json -e <EX> market book <SYM>
|
|
48
|
+
# Market
|
|
49
|
+
perp --json -e <EX> market list # available markets
|
|
50
|
+
perp --json -e <EX> market mid <SYM> # mid price
|
|
51
|
+
perp --json -e <EX> market book <SYM> # orderbook
|
|
129
52
|
|
|
130
|
-
# Trading
|
|
131
|
-
perp --json -e <EX> trade leverage <SYM> <N> --isolated
|
|
132
|
-
perp --json -e <EX> trade market <SYM> buy <SIZE>
|
|
133
|
-
perp --json -e <EX> trade market <SYM> sell <SIZE>
|
|
134
|
-
perp --json -e <EX> trade close <SYM>
|
|
135
|
-
perp --json -e <EX> trade check <SYM> <SIDE> <SIZE> --leverage <L>
|
|
53
|
+
# Trading
|
|
54
|
+
perp --json -e <EX> trade leverage <SYM> <N> --isolated # set BEFORE trading
|
|
55
|
+
perp --json -e <EX> trade market <SYM> buy <SIZE>
|
|
56
|
+
perp --json -e <EX> trade market <SYM> sell <SIZE>
|
|
57
|
+
perp --json -e <EX> trade close <SYM>
|
|
58
|
+
perp --json -e <EX> trade check <SYM> <SIDE> <SIZE> --leverage <L>
|
|
136
59
|
|
|
137
|
-
#
|
|
138
|
-
perp --json
|
|
139
|
-
perp --json
|
|
140
|
-
perp --json
|
|
141
|
-
perp --json deposit lighter cctp arb <AMOUNT> # deposit to Lighter via CCTP
|
|
142
|
-
perp --json withdraw <EX> <AMOUNT> # withdraw from exchange
|
|
143
|
-
```
|
|
144
|
-
**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.
|
|
60
|
+
# Risk
|
|
61
|
+
perp --json risk status # risk level + violations
|
|
62
|
+
perp --json risk liquidation-distance # % from liq for all positions
|
|
63
|
+
perp --json risk check --notional <$> --leverage <L>
|
|
145
64
|
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
arb scan returns: longExch, shortExch, netSpread
|
|
149
|
-
→ ALWAYS follow longExch/shortExch exactly. NEVER reverse the direction.
|
|
150
|
-
→ NEVER enter if netSpread ≤ 0 (= loss after fees)
|
|
151
|
-
→ Positive funding = longs pay shorts → be SHORT to receive
|
|
152
|
-
→ Negative funding = shorts pay longs → be LONG to receive
|
|
65
|
+
# Arb
|
|
66
|
+
perp --json arb scan --min 5 # find funding arb opportunities
|
|
153
67
|
```
|
|
154
68
|
|
|
155
|
-
|
|
156
|
-
```
|
|
157
|
-
BEFORE ANY TRADE:
|
|
158
|
-
0. perp --json portfolio → check TOTAL equity + per-exchange balances
|
|
159
|
-
- Single position notional < 25% of TOTAL equity
|
|
160
|
-
- Each exchange MUST have sufficient balance for its leg
|
|
161
|
-
- Notional ≠ margin required. Check available balance on EACH exchange.
|
|
162
|
-
- If balance is insufficient, bridge first or reduce size.
|
|
69
|
+
Exchange aliases: `hl`/`hyperliquid`, `pac`/`pacifica`, `lt`/`lighter`. Symbols auto-resolve (use bare: `BTC`, `SOL`, `ICP`).
|
|
163
70
|
|
|
164
|
-
|
|
165
|
-
2. perp --json -e <EX> account info → verify EXCHANGE-SPECIFIC balance
|
|
166
|
-
3. perp --json -e <EX> market mid <SYM> → current price
|
|
167
|
-
4. perp --json -e <EX> trade leverage <SYM> <N> --isolated → set leverage + isolated margin FIRST
|
|
168
|
-
5. perp --json risk check --notional <$> --leverage <L> → risk pre-check
|
|
169
|
-
6. perp --json -e <EX> trade check <SYM> <SIDE> <SIZE> --leverage <L> → trade validation
|
|
170
|
-
⚠ trade check does NOT read exchange-set leverage. ALWAYS pass --leverage explicitly.
|
|
171
|
-
7. [Show order details + risk assessment to user, get explicit confirmation]
|
|
172
|
-
8. perp --json -e <EX> trade market <SYM> <SIDE> <SIZE> → execute
|
|
173
|
-
9. perp --json -e <EX> account positions → verify result + check liquidation price
|
|
174
|
-
```
|
|
175
|
-
|
|
176
|
-
### Exchange-specific constraints
|
|
177
|
-
```
|
|
178
|
-
Minimum order values (notional, enforced by exchange):
|
|
179
|
-
- Hyperliquid: $10 minimum per order
|
|
180
|
-
- Pacifica: varies by symbol (usually ~$1)
|
|
181
|
-
- Lighter: varies by symbol
|
|
71
|
+
## Trade Execution Checklist
|
|
182
72
|
|
|
183
|
-
If your calculated size falls below the minimum, increase to meet it or skip the opportunity.
|
|
184
|
-
trade check returns valid: true/false but is ADVISORY — it does NOT block execution.
|
|
185
|
-
The exchange itself will reject orders below its minimum.
|
|
186
73
|
```
|
|
187
|
-
|
|
188
|
-
|
|
74
|
+
1. perp --json risk status → STOP if critical
|
|
75
|
+
2. perp --json -e <EX> account info → verify balance
|
|
76
|
+
3. perp --json -e <EX> trade leverage <SYM> <N> --isolated
|
|
77
|
+
4. perp --json -e <EX> trade check <SYM> <SIDE> <SIZE> --leverage <L>
|
|
78
|
+
5. [Show details to user, get confirmation]
|
|
79
|
+
6. perp --json -e <EX> trade market <SYM> <SIDE> <SIZE>
|
|
80
|
+
7. perp --json -e <EX> account positions → verify + check liq price
|
|
189
81
|
```
|
|
190
|
-
For funding arb, BOTH legs must have the EXACT SAME SIZE. Size mismatch = directional exposure.
|
|
191
|
-
|
|
192
|
-
1. Check orderbook depth on BOTH exchanges:
|
|
193
|
-
perp --json -e <LONG_EX> market book <SYM> → asks (you're buying)
|
|
194
|
-
perp --json -e <SHORT_EX> market book <SYM> → bids (you're selling)
|
|
195
82
|
|
|
196
|
-
|
|
197
|
-
- fillable_long = sum of ask sizes at best 2-3 levels
|
|
198
|
-
- fillable_short = sum of bid sizes at best 2-3 levels
|
|
199
|
-
- ORDER_SIZE = min(fillable_long, fillable_short, desired_size)
|
|
200
|
-
- Must be ≥ BOTH exchanges' minimum order value (e.g. HL requires ≥$10 notional)
|
|
83
|
+
## Position Sizing
|
|
201
84
|
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
→ verify fill via account positions
|
|
85
|
+
- Single position notional < **80%** of that exchange's available balance
|
|
86
|
+
- Use ISOLATED margin for arb
|
|
87
|
+
- Leverage 1-3x for arb, never exceed 5x
|
|
88
|
+
- Both arb legs MUST have exact same size
|
|
207
89
|
|
|
208
|
-
|
|
209
|
-
If mismatch (partial fill), adjust the larger to match the smaller.
|
|
210
|
-
```
|
|
211
|
-
See `references/strategies.md` for detailed execution strategy (chunked orders, limit orders, failure handling).
|
|
90
|
+
## Funding Arb Direction
|
|
212
91
|
|
|
213
|
-
### Post-entry monitoring (MANDATORY while positions are open)
|
|
214
92
|
```
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
perp --json -e <EX> account positions → check each position P&L
|
|
219
|
-
|
|
220
|
-
Every 1 hour (at funding settlement):
|
|
221
|
-
perp --json arb scan --min 5 → is spread still profitable?
|
|
222
|
-
perp --json portfolio → total equity across exchanges
|
|
223
|
-
Compare both legs' unrealized P&L — they should roughly offset
|
|
224
|
-
|
|
225
|
-
Exit triggers:
|
|
226
|
-
- Spread below breakeven (including fees) → show exit plan, get user approval
|
|
227
|
-
- risk status level = "critical" or canTrade = false → reduce immediately
|
|
228
|
-
- One leg closed unexpectedly → close the other leg IMMEDIATELY
|
|
229
|
-
- Target hold duration reached → re-evaluate or exit
|
|
230
|
-
```
|
|
231
|
-
|
|
232
|
-
### Knowing your capital (CHECK BEFORE ANY DECISION)
|
|
233
|
-
```
|
|
234
|
-
perp --json wallet show → configured wallets + addresses
|
|
235
|
-
perp --json wallet balance → on-chain USDC (in wallet, NOT on exchange)
|
|
236
|
-
perp --json -e <EX> account info → exchange balance (available for trading)
|
|
237
|
-
perp --json portfolio → unified view: equity, margin, P&L per exchange
|
|
93
|
+
arb scan returns: longExch, shortExch, netSpread
|
|
94
|
+
→ ALWAYS follow longExch/shortExch exactly. NEVER reverse.
|
|
95
|
+
→ NEVER enter if netSpread <= 0
|
|
238
96
|
```
|
|
239
|
-
**On-chain balance ≠ exchange balance.** Always check both. Capital must be deposited to exchange before trading.
|
|
240
97
|
|
|
241
|
-
|
|
242
|
-
For agent-specific operations (setup flows, deposit/withdraw, order types, idempotency), see `references/agent-operations.md`.
|
|
243
|
-
For autonomous strategies (funding rate arb, risk management, opportunity cost), see `references/strategies.md`.
|
|
98
|
+
## Monitoring (while positions open)
|
|
244
99
|
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
```json
|
|
249
|
-
{ "ok": true, "data": { ... }, "meta": { "timestamp": "..." } }
|
|
250
|
-
{ "ok": false, "error": { "code": "ERROR_CODE", "message": "...", "retryable": true } }
|
|
251
|
-
```
|
|
100
|
+
Every 15 min: `risk status` + `risk liquidation-distance` + `account positions`
|
|
101
|
+
Every 1 hour: `arb scan --min 5` + `portfolio`
|
|
102
|
+
Exit if: spread < breakeven, risk critical, one leg closed unexpectedly.
|
|
252
103
|
|
|
253
104
|
## Error Handling
|
|
254
105
|
|
|
255
|
-
|
|
256
|
-
|------|-----------|--------|
|
|
257
|
-
| INSUFFICIENT_BALANCE | No | Report, suggest deposit |
|
|
258
|
-
| MARGIN_INSUFFICIENT | No | Suggest lower leverage or smaller size |
|
|
259
|
-
| SYMBOL_NOT_FOUND | No | Run `market list` for valid symbols |
|
|
260
|
-
| SIGNATURE_FAILED | No | Run `wallet show` to check key configuration |
|
|
261
|
-
| RATE_LIMITED | Yes | Wait 5s, retry once |
|
|
262
|
-
| EXCHANGE_UNREACHABLE | Yes | Wait 5s, retry up to 3 times |
|
|
263
|
-
| TIMEOUT | Yes | Retry, check network |
|
|
106
|
+
All responses: `{ "ok": true, "data": {...} }` or `{ "ok": false, "error": { "code": "...", "retryable": true/false } }`
|
|
264
107
|
|
|
265
|
-
|
|
108
|
+
Retryable (wait 5s, retry once): `RATE_LIMITED`, `EXCHANGE_UNREACHABLE`, `TIMEOUT`
|
|
109
|
+
Not retryable: `INSUFFICIENT_BALANCE`, `MARGIN_INSUFFICIENT`, `SYMBOL_NOT_FOUND`
|
|
266
110
|
|
|
267
|
-
|
|
268
|
-
- Warn if single trade exceeds 50% of available balance
|
|
269
|
-
- Warn if leverage exceeds 10x
|
|
270
|
-
- Double-confirm bridge transfers over $1000
|
|
271
|
-
|
|
272
|
-
## Troubleshooting
|
|
273
|
-
|
|
274
|
-
### "No private key configured for <exchange>"
|
|
275
|
-
The wallet is not set up. Fix:
|
|
276
|
-
```bash
|
|
277
|
-
perp --json wallet set <exchange> <key> # if user has a key
|
|
278
|
-
perp --json wallet generate evm # if user needs a new EVM wallet
|
|
279
|
-
perp --json wallet generate solana # if user needs a new Solana wallet
|
|
280
|
-
perp --json wallet show # verify it worked
|
|
281
|
-
```
|
|
282
|
-
|
|
283
|
-
### Command hangs or waits for input
|
|
284
|
-
You used an interactive command. NEVER use `perp init` or any command without `--json`. Cancel and retry with `--json`.
|
|
285
|
-
|
|
286
|
-
### Generated wallet has zero balance
|
|
287
|
-
New wallets start empty. Show the address to the user and ask them to fund it with USDC before trading.
|
|
288
|
-
|
|
289
|
-
## MCP Server (Advisor Mode)
|
|
290
|
-
|
|
291
|
-
For read-only access without CLI execution:
|
|
292
|
-
```json
|
|
293
|
-
{
|
|
294
|
-
"mcpServers": {
|
|
295
|
-
"perp-cli": {
|
|
296
|
-
"command": "npx",
|
|
297
|
-
"args": ["-y", "perp-cli", "mcp"],
|
|
298
|
-
"env": {
|
|
299
|
-
"HL_PRIVATE_KEY": "<evm-hex>",
|
|
300
|
-
"PACIFICA_PRIVATE_KEY": "<solana-base58>"
|
|
301
|
-
}
|
|
302
|
-
}
|
|
303
|
-
}
|
|
304
|
-
}
|
|
305
|
-
```
|
|
111
|
+
## References
|
|
306
112
|
|
|
307
|
-
|
|
113
|
+
- `references/commands.md` — full command reference
|
|
114
|
+
- `references/agent-operations.md` — setup flows, deposit/withdraw, idempotency
|
|
115
|
+
- `references/strategies.md` — risk framework, arb strategy, opportunity cost
|
|
@@ -311,10 +311,10 @@ perp --json risk limits \
|
|
|
311
311
|
--max-leverage 5 \
|
|
312
312
|
--max-margin 60 \
|
|
313
313
|
--max-drawdown-pct 10 \
|
|
314
|
-
--max-position-pct
|
|
314
|
+
--max-position-pct 80 \
|
|
315
315
|
--max-drawdown 500 \
|
|
316
|
-
--max-position
|
|
317
|
-
--max-exposure
|
|
316
|
+
--max-position 50000 \
|
|
317
|
+
--max-exposure 100000 \
|
|
318
318
|
--daily-loss 200 \
|
|
319
319
|
--min-liq-distance 30
|
|
320
320
|
```
|
|
@@ -380,8 +380,8 @@ perp --json portfolio # totalEquity, marginUtilization, c
|
|
|
380
380
|
```
|
|
381
381
|
|
|
382
382
|
Rules of thumb:
|
|
383
|
-
- **Single position notional <
|
|
384
|
-
- **Total margin used <
|
|
383
|
+
- **Single position notional < 80% of that exchange's available balance**
|
|
384
|
+
- **Total margin used < 80% of total equity** — leave buffer for adverse moves
|
|
385
385
|
- **Capital in transit (bridging) counts as "at risk"** — it's not available for margin
|
|
386
386
|
|
|
387
387
|
### Per-Exchange Balance Constraints
|