Configuration & Utilities
Manage local configuration for the StarkFi CLI and check transaction status on-chain. Configuration includes RPC endpoints, network selection, and gas payment settings.
Prerequisites
- None for configuration commands (
config list,config set-*,config get-rpc). - Active session required for
tx-status(it reads the network from the session).
Configuration Commands
# List all current settings
npx starkfi@latest config list
# Reset all settings to defaults
npx starkfi@latest config reset
# Set custom RPC URL
npx starkfi@latest config set-rpc <url>
# Get current RPC URL
npx starkfi@latest config get-rpc
# Switch network
npx starkfi@latest config set-network <network>
# Toggle developer-sponsored gas (Gasfree mode)
npx starkfi@latest config set-gasfree <on|off>
# Set gas payment token (for Gasless mode)
npx starkfi@latest config set-gas-token <token>
Transaction Status
npx starkfi@latest tx-status <hash>
Gas Modes
StarkFi supports two gas abstraction modes:
| Mode | Who Pays | Command | Description |
|---|---|---|---|
| Gasfree | Developer | config set-gasfree on | Gas fees sponsored by StarkFi via Paymaster |
| Gasless | User (ERC-20) | config set-gas-token STRK | User pays gas in an ERC-20 token (default mode) |
Supported gas tokens: ETH, STRK, USDC, USDT, DAI
Gasfree and Gasless are mutually exclusive — enabling one disables the other.
Default: Gasless mode with STRK as gas token. Gas is paid through the Paymaster, so the user does not need native ETH for gas — any supported ERC-20 works.
Parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
url | string | Full HTTP(S) RPC endpoint URL | Yes |
network | string | mainnet or sepolia | Yes |
on/off | string | Enable or disable Gasfree mode | Yes |
token | string | Gas token symbol or reset (reverts to STRK) | Yes |
hash | string | Transaction hash (0x...) | Yes |
Rules
- Rate Limits: If any skill fails with "rate limit" or "429" errors, use
config set-rpcto set a custom RPC endpoint. - Persistence: Settings are stored locally and persist across sessions.
- Use
tx-statusAFTER everysend,trade,multi-swap,batch, and staking/lending transaction to verify success. - Use
config get-rpcto check the current RPC URL before changing it.
Examples
User: "I'm getting rate limit errors"
npx starkfi@latest config get-rpc
npx starkfi@latest config set-rpc https://starknet-mainnet.g.alchemy.com/v2/<key>
User: "Show my current configuration"
npx starkfi@latest config list
User: "Switch to testnet"
npx starkfi@latest config set-network sepolia
User: "Enable free gas mode"
npx starkfi@latest config set-gasfree on
User: "I want to pay gas in USDC"
npx starkfi@latest config set-gasfree off
npx starkfi@latest config set-gas-token USDC
User: "Reset gas token to default"
npx starkfi@latest config set-gas-token reset
User: "Reset all my settings"
npx starkfi@latest config reset
User: "Did my transaction go through? Hash is 0xabc..."
npx starkfi@latest tx-status 0xabc...
Error Handling
| Error | Action |
|---|---|
Invalid RPC URL | Ensure URL starts with http:// or https://. |
Invalid network | Use mainnet or sepolia. |
Unsupported gas token | Must be one of: ETH, STRK, USDC, USDT, DAI. |
Transaction not found | Verify the hash is correct and the network matches. |
Pending | Transaction is still in mempool — wait and retry. |
Related Skills
- This skill is referenced by all other skills for rate limit recovery.
- Use
config set-gasfree onfor developer-sponsored gas. - Use
tx-statusto verify transactions from any transactional skill.