@hypurrquant/defi-cli 0.4.1 → 1.0.0

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.
Files changed (12) hide show
  1. package/README.md +156 -265
  2. package/config/pools.example.toml +1 -1
  3. package/dist/index.js +8921 -6091
  4. package/dist/index.js.map +1 -1
  5. package/dist/main.js +8965 -6133
  6. package/dist/main.js.map +1 -1
  7. package/dist/mcp-server.js +1122 -126
  8. package/dist/mcp-server.js.map +1 -1
  9. package/package.json +3 -3
  10. package/skills/defi-cli/SKILL.md +0 -1
  11. package/skills/defi-cli/references/protocols.md +0 -1
  12. package/config/protocols/lending/lendle_mantle.toml +0 -14
package/README.md CHANGED
@@ -1,325 +1,202 @@
1
- # defi-cli
1
+ # @hypurrquant/defi-cli
2
2
 
3
3
  [![npm version](https://img.shields.io/npm/v/@hypurrquant/defi-cli.svg)](https://www.npmjs.com/package/@hypurrquant/defi-cli)
4
4
  [![npm downloads](https://img.shields.io/npm/dw/@hypurrquant/defi-cli.svg)](https://www.npmjs.com/package/@hypurrquant/defi-cli)
5
5
  [![license](https://img.shields.io/npm/l/@hypurrquant/defi-cli.svg)](https://github.com/hypurrquant/defi-cli/blob/main/LICENSE)
6
6
 
7
- Multi-chain DeFi CLI — **HyperEVM** (17 protocols) and **Mantle** (4 protocols) for lending, DEX, LP, bridge, and portfolio operations.
7
+ Multi-chain DeFi CLI — **7 chains · 48 protocols · 5 aggregators**. Lending, LP farming with emission claim, DEX swap via aggregator, cross-chain bridge.
8
8
 
9
9
  ```bash
10
- npm install -g @hypurrquant/defi-cli # global install
10
+ npm install -g @hypurrquant/defi-cli
11
11
  defi --json status
12
12
 
13
- # Or without global install (restricted environments)
13
+ # Or one-shot
14
14
  npx -y @hypurrquant/defi-cli --json status
15
15
  ```
16
16
 
17
- ## Features
18
-
19
- - **2 Chains** — HyperEVM (chain 999) and Mantle (chain 5000)
20
- - **21 Protocols** — lending (Aave V3 forks, Morpho, HypurrFi), DEX (KittenSwap, Ramses, Uniswap V3, Merchant Moe LB), vaults, CDP
21
- - **Lending** — rates, positions, supply, withdraw across all lending protocols
22
- - **DEX** — add/remove liquidity with multicall optimization
23
- - **LP Management** — discover emission pools with APR/TVL/MOE-per-day, add, farm, claim, remove, autopilot
24
- - **DEX Aggregator** — best-price swap via KyberSwap, OpenOcean, LiquidSwap
25
- - **Bridge** — cross-chain token transfer via LI.FI, deBridge, CCTP
26
- - **Portfolio** — aggregate positions across lending and LP
27
- - **Auto-Approve** — checks allowance, exact-approves, then executes in one flow
28
- - **Agent-First Design** — `--json`, `--fields`, `--ndjson`, `--dry-run`, runtime schema introspection
29
- - **MCP Server** — 14 tools for Claude Desktop, Cursor, and other MCP clients
30
- - **Claude Code Skill** — installable skill for AI-assisted DeFi operations
17
+ ## Supported Chains
18
+
19
+ | Chain | ID | Status | Protocols |
20
+ |---|---|---|---|
21
+ | HyperEVM | 999 | 🟢 production | 11 |
22
+ | Mantle | 5000 | 🟢 production | 3 |
23
+ | Base | 8453 | 🟢 production | 5 |
24
+ | BNB | 56 | 🟡 staged | 16 |
25
+ | Monad | 143 | 🟡 staged | 4 |
26
+ | Arbitrum | 42161 | 🟡 staged | 3 |
27
+ | Ethereum | 1 | 🟡 staged | 6 |
28
+
29
+ 🟢 = full lifecycle broadcast verified (mint/supply → claim → withdraw)
30
+ 🟡 = configs + read-only paths verified, awaiting funded broadcast
31
+
32
+ ## Supported Protocols
33
+
34
+ ### HyperEVM (11)
35
+ | Slug | Category | Notes |
36
+ |---|---|---|
37
+ | `hyperlend`, `hypurrfi` | Lending | Aave V3 forks |
38
+ | `felix-morpho` | Lending | Morpho Blue + MetaMorpho ERC-4626 routing |
39
+ | `project-x`, `hyperswap` | DEX | Uniswap V3 fee-only |
40
+ | `curve-hyperevm` | DEX | Curve StableswapNG |
41
+ | `ramses-cl` | DEX | Uniswap V3 + Ramses x(3,3) auto-stake |
42
+ | `ramses-hl` | DEX | Solidly V2 ve(3,3), RAM emission |
43
+ | `kittenswap` | DEX | Algebra V3 + Eternal Farming, KITTEN/WHYPE |
44
+ | `hybra` | DEX | Hybra V4 CL + GaugeManager (HYBR vesting) |
45
+ | `nest` | DEX | Algebra V3 + off-chain ticket NEST claim |
46
+
47
+ ### Mantle (3)
48
+ | Slug | Category | Notes |
49
+ |---|---|---|
50
+ | `aave-v3-mantle` | Lending | |
51
+ | `uniswap-v3-mantle` | DEX | |
52
+ | `merchantmoe-mantle` | DEX | LB hooks + MasterChef MOE emission |
53
+
54
+ ### Base (5)
55
+ | Slug | Category | Notes |
56
+ |---|---|---|
57
+ | `aave-v3-base` | Lending | |
58
+ | `compound-v3-base` | Lending | Comet |
59
+ | `uniswap-v3-base` | DEX | |
60
+ | `aerodrome-base` | DEX | Solidly V2, AERO emission |
61
+ | `aerodrome-cl` | DEX | Slipstream CL with NFT gauge, AERO emission |
62
+
63
+ ### BNB (16)
64
+ - **Lending**: `aave-v3-bnb`, `kinza-bnb`, `venus-bnb`, `venus-flux-bnb`
65
+ - **DEX**: `pancakeswap-v3-bnb` (+ MasterChef CAKE), `pancakeswap-v2-bnb`, `uniswap-v3-bnb`, `thena-v1`, `thena-fusion`, `biswap-bnb`, `apeswap-bnb`, `bakeryswap-bnb`, `bscswap-bnb`, `babydogeswap-bnb`, `fstswap-bnb`
66
+ - **Vault**: `beefy-bnb`
67
+
68
+ ### Monad (4)
69
+ `uniswap-v2-monad`, `uniswap-v3-monad`, `traderjoe-monad` (LB), `morpho-blue-monad`
70
+
71
+ ### Ethereum (6)
72
+ `aave-v2-ethereum`, `aave-v3-ethereum`, `compound-v3-ethereum`, `morpho-blue-ethereum`, `uniswap-v2-ethereum`, `uniswap-v3-ethereum`
73
+
74
+ ### Arbitrum (3)
75
+ `aave-v3-arbitrum`, `compound-v3-arbitrum`, `uniswap-v3-arbitrum`
76
+
77
+ ## DEX Aggregators (Live-verified)
78
+
79
+ | Aggregator | HyperEVM | Mantle | Base | BNB | Ethereum | Arbitrum |
80
+ |---|---|---|---|---|---|---|
81
+ | KyberSwap | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ |
82
+ | OpenOcean | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
83
+ | LiquidSwap | ✅ | — | — | — | — | — |
84
+ | LI.FI | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
85
+ | Relay | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
31
86
 
32
87
  ## Setup
33
88
 
34
89
  ```bash
35
- # Set wallet credentials
36
- export DEFI_PRIVATE_KEY="0x..." # Private key for transactions
37
- export DEFI_WALLET_ADDRESS="0x..." # Wallet address for queries
90
+ # Wallet credentials
91
+ export DEFI_PRIVATE_KEY="0x..."
92
+ export DEFI_WALLET_ADDRESS="0x..."
38
93
 
39
- # Optional: override RPC endpoints (defaults provided)
94
+ # Optional: override RPC endpoints
40
95
  export HYPEREVM_RPC_URL="https://..."
41
96
  export MANTLE_RPC_URL="https://..."
97
+ export BASE_RPC_URL="https://..."
98
+
99
+ # Or use OWS encrypted vault wallets
100
+ defi ows create my-wallet
101
+ export DEFI_WALLET_ADDRESS="ows:my-wallet"
42
102
 
43
103
  # Interactive setup wizard
44
104
  defi setup
45
-
46
- # Verify setup
47
- defi --json status
48
105
  ```
49
106
 
50
107
  ## Command Reference
51
108
 
52
109
  | Command | Description |
53
110
  |---------|-------------|
54
- | `defi` | Dashboard — multicall balances across all protocols |
55
- | `defi yield` | Cross-chain lending APY comparison (all chains, filter with `--chain`) |
56
- | `defi swap` | DEX aggregator swap (KyberSwap, OpenOcean, LiquidSwap) |
57
- | `defi lp discover` | Scan emission pools with APR, TVL, rewards data |
58
- | `defi lp add` | Add liquidity to a pool |
59
- | `defi lp farm` | Add liquidity and auto-stake for emissions |
60
- | `defi lp claim` | Claim fee and emission rewards |
61
- | `defi lp remove` | Auto-unstake and remove liquidity |
62
- | `defi lp autopilot` | Whitelist-based auto-allocation across pools |
63
- | `defi lending` | Supply, withdraw, rates, position |
64
- | `defi portfolio` | Aggregate positions across all protocols |
65
- | `defi price` | Oracle and DEX prices |
66
- | `defi token` | Approve, allowance, transfer, balance |
67
- | `defi wallet` | Address management |
68
- | `defi bridge` | Cross-chain transfer (LI.FI, deBridge, CCTP) |
69
- | `defi status` | Protocol overview |
70
- | `defi schema` | JSON schema for agent introspection |
71
- | `defi setup` | Interactive wallet/RPC config wizard |
72
-
73
- ## Supported Protocols
111
+ | `lp discover` | Scan emission pools (gauge/LB/MasterChef/Curve). `--emission-only` filters & sorts by APR |
112
+ | `lp add` | Add liquidity (V3 NPM, Slipstream CL, LB router auto-dispatch) |
113
+ | `lp farm` | Add + auto-stake into gauge or LB |
114
+ | `lp claim` | Claim emission/fees (auto-detects user's actual LB bins) |
115
+ | `lp remove` | Auto-unstake + remove (LB supports `--bins`, `--amounts`) |
116
+ | `lp compound` | V3 fee-only auto-compound (collect + increaseLiquidity multicall) |
117
+ | `lp positions` | Show all positions + pending rewards (LB auto-scans all rewarded pools) |
118
+ | `lp pipeline` | Print mint→stake→claim CLI sequence for a protocol |
119
+ | `lp autopilot` | Whitelist-based budget allocation (`~/.defi/pools.toml`) |
120
+ | `lending` | rates / position / supply / borrow / repay / withdraw |
121
+ | `yield` | compare / scan (cross-chain) / optimize / execute |
122
+ | `swap` | DEX aggregator (kyber, openocean, liquid, lifi, relay) |
123
+ | `bridge` | Cross-chain (lifi, debridge, cctp) |
124
+ | `portfolio` | show / snapshot / pnl / history |
125
+ | `price` | Oracle + DEX prices |
126
+ | `wallet` | Address management |
127
+ | `token` | balance / approve / allowance / transfer |
128
+ | `ows` | Encrypted vault wallet (multi-chain HD) |
129
+ | `setup` | Interactive wizard |
130
+ | `status` | Protocol overview |
131
+ | `schema` | JSON schema for agent introspection |
74
132
 
75
- ### HyperEVM (17 protocols)
76
-
77
- | Protocol | Category | Interface |
78
- |----------|----------|-----------|
79
- | KittenSwap | DEX | Algebra V3 (CL) |
80
- | NEST V1 | DEX | Algebra V3 (CL) |
81
- | Ramses HL | DEX | Solidly V2 (ve(3,3)) |
82
- | Ramses CL | DEX | Uniswap V3 (CL) |
83
- | Project X | DEX | Uniswap V2 |
84
- | Hybra | DEX | Solidly V2 |
85
- | HyperLend | Lending | Aave V3 |
86
- | HypurrFi | Lending | Aave V3 |
87
- | Felix Morpho | Lending | Morpho Blue |
88
- | Felix Vaults | Vault | ERC-4626 |
89
- | Felix CDP | CDP | Liquity V2 |
90
- | Hyperbeat | Vault | ERC-4626 |
91
- | Looping | Vault | ERC-4626 |
92
- | Upshift | Vault | ERC-4626 |
93
- | Lazy Summer | Yield Aggregator | ERC-4626 |
94
- | Hypersurface | Options | — |
95
- | Seaport | NFT | — |
96
-
97
- ### Mantle (4 protocols)
98
-
99
- | Protocol | Category | Interface |
100
- |----------|----------|-----------|
101
- | Aave V3 | Lending | Aave V3 |
102
- | Lendle | Lending | Aave V3 Fork |
103
- | Uniswap V3 | DEX | Uniswap V3 (CL) |
104
- | Merchant Moe | DEX | Uniswap V2 + Liquidity Book |
105
-
106
- ## Core Commands
107
-
108
- ### Dashboard
133
+ ## Examples
109
134
 
135
+ ### Cross-chain yield comparison
110
136
  ```bash
111
- # Multicall balance dashboard
112
- defi --json
113
-
114
- # Protocol overview (all chains)
115
- defi --json status
116
-
117
- # Single chain
118
- defi --json --chain mantle status
137
+ defi --json yield scan --asset USDC
119
138
  ```
120
139
 
121
- ### Lending
122
-
140
+ ### LB liquidity + auto-claim MOE on Mantle
123
141
  ```bash
124
- # Cross-chain lending APY comparison (scans all chains by default)
125
- defi --json yield
126
- defi --json --chain mantle yield --asset USDT
127
-
128
- # Check user position
129
- defi --json --chain hyperevm lending position --protocol hyperlend
142
+ # Add LB liquidity centred ±3 bins around active
143
+ defi --chain mantle lp add --protocol merchantmoe-mantle \
144
+ --token-a WMNT --token-b USDT0 --amount-a 1000000000000000000 --amount-b 600000 \
145
+ --pool 0x03BeafC0d25BB553fCa274301832419C05269987 --num-bins 3 --broadcast
130
146
 
131
- # Supply collateral (auto-approve included)
132
- defi --json --chain hyperevm lending supply --protocol hyperlend --asset USDC --amount 1000000000 --broadcast
147
+ # See pending MOE across all my LB positions (auto-scans all pools)
148
+ defi --chain mantle lp positions --protocol merchantmoe-mantle
133
149
 
134
- # Withdraw collateral
135
- defi --json --chain hyperevm lending withdraw --protocol hyperlend --asset USDC --amount 500000000 --broadcast
150
+ # Claim — auto-detects user's actual bins (active±50 scan)
151
+ defi --chain mantle lp claim --protocol merchantmoe-mantle \
152
+ --pool 0x03BeafC0d25BB553fCa274301832419C05269987 --broadcast
136
153
  ```
137
154
 
138
- ### DEX Aggregator Swap
139
-
140
- Uses KyberSwap, OpenOcean, and LiquidSwap to find the best route automatically.
141
-
155
+ ### Aerodrome Slipstream CL on Base
142
156
  ```bash
143
- # Dry-run (default — no transaction)
144
- defi --json --chain hyperevm swap --from WHYPE --to USDC --amount 1000000000000000000
145
-
146
- # Execute swap
147
- defi --json --chain hyperevm swap --from WHYPE --to USDC --amount 1000000000000000000 --broadcast
157
+ # Mint + auto-stake CL position with ±5% range
158
+ defi --chain base lp farm --protocol aerodrome-cl \
159
+ --token-a WETH --token-b USDC --amount-a 50000000000000 --amount-b 110000 \
160
+ --range 5 --pool 0xb2cc224c1c9feE385f8ad6a55b4d94E92359DC59 --broadcast
148
161
 
149
- # With slippage (basis points)
150
- defi --json --chain hyperevm swap --from WHYPE --to USDC --amount 1000000000000000000 --slippage 100 --broadcast
162
+ # Claim AERO; gauge.withdraw also auto-claims pending on unstake
163
+ defi --chain base lp claim --protocol aerodrome-cl \
164
+ --gauge 0xF33a96b5932D9E9B9A0eDA447AbD8C9d48d2e0c8 --token-id <id> --broadcast
151
165
  ```
152
166
 
153
- ### LP Operations
154
-
155
- #### Discover Pools
156
-
167
+ ### DEX aggregator swap
157
168
  ```bash
158
- # Discover emission pools with APR, TVL, rewards (requires --chain)
159
- defi --json --chain hyperevm lp discover
160
-
161
- # Mantle LB pools with MOE/day, APR, pool TVL
162
- defi --json --chain mantle lp discover
163
-
164
- # Filter by protocol
165
- defi --json --chain hyperevm lp discover --protocol kittenswap
166
- ```
167
-
168
- #### Add Liquidity
169
-
170
- ```bash
171
- defi --json --chain hyperevm lp add --protocol kittenswap --pool 0x... --amount-a 1000000000000000000 --amount-b 5000000000 --broadcast
172
- ```
173
-
174
- #### Farm (Add + Auto-stake)
175
-
176
- ```bash
177
- # Add liquidity and stake into gauge/farming in one step
178
- defi --json --chain hyperevm lp farm --protocol kittenswap --pool 0x... --amount-a 1000000000000000000 --amount-b 5000000000 --broadcast
179
- ```
180
-
181
- #### Claim Rewards
182
-
183
- ```bash
184
- # Claim fee and emission rewards from a pool
185
- defi --json --chain hyperevm lp claim --protocol kittenswap --pool 0x... --broadcast
186
- ```
187
-
188
- #### Remove Liquidity
189
-
190
- ```bash
191
- # Auto-unstake (if staked) and remove liquidity
192
- defi --json --chain hyperevm lp remove --protocol kittenswap --pool 0x... --broadcast
193
- ```
194
-
195
- #### LP Autopilot
196
-
197
- Reads `~/.defi/pools.toml` for whitelisted pools and allocates budget automatically.
198
-
199
- ```bash
200
- # Dry-run autopilot allocation
201
- defi --json lp autopilot --budget 1000000000 # 1000 USDC
202
-
203
- # Execute
204
- defi --json lp autopilot --budget 1000000000 --broadcast
205
- ```
206
-
207
- **pools.toml example:**
208
-
209
- ```toml
210
- [[pools]]
211
- protocol = "kittenswap"
212
- pool_address = "0xYourPoolAddress"
213
- weight = 50 # 50% of budget
214
-
215
- [[pools]]
216
- protocol = "nest-v1"
217
- pool_address = "0xAnotherPool"
218
- weight = 50
219
- ```
220
-
221
- Default location: `~/.defi/pools.toml`
222
-
223
- ### Bridge
224
-
225
- ```bash
226
- # Bridge via LI.FI (default)
227
- defi --json bridge --token USDC --amount 100000000 --to-chain mantle
228
-
229
- # Bridge via deBridge DLN
230
- defi --json bridge --token USDC --amount 100000000 --to-chain arbitrum --provider debridge --broadcast
231
-
232
- # Native USDC via Circle CCTP V2
233
- defi --json bridge --token USDC --amount 100000000 --to-chain arbitrum --provider cctp --broadcast
234
- ```
235
-
236
- ### Portfolio
237
-
238
- ```bash
239
- # Aggregate positions across all protocols
240
- defi --json --chain hyperevm portfolio show --address 0xYourAddress
241
- ```
242
-
243
- ### Token & Wallet
244
-
245
- ```bash
246
- # Token operations (--chain required)
247
- defi --json --chain hyperevm token balance --owner 0x... --token USDC
248
- defi --json --chain hyperevm token allowance --owner 0x... --token USDC --spender 0x...
249
- defi --json --chain hyperevm token approve --token USDC --spender 0x... --amount 1000000 --broadcast
250
- defi --json --chain hyperevm token transfer --token USDC --to 0x... --amount 1000000 --broadcast
251
-
252
- # Wallet management
253
- defi --json --chain hyperevm wallet balance --address 0x...
254
- ```
255
-
256
- ### Price & Market Data
257
-
258
- ```bash
259
- # Oracle + DEX prices (--chain required)
260
- defi --json --chain hyperevm price --asset WHYPE
261
-
262
- # DEX prices only
263
- defi --json --chain hyperevm price --asset WHYPE --source dex
264
-
265
- # Oracle prices only
266
- defi --json --chain hyperevm price --asset USDC --source oracle
169
+ # Pick the cheapest provider per chain
170
+ defi --chain mantle swap --provider lifi --from MOE --to WMNT --amount <wei> --broadcast
171
+ defi --chain base swap --provider kyber --from WETH --to USDC --amount <wei> --broadcast
172
+ defi --chain ethereum swap --provider relay --from WETH --to USDC --amount <wei> --broadcast
267
173
  ```
268
174
 
269
175
  ## Agent-First Design
270
176
 
271
- Built for AI agents and automation with structured output, schema introspection, and validation:
272
-
273
177
  ```bash
274
178
  # Every command returns JSON envelope
275
179
  defi --json status
276
180
  # → { "ok": true, "data": {...}, "meta": { "timestamp": "..." } }
277
181
 
278
- # Runtime schema introspection (query available commands)
182
+ # Schema introspection
279
183
  defi --json schema
280
184
 
281
- # Filter output to specific fields (saves tokens)
185
+ # Filter output (saves tokens)
282
186
  defi --json --fields balance,positions status
283
187
 
284
- # Stream large lists as NDJSON (one JSON per line)
188
+ # Stream large lists
285
189
  defi --json --ndjson lp discover
286
190
 
287
- # Pre-validate before executing
288
- defi --json --chain hyperevm swap --from WHYPE --to USDC --amount 1000000000000000000
289
-
290
- # Safe by default: --dry-run is on, use --broadcast to execute
291
- defi --json --chain hyperevm swap --from WHYPE --to USDC --amount 1000000000000000000 --broadcast
292
- ```
293
-
294
- Responses include `needs_approval` simulation status. Auto-approve flow: check allowance → exact approve → execute tx.
295
-
296
- All responses are auto-sanitized (control chars stripped, prompt injection patterns blocked).
297
- Errors include `retryable` flag — only retry when `true`.
298
-
299
- ## Global Flags
300
-
301
- ```bash
302
- --json # Output as JSON (structured for agents)
303
- --ndjson # Output as newline-delimited JSON
304
- --fields <f> # Select output fields (comma-separated)
305
- --chain <chain> # Target chain: hyperevm or mantle (required for tx commands)
306
- --dry-run # Dry-run mode (default, no broadcast)
307
- --broadcast # Execute transaction on-chain
191
+ # Dry-run by default — explicit --broadcast required
192
+ defi --chain hyperevm swap --from WHYPE --to USDC --amount 1000000000000000000 # simulated
193
+ defi --chain hyperevm swap --from WHYPE --to USDC --amount 1000000000000000000 --broadcast # executed
308
194
  ```
309
195
 
310
- ## Environment Variables
311
-
312
- ```bash
313
- DEFI_PRIVATE_KEY # Private key for signing transactions
314
- DEFI_WALLET_ADDRESS # Wallet address for queries and execution
315
- HYPEREVM_RPC_URL # Override HyperEVM RPC endpoint
316
- MANTLE_RPC_URL # Override Mantle RPC endpoint
317
- ```
196
+ Auto-approve flow: simulation returns `needs_approval` with `pending_approvals` list → executor prepends the approve tx automatically.
318
197
 
319
198
  ## MCP Server
320
199
 
321
- 17 MCP tools for Claude Desktop, Cursor, and other MCP clients.
322
-
323
200
  ```json
324
201
  {
325
202
  "mcpServers": {
@@ -331,21 +208,35 @@ MANTLE_RPC_URL # Override Mantle RPC endpoint
331
208
  }
332
209
  ```
333
210
 
334
- **Available tools:** `defi_status`, `defi_yield`, `defi_lending_rates`, `defi_lending_supply`, `defi_lending_withdraw`, `defi_lp_discover`, `defi_lp_add`, `defi_lp_farm`, `defi_lp_claim`, `defi_lp_remove`, `defi_swap`, `defi_bridge`, `defi_price`, `defi_token_balance`, `defi_token_approve`, `defi_portfolio`, `defi_schema`
335
-
336
- See `mcp-config.example.json` for full configuration.
211
+ Tools include: `defi_status`, `defi_yield_scan`, `defi_lending_*`, `defi_lp_*`, `defi_swap`, `defi_bridge`, `defi_price`, `defi_token_*`, `defi_portfolio`, `defi_schema`. See `mcp-config.example.json`.
337
212
 
338
213
  ## Claude Code Skill
339
214
 
340
- Install the skill for AI-assisted DeFi operations:
341
-
342
215
  ```bash
343
- # Install from npm package
344
216
  npx -y @hypurrquant/defi-cli skill install
345
217
  ```
346
218
 
347
219
  Or copy `skills/defi-cli/` into your Claude Code skills directory.
348
220
 
221
+ ## Environment Variables
222
+
223
+ | Variable | Description |
224
+ |---|---|
225
+ | `{CHAIN}_RPC_URL` | Per-chain RPC override (e.g., `MANTLE_RPC_URL`, `BASE_RPC_URL`) |
226
+ | `DEFI_PRIVATE_KEY` | Private key for `--broadcast` |
227
+ | `DEFI_WALLET_ADDRESS` | Default wallet (accepts `ows:<name>` for OWS vault) |
228
+
229
+ ## Global Flags
230
+
231
+ ```bash
232
+ --chain <name> # hyperevm | mantle | base | bnb | monad | arbitrum | ethereum
233
+ --json # JSON output
234
+ --ndjson # NDJSON streaming
235
+ --fields <a,b> # Output field filter
236
+ --dry-run # Default — simulate only
237
+ --broadcast # Send tx on-chain
238
+ ```
239
+
349
240
  ## License
350
241
 
351
242
  MIT
package/config/pools.example.toml CHANGED
@@ -11,7 +11,7 @@ max_allocation_pct = 40 # max % of budget for this pool
11
11
 
12
12
  [[whitelist]]
13
13
  chain = "mantle"
14
- protocol = "lendle-mantle"
14
+ protocol = "aave-v3-mantle"
15
15
  asset = "USDC"
16
16
  type = "lending"
17
17
  max_allocation_pct = 40