k = base_reserve × quote_reserve

// Price calculation
mark_price = quote_reserve / base_reserve

// Swap output (buying base / going long)
new_quote = quote_reserve + input_amount
new_base  = k / new_quote
base_out  = base_reserve - new_base

side:       Long | Short
collateral: Amount of tokens deposited as margin
leverage:   1x to max_leverage (set by market)
size:       collateral × leverage (notional)
entry:      Calculated from vAMM swap output
liq_price:  Auto-calculated based on leverage

// Long position
pnl = size × (current_price - entry_price) / entry_price

// Short position
pnl = size × (entry_price - current_price) / entry_price

// Payout on close
payout = max(0, collateral + pnl) - closing_fee

maintenance_margin = 5% of position size

// Position is liquidatable when:
collateral + unrealized_pnl ≤ maintenance_margin

// Liquidation price (Long):
liq_price = entry × (1 - (1 - maintenance) / leverage)

// Liquidation price (Short):
liq_price = entry × (1 + (1 - maintenance) / leverage)

// First deposit
shares = deposit_amount

// Subsequent deposits
shares = deposit_amount × total_shares / total_liquidity

// vAMM reserves scale proportionally with liquidity
// More liquidity = deeper book = less slippage

ProtocolConfig  → seeds: ["protocol"]
Market          → seeds: ["market", token_mint]
TokenVault      → seeds: ["vault", market]
VaultAuthority  → seeds: ["vault_auth", market]
Position        → seeds: ["position", market, trader, index]

import { LeviantPerpClient } from '@leviantperp/sdk';
import { Connection } from '@solana/web3.js';

// Connect
const connection = new Connection('https://api.devnet.solana.com');
const client = LeviantPerpClient.fromPhantom(connection);

// Create a market
const { tx, market } = await client.createMarket(
  tokenMint,    // PublicKey
  10,           // max leverage
  30,           // spread bps
  1_000_000     // seed liquidity
);

// Open a 5x long
const { tx, position } = await client.openPosition(
  tokenMint,
  'long',
  10_000,       // collateral
  5             // leverage
);

// Get market stats
const stats = await client.getMarketStats(tokenMint);
console.log(stats.markPrice, stats.creatorFees);