@hypurrquant/defi-cli 0.5.0 → 1.0.1

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 (14) hide show
  1. package/README.md +148 -265
  2. package/config/pools.example.toml +1 -1
  3. package/dist/index.js +1489 -127
  4. package/dist/index.js.map +1 -1
  5. package/dist/main.js +1490 -128
  6. package/dist/main.js.map +1 -1
  7. package/dist/mcp-server.js +1266 -88
  8. package/dist/mcp-server.js.map +1 -1
  9. package/package.json +1 -1
  10. package/skills/defi-cli/SKILL.md +121 -91
  11. package/skills/defi-cli/package.json +11 -3
  12. package/skills/defi-cli/references/commands.md +106 -53
  13. package/skills/defi-cli/references/protocols.md +100 -68
  14. package/config/protocols/lending/lendle_mantle.toml +0 -14
package/skills/defi-cli/references/protocols.md CHANGED
@@ -1,95 +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 |
56
- | `lendle-mantle` | Lendle | aave_v3 | Mantle native lending |
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 |
57
75
 
58
- ### DEX Protocols
76
+ ---
77
+
78
+ ## Monad (chain: `monad`, Chain ID: 143) — 🟡 staged
59
79
 
60
80
  | Slug | Name | Interface | Notes |
61
81
  |------|------|-----------|-------|
62
- | `uniswap-v3-mantle` | Uniswap V3 | uniswap_v3 | Concentrated liquidity |
63
- | `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"`).
64
100
 
65
101
  ---
66
102
 
67
- ## DEX Aggregator Providers (swap command)
103
+ ## Bridge Providers (`defi bridge --provider`)
68
104
 
69
- | Provider | Chains | Notes |
70
- |----------|--------|-------|
71
- | KyberSwap | HyperEVM, Mantle | Default for HyperEVM |
72
- | OpenOcean | HyperEVM, Mantle | Fallback aggregator |
73
- | 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`
74
112
 
75
113
  ---
76
114
 
77
- ## Common Token Symbols
115
+ ## Common Token Symbols by Chain
78
116
 
79
117
  ### HyperEVM
80
- - `HYPE` — native token (use WHYPE for ERC-20 swaps)
81
- - `WHYPE` — wrapped HYPE (0x5555555555555555555555555555555555555555)
82
- - `USDC` — USD Coin
83
- - `USDT` — Tether
84
- - `WBTC` — Wrapped Bitcoin
85
- - `WETH` — Wrapped Ether
118
+ - `HYPE` (native), `WHYPE` (`0x5555555555555555555555555555555555555555`), `USDC`, `USDT0`, `WBTC`, `WETH`, `RAM`, `KITTEN`, `NEST`
86
119
 
87
120
  ### Mantle
88
- - `MNT` — native token
89
- - `WMNT` — wrapped MNT
90
- - `USDC` — USD Coin
91
- - `USDT` — Tether
92
- - `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`
93
131
 
94
132
  ---
95
133
 
@@ -97,19 +135,13 @@
97
135
 
98
136
  | Token | Decimals | 1 token in wei |
99
137
  |-------|----------|----------------|
100
- | HYPE/WHYPE/WETH/WBTC | 18 | `1000000000000000000` |
101
- | USDC | 6 | `1000000` |
102
- | USDT | 6 | `1000000` |
103
- | 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` |
104
141
 
105
142
  ---
106
143
 
107
- ## Bridge Provider Support
108
-
109
- | Provider | Flag | Best For |
110
- |----------|------|----------|
111
- | LI.FI (default) | `--provider lifi` | Any token, any chain |
112
- | deBridge DLN | `--provider debridge` | Cross-chain arbitrary tokens |
113
- | Circle CCTP V2 | `--provider cctp` | Native USDC transfers |
144
+ ## Verification Status
114
145
 
115
- 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
package/config/protocols/lending/lendle_mantle.toml DELETED
@@ -1,14 +0,0 @@
1
- [protocol]
2
- name = "Lendle"
3
- slug = "lendle-mantle"
4
- category = "lending"
5
- interface = "aave_v2"
6
- chain = "mantle"
7
- native = true
8
- description = "Lendle — Aave V2 fork on Mantle ($6.4M TVL)"
9
-
10
- [protocol.contracts]
11
- pool = "0xCFa5aE7c2CE8Fadc6426C1ff872cA45378Fb7cF3"
12
- oracle = "0x870c9692Ab04944C86ec6FEeF63F261226506EfC"
13
- pool_data_provider = "0x552b9e4bae485C4B7F540777d7D25614CdB84773"
14
- pool_addresses_provider = "0xAb94Bedd21ae3411eB2698945dfCab1D5C19C3d4"