> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kimia.live/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> The most common problems on Kimia and how to fix them.

## I can't connect my wallet

* Make sure your wallet is unlocked and on **devnet**.
* Try a hard refresh (`Cmd+Shift+R` / `Ctrl+Shift+F5`).
* If the wallet list is empty, check that your extension supports
  [Wallet Standard](https://wallet-standard.github.io/wallet-standard/). Kimia
  uses wallet-standard for discovery.

## "Insufficient SOL for fees"

Every tx costs a small amount of SOL, even on devnet.

```bash theme={null}
solana airdrop 2
```

Or click the airdrop icon in the app header.

## Trade reverts with `StaleOracle`

Kimia uses **Pyth Hermes Pull Oracles**, the price must be posted and consumed
in the same tx.

* The app handles this automatically by prepending a `postPriceUpdate`
  instruction.
* If the tx takes >60 s to land, the oracle goes stale. Retry.
* If you're building your own client, see [oracles concept](/concepts/oracles)
  for the exact flow.

## Trade reverts with `InsufficientFreeCollateral`

Your open orders may have reserved margin that you're trying to spend.

* Check **Open Orders**, cancel anything you don't want.
* Alternately, deposit more USDC.

`free_collateral = collateral - total_reserved_margin`. A resting order cannot
share margin with a new position.

## Trade reverts with `SlippageExceeded`

Market moved too far between quote and fill.

* Raise your **Max Slippage** (default 1%; try 2-3% on small markets).
* Reduce your trade size, large market orders walk more levels.

## My fixed-rate intent reverted at step 3

The AMM moved against you between TX2 and TX3.

* Your PT, YT, and any USDC you have are **unchanged**. Nothing was taken.
* You can unwind manually: sell YT at whatever rate the AMM offers now, or
  recombine PT + YT for an early-exit (0.3% fee).
* Raising your target rate above what the AMM realistically offers will always
  revert.

## My vault share price didn't move

Funding accrues off-chain (in the perp engine's cumulative-funding variable)
but NAV only updates when `claim_funding` runs.

* Anyone can call it. Click "Crank funding" in the vault page.
* In practice, keepers run it hourly. If you're on a fresh devnet without
  keepers, you'll need to crank yourself.

## I deposited to the vault but nothing happened

Check the transaction on the [explorer](https://explorer.solana.com/?cluster=devnet).

* If it's pending, wait 15-30 s.
* If it's failed, the toast shows the error. Common culprits:
  `VaultNotActive` (vault is paused), `StaleOracle` (retry), `MathOverflow`
  (size too large).

## I want to see my PT + YT balances

PT and YT are normal SPL tokens. Add their mint addresses to your wallet:

* From the Earn page, click the token icon → **Copy mint address**.
* Paste into your wallet's "Add custom token" flow.

## I got liquidated

* Liquidation triggers at `health ≤ 0`, i.e. when `free_collateral +
  unrealized_pnl < maintenance_margin_req`.
* Your entire position was closed at oracle price, minus a 5% liquidation fee.
* Any remaining collateral stays in your `UserAccount` and can be withdrawn.
* If the liquidation resulted in **bad debt** (collateral \< -unrealized\_pnl),
  the insurance fund absorbed the rest, and you owe nothing.

Prevent it next time:

* Watch your **liquidation price** on the positions page.
* Don't max-leverage into volatile markets.
* Deposit more collateral instead of reducing the position if you want to ride
  a drawdown.

## Still stuck?

* Copy the failing transaction ID from the toast.
* Open the explorer link, grab the program-log section.
* Most errors are documented in the [errors reference](/resources/errors).