Account Structure (PDAs)

Reference for all 7 PDA account types the program maintains. Every field is sourced from programs/obv-perps/src/state/.

1. MarketConfig

Per-market configuration + live state. One per market (68 total at launch).

Seeds: ["market", market_id: u16]

2. UserPosition

One per trader per market. Created by open_position; closed by close_position, liquidation, or settlement.

Seeds: ["position", market_config: Pubkey, owner: Pubkey]

The first key is the MarketConfig PDA, not the raw market id. Pre-derive it from ["market", market_id] and pass that pubkey when deriving the position PDA.

One position per (trader, market) pair is enforced by the PDA seeds. A trader who wants two positions on the same market must use two different signers (e.g., a sub-account).

3. LiquidityPool

Singleton. Global cross-market USDC custody — one PDA + one SPL token account shared by all 68 markets. Replaces the per-market VaultAccount model that earlier versions used.

Seeds: ["liquidity_pool"]

The pool_token SPL token account is at seeds ["pool_token"] with token::authority = liquidity_pool (the LiquidityPool PDA). Per-market accounting (open interest, funding accumulators, mark price) still lives on MarketConfig; only capital custody is global.

The full solvency invariant pool_token.amount ≥ Σ obligations is enforced off-chain by scripts/probe-solvency.ts (60s cadence with Telegram alerts on drift). On-chain instructions do cheap local checks only — see On-Chain Program → Capital model.

4. InsuranceFund

Global insurance fund. One PDA, shared across all markets.

Seeds: ["insurance"]

5. BackstopPosition

Created when Layer 2 absorbs an underwater position. Lives until fully unwound. At most one outstanding BackstopPosition per market at a time — the next absorption on the same market reuses the PDA after the previous one is fully unwound.

Seeds: ["backstop", market_id: u16]

6. TriggerOrder

One per placed SL, TP, or Limit Open. Closed on execute, cancel, or expiry-triggered cleanup.

Seeds: ["trigger", market_config: Pubkey, owner: Pubkey, order_id: u64 (LE)]

The first key is the MarketConfig PDA (not the raw market id), and the order id is serialized as little-endian u64.

Max 10 TriggerOrder accounts per (user, market) pair.

7. UserOrderCounter

Monotonic order ID allocator per user.

Seeds: ["order_counter", owner: Pubkey, market_config: Pubkey]

One counter per (user, market) pair — independent monotonic sequences keep order ids tightly packed within a market without colliding across markets.

next_order_id never decrements — cancelled orders don’t free their slot for reuse. This guarantees no two of a user’s orders ever share a PDA.

Deriving PDAs from TypeScript

import { PROGRAM_ID } from "@sportsperp/sdk";
import { PublicKey } from "@solana/web3.js";
import { struct, u16 } from "@coral-xyz/anchor";
 
// Market
const [marketPda] = PublicKey.findProgramAddressSync(
  [Buffer.from("market"), new BN(marketId).toArrayLike(Buffer, "le", 2)],
  PROGRAM_ID
);
 
// Position
const [positionPda] = PublicKey.findProgramAddressSync(
  [Buffer.from("position"), marketPda.toBuffer(), user.toBuffer()],
  PROGRAM_ID
);

Or just use the SDK helpers (sdk/src/pda.ts) — they’re exactly the same derivations, with typed signatures.

Account sizes (approximate)

For rent calculations and bulk queries:

Tip: When using getProgramAccounts with memcmp filters, match on dataSize: 138 to find UserPositions, dataSize: 350 for MarketConfigs, etc. Don’t fetch without filters — devnet will rate-limit.

Further reading

• SDK — the account fetcher helpers that wrap this state.
• Protocol Architecture → On-Chain Program — the program’s view of these accounts.
• Fixed-Point Math — the scales referenced throughout this table.