starkfi 0.6.3 → 0.7.0

package/MCP.md

@@ -1,6 +1,6 @@
 # Model Context Protocol (MCP) — Tool Reference
 
-StarkFi exposes **42 MCP tools** via stdio transport. AI clients (Cursor, Claude Desktop, Antigravity) connect and discover all tools with JSON schemas automatically.
+StarkFi exposes **51 MCP tools** via stdio transport. AI clients (Cursor, Claude Desktop, Antigravity) connect and discover all tools with JSON schemas automatically.
 
 ## Setup
 
@@ -22,7 +22,7 @@ StarkFi exposes **42 MCP tools** via stdio transport. AI clients (Cursor, Claude
 
 ---
 
-## Tool Registry (42 Tools)
+## Tool Registry (51 Tools)
 
 ### Auth & Config (2)
 
@@ -50,7 +50,7 @@ StarkFi exposes **42 MCP tools** via stdio transport. AI clients (Cursor, Claude
 | `swap_tokens` | write | Execute swap |
 | `get_multi_swap_quote` | read | Multi-pair quote (2-3 pairs) |
 | `multi_swap` | write | Execute multi-pair swap |
-| `batch_execute` | write | Atomic multicall (swap + stake + lend + send + DCA, min 2 ops) |
+| `batch_execute` | write | Atomic multicall (swap + stake + lend + send + DCA + troves, min 2 ops) |
 
 ### Staking (8)
 
@@ -101,6 +101,25 @@ StarkFi exposes **42 MCP tools** via stdio transport. AI clients (Cursor, Claude
 | `confidential_ragequit` | write | Emergency full withdrawal |
 | `confidential_rollover` | write | Activate pending balance |
 
+### Troves DeFi Vaults (4)
+
+| Tool | Type | Description |
+| --- | --- | --- |
+| `list_troves_strategies` | read | List active Troves vault strategies with APY, TVL, and risk tier |
+| `get_troves_position` | read | User vault position — shares and underlying asset value |
+| `troves_deposit` | write | Deposit into a Troves vault strategy |
+| `troves_withdraw` | write | Withdraw from a Troves vault strategy |
+
+### LST Staking — Endur (5)
+
+| Tool | Type | Description |
+| --- | --- | --- |
+| `get_lst_position` | read | LST share balance and equivalent staked value (yield embedded in share price) |
+| `get_lst_stats` | read | Endur LST statistics — current APY and TVL |
+| `lst_stake` | write | Deposit into Endur liquid staking (e.g. STRK → xSTRK) |
+| `lst_redeem` | write | Redeem specific amount of LST shares back to underlying |
+| `lst_exit_all` | write | Redeem entire LST position |
+
 ---
 
 ## Agent Best Practices
@@ -111,6 +130,8 @@ StarkFi exposes **42 MCP tools** via stdio transport. AI clients (Cursor, Claude
 4. **Check auth first** — Call `get_auth_status` before any wallet operations
 5. **Check existing positions** — Query before creating to avoid duplicates
 6. **Confidential lifecycle** — Always `confidential_setup` → `confidential_balance` → action. Remind recipients to `confidential_rollover`
+7. **Troves safety** — Use `list_troves_strategies` to validate strategy exists before deposit
+8. **LST yield model** — Endur LST yield is embedded in the share price. Do **not** call `claim_rewards` for LST positions — use `lst_redeem` or `lst_exit_all` instead
 
 ---
 
@@ -126,4 +147,6 @@ StarkFi exposes **42 MCP tools** via stdio transport. AI clients (Cursor, Claude
 | Tool Schemas (Lending) | [docs.starkfi.app/docs/mcp/tools-lending](https://docs.starkfi.app/docs/mcp/tools-lending) |
 | Tool Schemas (DCA) | [docs.starkfi.app/docs/mcp/tools-dca](https://docs.starkfi.app/docs/mcp/tools-dca) |
 | Tool Schemas (Confidential) | [docs.starkfi.app/docs/mcp/tools-confidential](https://docs.starkfi.app/docs/mcp/tools-confidential) |
+| Tool Schemas (Troves) | [docs.starkfi.app/docs/mcp/tools-troves](https://docs.starkfi.app/docs/mcp/tools-troves) |
+| Tool Schemas (LST) | [docs.starkfi.app/docs/mcp/tools-lst](https://docs.starkfi.app/docs/mcp/tools-lst) |
 | Security Model | [docs.starkfi.app/docs/architecture/security](https://docs.starkfi.app/docs/architecture/security) |

package/README.md

@@ -24,7 +24,7 @@ npx starkfi@latest --help
 
 Most DeFi tools are built for humans clicking buttons. StarkFi is built for **agents**.
 
-- 🤖 **42 MCP tools** — Any AI assistant (Cursor, Claude, Antigravity) can execute DeFi operations autonomously
+- 🤖 **51 MCP tools** — Any AI assistant (Cursor, Claude, Antigravity) can execute DeFi operations autonomously
 - ⚡ **Atomic Batching** — Combine swap + stake + lend + send into a single multicall transaction
 - 💸 **Gas Abstraction** — Pay gas in STRK, ETH, USDC, USDT, or DAI — or let the developer sponsor gas entirely
 - 🔒 **Confidential Transfers** — Privacy-preserving transfers via Tongo Cash (ZK proofs)
@@ -66,17 +66,19 @@ npx starkfi@latest portfolio
 | **Stake** | `stake 100 -v karnot` | [Staking](/docs/cli/staking) |
 | **Lend** | `lend-supply 100 -p Prime -t USDC` | [Lending](/docs/cli/lending) |
 | **DCA** | `dca-create 1000 USDC ETH --per-cycle 10 --frequency P1D` | [DCA](/docs/cli/dca) |
+| **Troves Vaults** | `troves-deposit 100 evergreen_strk` | [Troves](/docs/cli/troves) |
+| **LST Staking** | `lst-stake 100` | [LST](/docs/cli/lst) |
 | **Confidential** | `conf-fund 100 --token USDC` | [Confidential](/docs/cli/confidential) |
 | **Portfolio** | `portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK"` | [Portfolio](/docs/cli/portfolio) |
 | **Gas Modes** | `config set-gasfree on` / `config set-gas-token USDC` | [Configuration](/docs/configuration) |
 
-→ **[Full CLI Reference (41 commands)](https://docs.starkfi.app/docs/cli)**
+→ **[Full CLI Reference (50 commands)](https://docs.starkfi.app/docs/cli)**
 
 ---
 
 ## AI Integration
 
-### MCP Server (42 Tools)
+### MCP Server (51 Tools)
 
 ```bash
 npx starkfi@latest mcp-start
@@ -104,6 +106,8 @@ Add to your AI client config (Cursor, Claude Desktop, Antigravity):
 | Lending | `list_lending_pools`, `get_lending_position`, `supply_assets`, `withdraw_assets`, `borrow_assets`, `repay_debt`, `close_position`, `monitor_lending_position`, `auto_rebalance_lending`, `lending_quote_health` | 10 |
 | DCA | `dca_preview`, `dca_create`, `dca_list`, `dca_cancel` | 4 |
 | Confidential | `confidential_setup`, `confidential_balance`, `confidential_fund`, `confidential_transfer`, `confidential_withdraw`, `confidential_ragequit`, `confidential_rollover` | 7 |
+| Troves Vaults | `list_troves_strategies`, `get_troves_position`, `troves_deposit`, `troves_withdraw` | 4 |
+| LST Staking | `get_lst_position`, `get_lst_stats`, `lst_stake`, `lst_redeem`, `lst_exit_all` | 5 |
 
 → **[Full MCP Documentation](https://docs.starkfi.app/docs/mcp)** · **[Tool Schemas (MCP.md)](MCP.md)**
 
@@ -129,11 +133,11 @@ Chat-based DeFi via natural language with BYOAI model (OpenAI, Claude, Gemini).
 
 ```
 src/
-├── commands/      # 12 command groups (41 commands)
-├── services/      # 15 service modules
-├── mcp/           # MCP server (42 tools, stdio transport)
+├── commands/      # 14 command groups (50 commands)
+├── services/      # 17 service modules
+├── mcp/           # MCP server (51 tools, stdio transport)
 ├── lib/           # 15 shared utilities
-skills/            # 12 agent skills
+skills/            # 14 agent skills
 server/            # Auth server (Hono + Privy TEE)
 docs/              # Documentation site (Fumadocs)
 ```
@@ -144,16 +148,18 @@ docs/              # Documentation site (Fumadocs)
 
 ## Starkzap Modules
 
-StarkFi leverages **all core Starkzap modules**:
+StarkFi leverages **all core Starkzap v3 modules**:
 
 | Module | Usage |
 | --- | --- |
 | **Wallets** | `OnboardStrategy.Privy` + `argentXV050` for email-based wallet onboarding |
-| **Paymaster** | Gas abstraction with 5 tokens + developer-sponsored gasfree mode |
+| **Paymaster** | Gas abstraction with v3 `{ type: "paymaster", gasToken }` union |
 | **Staking** | Multi-token lifecycle (STRK, WBTC, tBTC, SolvBTC, LBTC) |
 | **DCA** | Recurring buy orders via AVNU and Ekubo |
-| **TxBuilder** | Atomic multicall batching (swap + stake + lend + send + DCA) |
+| **TxBuilder** | Atomic multicall batching (swap + stake + lend + send + DCA + troves) |
 | **Confidential** | Privacy-preserving transfers via Tongo Cash (ZK proofs) |
+| **Troves** | DeFi vault strategies — deposit/withdraw into yield-bearing vaults |
+| **Endur LST** | Liquid staking (STRK → xSTRK) — yield embedded in share price |
 | **ERC-20** | Token presets, balance queries, transfers, approvals |
 
 ---