# Starknet

Send, receive, and manage assets on Starknet — including STRK, WBTC, USDC, and any ERC-20 token. Starknet provides instant, low-cost transactions with programmable smart contracts, making it ideal for agentic trading and DeFi.

### Check balance

```bash
xverse-wallet starknet balance --json
```

Returns all ERC-20 token balances on Starknet. Filter for specific tokens:

```bash
xverse-wallet starknet balance --filter "WBTC|USDC" --json
```

### Receive on Starknet

```bash
xverse-wallet starknet receive --json
```

Returns your Starknet address for receiving tokens.

### Send tokens

Send STRK, WBTC, USDC, or any ERC-20 token:

```bash
# Preview
xverse-wallet starknet send --to <address> --amount 10 --token STRK --json

# Execute
xverse-wallet starknet send --to <address> --amount 10 --token STRK --yes --json
```

#### Options

| Option                   | Description                                                |
| ------------------------ | ---------------------------------------------------------- |
| `--to <address>`         | Destination Starknet address                               |
| `--amount <value>`       | Amount to send                                             |
| `--token <contract>`     | Token to send (default: STRK). Symbol or contract address. |
| `--fee-token <contract>` | Token to pay gas with (if sponsorship unavailable)         |
| `--yes`                  | Execute (omit for dry run)                                 |

> **Note:** Transaction sponsorship is automatic when available. If unavailable, you must specify `--fee-token` with a token you hold a balance of.

### Transaction history

```bash
xverse-wallet starknet history --token STRK --json
xverse-wallet starknet history --token WBTC --limit 10 --json
```

### WBTC Staking

Stake WBTC on Starknet to earn STRK rewards.

#### Check staking position

```bash
xverse-wallet starknet staking status --json
```

#### Stake WBTC

```bash
# Preview
xverse-wallet starknet staking deposit --token wbtc --amount 0.01 --json

# Execute
xverse-wallet starknet staking deposit --token wbtc --amount 0.01 --fee-token <contract> --yes --json
```

#### Withdraw (7-day cooldown)

```bash
# Start withdrawal
xverse-wallet starknet staking withdraw-intent --amount 0.01 --fee-token <contract> --yes --json

# Complete after cooldown
xverse-wallet starknet staking withdraw --fee-token <contract> --yes --json
```

#### Claim STRK rewards

```bash
xverse-wallet starknet staking claim --fee-token <contract> --yes --json
```

#### Earning overview

For a guided view of your staking position, claimable rewards, and suggested next actions:

```bash
xverse-wallet earn status --json
xverse-wallet earn guide
```