starkfi 0.5.0 → 0.6.0

package/skills/lending/SKILL.md

@@ -44,7 +44,7 @@ Manage lending and borrowing positions on Vesu V2 protocol on Starknet. Supply a
     - 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.
 4. AFTER any transactional operation, verify with `tx-status`.
-5. When using `--use-supplied`, the borrow is backed by the user's existing vTokens (supplied positions) rather than transferring from wallet.
+5. When using `--use-supplied`, the borrow is backed by the user's existing earn positions (supplied positions) rather than transferring from wallet.
 6. When the user asks about health, risk, or liquidation — use `lend-monitor` first for a comprehensive overview with 4-level risk classification (SAFE/WARNING/DANGER/CRITICAL).
 7. When a position's health factor is low, suggest `lend-auto` to automatically rebalance. Always use `--simulate` first to preview the action before executing.
 
@@ -70,10 +70,10 @@ npx starkfi@latest lend-status --pool <name|address> --collateral-token <symbol>
 
 ```bash
 # Supply (deposit assets to earn yield)
-npx starkfi@latest lend-supply <amount> --pool <name|address> --token <symbol>
+npx starkfi@latest lend-supply <amount> --pool <name|address> --token <symbol> [--simulate]
 
 # Withdraw (remove supplied assets)
-npx starkfi@latest lend-withdraw <amount> --pool <name|address> --token <symbol>
+npx starkfi@latest lend-withdraw <amount> --pool <name|address> --token <symbol> [--simulate]
 ```
 
 ### Borrow & Repay
@@ -84,17 +84,17 @@ npx starkfi@latest lend-borrow \
   --pool <name|address> \
   --collateral-amount <n> --collateral-token <symbol> \
   --borrow-amount <n> --borrow-token <symbol> \
-  [--use-supplied]
+  [--use-supplied] [--simulate]
 
 # Repay (pay back borrowed amount)
-npx starkfi@latest lend-repay <amount> --pool <name|address> --token <symbol> --collateral-token <symbol>
+npx starkfi@latest lend-repay <amount> --pool <name|address> --token <symbol> --collateral-token <symbol> [--simulate]
 ```
 
 ### Close Position
 
 ```bash
 # Atomically repay all debt and withdraw all collateral
-npx starkfi@latest lend-close --pool <name|address> --collateral-token <symbol> --borrow-token <symbol>
+npx starkfi@latest lend-close --pool <name|address> --collateral-token <symbol> --borrow-token <symbol> [--simulate]
 ```
 
 ### Health Monitoring
@@ -130,9 +130,10 @@ npx starkfi@latest lend-auto --pool <name|address> --collateral-token <symbol> -
 
 | 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      |
+| `amount`     | number | Amount (positional)                        | Yes      |
+| `--pool`     | string | Pool name or address                       | Yes      |
+| `--token`    | string | Token symbol (`USDC`, `ETH`, `STRK`, etc.) | Yes      |
+| `--simulate` | flag   | Estimate fees and validate without executing | No     |
 
 ### lend-borrow
 
@@ -143,7 +144,8 @@ npx starkfi@latest lend-auto --pool <name|address> --collateral-token <symbol> -
 | `--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       |
+| `--use-supplied`      | flag   | Use existing earn positions as collateral    | No       |
+| `--simulate`          | flag   | Estimate fees and validate without executing | No       |
 
 ### lend-repay
 
@@ -153,6 +155,7 @@ npx starkfi@latest lend-auto --pool <name|address> --collateral-token <symbol> -
 | `--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      |
+| `--simulate`         | flag   | Estimate fees and validate without executing | No |
 
 ### lend-close
 
@@ -161,6 +164,7 @@ npx starkfi@latest lend-auto --pool <name|address> --collateral-token <symbol> -
 | `--pool`             | string | Pool name or address    | Yes      |
 | `--collateral-token` | string | Collateral token symbol | Yes      |
 | `--borrow-token`     | string | Borrow token symbol     | Yes      |
+| `--simulate`         | flag   | Estimate fees and validate without executing | No |
 
 ### lend-status
 
@@ -205,7 +209,7 @@ Run without arguments to **scan all pools**. Or specify `--pool` + `--collateral
 | `--borrow-token`       | string | Debt token symbol                              | Yes      |
 | `--strategy`           | string | `repay`, `add-collateral`, or `auto` (default) | No       |
 | `--target-hf`          | number | Target health factor (default: 1.3)            | No       |
-| `--simulate`           | flag   | Preview without executing                      | No       |
+| `--simulate`           | flag   | Estimate fees and validate without executing | No       |
 
 ## Examples
 
@@ -226,7 +230,8 @@ npx starkfi@latest lend-pools Prime
 ```bash
 npx starkfi@latest status
 npx starkfi@latest balance --token USDC
-npx starkfi@latest lend-supply 500 --pool Prime --token USDC
+npx starkfi@latest lend-supply 500 --pool Prime --token USDC --simulate  # Preview first
+npx starkfi@latest lend-supply 500 --pool Prime --token USDC             # Execute
 npx starkfi@latest tx-status <hash>
 ```
 

package/skills/multi-swap/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: multi-swap
-description: Execute multiple token swaps in a single Starknet transaction using Fibrous aggregation. Supports 2-3 swap pairs bundled into one multicall. Use this skill when the user wants to swap multiple token pairs at once, do batch swaps, execute several trades simultaneously, perform parallel swaps, or do bulk trading in one transaction. Also trigger when the user mentions "two swaps", "three swaps", "swap X and Y at the same time", or wants to convert multiple tokens in a single call.
+description: Execute multiple token swaps in a single Starknet transaction via Fibrous (default). Supports per-provider selection (avnu, ekubo, or auto to race all). Supports 2-3 swap pairs bundled into one multicall. Use this skill when the user wants to swap multiple token pairs at once, do batch swaps, execute several trades simultaneously, perform parallel swaps, or do bulk trading in one transaction. Also trigger when the user mentions "two swaps", "three swaps", "swap X and Y at the same time", or wants to convert multiple tokens in a single call.
 license: MIT
 compatibility: Requires Node.js 18+ and npx.
 metadata:
@@ -17,7 +17,7 @@ allowed-tools:
 
 # Multi-Swap
 
-Execute 2-3 independent token swaps in a single Starknet transaction via Fibrous aggregation. All swaps are bundled into one multicall, saving gas compared to executing them individually.
+Execute 2-3 independent token swaps in a single Starknet transaction via Fibrous (default). Other providers can be selected with `--provider`, or use `--provider auto` to race all providers per pair. All swaps are bundled into one multicall, saving gas compared to executing them individually.
 
 ## Prerequisites
 
@@ -37,7 +37,7 @@ Execute 2-3 independent token swaps in a single Starknet transaction via Fibrous
 ## Commands
 
 ```bash
-npx starkfi@latest multi-swap "<pairs>" [--slippage <percent>] [--simulate] [--json]
+npx starkfi@latest multi-swap "<pairs>" [--provider <fibrous|avnu|ekubo|auto>] [--slippage <percent>] [--simulate] [--json]
 ```
 
 ## Parameters
@@ -45,6 +45,7 @@ npx starkfi@latest multi-swap "<pairs>" [--slippage <percent>] [--simulate] [--j
 | Parameter    | Type   | Description                                            | Required |
 | ------------ | ------ | ------------------------------------------------------ | -------- |
 | `pairs`      | string | Swap pairs: `"100 USDC>ETH, 50 USDT>STRK"` (2-3 pairs) | Yes      |
+| `--provider` | string | Provider: `fibrous` (default), `avnu`, `ekubo`, `auto` (race all) | No       |
 | `--slippage` | number | Slippage tolerance in % (default: `1`)                 | No       |
 | `--simulate` | flag   | Estimate fees without broadcasting                     | No       |
 | `--json`     | flag   | Output as JSON                                         | No       |
@@ -79,14 +80,16 @@ npx starkfi@latest multi-swap "50 DAI>ETH, 100 USDC>STRK, 0.1 ETH>USDT" --simula
 
 ## Error Handling
 
-| Error                  | Action                                                         |
-| ---------------------- | -------------------------------------------------------------- |
-| `Too few pairs`        | Multi-swap requires at least 2 pairs. Use `trade` for singles. |
-| `Too many pairs`       | Maximum 3 pairs. Split into multiple calls.                    |
-| `No route found`       | One or more pairs lack liquidity.                              |
-| `Insufficient balance` | Check `balance` — user may lack one of the source tokens.      |
-| `Simulation failed`    | One of the routes is invalid or would revert.                  |
-| `Not authenticated`    | Run `authenticate-wallet` skill first.                         |
+| Error                     | Action                                                         |
+| ------------------------- | -------------------------------------------------------------- |
+| `Too few pairs`           | Multi-swap requires at least 2 pairs. Use `trade` for singles. |
+| `Too many pairs`          | Maximum 3 pairs. Split into multiple calls.                    |
+| `No route found`          | One or more pairs lack liquidity.                              |
+| `Insufficient balance`    | Check `balance` — user may lack one of the source tokens.      |
+| `Provider unavailable`    | Specified provider is invalid. Valid: fibrous, avnu, ekubo.    |
+| `All providers failed`    | All providers timed out or errored. Retry later.               |
+| `Simulation failed`       | One of the routes is invalid or would revert.                  |
+| `Not authenticated`       | Run `authenticate-wallet` skill first.                         |
 
 ## Related Skills
 

package/skills/portfolio/SKILL.md

@@ -30,7 +30,7 @@ Display a comprehensive DeFi portfolio dashboard aggregating token balances, sta
 
 1. Use `portfolio` as the FIRST command when the user asks "what do I have?" or wants an overall assessment.
 2. The `portfolio` command is read-only — it never modifies any on-chain state.
-3. USD prices are sourced from Fibrous aggregation and may have slight variations.
+3. USD prices are sourced from the StarkZap SDK and may have slight variations.
 4. For `portfolio-rebalance`, ALWAYS use `--simulate` first to preview the plan before executing.
 5. Target allocations must sum to **100%**. If they don't, inform the user and ask them to adjust.
 6. After rebalancing, run `portfolio` again to confirm the new allocation.
@@ -134,7 +134,7 @@ npx starkfi@latest portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK" --sli
 | `Partial failure`      | Some sections may show errors while others succeed. The portfolio uses fault-tolerant aggregation. |
 | `Network error`        | Retry once. Use `config` to set custom RPC.                                                        |
 | `Invalid allocation`   | Ensure target percentages sum to 100 and token symbols are valid.                                  |
-| `Rebalance failed`     | Check balances, ensure tokens have sufficient liquidity on Fibrous.                                |
+| `Rebalance failed`     | Check balances, ensure tokens have sufficient liquidity on supported providers. |
 | `Insufficient balance` | Not enough tokens to execute swaps — check `balance` first.                                        |
 
 ## Related Skills
@@ -143,5 +143,6 @@ npx starkfi@latest portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK" --sli
 - Use `staking` `stake-status` for detailed staking positions.
 - 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 `trade` if you need to swap a single token pair (not full rebalance).
 

package/skills/send/SKILL.md

@@ -80,3 +80,4 @@ npx starkfi@latest send 100 USDC 0x07b2... --simulate
 - Use `balance` to verify funds before sending.
 - Use `config` to set a custom RPC if experiencing rate limits.
 - Use `trade` if the user needs to swap tokens before sending.
+- Use `confidential` for privacy-preserving transfers (hidden amounts, ZK proofs).

package/skills/trade/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: trade
-description: Swap tokens on Starknet using Fibrous aggregation for optimal routing. Supports simulation (dry-run) before execution. Use this skill when the user wants to swap, exchange, trade, convert, buy, or sell one token for another on Starknet. Also use when the user asks about token prices, exchange rates, DEX routing, best swap route, or wants to check how much they would receive for a given amount — even if they don't explicitly say "swap".
+description: Swap tokens on Starknet via Fibrous DEX aggregator. Supports per-provider selection (avnu, ekubo, or auto to race all). Use this skill when the user wants to swap, exchange, trade, convert, buy, or sell one token for another on Starknet. Also use when the user asks about token prices, exchange rates, DEX routing, best swap route, or wants to check how much they would receive for a given amount — even if they don't explicitly say "swap".
 license: MIT
 compatibility: Requires Node.js 18+ and npx.
 metadata:
@@ -17,7 +17,7 @@ allowed-tools:
 
 # Trade / Swap Tokens
 
-Exchange one token for another on Starknet via Fibrous trade aggregation. The CLI finds the best route across multiple DEXs, simulates the swap, and executes. All transactions are routed through the Paymaster by default (gas paid in STRK or configured token).
+Exchange one token for another on Starknet via Fibrous (default). Other providers (AVNU, Ekubo) can be selected with `--provider`, or use `--provider auto` to race all providers for the best price. All transactions are routed through the Paymaster by default (gas paid in STRK or configured token).
 
 ## Prerequisites
 
@@ -35,19 +35,20 @@ Exchange one token for another on Starknet via Fibrous trade aggregation. The CL
 ## Commands
 
 ```bash
-npx starkfi@latest trade <amount> <from> <to> [--slippage <percent>] [--simulate] [--json]
+npx starkfi@latest trade <amount> <from> <to> [--provider <fibrous|avnu|ekubo|auto>] [--slippage <percent>] [--simulate] [--json]
 ```
 
 ## Parameters
 
-| Parameter    | Type   | Description                              | Required |
-| ------------ | ------ | ---------------------------------------- | -------- |
-| `amount`     | number | Amount of source token to swap           | Yes      |
-| `from`       | string | Source token symbol (e.g. `ETH`, `USDC`) | Yes      |
-| `to`         | string | Target token symbol (e.g. `STRK`, `DAI`) | Yes      |
-| `--slippage` | number | Slippage tolerance in % (default: `1`)   | No       |
-| `--simulate` | flag   | Estimate fees without broadcasting       | No       |
-| `--json`     | flag   | Output as JSON                           | No       |
+| Parameter    | Type   | Description                                       | Required |
+| ------------ | ------ | ------------------------------------------------- | -------- |
+| `amount`     | number | Amount of source token to swap                    | Yes      |
+| `from`       | string | Source token symbol (e.g. `ETH`, `USDC`)          | Yes      |
+| `to`         | string | Target token symbol (e.g. `STRK`, `DAI`)          | Yes      |
+| `--provider` | string | Provider: `fibrous` (default), `avnu`, `ekubo`, `auto` (race all) | No |
+| `--slippage` | number | Slippage tolerance in % (default: `1`)            | No       |
+| `--simulate` | flag   | Estimate fees without broadcasting                | No       |
+| `--json`     | flag   | Output as JSON                                    | No       |
 
 ## Examples
 
@@ -77,16 +78,19 @@ npx starkfi@latest tx-status <hash>
 
 ## Error Handling
 
-| Error                  | Action                                                  |
-| ---------------------- | ------------------------------------------------------- |
-| `No route found`       | Liquidity may be too low or pair doesn't exist.         |
-| `Insufficient balance` | Check `balance` and suggest a smaller amount.           |
-| `Simulation failed`    | Route is invalid or would revert. Do not retry blindly. |
-| `Not authenticated`    | Run `authenticate-wallet` skill first.                  |
+| Error                     | Action                                                  |
+| ------------------------- | ------------------------------------------------------- |
+| `No route found`          | Liquidity may be too low or pair doesn't exist.         |
+| `Insufficient balance`    | Check `balance` and suggest a smaller amount.           |
+| `Provider unavailable`    | Specified provider is invalid. Valid: fibrous, avnu, ekubo. |
+| `All providers failed`    | All providers timed out or errored. Retry later.        |
+| `Simulation failed`       | Route is invalid or would revert. Do not retry blindly. |
+| `Not authenticated`       | Run `authenticate-wallet` skill first.                  |
 
 ## Related Skills
 
 - 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).
+- Use `batch` for combining a swap with other operations (stake, supply, send, dca).
+- Use `dca` for recurring buy orders instead of a one-time swap.
 - Use `config` to set a custom RPC if experiencing rate limits.