@hypurrquant/defi-cli 1.0.0 → 1.0.2

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 +10 -18
  2. package/dist/index.js +171 -68
  3. package/dist/index.js.map +1 -1
  4. package/dist/main.js +231 -136
  5. package/dist/main.js.map +1 -1
  6. package/dist/mcp-server.js +408 -7
  7. package/dist/mcp-server.js.map +1 -1
  8. package/package.json +1 -1
  9. package/skills/defi-cli/SKILL.md +121 -90
  10. package/skills/defi-cli/package.json +11 -3
  11. package/skills/defi-cli/references/commands.md +106 -53
  12. package/skills/defi-cli/references/protocols.md +100 -67
package/skills/defi-cli/references/protocols.md CHANGED
@@ -1,94 +1,133 @@
1
1
  # defi-cli Protocol Reference
2
2
 
3
- ## HyperEVM (chain: `hyperevm`, Chain ID: 999)
4
-
5
- ### Lending Protocols
3
+ ## HyperEVM (chain: `hyperevm`, Chain ID: 999) — 🟢 production
6
4
 
5
+ ### Lending
7
6
  | Slug | Name | Interface | Notes |
8
7
  |------|------|-----------|-------|
9
- | `hyperlend` | HyperLend | aave_v3 | Main Aave V3 fork |
10
- | `hypurrfi` | HypurrFi | aave_v3 | HypurrQuant native lending |
11
- | `felix-morpho` | Felix Morpho | morpho_blue | Morpho Blue vaults |
12
-
13
- ### DEX Protocols
8
+ | `hyperlend` | HyperLend | aave_v3 | Aave V3 fork |
9
+ | `hypurrfi` | HypurrFi | aave_v3 | HypurrQuant native |
10
+ | `felix-morpho` | Felix Morpho | morpho_blue | MetaMorpho ERC-4626 vault routing |
14
11
 
12
+ ### DEX
15
13
  | Slug | Name | Interface | Notes |
16
14
  |------|------|-----------|-------|
17
- | `kittenswap` | KittenSwap | algebra_v3 | Algebra V3 (concentrated); 16 gauge pools |
18
- | `nest-v1` | NEST V1 | algebra_v3 | Algebra V3 fork; 13 gauge pools |
19
- | `ramses-cl` | Ramses CL | uniswap_v3 | Concentrated liquidity; 25 gauge pools |
20
- | `ramses-hl` | Ramses HL | solidly_v2 | Solidly V2 ve(3,3) |
21
- | `hybra` | Hybra | solidly_v2 | Solidly V2; 45 gauge pools |
22
- | `project-x` | Project X | uniswap_v2 | Uniswap V2 fork |
15
+ | `project-x` | Project X | uniswap_v3 | V3 fee-only |
16
+ | `hyperswap` | HyperSwap | uniswap_v3 | V3 fee-only |
17
+ | `curve-hyperevm` | Curve | curve_stableswap | StableswapNG factory |
18
+ | `ramses-cl` | Ramses CL | uniswap_v3 + cl_style="ramses" | x(3,3) auto-stake, NPM.getPeriodReward |
19
+ | `ramses-hl` | Ramses HL | solidly_v2 | ve(3,3) gauge, RAM emission |
20
+ | `kittenswap` | KittenSwap | algebra_v3 + farming_center | KITTEN/WHYPE eternal farming |
21
+ | `hybra` | Hybra V4 | hybra | CL gauge + GaugeManager + 2-year veHYBR lock (default) |
22
+ | `nest` | NEST | algebra_v3 | Off-chain ticket NEST claim |
23
23
 
24
- ### Vault Protocols (ERC-4626)
24
+ ---
25
25
 
26
- | Slug | Name | Notes |
27
- |------|------|-------|
28
- | `felix-vaults` | Felix Vaults | CDP-backed vaults |
29
- | `hyperbeat` | Hyperbeat | Auto-compounding vault |
30
- | `looping` | Looping | Leverage looping |
31
- | `upshift` | Upshift | Yield optimization |
32
- | `lazy-summer` | Lazy Summer | Yield aggregator |
26
+ ## Mantle (chain: `mantle`, Chain ID: 5000) — 🟢 production
33
27
 
34
- ### CDP Protocols
28
+ | Slug | Name | Interface | Notes |
29
+ |------|------|-----------|-------|
30
+ | `aave-v3-mantle` | Aave V3 | aave_v3 | Official Aave V3 |
31
+ | `uniswap-v3-mantle` | Uniswap V3 | uniswap_v3 | Concentrated liquidity |
32
+ | `merchantmoe-mantle` | Merchant Moe | uniswap_v2 + lb_factory + masterchef | LB hooks + MasterChef MOE emission via veMOE-weighted pid |
35
33
 
