Batch Execute

Bundle multiple diverse DeFi operations into a single Starknet multicall transaction. Supports combining swaps, staking, lending supply, and token sends — all executed atomically in one on-chain call.

Prerequisites

• Active session required.
• Sufficient balance for all operations + gas fees.
• Minimum 2 operations required per batch.

Rules

1. BEFORE any batch, you MUST run npx starkfi@latest status and npx starkfi@latest balance to verify connectivity and funds.
2. A batch MUST include at least 2 operations. For single operations, use the dedicated skill (trade, send, staking, or lending).
3. Each --swap, --stake, --supply, and --send flag can appear multiple times (repeatable).
4. Suggest using --simulate first to verify the entire batch would succeed.
5. AFTER a successful batch, verify with npx starkfi@latest tx-status <hash>.
6. All operations in a batch are atomic — if any one fails, the entire transaction reverts.

Commands

npx starkfi@latest batch [--simulate] [--json] \
  --swap "<amount> <from> <to>" \
  --stake "<amount> <token> <validator_or_pool>" \
  --supply "<amount> <token> <pool_address>" \
  --send "<amount> <token> <recipient>"

Operation Formats

Note: --stake accepts either a validator name (e.g. Karnot) or a pool contract address (starting with 0x). The CLI auto-detects the format.

Parameters

*At least 2 operations (of any type) are required.

Examples

User: "Swap 100 USDC to ETH and stake 500 STRK with Karnot in one transaction"

npx starkfi@latest status
npx starkfi@latest balance
npx starkfi@latest batch --swap "100 USDC ETH" --stake "500 STRK Karnot"
npx starkfi@latest tx-status <hash>

User: "Batch: swap 50 USDT to STRK, supply 100 USDC and send 10 STRK"

npx starkfi@latest status
npx starkfi@latest balance
npx starkfi@latest batch \
  --swap "50 USDT STRK" \
  --supply "100 USDC 0x04a3..." \
  --send "10 STRK 0x07b2..."
npx starkfi@latest tx-status <hash>

User: "Simulate a batch of two swaps and a stake"

npx starkfi@latest batch --simulate \
  --swap "100 USDC ETH" \
  --swap "200 USDT STRK" \
  --stake "500 STRK Karnot"

Error Handling

Related Skills

• Use trade for a single swap.
• Use staking for standalone staking operations.
• Use lending for standalone lending operations.
• Use send for standalone token transfers.