Skip to main content

​
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. Kimia uses wallet-standard for discovery.

​
”Insufficient SOL for fees”

Every tx costs a small amount of SOL, even on devnet.
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 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.
  • 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.