starkfi 0.6.3 → 0.7.0

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "starkfi",
-	"version": "0.6.3",
-	"description": "AI-native Starknet DeFi CLI + MCP Server + Agent Skills — Swaps, multi-swap, batch (multicall), staking, lending, DCA, confidential transfers, simulation, portfolio, gas abstraction",
+	"version": "0.7.0",
+	"description": "AI-native Starknet DeFi CLI + MCP Server + Agent Skills — Swaps, multi-swap, batch (multicall), staking, liquid staking (LST), lending, DCA, Troves vaults, confidential transfers, simulation, portfolio, gas abstraction",
 	"type": "module",
 	"bin": {
 		"starkfi": "./dist/index.js"
@@ -77,24 +77,24 @@
 	"devDependencies": {
 		"@eslint/js": "^10.0.1",
 		"@modelcontextprotocol/sdk": "^1.29.0",
-		"@types/node": "^25.5.2",
+		"@types/node": "^25.6.0",
 		"chalk": "^5.6.2",
 		"commander": "^14.0.3",
 		"env-paths": "^3.0.0",
-		"eslint": "^10.2.0",
+		"eslint": "^10.2.1",
 		"eslint-config-prettier": "^10.1.8",
-		"globals": "^17.4.0",
+		"globals": "^17.5.0",
 		"jiti": "^2.6.1",
-		"ora": "^9.3.0",
-		"prettier": "^3.8.1",
-		"starkzap": "^2.0.0",
+		"ora": "^9.4.0",
+		"prettier": "^3.8.3",
+		"starkzap": "^3.0.0",
 		"tsup": "^8.5.1",
 		"tsx": "^4.21.0",
 		"typescript": "^5.9.3",
-		"typescript-eslint": "^8.58.0",
+		"typescript-eslint": "^8.59.0",
 		"zod": "^4.3.6"
 	},
 	"dependencies": {
-		"@fatsolutions/tongo-sdk": "^1.4.0"
+		"@fatsolutions/tongo-sdk": "^1.5.0"
 	}
 }

package/skills/README.md

@@ -2,7 +2,7 @@
 
 Agent Skills for the [StarkFi](https://github.com/ahmetenesdur/starkfi) CLI — a Starknet DeFi toolkit.
 
-> 12 skills · [Full Documentation](https://docs.starkfi.app/docs/skills)
+> 14 skills · [Full Documentation](https://docs.starkfi.app/docs/skills)
 
 ## Available Skills
 
@@ -13,8 +13,10 @@ Agent Skills for the [StarkFi](https://github.com/ahmetenesdur/starkfi) CLI —
 | [send](./send/SKILL.md)                               | transaction | Transfer tokens to a Starknet address                                                   |
 | [trade](./trade/SKILL.md)                             | transaction | Swap tokens via Fibrous (default), AVNU, or Ekubo                                       |
 | [multi-swap](./multi-swap/SKILL.md)                   | transaction | Multiple swaps in one transaction (up to 3)                                             |
-| [batch](./batch/SKILL.md)                             | transaction | Combine swap + stake + supply + send + borrow + repay + withdraw + DCA in one multicall |
-| [staking](./staking/SKILL.md)                         | transaction | Stake, unstake, claim, compound (STRK, WBTC, tBTC, SolvBTC, LBTC)                       |
+| [batch](./batch/SKILL.md)                             | transaction | Combine swap + stake + supply + send + borrow + repay + withdraw + DCA + troves in one multicall |
+| [staking](./staking/SKILL.md)                         | transaction | Delegation staking: stake, unstake, claim, compound (STRK, WBTC, tBTC, SolvBTC, LBTC)  |
+| [lst](./lst/SKILL.md)                                 | transaction | Endur liquid staking: stake STRK → xSTRK, redeem, exit-all (auto-yield via share price) |
+| [troves](./troves/SKILL.md)                           | transaction | Troves DeFi yield vaults: list strategies, deposit, withdraw, check positions            |
 | [lending](./lending/SKILL.md)                         | transaction | Vesu V2 lending: supply, borrow, repay, monitor, auto-rebalance                         |
 | [dca](./dca/SKILL.md)                                 | transaction | Dollar-Cost Averaging: create, preview, list, cancel recurring orders                   |
 | [confidential](./confidential/SKILL.md)               | transaction | Tongo Cash: fund, transfer, withdraw, ragequit, rollover (ZK privacy)                   |
@@ -62,6 +64,12 @@ npx skills add ahmetenesdur/starkfi
 | "Repay debt and stake in one tx"    | `batch`               |
 | "Stake 1000 STRK with Karnot"       | `staking`             |
 | "Earn yield on my STRK"             | `staking`             |
+| "Liquid stake 500 STRK"             | `lst`                 |
+| "How much is my xSTRK worth?"       | `lst`                 |
+| "What's the LST exchange rate?"     | `lst`                 |
+| "Deposit 100 into Evergreen vault"  | `troves`              |
+| "Show me yield vault strategies"    | `troves`              |
+| "Withdraw from my vault"            | `troves`              |
 | "Supply 500 USDC to Prime pool"     | `lending`             |
 | "Is my position safe?"              | `lending`             |
 | "My health factor is low, fix it"   | `lending`             |

package/skills/balance/SKILL.md

@@ -79,4 +79,6 @@ npx starkfi@latest balance --json
 - Run this BEFORE `lending` supply operations to confirm available assets.
 - Run this BEFORE `dca` to verify sufficient sell token balance for the total DCA amount.
 - Run this BEFORE `confidential` `conf-fund` to verify sufficient tokens for funding the confidential account.
-- Use `portfolio` for a complete view including staking and lending positions with USD values.
+- Run this BEFORE `troves` deposits to verify sufficient tokens for the vault strategy.
+- Run this BEFORE `lst` liquid staking to confirm available STRK.
+- Use `portfolio` for a complete view including staking, lending, vault, and LST positions with USD values.

package/skills/batch/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: batch
-description: Execute multiple different DeFi operations in a single Starknet transaction — combine swaps, staking, lending supply/borrow/repay/withdraw, token sends, and DCA orders into one multicall. Use this skill when the user wants to batch, combine, bundle, or chain multiple diverse operations together in one atomic transaction, such as "swap ETH and then stake STRK" or "withdraw from lending and swap" or "repay debt and stake" or "swap and send in one go" or "create a DCA order and stake". Also trigger when the user mentions multicall, combining operations, doing multiple things at once, or wants to save gas by bundling actions — even if they don't use the word "batch".
+description: Execute multiple different DeFi operations in a single Starknet transaction — combine swaps, staking, lending supply/borrow/repay/withdraw, token sends, DCA orders, and Troves vault deposits/withdrawals into one multicall. Use this skill when the user wants to batch, combine, bundle, or chain multiple diverse operations together in one atomic transaction, such as "swap ETH and then stake STRK" or "withdraw from lending and swap" or "repay debt and stake" or "swap and send in one go" or "create a DCA order and stake" or "deposit into vault and swap". Also trigger when the user mentions multicall, combining operations, doing multiple things at once, or wants to save gas by bundling actions — even if they don't use the word "batch".
 license: MIT
 compatibility: Requires Node.js 18+ and npx.
 metadata:
@@ -17,7 +17,7 @@ allowed-tools:
 
 # Batch Execute
 
-Bundle multiple diverse DeFi operations into a single Starknet multicall transaction. Supports combining **swaps**, **staking**, **lending supply/borrow/repay/withdraw**, **token sends**, and **DCA orders** — all executed atomically in one on-chain call.
+Bundle multiple diverse DeFi operations into a single Starknet multicall transaction. Supports combining **swaps**, **staking**, **lending supply/borrow/repay/withdraw**, **token sends**, **DCA orders**, and **Troves vault deposits/withdrawals** — all executed atomically in one on-chain call.
 
 ## Prerequisites
 
@@ -47,7 +47,9 @@ npx starkfi@latest batch [--simulate] [--json] \
   --repay "<amount> <token> <col_token> <pool>" \
   --withdraw "<amount> <token> <pool>" \
   --dca-create "<amount> <sell> <buy> <perCycle> [frequency]" \
-  --dca-cancel "<orderId>"
+  --dca-cancel "<orderId>" \
+  --troves-deposit "<amount> <strategy_id> [token]" \
+  --troves-withdraw "<amount> <strategy_id> [token]"
 ```
 
 ## Operation Formats
@@ -63,6 +65,8 @@ npx starkfi@latest batch [--simulate] [--json] \
 | `--withdraw`   | `"<amount> <token> <pool>"`                | `--withdraw "200 USDC Prime"`   |
 | `--dca-create` | `"<amount> <sell> <buy> <perCycle> [freq]"` | `--dca-create "1000 USDC ETH 10 P1D"` |
 | `--dca-cancel` | `"<orderId>"`                              | `--dca-cancel "abc123"`         |
+| `--troves-deposit`  | `"<amount> <strategy_id> [token]"`    | `--troves-deposit "100 evergreen_strk"` |
+| `--troves-withdraw` | `"<amount> <strategy_id> [token]"`    | `--troves-withdraw "50 evergreen_strk"` |
 
 > **Note:** `--stake` accepts either a validator name (e.g. `Karnot`) or a pool contract address (starting with `0x`). The CLI auto-detects the format.
 
@@ -79,6 +83,8 @@ npx starkfi@latest batch [--simulate] [--json] \
 | `--withdraw`   | string | Withdraw from lending pool (repeatable) | No\*   |
 | `--dca-create` | string | Create DCA order (repeatable)         | No\*     |
 | `--dca-cancel` | string | Cancel DCA order (repeatable)         | No\*     |
+| `--troves-deposit`  | string | Troves vault deposit (repeatable) | No\*     |
+| `--troves-withdraw` | string | Troves vault withdraw (repeatable) | No\*    |
 | `--simulate` | flag   | Estimate fees without broadcasting    | No       |
 | `--json`     | flag   | Output as JSON                        | No       |
 
@@ -150,3 +156,5 @@ npx starkfi@latest batch --simulate \
 - Use `lending` for standalone lending operations.
 - Use `send` for standalone token transfers.
 - Use `dca` for standalone DCA order management.
+- Use `troves` for standalone vault deposit/withdraw operations.
+- Use `lst` for liquid staking operations (not supported in batch).

package/skills/lending/SKILL.md

@@ -310,5 +310,7 @@ npx starkfi@latest lend-auto --pool Prime --collateral-token ETH --borrow-token
 - Use `balance` to verify available assets before supplying.
 - Use `trade` to swap tokens if the user doesn't have the right asset.
 - Use `portfolio` for a full overview including lending positions with USD values.
-- Use `batch` to combine supply operations with swaps or staking.
+- Use `batch` to combine supply operations with swaps, staking, or vault deposits.
+- Use `troves` for vault-based yield strategies (different from lending).
+- Use `lst` for liquid staking yield (xSTRK can also be supplied to lending pools).
 - Use `portfolio-rebalance` (within `portfolio` skill) to optimize overall portfolio allocation.

package/skills/lst/SKILL.md

@@ -0,0 +1,171 @@
+---
+name: lst
+description: Liquid staking via Endur on Starknet — stake STRK to receive xSTRK, redeem xSTRK back to STRK, check positions, and view protocol stats. Yield is embedded in the xSTRK share price (no manual claim needed). Use this skill when the user mentions liquid staking, LST, xSTRK, Endur, liquid staking token, share price, instant staking, tradeable staking position, or wants a staking token they can trade or use in DeFi — even if they don't say "liquid staking" explicitly.
+license: MIT
+compatibility: Requires Node.js 18+ and npx.
+metadata:
+    version: 0.1.0
+    author: ahmetenesdur
+    category: transaction
+allowed-tools:
+    - Bash(npx starkfi@latest lst-position)
+    - Bash(npx starkfi@latest lst-position *)
+    - Bash(npx starkfi@latest lst-stats)
+    - Bash(npx starkfi@latest lst-stats *)
+    - Bash(npx starkfi@latest lst-stake *)
+    - Bash(npx starkfi@latest lst-redeem *)
+    - Bash(npx starkfi@latest lst-exit-all)
+    - Bash(npx starkfi@latest lst-exit-all *)
+    - Bash(npx starkfi@latest status)
+    - Bash(npx starkfi@latest balance)
+    - Bash(npx starkfi@latest balance *)
+    - Bash(npx starkfi@latest tx-status *)
+---
+
+# Liquid Staking (Endur LST)
+
+Stake STRK tokens through the Endur liquid staking protocol to receive **xSTRK** — a liquid staking token whose value appreciates over time as staking yield accrues automatically.
+
+## Prerequisites
+
+- Active session required.
+- Sufficient STRK balance for staking + gas fees.
+
+## ⚠️ Critical: Yield Model
+
+Endur LST yield is **NOT** a claimable reward. The xSTRK share price increases automatically to reflect accumulated staking yield. To realize your yield, redeem xSTRK back to STRK — you will receive more STRK than you originally staked.
+
+**Do NOT use the `staking` skill's `rewards --claim` or `rewards --compound` for xSTRK positions.** Those commands are for delegation staking only.
+
+## LST vs Delegation Staking
+
+| Feature             | Delegation Staking (`staking` skill) | Endur LST (`lst` skill)          |
+| ------------------- | ------------------------------------ | -------------------------------- |
+| Token received      | None (position tracked on-chain)     | xSTRK (ERC-20, tradeable)        |
+| Yield mechanism     | Manual claim via `rewards --claim`   | Automatic via share price        |
+| Liquidity           | Locked until unstake cooldown        | Liquid — trade xSTRK anytime     |
+| DeFi composability  | Limited                              | xSTRK usable in Troves, lending  |
+| Unstaking           | 2-step process with cooldown         | Instant redemption               |
+
+## Rules
+
+1. BEFORE staking, check `balance --token STRK` to confirm sufficient STRK.
+2. Use `lst-stats` to check the current exchange rate, total STRK staked, and APR before staking.
+3. Use `lst-position` to check the user's current xSTRK balance and its STRK value.
+4. **NEVER** suggest using `rewards --claim` or `rewards --compound` for LST positions. Yield is automatic.
+5. When the user asks about "how much yield" from LST, show `lst-position` which displays the current STRK value vs original deposit.
+6. Suggest using `--simulate` first for large operations.
+7. AFTER any transactional operation (stake, redeem, exit-all), verify with `tx-status`.
+8. `lst-exit-all` redeems the entire xSTRK balance — warn the user before executing.
+
+## Commands
+
+```bash
+# Check LST position (xSTRK balance and STRK value)
+npx starkfi@latest lst-position [--json]
+
+# View Endur protocol stats (exchange rate, APR, total staked)
+npx starkfi@latest lst-stats [--json]
+
+# Stake STRK to receive xSTRK
+npx starkfi@latest lst-stake <amount> [--simulate] [--json]
+
+# Redeem xSTRK back to STRK (partial)
+npx starkfi@latest lst-redeem <amount> [--simulate] [--json]
+
+# Redeem all xSTRK back to STRK
+npx starkfi@latest lst-exit-all [--simulate] [--json]
+```
+
+## Parameters
+
+### lst-stake
+
+| Parameter    | Type   | Description                        | Required |
+| ------------ | ------ | ---------------------------------- | -------- |
+| `amount`     | number | Amount of STRK to stake            | Yes      |
+| `--simulate` | flag   | Estimate fees without broadcasting | No       |
+| `--json`     | flag   | Output as JSON                     | No       |
+
+### lst-redeem
+
+| Parameter    | Type   | Description                        | Required |
+| ------------ | ------ | ---------------------------------- | -------- |
+| `amount`     | number | Amount of xSTRK to redeem          | Yes      |
+| `--simulate` | flag   | Estimate fees without broadcasting | No       |
+| `--json`     | flag   | Output as JSON                     | No       |
+
+### lst-exit-all
+
+| Parameter    | Type | Description                        | Required |
+| ------------ | ---- | ---------------------------------- | -------- |
+| `--simulate` | flag | Estimate fees without broadcasting | No       |
+| `--json`     | flag | Output as JSON                     | No       |
+
+## Examples
+
+**User:** "What's the current LST exchange rate?"
+
+```bash
+npx starkfi@latest lst-stats
+```
+
+**User:** "Stake 1000 STRK via liquid staking"
+
+```bash
+npx starkfi@latest status
+npx starkfi@latest balance --token STRK
+npx starkfi@latest lst-stats   # Check current exchange rate
+npx starkfi@latest lst-stake 1000 --simulate
+npx starkfi@latest lst-stake 1000
+npx starkfi@latest tx-status <hash>
+```
+
+**User:** "How much is my xSTRK worth?"
+
+```bash
+npx starkfi@latest lst-position
+```
+
+**User:** "Redeem 500 xSTRK back to STRK"
+
+```bash
+npx starkfi@latest lst-position  # Check available xSTRK balance
+npx starkfi@latest lst-redeem 500 --simulate
+npx starkfi@latest lst-redeem 500
+npx starkfi@latest tx-status <hash>
+```
+
+**User:** "Exit all my liquid staking"
+
+```bash
+npx starkfi@latest lst-position  # Show what will be redeemed
+# WARN: This redeems all xSTRK. Confirm with user.
+npx starkfi@latest lst-exit-all
+npx starkfi@latest tx-status <hash>
+```
+
+**User:** "Should I use regular staking or liquid staking?"
+
+```bash
+# Show both options for comparison
+npx starkfi@latest lst-stats          # LST: exchange rate, APR
+npx starkfi@latest validators         # Delegation: validator list
+# Explain: LST = liquid + auto-yield; Delegation = locked + manual claim
+```
+
+## Error Handling
+
+| Error                  | Action                                                   |
+| ---------------------- | -------------------------------------------------------- |
+| `Insufficient balance` | Check `balance --token STRK` for staking, or `lst-position` for redeem. |
+| `Simulation failed`    | Transaction would revert. Check amount and gas.          |
+| `Not authenticated`    | Run `authenticate-wallet` skill first.                   |
+
+## Related Skills
+
+- Use `balance` to check available STRK before staking.
+- Use `staking` for delegation staking (validator-based, manual reward claims).
+- Use `troves` to deposit xSTRK into yield vaults for additional yield.
+- Use `portfolio` for a full overview including LST positions with USD values.
+- Use `batch` to combine swaps with liquid staking in one transaction.

package/skills/portfolio/SKILL.md

@@ -71,13 +71,15 @@ npx starkfi@latest portfolio-rebalance --target "<allocation>" [--slippage <n>]
 
 ## Dashboard Sections
 
-The portfolio displays five sections:
+The portfolio displays seven sections:
 
 1. **Token Balances** — STRK, ETH, and all ERC-20 tokens with non-zero balances and their USD values.
 2. **Staking Positions** — Active stakes across all validators/pools with pending rewards. Shows unpooling amounts and cooldown dates when exit intents are active.
 3. **Lending Positions** — Active Vesu V2 positions: supplied and borrowed amounts with pool details.
 4. **DCA Orders** — Active Dollar-Cost Averaging recurring swap orders.
 5. **Confidential Tongo Balance** — Private active and pending balances under Tongo Cash.
+6. **Troves Vault Positions** — Active deposits in Troves DeFi yield strategies with current value and APY.
+7. **LST Positions** — xSTRK holdings from Endur liquid staking with current STRK value and yield accrued.
 
 ## Examples
 
@@ -146,5 +148,7 @@ npx starkfi@latest portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK" --sli
 - Use `lending` `lend-status` for detailed lending positions.
 - Use `lending` `lend-monitor` to monitor health factors across lending positions.
 - Use `dca` `dca-list` to view active DCA orders.
+- Use `troves` `troves-position` for detailed vault positions.
+- Use `lst` `lst-position` for detailed liquid staking positions.
 - Use `trade` if you need to swap a single token pair (not full rebalance).
 

package/skills/staking/SKILL.md

@@ -50,6 +50,7 @@ Manage Starknet staking operations: delegate tokens to validators, claim or comp
 5. AFTER any transactional operation (stake, unstake, rewards), verify with `tx-status`.
 6. Use `stake-status` to view the user's current staking positions across all validators. When exit intents are active, unpooling amounts and cooldown dates are shown automatically.
 7. Token defaults to `STRK` if `--token` is not specified.
+8. **LST Disambiguation:** If the user mentions "liquid staking", "xSTRK", or "Endur", redirect to the `lst` skill instead. This skill handles **delegation staking** only. Do NOT use `rewards --claim` or `rewards --compound` for xSTRK positions.
 
 ## Commands
 
@@ -187,3 +188,4 @@ npx starkfi@latest stake-status
 - Use `balance` to check available tokens before staking.
 - Use `portfolio` for a full overview including staking positions with USD values.
 - Use `batch` to combine staking with other operations in one transaction.
+- Use `lst` for liquid staking via Endur (xSTRK — automatic yield, instant redemption).

package/skills/trade/SKILL.md

@@ -91,6 +91,8 @@ npx starkfi@latest tx-status <hash>
 
 - Use `balance` to check available tokens before trading.
 - Use `multi-swap` for executing 2-3 swaps in a single transaction.
-- Use `batch` for combining a swap with other operations (stake, supply, send, dca).
+- Use `batch` for combining a swap with other operations (stake, supply, send, dca, troves).
 - Use `dca` for recurring buy orders instead of a one-time swap.
+- Use `troves` to deposit swap proceeds into yield vaults.
+- Use `lst` for liquid staking after swapping to STRK.
 - Use `config` to set a custom RPC if experiencing rate limits.

package/skills/troves/SKILL.md

@@ -0,0 +1,142 @@
+---
+name: troves
+description: Deposit and withdraw from Troves DeFi yield vault strategies on Starknet. View available strategies, check positions, and manage vault deposits. Use this skill when the user mentions Troves, vault, yield vault, DeFi vault, strategy, yield farming, vault deposit, vault withdraw, earning yield through vaults, passive yield strategies, or wants to deposit into or withdraw from a yield strategy — even if they don't say "Troves" explicitly.
+license: MIT
+compatibility: Requires Node.js 18+ and npx.
+metadata:
+    version: 0.1.0
+    author: ahmetenesdur
+    category: transaction
+allowed-tools:
+    - Bash(npx starkfi@latest troves-list)
+    - Bash(npx starkfi@latest troves-list *)
+    - Bash(npx starkfi@latest troves-position)
+    - Bash(npx starkfi@latest troves-position *)
+    - Bash(npx starkfi@latest troves-deposit *)
+    - Bash(npx starkfi@latest troves-withdraw *)
+    - Bash(npx starkfi@latest status)
+    - Bash(npx starkfi@latest balance)
+    - Bash(npx starkfi@latest balance *)
+    - Bash(npx starkfi@latest tx-status *)
+---
+
+# Troves DeFi Vaults
+
+Manage Troves yield vault strategies on Starknet: browse curated vault strategies, deposit tokens to earn yield, and withdraw from positions. Strategies range from single-asset vaults to LP and leveraged positions.
+
+## Prerequisites
+
+- Active session required.
+- Sufficient token balance for deposits + gas fees.
+
+## Rules
+
+1. BEFORE any deposit, you MUST run `npx starkfi@latest troves-list` to discover available strategies and their current APY, TVL, and risk factors.
+2. BEFORE depositing, check `balance` to confirm the user has enough of the required deposit token.
+3. Use `troves-position` to check the user's current vault positions before withdrawing.
+4. **Risk awareness:** Always inform the user of the strategy's `riskFactor` (1.0 = low, 5.0 = high) and `isAudited` status before depositing.
+5. Suggest using `--simulate` first for large deposits to verify the transaction would succeed.
+6. AFTER any transactional operation (deposit, withdraw), verify with `tx-status`.
+7. Only deposit into strategies with status `Active`. Warn if a strategy is `Paused` or `Deprecated`.
+
+## Commands
+
+```bash
+# List all available strategies
+npx starkfi@latest troves-list [--json]
+
+# Check current vault positions
+npx starkfi@latest troves-position [--json]
+
+# Deposit into a strategy
+npx starkfi@latest troves-deposit <amount> --strategy <id> [--token <symbol>] [--simulate] [--json]
+
+# Withdraw from a strategy
+npx starkfi@latest troves-withdraw <amount> --strategy <id> [--token <symbol>] [--simulate] [--json]
+```
+
+## Parameters
+
+### troves-deposit / troves-withdraw
+
+| Parameter    | Type   | Description                                       | Required |
+| ------------ | ------ | ------------------------------------------------- | -------- |
+| `amount`     | number | Amount to deposit or withdraw (positional)        | Yes      |
+| `--strategy` | string | Strategy ID (e.g. `evergreen_strk`)               | Yes      |
+| `--token`    | string | Token symbol (auto-detected from strategy if omitted) | No   |
+| `--simulate` | flag   | Estimate fees without broadcasting                | No       |
+| `--json`     | flag   | Output as JSON                                    | No       |
+
+## Strategy Properties
+
+Each strategy has the following properties:
+
+| Property        | Description                        |
+| --------------- | ---------------------------------- |
+| `id`            | Unique strategy identifier         |
+| `name`          | Human-readable strategy name       |
+| `apy`           | Current annual percentage yield    |
+| `tvlUsd`        | Total value locked in USD          |
+| `depositTokens` | Accepted deposit tokens            |
+| `riskFactor`    | Risk rating (1.0 = low, 5.0 = high) |
+| `isAudited`     | Whether the strategy is audited    |
+| `status`        | `Active`, `Paused`, or `Deprecated` |
+
+## Examples
+
+**User:** "What yield vault strategies are available?"
+
+```bash
+npx starkfi@latest troves-list
+```
+
+**User:** "Deposit 500 STRK into Evergreen vault"
+
+```bash
+npx starkfi@latest status
+npx starkfi@latest balance --token STRK
+npx starkfi@latest troves-list  # Verify strategy exists and is Active
+npx starkfi@latest troves-deposit 500 --strategy evergreen_strk --simulate
+npx starkfi@latest troves-deposit 500 --strategy evergreen_strk
+npx starkfi@latest tx-status <hash>
+```
+
+**User:** "Show me my vault positions"
+
+```bash
+npx starkfi@latest troves-position
+```
+
+**User:** "Withdraw 200 STRK from Evergreen"
+
+```bash
+npx starkfi@latest troves-position  # Check available balance
+npx starkfi@latest troves-withdraw 200 --strategy evergreen_strk --simulate
+npx starkfi@latest troves-withdraw 200 --strategy evergreen_strk
+npx starkfi@latest tx-status <hash>
+```
+
+**User:** "Find the highest APY vault for STRK"
+
+```bash
+npx starkfi@latest troves-list --json
+# Parse and present strategies sorted by APY, filtered by STRK deposit token
+```
+
+## Error Handling
+
+| Error                   | Action                                                         |
+| ----------------------- | -------------------------------------------------------------- |
+| `Strategy not found`    | Run `troves-list` to find valid strategy IDs.                  |
+| `Strategy paused`       | Strategy is not accepting deposits. Choose another one.        |
+| `Insufficient balance`  | Check `balance` for the required deposit token.                |
+| `Simulation failed`     | Transaction would revert. Check amount, strategy, and gas.     |
+| `Not authenticated`     | Run `authenticate-wallet` skill first.                         |
+
+## Related Skills
+
+- Use `balance` to verify available tokens before depositing.
+- Use `portfolio` for a full overview including vault positions with USD values.
+- Use `batch` to combine vault deposits with swaps or staking in one transaction.
+- Use `lst` for liquid staking (different yield mechanism — share price appreciation).
+- Use `staking` for delegation staking (validator-based yield).