Troves Commands

Prerequisite: Requires an active authenticated session. Run starkfi auth login first.

Overview

Troves commands let you interact with DeFi yield vault strategies on Starknet. Strategies include single-asset vaults (e.g. STRK Evergreen), LP vaults (e.g. Ekubo STRK/USDC), and leveraged strategies — all audited and managed by the Troves protocol.

Commands

troves-list

List all active vault strategies with APY, TVL, risk tier, and deposit tokens.

starkfi troves-list
starkfi troves-list --json

Output columns: ID, Name, APY, TVL, Tokens, Risk Factor, Audited

troves-position

Show your position in a specific strategy — share balance and underlying asset value.

starkfi troves-position <strategy-id>
starkfi troves-position evergreen_strk --json

troves-deposit

Deposit tokens into a vault strategy.

starkfi troves-deposit <amount> <strategy-id> [-t <token>]

Examples:

starkfi troves-deposit 100 evergreen_strk
starkfi troves-deposit 0.5 ekubo_cl_strketh -t ETH

troves-withdraw

Withdraw tokens from a vault strategy.

starkfi troves-withdraw <amount> <strategy-id> [-t <token>]

Examples:

starkfi troves-withdraw 50 evergreen_strk
starkfi troves-withdraw 0.25 ekubo_cl_strketh -t ETH

Best Practices

1. List before depositing — Always run troves-list to verify the strategy exists and check the current APY
2. Check positions — Use troves-position to see your current deposit before adding more or withdrawing
3. Understand risk — Check the riskFactor and isAudited fields before depositing

Batch Support

Troves operations can be combined with other DeFi operations in a single atomic transaction:

starkfi batch --swap "100 USDC STRK" --troves-deposit "100 STRK evergreen_strk"

MCP equivalents: Troves Tools — list_troves_strategies, get_troves_position, troves_deposit, troves_withdraw