36
- | Slug | Name | Interface | Stablecoin |
37
- |------|------|-----------|------------|
38
- | `felix` | Felix CDP | liquity_v2 | feUSD |
34
+ ---
39
35
 
40
- ### Other
36
+ ## Base (chain: `base`, Chain ID: 8453) — 🟢 production
41
37
 
42
- | Slug | Name | Category |
43
- |------|------|----------|
44
- | `hypersurface` | Hypersurface | options |
45
- | `seaport-hyperevm` | Seaport | nft marketplace |
38
+ | Slug | Name | Interface | Notes |
39
+ |------|------|-----------|-------|
40
+ | `aave-v3-base` | Aave V3 | aave_v3 | Official |
41
+ | `compound-v3-base` | Compound V3 | compound_v3 | Comet (USDC market) |
42
+ | `uniswap-v3-base` | Uniswap V3 | uniswap_v3 | V3 fee-only |
43
+ | `aerodrome-base` | Aerodrome | solidly_v2 | ve(3,3) gauge, AERO emission |
44
+ | `aerodrome-cl` | Aerodrome Slipstream | uniswap_v3 + cl_style="slipstream" | NFT-gated CL gauge, AERO emission |
46
45
 
47
46
  ---
48
47
 
49
- ## Mantle (chain: `mantle`, Chain ID: 5000)
48
+ ## BNB Chain (chain: `bnb`, Chain ID: 56) — 🟡 staged
50
49
 
51
- ### Lending Protocols
50
+ ### Lending
51
+ | Slug | Name | Interface |
52
+ |------|------|-----------|
53
+ | `aave-v3-bnb` | Aave V3 BNB | aave_v3 |
54
+ | `kinza-bnb` | Kinza | aave_v3 |
55
+ | `venus-bnb` | Venus | compound_v2 |
56
+ | `venus-flux-bnb` | Venus Flux | compound_v2 |
52
57
 
58
+ ### DEX
53
59
  | Slug | Name | Interface | Notes |
54
60
  |------|------|-----------|-------|
55
- | `aave-v3-mantle` | Aave V3 Mantle | aave_v3 | Official Aave V3 |
61
+ | `pancakeswap-v3-bnb` | PancakeSwap V3 | uniswap_v3 + masterchef | CAKE emission via MasterChef |
62
+ | `pancakeswap-v2-bnb` | PancakeSwap V2 | uniswap_v2 | |
63
+ | `uniswap-v3-bnb` | Uniswap V3 | uniswap_v3 | |
64
+ | `thena-v1` | Thena V1 | solidly_v2 | ve(3,3) THE emission |
65
+ | `thena-fusion` | Thena Fusion | algebra_v3 + farming_center | Algebra eternal farming |
66
+ | `biswap-bnb` | Biswap | uniswap_v2 | |
67
+ | `apeswap-bnb` | ApeSwap | uniswap_v2 | |
68
+ | `bakeryswap-bnb` | BakerySwap | uniswap_v2 | |
69
+ | `bscswap-bnb` | BSCSwap | uniswap_v2 | |
70
+ | `babydogeswap-bnb` | BabyDogeSwap | uniswap_v2 | |
71
+ | `fstswap-bnb` | FSTSwap | uniswap_v2 | |
72
+
73
+ ### Vault
74
+ | `beefy-bnb` | Beefy | erc4626 | Auto-compounding |
56
75
 
57
- ### DEX Protocols
76
+ ---
77
+
78
+ ## Monad (chain: `monad`, Chain ID: 143) — 🟡 staged
58
79
 
59
80
  | Slug | Name | Interface | Notes |
60
81
  |------|------|-----------|-------|
61
- | `uniswap-v3-mantle` | Uniswap V3 | uniswap_v3 | Concentrated liquidity |
62
- | `merchantmoe-mantle` | Merchant Moe | uniswap_v2 + lb | V2 AMM + Liquidity Book; 35 LB pools |
82
+ | `uniswap-v2-monad` | Uniswap V2 | uniswap_v2 | |
83
+ | `uniswap-v3-monad` | Uniswap V3 | uniswap_v3 | |
84
+ | `traderjoe-monad` | TraderJoe LB | uniswap_v2 + lb_factory | Active LB pools (AUSD/USDC, WMNT/USDC) |
85
+ | `morpho-blue-monad` | Morpho Blue | morpho_blue | Limited markets |
86
+
87
+ ---
88
+
89
+ ## DEX Aggregator Providers (`defi swap --provider`)
90
+
91
+ | Provider | Supported chains | Notes |
92
+ |----------|------------------|-------|
93
+ | `kyber` (KyberSwap) | hyperevm, base, bnb | NOT mantle, NOT monad |
94
+ | `openocean` | hyperevm, mantle, base, bnb | Universal fallback |
95
+ | `liquid` (LiquidSwap) | hyperevm | HyperEVM-native |
96
+ | `lifi` (LI.FI) | all source chains (via chain_id) | Cross-chain capable |
97
+ | `relay` (Relay) | all source chains (via chain_id) | Multi-step routes (auto-skips approve step) |
98
+
99
+ Slug mapping per chain lives in `chains.toml [chain.X.aggregators]`. LI.FI/Relay route by numeric chain_id (slug `"auto"`).
63
100
 
64
101
  ---
65
102
 
66
- ## DEX Aggregator Providers (swap command)
103
+ ## Bridge Providers (`defi bridge --provider`)
67
104
 
68
- | Provider | Chains | Notes |
69
- |----------|--------|-------|
70
- | KyberSwap | HyperEVM, Mantle | Default for HyperEVM |
71
- | OpenOcean | HyperEVM, Mantle | Fallback aggregator |
72
- | LiquidSwap | HyperEVM | HyperEVM-native |
105
+ | Provider | Flag | Best For |
106
+ |----------|------|----------|
107
+ | LI.FI (default) | `--provider lifi` | Any token, any chain |
108
+ | deBridge DLN | `--provider debridge` | Cross-chain arbitrary tokens |
109
+ | Circle CCTP V2 | `--provider cctp` | Native USDC transfers |
110
+
111
+ CCTP supported chains: `ethereum`, `avalanche`, `optimism`, `arbitrum`, `base`, `polygon`
73
112
 
74
113
  ---
75
114
 
76
- ## Common Token Symbols
115
+ ## Common Token Symbols by Chain
77
116
 
78
117
  ### HyperEVM
79
- - `HYPE` — native token (use WHYPE for ERC-20 swaps)
80
- - `WHYPE` — wrapped HYPE (0x5555555555555555555555555555555555555555)
81
- - `USDC` — USD Coin
82
- - `USDT` — Tether
83
- - `WBTC` — Wrapped Bitcoin
84
- - `WETH` — Wrapped Ether
118
+ - `HYPE` (native), `WHYPE` (`0x5555555555555555555555555555555555555555`), `USDC`, `USDT0`, `WBTC`, `WETH`, `RAM`, `KITTEN`, `NEST`
85
119
 
86
120
  ### Mantle
87
- - `MNT` — native token
88
- - `WMNT` — wrapped MNT
89
- - `USDC` — USD Coin
90
- - `USDT` — Tether
91
- - `WETH` — Wrapped Ether
121
+ - `MNT` (native), `WMNT` (`0x78c1b0...`), `USDC` (`0x09Bc4E...`), `USDT` (`0x201E...`), `USDT0`, `WETH` (`0xdEAd...1111`), `mETH` (`0xcDA8...`), `MOE` (`0x4515...`)
122
+
123
+ ### Base
124
+ - `ETH` (native), `WETH` (`0x4200000000000000000000000000000000000006`), `USDC` (`0x83358...`), `AERO` (`0x9401...`)
125
+
126
+ ### BNB
127
+ - `BNB` (native), `WBNB` (`0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c`), `USDT` (`0x55d398...`), `USDC`, `BUSD`, `CAKE`
128
+
129
+ ### Monad
130
+ - `MON` (native), `WMON` (`0x3bd359...`), `USDC` (`0x754704...`), `USDT0`, `WETH`, `WBTC`, `wstETH`, `AUSD`
92
131
 
93
132
  ---
94
133
 
@@ -96,19 +135,13 @@
96
135
 
97
136
  | Token | Decimals | 1 token in wei |
98
137
  |-------|----------|----------------|
99
- | HYPE/WHYPE/WETH/WBTC | 18 | `1000000000000000000` |
100
- | USDC | 6 | `1000000` |
101
- | USDT | 6 | `1000000` |
102
- | MNT/WMNT | 18 | `1000000000000000000` |
138
+ | Native + WETH/WBNB/WMNT/WMON/WHYPE/mETH/AERO/MOE | 18 | `1000000000000000000` |
139
+ | USDC, USDT, USDT0 | 6 | `1000000` |
140
+ | WBTC | 8 | `100000000` |
103
141
 
104
142
  ---
105
143
 
106
- ## Bridge Provider Support
107
-
108
- | Provider | Flag | Best For |
109
- |----------|------|----------|
110
- | LI.FI (default) | `--provider lifi` | Any token, any chain |
111
- | deBridge DLN | `--provider debridge` | Cross-chain arbitrary tokens |
112
- | Circle CCTP V2 | `--provider cctp` | Native USDC transfers |
144
+ ## Verification Status
113
145
 
114
- CCTP supported chains: `ethereum`, `avalanche`, `optimism`, `arbitrum`, `base`, `polygon`
146
+ - 🟢 **production**: full lifecycle mainnet broadcast verified (mint/supply → claim emission → withdraw/remove)
147
+ - 🟡 **staged**: chain config + read-only paths verified, awaiting funded broadcast verification