staking

Stake, unstake, claim, and compound rewards for STRK, WBTC, tBTC, SolvBTC, and LBTC on Starknet. View validators, pools, and staking positions. Use this skill when the user mentions staking, delegating, validators, rewards, compounding, unstaking, or wants to earn yield on their STRK or BTC tokens.

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "staking" with this command: npx skills add ahmetenesdur/starkfi/ahmetenesdur-starkfi-staking

Staking

Manage Starknet staking operations: delegate tokens to validators, claim or compound rewards, and unstake positions. Supports multiple token types across various validators and pools.

Prerequisites

  • Active session required.
  • Sufficient token balance for staking + gas fees.

Supported Tokens

TokenType
STRKNative
WBTCBitcoin
tBTCBitcoin
SolvBTCBitcoin
LBTCBitcoin

Rules

  1. BEFORE staking, you MUST run npx starkfi@latest validators to list available validators, then npx starkfi@latest pools <validator> to see available pools.
  2. BEFORE staking, check balance to confirm the user has enough tokens.
  3. Unstaking is a two-step process: first unstake intent starts a cooldown, then unstake exit finalizes after the cooldown period. The user must wait between these steps.
  4. rewards --compound atomically claims and restakes in one transaction.
  5. AFTER any transactional operation (stake, unstake, rewards), verify with tx-status.
  6. Use stake-status to view the user's current staking positions across all validators. When exit intents are active, unpooling amounts and cooldown dates are shown automatically.
  7. Token defaults to STRK if --token is not specified.

Commands

# Discovery
npx starkfi@latest validators [--json]
npx starkfi@latest pools <validator> [--json]
npx starkfi@latest stake-status [validator] [--json]

# Stake tokens
npx starkfi@latest stake <amount> --validator <name> [--token <symbol>] [--simulate]

# Unstake (two-step)
npx starkfi@latest unstake intent --validator <name> --amount <amount> [--token <symbol>]
npx starkfi@latest unstake exit --validator <name> [--token <symbol>]

# Rewards
npx starkfi@latest rewards --claim --validator <name> [--token <symbol>]
npx starkfi@latest rewards --compound --validator <name> [--token <symbol>]

Parameters

stake

ParameterTypeDescriptionRequired
amountnumberAmount to stake (positional)Yes
--validatorstringValidator name (from validators list)Yes*
--poolstringPool contract address (alternative to validator)Yes*
--tokenstringToken symbol (default: STRK)No
--simulateflagEstimate fees without broadcastingNo

*Provide either --validator or --pool.

unstake

ParameterTypeDescriptionRequired
actionstringintent or exit (positional)Yes
--validatorstringValidator nameYes*
--poolstringPool contract addressYes*
--amountnumberAmount to unstake (required for intent)For intent
--tokenstringToken symbol (default: STRK)No

rewards

ParameterTypeDescriptionRequired
--claimflagClaim pending rewardsYes*
--compoundflagClaim and immediately restakeYes*
--validatorstringValidator nameYes**
--poolstringPool contract addressYes**
--tokenstringToken symbol (default: STRK)No

*Provide either --claim or --compound. **Provide either --validator or --pool.

Examples

User: "Which validators can I stake with?"

npx starkfi@latest validators

User: "Show me pools for Karnot"

npx starkfi@latest pools Karnot

User: "Stake 1000 STRK with Karnot"

npx starkfi@latest status
npx starkfi@latest balance --token STRK
npx starkfi@latest stake 1000 --validator Karnot
npx starkfi@latest tx-status <hash>

User: "Stake 0.5 WBTC with Karnot"

npx starkfi@latest balance --token WBTC
npx starkfi@latest stake 0.5 --validator Karnot --token WBTC
npx starkfi@latest tx-status <hash>

User: "Compound my STRK rewards from Karnot"

npx starkfi@latest rewards --compound --validator Karnot
npx starkfi@latest tx-status <hash>

User: "Claim my rewards from Karnot"

npx starkfi@latest rewards --claim --validator Karnot
npx starkfi@latest tx-status <hash>

User: "I want to unstake my STRK from Karnot"

# Step 1: Start unstake cooldown
npx starkfi@latest unstake intent --validator Karnot --amount 1000
npx starkfi@latest tx-status <hash>
# Inform user about cooldown period
# Step 2: After cooldown, finalize
npx starkfi@latest unstake exit --validator Karnot
npx starkfi@latest tx-status <hash>

User: "Show me all my staking positions"

npx starkfi@latest stake-status

Error Handling

ErrorAction
Validator not foundRun validators to list valid names.
Pool not foundRun pools <validator> to list available pools.
Insufficient balanceCheck balance and suggest a smaller amount.
Cooldown not completeUser must wait before running unstake exit.
No rewards to claimPosition has no pending rewards.
Not authenticatedRun authenticate-wallet skill first.

Related Skills

  • Use balance to check available tokens before staking.
  • Use portfolio for a full overview including staking positions with USD values.
  • Use batch to combine staking with other operations in one transaction.

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open in GitHubOpen in ClawHub

Related Skills

Related by shared tags or category signals.

Web3

authenticate-wallet

No summary provided by upstream source.

Repository SourceNeeds Review
12-ahmetenesdur
Web3

trade

No summary provided by upstream source.

Repository SourceNeeds Review
12-ahmetenesdur
Web3

balance

No summary provided by upstream source.

Repository SourceNeeds Review
11-ahmetenesdur
Web3

send

No summary provided by upstream source.

Repository SourceNeeds Review
11-ahmetenesdur
staking | V50.AI