Staking Tools

Prerequisite: All staking tools require an active authenticated session. Call get_auth_status first to verify.

Recommended Flow

1. list_validators     →  Find validators on the network
2. list_pools          →  Find pools for a validator
3. get_staking_info    →  Check existing position (if any)
4. stake_tokens        →  Stake tokens into a pool
5. get_stake_status    →  View staking dashboard

list_validators

List all known Starknet staking validators.

Parameters: None

Returns validator names and staker addresses for the current network. This is a read-only tool.

list_pools

List delegation pools for a specific validator.

This is a read-only tool.

get_staking_info

Get staking position info for a specific pool: staked balance, unclaimed rewards, total balance, commission, and unpooling cooldown.

This is a read-only tool.

get_stake_status

Scan all known validators and pools to return a consolidated staking dashboard with total staked, total rewards, unpooling amounts, cooldown dates, and per-pool breakdown.

This is a read-only tool.

stake_tokens

Stake tokens in a delegation pool. Automatically detects whether to enter the pool or add to an existing delegation.

Important: This is a transactional tool. Confirm with the user before executing.

unstake_tokens

Unstaking is a two-step process with a cooldown period:

1. Call with action: "intent" to start the exit
2. Wait for the cooldown period to complete
3. Call with action: "exit" to complete withdrawal

Important: This is a transactional tool. The exit action can only be called after the cooldown period has elapsed.

claim_rewards

Withdraw staking rewards from a pool to the user's wallet.

Tip: Use get_staking_info first to check the unclaimed rewards amount.

compound_rewards

Atomically claim and re-stake rewards in a single transaction (compound interest). More gas-efficient than calling claim_rewards followed by stake_tokens separately.