ahmetenesdur/multi-swap
skills/multi-swap/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add ahmetenesdur/starkfi multi-swapInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 8:42 PM1.9s1 file scanned
SKILL.md
- name:
- multi-swap
- 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.
- version:
- 0.1.0
- author:
- ahmetenesdur
- category:
- transaction
Multi-Swap
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
- Active session required.
- Sufficient balance for ALL source tokens + gas fees.
Rules
- BEFORE any multi-swap, you MUST run
npx starkfi@latest statusandnpx starkfi@latest balanceto verify connectivity and source token balances for ALL pairs. - Minimum 2 and maximum 3 swap pairs per multi-swap. Single swaps should use the
tradeskill instead. - The pairs string MUST be wrapped in double quotes and each pair separated by a comma.
- Each pair follows the format:
<amount> <FROM>><TO>(no spaces around>). - Default slippage is 1%. To change, use
--slippage <percent>. - Suggest using
--simulatefirst so the user can confirm gas cost. - AFTER a successful multi-swap, you MUST verify using
npx starkfi@latest tx-status <hash>.
Commands
npx starkfi@latest multi-swap "<pairs>" [--provider <fibrous|avnu|ekubo|auto>] [--slippage <percent>] [--simulate] [--json]
Parameters
| 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 |
Pair Format
"<amount> <FROM>><TO>, <amount> <FROM>><TO>"
Examples:
"100 USDC>ETH, 200 USDT>STRK"— two pairs"50 DAI>ETH, 100 USDC>STRK, 0.1 ETH>USDT"— three pairs (maximum)
Examples
User: "Swap 100 USDC to ETH and 200 USDT to STRK in one transaction"
npx starkfi@latest status
npx starkfi@latest balance
npx starkfi@latest multi-swap "100 USDC>ETH, 200 USDT>STRK"
npx starkfi@latest tx-status <hash>
User: "Simulate swapping 50 DAI, 100 USDC, and 0.1 ETH"
npx starkfi@latest multi-swap "50 DAI>ETH, 100 USDC>STRK, 0.1 ETH>USDT" --simulate
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. |
| 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
- Use
tradefor a single swap (simpler syntax). - Use
batchfor combining swaps with other operations (stake, supply, send). - Use
balanceto verify you have enough of all source tokens.
Related Skills
ahmetenesdur/troves
testing
VerifiedTrustedCommunity
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.
2SKILL.mdUpdated Apr 29, 2026
ahmetenesdur/lst
testing
VerifiedTrustedCommunity
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.
2SKILL.mdUpdated Apr 29, 2026
ahmetenesdur/dca
testing
VerifiedTrustedCommunity
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.
2SKILL.mdUpdated Apr 10, 2026
ahmetenesdur/confidential
development
VerifiedTrustedCommunity
Manage confidential (private) transfers via Tongo Cash on Starknet — setup, fund, transfer, withdraw, ragequit, rollover using ZK proofs. Use this skill when the user wants to send tokens privately, hide transfer amounts, use zero-knowledge proofs, set up Tongo, fund or withdraw from a confidential account, perform an emergency exit (ragequit), or activate pending balance (rollover). Also trigger when the user says "send privately", "confidential transfer", "hide my transaction", "Tongo Cash", "ZK transfer", or any variation about privacy-preserving transfers — even if they don't use the word "confidential".
2SKILL.mdUpdated Apr 10, 2026