starkfi 0.6.1 → 0.6.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (10) hide show
  1. package/MCP.md +110 -450
  2. package/README.md +90 -468
  3. package/dist/index.js +125 -119
  4. package/package.json +1 -1
  5. package/skills/README.md +47 -21
  6. package/skills/config/SKILL.md +1 -1
  7. package/skills/dca/SKILL.md +2 -1
  8. package/skills/lending/SKILL.md +1 -1
  9. package/skills/portfolio/SKILL.md +3 -1
  10. package/skills/staking/SKILL.md +1 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "starkfi",
3
- "version": "0.6.1",
3
+ "version": "0.6.3",
4
4
  "description": "AI-native Starknet DeFi CLI + MCP Server + Agent Skills — Swaps, multi-swap, batch (multicall), staking, lending, DCA, confidential transfers, simulation, portfolio, gas abstraction",
5
5
  "type": "module",
6
6
  "bin": {
package/skills/README.md CHANGED
@@ -2,29 +2,30 @@
2
2
 
3
3
  Agent Skills for the [StarkFi](https://github.com/ahmetenesdur/starkfi) CLI — a Starknet DeFi toolkit.
4
4
 
5
+ > 12 skills · [Full Documentation](https://docs.starkfi.app/docs/skills)
6
+
5
7
  ## Available Skills
6
8
 
7
- | Skill | Category | Description |
8
- | ----------------------------------------------------- | ----------- | ----------------------------------------------------------------- |
9
- | [authenticate-wallet](./authenticate-wallet/SKILL.md) | auth | Email OTP login, session management, wallet deploy |
10
- | [balance](./balance/SKILL.md) | wallet-data | Check STRK, ETH, and ERC-20 token balances |
11
- | [send](./send/SKILL.md) | transaction | Transfer tokens to a Starknet address |
12
- | [trade](./trade/SKILL.md) | transaction | Swap tokens via Fibrous (default), AVNU, or Ekubo |
13
- | [multi-swap](./multi-swap/SKILL.md) | transaction | Multiple swaps in one transaction (up to 3) |
9
+ | Skill | Category | Description |
10
+ | ----------------------------------------------------- | ----------- | --------------------------------------------------------------------------------------- |
11
+ | [authenticate-wallet](./authenticate-wallet/SKILL.md) | auth | Email OTP login, session management, wallet deploy |
12
+ | [balance](./balance/SKILL.md) | wallet-data | Check STRK, ETH, and ERC-20 token balances |
13
+ | [send](./send/SKILL.md) | transaction | Transfer tokens to a Starknet address |
14
+ | [trade](./trade/SKILL.md) | transaction | Swap tokens via Fibrous (default), AVNU, or Ekubo |
15
+ | [multi-swap](./multi-swap/SKILL.md) | transaction | Multiple swaps in one transaction (up to 3) |
14
16
  | [batch](./batch/SKILL.md) | transaction | Combine swap + stake + supply + send + borrow + repay + withdraw + DCA in one multicall |
15
- | [staking](./staking/SKILL.md) | transaction | Stake, unstake, claim, compound (STRK, WBTC, tBTC, SolvBTC, LBTC) |
16
- | [lending](./lending/SKILL.md) | transaction | Vesu V2 lending: supply, borrow, repay, monitor, auto-rebalance |
17
- | [dca](./dca/SKILL.md) | transaction | Dollar-Cost Averaging: create, preview, list, cancel recurring orders |
18
- | [confidential](./confidential/SKILL.md) | transaction | Tongo Cash: fund, transfer, withdraw, ragequit, rollover (ZK privacy) |
19
- | [portfolio](./portfolio/SKILL.md) | wallet-data | DeFi dashboard + portfolio optimization via rebalancing |
20
- | [config](./config/SKILL.md) | utility | RPC, network, gas settings, transaction status |
17
+ | [staking](./staking/SKILL.md) | transaction | Stake, unstake, claim, compound (STRK, WBTC, tBTC, SolvBTC, LBTC) |
18
+ | [lending](./lending/SKILL.md) | transaction | Vesu V2 lending: supply, borrow, repay, monitor, auto-rebalance |
19
+ | [dca](./dca/SKILL.md) | transaction | Dollar-Cost Averaging: create, preview, list, cancel recurring orders |
20
+ | [confidential](./confidential/SKILL.md) | transaction | Tongo Cash: fund, transfer, withdraw, ragequit, rollover (ZK privacy) |
21
+ | [portfolio](./portfolio/SKILL.md) | wallet-data | DeFi dashboard + portfolio optimization via rebalancing |
22
+ | [config](./config/SKILL.md) | utility | RPC, network, gas settings, transaction status |
21
23
 
22
24
  ## Installation
23
25
 
24
26
  Install with [Vercel's Skills CLI](https://skills.sh):
25
27
 
26
28
  ```bash
27
- # Add skills to your AI assistant (e.g. Antigravity)
28
29
  npx skills add ahmetenesdur/starkfi
29
30
  ```
30
31
 
@@ -34,12 +35,16 @@ npx skills add ahmetenesdur/starkfi
34
35
  2. Ensure the **StarkFi Auth Server** is running (required for authentication and signing).
35
36
  3. No manual CLI installation needed — all skills use `npx starkfi@latest`.
36
37
 
38
+ → **[Installation Guide](https://docs.starkfi.app/docs/installation)** · **[Quick Start](https://docs.starkfi.app/docs/quick-start)**
39
+
37
40
  ## Typical Workflow
38
41
 
39
- 1. **Authenticate** → `authenticate-wallet` (required first)
40
- 2. **Check funds** → `balance` or `portfolio`
41
- 3. **Execute** → `send`, `trade`, `multi-swap`, `batch`, `staking`, `lending`, `dca`, or `confidential`
42
- 4. **Verify** → `tx-status` (via `config` skill)
42
+ ```
43
+ 1. authenticate-wallet → Log in (required first)
44
+ 2. balance / portfolio → Check funds and positions
45
+ 3. trade / batch / ... → Execute DeFi operations
46
+ 4. config (tx-status) → Verify transaction
47
+ ```
43
48
 
44
49
  ## Trigger Examples
45
50
 
@@ -47,23 +52,44 @@ npx skills add ahmetenesdur/starkfi
47
52
  | ----------------------------------- | --------------------- |
48
53
  | "Log me in with my email" | `authenticate-wallet` |
49
54
  | "How much STRK do I have?" | `balance` |
55
+ | "What's in my wallet?" | `balance` |
50
56
  | "Send 10 USDC to 0x04a3..." | `send` |
51
57
  | "Swap 100 USDC for ETH" | `trade` |
58
+ | "Get me the best price for ETH" | `trade` |
52
59
  | "Swap USDC to ETH and USDT to STRK" | `multi-swap` |
53
60
  | "Swap ETH and then stake STRK" | `batch` |
54
61
  | "Withdraw from lending and swap" | `batch` |
62
+ | "Repay debt and stake in one tx" | `batch` |
55
63
  | "Stake 1000 STRK with Karnot" | `staking` |
64
+ | "Earn yield on my STRK" | `staking` |
56
65
  | "Supply 500 USDC to Prime pool" | `lending` |
57
66
  | "Is my position safe?" | `lending` |
58
- | "Fix my risky position" | `lending` |
67
+ | "My health factor is low, fix it" | `lending` |
59
68
  | "Show me my portfolio" | `portfolio` |
60
- | "Rebalance to 50% ETH, 30% USDC" | `portfolio` |
69
+ | "Rebalance to 50% ETH, 30% USDC" | `portfolio` |
70
+ | "What am I worth on Starknet?" | `portfolio` |
61
71
  | "DCA 100 USDC into ETH daily" | `dca` |
62
72
  | "Show my active DCA orders" | `dca` |
63
- | "I'm getting rate limit errors" | `config` |
73
+ | "Cancel my recurring buy" | `dca` |
64
74
  | "Set up my Tongo account" | `confidential` |
65
75
  | "Fund 100 USDC confidentially" | `confidential` |
66
76
  | "Send 50 privately" | `confidential` |
77
+ | "I'm getting rate limit errors" | `config` |
78
+ | "Switch to testnet" | `config` |
79
+ | "Enable free gas mode" | `config` |
80
+ | "Did my transaction go through?" | `config` |
81
+
82
+ ## Skills vs MCP Tools
83
+
84
+ Skills are **multi-step workflow recipes** that teach AI assistants _how_ to orchestrate atomic MCP tools into real-world workflows. For example, the `trade` skill knows to check auth → check balance → simulate → execute → verify.
85
+
86
+ | Aspect | Skills | MCP Tools |
87
+ | ----------- | ---------------------------------------------- | ----------------------------------- |
88
+ | **Scope** | Multi-step workflows | Single atomic operations |
89
+ | **Context** | Includes rules, error handling, related skills | Schema + parameters only |
90
+ | **When** | AI coding assistants (Cursor, Antigravity) | MCP clients (Claude, custom agents) |
91
+
92
+ → **[Skills Documentation](https://docs.starkfi.app/docs/skills)** · **[Skills Usage Guide](https://docs.starkfi.app/docs/skills/usage)** · **[MCP Tools](https://docs.starkfi.app/docs/mcp)**
67
93
 
68
94
  ## License
69
95
 
package/skills/config/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: config
3
- description: View and modify StarkFi CLI configuration — set custom RPC URLs, switch networks, manage gas settings, and check transaction status. Use this skill when the user mentions RPC, rate limits, network settings, gas mode, gas token, configuration, settings, preferences, or wants to check a transaction hash. Also trigger when the user wants to customize their setup, troubleshoot connection issues, switch between mainnet and testnet, change how gas is paid, or verify whether a transaction succeeded — even if they don't say "config".
3
+ description: View and modify StarkFi CLI configuration — set custom RPC URLs, switch networks, manage gas settings, and check transaction status. Use this skill when the user mentions RPC, rate limits, network settings, gas mode, gas token, configuration, settings, preferences, or wants to check a transaction hash. Also trigger when the user wants to customize their setup, troubleshoot connection issues, fix errors, switch between mainnet and testnet, change how gas is paid, enable free gas, "gas fees too high", "not working", verify whether a transaction succeeded, or check tx status — even if they don't say "config".
4
4
  license: MIT
5
5
  compatibility: Requires Node.js 18+ and npx.
6
6
  metadata:
package/skills/dca/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: dca
3
- description: Create, preview, list, and cancel recurring Dollar-Cost Averaging (DCA) buy orders on Starknet via AVNU or Ekubo. Use this skill when the user wants to set up automatic recurring purchases, dollar cost average into a token, create a DCA order, schedule periodic buys, or manage existing DCA orders — even if they don't use the term "DCA" explicitly.
3
+ description: Create, preview, list, and cancel recurring Dollar-Cost Averaging (DCA) buy orders on Starknet via AVNU or Ekubo. Use this skill when the user wants to set up automatic recurring purchases, dollar-cost average into a token, create a DCA order, schedule periodic buys, invest regularly, buy every day/week/month, or manage existing DCA orders. Also trigger when the user says "recurring buy", "scheduled purchase", "buy X of Y every day", or any variation about automated periodic investing — even if they don't use the term "DCA" explicitly.
4
4
  license: MIT
5
5
  compatibility: Requires Node.js 18+ and npx.
6
6
  metadata:
@@ -9,6 +9,7 @@ metadata:
9
9
  category: transaction
10
10
  allowed-tools:
11
11
  - Bash(npx starkfi@latest dca-create *)
12
+ - Bash(npx starkfi@latest dca-list)
12
13
  - Bash(npx starkfi@latest dca-list *)
13
14
  - Bash(npx starkfi@latest dca-cancel *)
14
15
  - Bash(npx starkfi@latest dca-preview *)
package/skills/lending/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: lending
3
- description: Manage Vesu V2 lending positions on Starknet — supply assets, borrow against collateral, repay debt, withdraw, close positions, monitor health factors, and auto-rebalance risky positions. Use this skill when the user mentions lending, borrowing, supplying collateral, Vesu, interest, health factor, liquidation, monitoring positions, auto-rebalancing, protecting against liquidation, or DeFi yield from lending protocols.
3
+ description: Manage Vesu V2 lending positions on Starknet — supply assets, borrow against collateral, repay debt, withdraw, close positions, monitor health factors, and auto-rebalance risky positions. Use this skill when the user mentions lending, borrowing, supplying collateral, Vesu, earn interest, health factor, liquidation risk, monitoring positions, auto-rebalancing, protecting against liquidation, "my position is risky", "health factor low", or DeFi yield from lending protocols — even if they don't say "lending" explicitly.
4
4
  license: MIT
5
5
  compatibility: Requires Node.js 18+ and npx.
6
6
  metadata:
package/skills/portfolio/SKILL.md CHANGED
@@ -71,11 +71,13 @@ npx starkfi@latest portfolio-rebalance --target "<allocation>" [--slippage <n>]
71
71
 
72
72
  ## Dashboard Sections
73
73
 
74
- The portfolio displays three sections:
74
+ The portfolio displays five sections:
75
75
 
76
76
  1. **Token Balances** — STRK, ETH, and all ERC-20 tokens with non-zero balances and their USD values.
77
77
  2. **Staking Positions** — Active stakes across all validators/pools with pending rewards. Shows unpooling amounts and cooldown dates when exit intents are active.
78
78
  3. **Lending Positions** — Active Vesu V2 positions: supplied and borrowed amounts with pool details.
79
+ 4. **DCA Orders** — Active Dollar-Cost Averaging recurring swap orders.
80
+ 5. **Confidential Tongo Balance** — Private active and pending balances under Tongo Cash.
79
81
 
80
82
  ## Examples
81
83
 
package/skills/staking/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: staking
3
- description: Stake, unstake, claim, and compound rewards for STRK, WBTC, tBTC, SolvBTC, and LBTC on Starknet. View validators, pools, and staking positions. Use this skill when the user mentions staking, delegating, validators, rewards, compounding, unstaking, or wants to earn yield on their STRK or BTC tokens.
3
+ description: Stake, unstake, claim, and compound rewards for STRK, WBTC, tBTC, SolvBTC, and LBTC on Starknet. View validators, pools, and staking positions. Use this skill when the user mentions staking, delegating, validators, staking pools, rewards, compounding, unstaking, earning yield, passive income on crypto, or wants to earn on their STRK or BTC tokens — even if they don't say "stake" explicitly.
4
4
  license: MIT
5
5
  compatibility: Requires Node.js 18+ and npx.
6
6
  metadata: