Quickstart

This quickstart walks through cloning the repo, building the programs, launching the frontend against devnet, and running the end-to-end script that touches every program.

Prerequisites

Install toolchain

You need Rust, the Solana CLI, and Anchor.

# Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Solana
sh -c "$(curl -sSfL https://release.solana.com/stable/install)"

# Anchor
cargo install --git https://github.com/coral-xyz/anchor avm --locked --force
avm install latest && avm use latest

Fund a devnet wallet

solana config set --url devnet
solana-keygen new --outfile ~/.config/solana/id.json
solana airdrop 2

Clone and build

git clone https://github.com/kimia-protocol/kimia.git
cd kimia

The repo has three workspaces:

kimia/
├── Perp-engine/   # kimia-perp Anchor program + perps-math / perps-common crates
├── Programs/      # delta-vault, intent-router, yield-amm, split-engine, kusd-mint
└── frontend/      # Next.js 16 app (app/, codama clients, wallet)

Build every Anchor program:

cd Perp-engine && anchor build && cd ..
cd Programs    && anchor build && cd ..

Run the devnet end-to-end

The Programs/ workspace ships a single script that:

Initializes the perp market and orderbook
Seeds the spot pool with USDC/wSOL
Initializes the delta-vault, opens a hedged position
Creates a split-engine market (PT + YT)
Creates a yield-AMM pool and swaps YT for underlying

cd Programs
npm install
npx ts-node tests/devnet-e2e.ts

The script is idempotent, re-running it skips initialized accounts.

Launch the frontend

cd frontend
npm install
npm run setup    # builds Anchor vault + regenerates all Codama clients
npm run dev

Open http://localhost:3000, connect a wallet, pick devnet in the cluster switcher, and you’ll see:

Route	What it exposes
`/`	Perp trading, TradingView chart, orderbook, order form, positions
`/vaults`	Deposit / withdraw / claim funding on the delta-vault
`/earn`	Buy PT, claim yield, redeem at maturity
`/yield-amm`	Add / remove LP, swap PT ↔ underlying
`/intent`	Fixed-rate lock flow across the full stack
`/kusd`	Mint / redeem kUSD, stake for yield

Regenerate clients after a program change

Every program has a Codama config that targets its IDL. After you edit Rust:

cd frontend
npm run codama:all

This rewrites TypeScript clients under app/generated/<program>/, instructions, accounts, and PDA helpers, all typed against @solana/kit.

Integrate

Guides

Reference

Prerequisites

Clone and build

Run the devnet end-to-end

Launch the frontend

Regenerate clients after a program change

What next?

Architecture

Program reference

​Prerequisites

​Clone and build

​Run the devnet end-to-end

​Launch the frontend

​Regenerate clients after a program change

​What next?

Architecture

Program reference

Prerequisites

Clone and build

Run the devnet end-to-end

Launch the frontend

Regenerate clients after a program change

What next?