Configuration

View Current Settings

starkfi config list

Shows your current network, RPC endpoint, gas mode, and gas token. If nothing has been configured, you'll see default values.

Network

Switch between Starknet mainnet and Sepolia testnet:

starkfi config set-network mainnet    # Production (default)
starkfi config set-network sepolia    # Testnet

Note: Switching networks does not affect your session — you stay authenticated. However, your wallet address and balances will differ per network.

Custom RPC

Set a custom Starknet RPC endpoint:

starkfi config set-rpc https://starknet-mainnet.g.alchemy.com/v2/YOUR_KEY

Check the current RPC:

starkfi config get-rpc

Tip: Use a custom RPC if you're hitting rate limits on the default Starkzap endpoint, or if you need higher throughput for batch operations.

Gas Abstraction

By default, you pay gas in STRK. StarkFi supports two alternative gas modes via the AVNU Paymaster — both let you transact without holding STRK.

Gasfree Mode — Developer Pays Everything

The developer sponsors all gas fees. Users transact for free.

starkfi config set-gasfree on     # Enable
starkfi config set-gasfree off    # Disable

Best for onboarding new users, demos, and testing environments.

Gasless Mode — User Pays in Any Token

Users pay gas in an ERC-20 token they already hold — no STRK needed:

starkfi config set-gas-token USDC     # Pay gas in USDC
starkfi config set-gas-token ETH      # Pay gas in ETH
starkfi config set-gas-token reset    # Revert to default (STRK)

Supported Gas Tokens

Important: Gasfree and Gasless modes are mutually exclusive. Enabling one clears the other. Use starkfi config list to verify your current mode.

Reset All Settings

Clear all custom configuration and revert to defaults:

starkfi config reset

This removes custom RPC URL, network, gas token, and gasfree mode settings in one command.

MCP Server Configuration

When using the MCP server, the same settings are available through the config_action tool:

{ "action": "set-gasfree", "value": "on" }
{ "action": "set-gas-token", "value": "USDC" }
{ "action": "set-network", "value": "mainnet" }
{ "action": "reset" }
{ "action": "list" }

All 7 subcommands work identically in both CLI and MCP: list, reset, set-rpc, get-rpc, set-network, set-gasfree, set-gas-token.

Environment Variables

These environment variables override configuration for advanced use cases: