Lending (Vesu V2)
Manage lending and borrowing positions on Vesu V2 protocol on Starknet. Supply assets to earn yield, borrow against collateral, repay debt, and close positions.
Prerequisites
- Active session required.
- Sufficient token balance for supply/repay operations + gas fees.
Rules
- BEFORE any lending action, run
npx starkfi@latest lend-poolsto discover available pools and tokens. Uselend-pools <name>for detailed pool info including APY rates. - Pool can be specified by name (e.g.
Prime,Genesis) or by contract address (0x...). - BEFORE borrowing, run
npx starkfi@latest lend-statusto check existing positions, or with--pooland--collateral-tokenfor Health Factor:- Health Factor > 2.0 → Safe to borrow.
- Health Factor 1.5 – 2.0 → WARN the user about increasing risk.
- Health Factor < 1.5 → STRONGLY advise against borrowing. Suggest repaying instead.
- Health Factor < 1.1 → DO NOT proceed without explicit double-confirmation from the user.
- AFTER any transactional operation, verify with
tx-status. - When using
--use-supplied, the borrow is backed by the user's existing vTokens (supplied positions) rather than transferring from wallet.
Commands
Discovery
# List all pools (overview table)
npx starkfi@latest lend-pools [--json]
# Detailed pool info with APY rates
npx starkfi@latest lend-pools <name> [--json]
# View all lending positions (auto-scan)
npx starkfi@latest lend-status
# View specific position status
npx starkfi@latest lend-status --pool <name|address> --collateral-token <symbol> [--borrow-token <symbol>]
Supply & Withdraw
# Supply (deposit assets to earn yield)
npx starkfi@latest lend-supply <amount> --pool <name|address> --token <symbol>
# Withdraw (remove supplied assets)
npx starkfi@latest lend-withdraw <amount> --pool <name|address> --token <symbol>
Borrow & Repay
# Borrow (provide collateral and take loan)
npx starkfi@latest lend-borrow \
--pool <name|address> \
--collateral-amount <n> --collateral-token <symbol> \
--borrow-amount <n> --borrow-token <symbol> \
[--use-supplied]
# Repay (pay back borrowed amount)
npx starkfi@latest lend-repay <amount> --pool <name|address> --token <symbol> --collateral-token <symbol>
Close Position
# Atomically repay all debt and withdraw all collateral
npx starkfi@latest lend-close --pool <name|address> --collateral-token <symbol> --borrow-token <symbol>
Parameters
lend-supply / lend-withdraw
| Parameter | Type | Description | Required |
|---|---|---|---|
amount | number | Amount (positional) | Yes |
--pool | string | Pool name or address | Yes |
--token | string | Token symbol (USDC, ETH, STRK, etc.) | Yes |
lend-borrow
| Parameter | Type | Description | Required |
|---|---|---|---|
--pool | string | Pool name or address | Yes |
--collateral-amount | number | Collateral amount to supply | Yes |
--collateral-token | string | Collateral token (e.g. ETH, STRK) | Yes |
--borrow-amount | number | Amount to borrow | Yes |
--borrow-token | string | Token to borrow (e.g. USDC, USDT) | Yes |
--use-supplied | flag | Use existing vTokens as collateral | No |
lend-repay
| Parameter | Type | Description | Required |
|---|---|---|---|
amount | number | Amount to repay (positional) | Yes |
--pool | string | Pool name or address | Yes |
--token | string | Token to repay (e.g. USDC) | Yes |
--collateral-token | string | Collateral token of the position | Yes |
lend-close
| Parameter | Type | Description | Required |
|---|---|---|---|
--pool | string | Pool name or address | Yes |
--collateral-token | string | Collateral token symbol | Yes |
--borrow-token | string | Borrow token symbol | Yes |
lend-status
Run without arguments to auto-scan all pools. Or specify --pool + --collateral-token for a detailed position view.
| Parameter | Type | Description | Required |
|---|---|---|---|
--pool | string | Pool name or address | No (auto-scan if omitted) |
--collateral-token | string | Token supplied/used as collateral | No* |
--borrow-token | string | Borrow token (needed to see debt + HF) | No |
* Required when
--poolis specified.
Examples
User: "What lending pools are available?"
npx starkfi@latest lend-pools
User: "Show me details for the Prime pool"
npx starkfi@latest lend-pools Prime
User: "Supply 500 USDC to Prime"
npx starkfi@latest status
npx starkfi@latest balance --token USDC
npx starkfi@latest lend-supply 500 --pool Prime --token USDC
npx starkfi@latest tx-status <hash>
User: "Borrow 100 USDC with ETH collateral from Prime"
npx starkfi@latest lend-status
# Check Health Factor before proceeding
npx starkfi@latest lend-borrow \
--pool Prime \
--collateral-amount 0.1 --collateral-token ETH \
--borrow-amount 100 --borrow-token USDC
npx starkfi@latest tx-status <hash>
User: "Repay my 100 USDC loan from Prime"
npx starkfi@latest lend-repay 100 --pool Prime --token USDC --collateral-token ETH
npx starkfi@latest tx-status <hash>
User: "Close my ETH/USDC position in Prime"
npx starkfi@latest lend-close --pool Prime --collateral-token ETH --borrow-token USDC
npx starkfi@latest tx-status <hash>
User: "How healthy is my position?"
# Quick overview of all positions
npx starkfi@latest lend-status
# Detailed health factor for specific position
npx starkfi@latest lend-status --pool Prime --collateral-token ETH --borrow-token USDC
Error Handling
| Error | Action |
|---|---|
Pool not found | Run lend-pools to list valid pool names. |
Health Factor too low | Warn of liquidation risk. Suggest repaying or supplying more. |
Insufficient collateral | Cannot borrow without supplying first. |
Dust limit | Borrow amount is below the pool's minimum dollar value (~$10). Increase it. |
Insufficient balance | Check balance — user may need to swap for the token. |
Not authenticated | Run authenticate-wallet skill first. |
Related Skills
- Use
balanceto verify available assets before supplying. - Use
tradeto swap tokens if the user doesn't have the right asset. - Use
portfoliofor a full overview including lending positions with USD values. - Use
batchto combine supply operations with swaps or staking.