Staking Commands

Stake, unstake, claim rewards, and browse validators — STRK, WBTC, tBTC, SolvBTC, LBTC

Prerequisite: All staking commands require an active authenticated session. Run starkfi auth login first.

Typical Flow

1. starkfi validators        →  Browse available validators
2. starkfi pools karnot      →  View pools for a validator
3. starkfi stake 100 -v karnot  →  Stake tokens
4. starkfi stake-status      →  View staking dashboard
5. starkfi rewards --compound -v karnot  →  Compound rewards

validators

Lists all available Starknet staking validators.

starkfi validators
starkfi validators --json

Shows validator name and staker address for the current network.

pools

Lists staking pools for a specific validator.

starkfi pools <validator>

Accepts a validator name (e.g., karnot) or staker address. Supports partial matches. Shows pool address, token, amount, and commission.

Examples:

starkfi pools karnot
starkfi pools fibrous --json

stake

Stakes tokens with a validator.

starkfi stake <amount> -v <validator> [flags]

Flags:

Flag	Default	Description
`-v, --validator <name>`	—	Validator name (auto-finds pool)
`-p, --pool <address>`	—	Pool contract address (direct)
`-t, --token <symbol>`	`STRK`	Token to stake
`--simulate`	`false`	Estimate fees without executing
`--json`	`false`	Output raw JSON

You must provide either --validator or --pool.

Supported tokens: STRK, WBTC, tBTC, SolvBTC, LBTC

Examples:

starkfi stake 100 -v karnot
starkfi stake 50 -v fibrous --simulate
starkfi stake 10 -p 0x04a3... -t STRK

stake-status

Shows a consolidated staking dashboard across all validators and pools.

starkfi stake-status [validator]
starkfi stake-status --json

Optionally filter by validator name. Shows staked amount, pending rewards, total value, and commission for each pool.

When an exit intent is active, additional Unpooling and Cooldown columns appear automatically showing the pending withdrawal amount and the date when the cooldown period ends.

rewards

Claims or compounds staking rewards.

# Claim rewards (withdraw to wallet)
starkfi rewards --claim -v <validator>

# Compound rewards (restake automatically)
starkfi rewards --compound -v <validator>

Flags:

Flag	Description
`--claim`	Withdraw rewards to wallet
`--compound`	Claim and immediately restake
`-v, --validator <name>`	Validator name (auto-finds pool)
`-p, --pool <address>`	Pool address (direct)
`-t, --token <symbol>`	Token symbol (default: `STRK`)
`--simulate`	Estimate fees without executing

You must provide either --validator or --pool, and either --claim or --compound.

Tip: --compound is more gas-efficient than claiming and re-staking separately.

unstake

Begins or finalizes the unstaking process. Unstaking is a two-step process with a cooldown period:

# Step 1 — Create exit intent
starkfi unstake intent -v <validator> -a <amount>

# Step 2 — Finalize exit (after cooldown)
starkfi unstake exit -v <validator>

Arguments:

Argument	Description
`action`	`intent` to start exit, `exit` to complete after cooldown

Flags:

Flag	Description
`-v, --validator <name>`	Validator name (auto-finds pool)
`-p, --pool <address>`	Pool contract address (direct)
`-a, --amount <value>`	Amount to unstake (required for `intent`)
`-t, --token <symbol>`	Token symbol (default: `STRK`)
`--simulate`	Estimate fees without executing

Note: There is a cooldown period between intent and exit. Run stake-status to track unpooling amounts and cooldown end dates.

Typical Flow

validators

pools

stake

stake-status

rewards

unstake

On this page