@percolatorct/sdk 1.0.0-beta.9 → 2.0.1

package/dist/math/trading.d.ts

@@ -10,68 +10,20 @@
  */
 /**
  * Compute mark-to-market PnL for an open position.
- *
- * @param positionSize - Signed position size (positive = long, negative = short).
- * @param entryPrice   - Entry price in e6 format (1 USD = 1_000_000).
- * @param oraclePrice  - Current oracle price in e6 format.
- * @returns PnL in native token units (positive = profit, negative = loss).
- *
- * @example
- * ```ts
- * // Long 10 SOL at $100, oracle now $110 → profit
- * const pnl = computeMarkPnl(10_000_000n, 100_000_000n, 110_000_000n);
- * ```
  */
 export declare function computeMarkPnl(positionSize: bigint, entryPrice: bigint, oraclePrice: bigint): bigint;
 /**
  * Compute liquidation price given entry, capital, position and maintenance margin.
  * Uses pure BigInt arithmetic for precision (no Number() truncation).
- *
- * @param entryPrice          - Entry price in e6 format.
- * @param capital             - Account capital in native token units.
- * @param positionSize        - Signed position size (positive = long, negative = short).
- * @param maintenanceMarginBps - Maintenance margin requirement in basis points (e.g. 500n = 5%).
- * @returns Liquidation price in e6 format. Returns 0n for longs that can't be liquidated,
- *          or max u64 for shorts with ≥100% maintenance margin.
- *
- * @example
- * ```ts
- * // Long 1 SOL at $100, $10 capital, 5% maintenance margin
- * const liqPrice = computeLiqPrice(100_000_000n, 10_000_000n, 1_000_000n, 500n);
- * ```
  */
 export declare function computeLiqPrice(entryPrice: bigint, capital: bigint, positionSize: bigint, maintenanceMarginBps: bigint): bigint;
 /**
  * Compute estimated liquidation price BEFORE opening a trade.
  * Accounts for trading fees reducing effective capital.
- *
- * @param oracleE6   - Current oracle price in e6 format (used as entry estimate).
- * @param margin     - Deposit margin in native token units.
- * @param posSize    - Intended position size (absolute value used internally).
- * @param maintBps   - Maintenance margin in basis points.
- * @param feeBps     - Trading fee in basis points.
- * @param direction  - Trade direction: `"long"` or `"short"`.
- * @returns Estimated liquidation price in e6 format.
- *
- * @example
- * ```ts
- * const liq = computePreTradeLiqPrice(
- *   100_000_000n, 10_000_000n, 1_000_000n, 500n, 30n, "long"
- * );
- * ```
  */
 export declare function computePreTradeLiqPrice(oracleE6: bigint, margin: bigint, posSize: bigint, maintBps: bigint, feeBps: bigint, direction: "long" | "short"): bigint;
 /**
  * Compute trading fee from notional value and fee rate in bps.
- *
- * @param notional      - Trade notional value in native token units.
- * @param tradingFeeBps - Fee rate in basis points (e.g. 30n = 0.30%).
- * @returns Fee amount in native token units.
- *
- * @example
- * ```ts
- * const fee = computeTradingFee(1_000_000_000n, 30n); // 0.30% of 1 SOL
- * ```
  */
 export declare function computeTradingFee(notional: bigint, tradingFeeBps: bigint): bigint;
 /**
@@ -137,86 +89,19 @@ export declare function computeFeeSplit(totalFee: bigint, config: FeeSplitConfig
 export declare function computePnlPercent(pnlTokens: bigint, capital: bigint): number;
 /**
  * Estimate entry price including fee impact (slippage approximation).
- *
- * @param oracleE6      - Current oracle price in e6 format.
- * @param tradingFeeBps - Trading fee in basis points.
- * @param direction     - Trade direction: `"long"` or `"short"`.
- * @returns Estimated entry price in e6 format (higher for longs, lower for shorts).
- *
- * @example
- * ```ts
- * const entry = computeEstimatedEntryPrice(100_000_000n, 30n, "long");
- * // → 100_030_000n (oracle + 0.30% fee impact)
- * ```
  */
 export declare function computeEstimatedEntryPrice(oracleE6: bigint, tradingFeeBps: bigint, direction: "long" | "short"): bigint;
 /**
  * Convert per-slot funding rate (bps) to annualized percentage.
- *
- * @param fundingRateBpsPerSlot - Funding rate per slot in basis points (i64 from engine state).
- * @returns Annualized funding rate as a percentage (e.g. 12.5 = 12.5% APR).
- * @throws Error if the value exceeds Number.MAX_SAFE_INTEGER.
- *
- * @example
- * ```ts
- * const apr = computeFundingRateAnnualized(1n); // ~78.84% APR
- * ```
  */
 export declare function computeFundingRateAnnualized(fundingRateBpsPerSlot: bigint): number;
 /**
  * Compute margin required for a given notional and initial margin bps.
- *
- * @param notional         - Trade notional value in native token units.
- * @param initialMarginBps - Initial margin requirement in basis points (e.g. 1000n = 10%).
- * @returns Required margin in native token units.
- *
- * @example
- * ```ts
- * const margin = computeRequiredMargin(10_000_000_000n, 1000n); // 10% of notional
- * // → 1_000_000_000n
- * ```
  */
 export declare function computeRequiredMargin(notional: bigint, initialMarginBps: bigint): bigint;
 /**
  * Compute maximum leverage from initial margin bps.
  *
- * Formula: leverage = 10000 / initialMarginBps
- * Uses scaled arithmetic to preserve precision for fractional leverage values.
- *
- * @param initialMarginBps - Initial margin requirement in basis points (e.g. 500n = 5% → 20x).
- * @returns Maximum leverage as a number (e.g. 20 for 500 bps, 3.003 for 3333 bps).
- * @throws Error if initialMarginBps is zero (infinite leverage is undefined).
- *
- * @example
- * ```ts
- * const maxLev = computeMaxLeverage(500n); // → 20
- * const maxLev2 = computeMaxLeverage(1000n); // → 10
- * const maxLev3 = computeMaxLeverage(3333n); // → 3.003 (not truncated to 3)
- * ```
+ * @throws Error if initialMarginBps is zero (infinite leverage is undefined)
  */
 export declare function computeMaxLeverage(initialMarginBps: bigint): number;
-/**
- * Compute the maximum amount that can be withdrawn from a position.
- *
- * The withdrawable amount is the capital plus any matured (unreserved) PnL.
- * Reserved PnL is still locked and cannot be withdrawn until the warmup period elapses.
- *
- * Formula: max_withdrawable = capital + max(0, pnl - reserved_pnl)
- *
- * @param capital - Capital allocated to the position (in native token units)
- * @param pnl - Mark-to-market PnL (in native token units, can be negative)
- * @param reservedPnl - PnL that is still locked during warmup (always non-negative)
- * @returns The maximum amount in native units that can be withdrawn without closing the position
- *
- * @example
- * ```ts
- * // Position: 10 SOL capital, +2 SOL mark PnL, 0.5 SOL reserved
- * const max = computeMaxWithdrawable(
- *   10_000_000_000n,  // 10 SOL in lamports
- *   2_000_000_000n,   // +2 SOL in lamports
- *   500_000_000n      // 0.5 SOL reserved in lamports
- * );
- * // Returns: 11_500_000_000n (10 + (2 - 0.5) = 11.5 SOL in lamports)
- * ```
- */
-export declare function computeMaxWithdrawable(capital: bigint, pnl: bigint, reservedPnl: bigint): bigint;

package/dist/math/warmup.d.ts

@@ -53,53 +53,3 @@ export declare function computeWarmupLeverageCap(initialMarginBps: bigint, total
  * @returns Maximum position size in native units.
  */
 export declare function computeWarmupMaxPositionSize(initialMarginBps: bigint, totalCapital: bigint, currentSlot: bigint, warmupStartSlot: bigint, warmupPeriodSlots: bigint): bigint;
-/**
- * Warmup progress information for a position.
- */
-export interface WarmupProgress {
-    /** PnL available for withdrawal right now (not locked by warmup). */
-    maturedPnl: bigint;
-    /** PnL still locked until warmup completes. */
-    reservedPnl: bigint;
-    /** Progress toward full warmup as a basis point (0–10,000). */
-    progressBps: bigint;
-    /** Slots remaining until full warmup (0 if fully matured). */
-    slotsRemaining: bigint;
-}
-/**
- * Compute PnL warmup progress for a position.
- *
- * During the warmup period, a position's unrealized PnL is linearly released.
- * The portion available for withdrawal grows over time. This utility shows:
- * - How much PnL is currently available (matured)
- * - How much is still locked (reserved)
- * - Progress toward full maturation (as %)
- * - Slots remaining
- *
- * Users can display a progress bar or "unlocks in X slots" message to give
- * transparency into when their PnL becomes withdrawable.
- *
- * @param currentSlot        - Current on-chain slot (from engine state).
- * @param warmupStartedAtSlot - Slot when this position's warmup started.
- * @param warmupPeriodSlots  - Total warmup duration in slots (from market config).
- * @param pnl                - Total realized + unrealized PnL (from account).
- * @param reservedPnl        - PnL locked during warmup (from account).
- * @returns WarmupProgress with matured/reserved PnL, progress %, and slots remaining.
- *
- * @example
- * ```ts
- * const progress = computeWarmupProgress(
- *   10000n,      // current slot
- *   9000n,       // warmup started at slot 9000
- *   2000n,       // warmup period = 2000 slots
- *   1000000000n, // pnl = 1 SOL
- *   600000000n   // reserved = 0.6 SOL (60% still locked)
- * );
- * // Returns:
- * // maturedPnl: 400000000n    (0.4 SOL available)
- * // reservedPnl: 600000000n   (0.6 SOL locked)
- * // progressBps: 5000n        (50% complete)
- * // slotsRemaining: 1000n     (1000 slots until fully mature)
- * ```
- */
-export declare function computeWarmupProgress(currentSlot: bigint, warmupStartedAtSlot: bigint, warmupPeriodSlots: bigint, pnl: bigint, reservedPnl: bigint): WarmupProgress;

package/dist/runtime/lighthouse.d.ts

@@ -55,7 +55,7 @@ export declare const LIGHTHOUSE_CONSTRAINT_ADDRESS = 6400;
  * Known Lighthouse/Anchor error codes that may appear in transaction logs.
  * All are in the Anchor error range (0x1770–0x1900+).
  */
-export declare const LIGHTHOUSE_ERROR_CODES: Set<6000 | 6032 | 6036 | 6038 | 6400 | 6001 | 6002 | 6003 | 6016 | 6033 | 6034 | 6035 | 6037 | 6039 | 6040 | 6041 | 6042 | 6043>;
+export declare const LIGHTHOUSE_ERROR_CODES: Set<6400 | 6000 | 6001 | 6002 | 6003 | 6016 | 6032 | 6033 | 6034 | 6035 | 6036 | 6037 | 6038 | 6039 | 6040 | 6041 | 6042 | 6043>;
 /**
  * Check if a TransactionInstruction is from the Lighthouse program.
  *

package/dist/solana/discovery.d.ts

@@ -36,16 +36,11 @@ export interface DiscoveredMarket {
  *          in SLAB_TIERS_V0 for discovery of legacy on-chain accounts.
  */
 /**
- * Default slab tiers for the current mainnet program (v12.1).
+ * Default slab tiers for the current mainnet program (v12.17).
  * These are used by useCreateMarket to allocate slab accounts of the correct size.
+ * V12_17: two-bucket warmup, per-side funding, ACCOUNT_SIZE=352 (SBF).
  */
 export declare const SLAB_TIERS: {
-    readonly micro: {
-        maxAccounts: number;
-        dataSize: number;
-        label: string;
-        description: string;
-    };
     readonly small: {
         maxAccounts: number;
         dataSize: number;
@@ -166,12 +161,6 @@ export declare const SLAB_TIERS_V1D_LEGACY: {
 };
 /** @deprecated Alias — use SLAB_TIERS (already V1) */
 export declare const SLAB_TIERS_V1: {
-    readonly micro: {
-        maxAccounts: number;
-        dataSize: number;
-        label: string;
-        description: string;
-    };
     readonly small: {
         maxAccounts: number;
         dataSize: number;

package/dist/solana/oracle.d.ts

@@ -16,19 +16,11 @@ declare const CHAINLINK_MIN_SIZE = 224;
 declare const MAX_DECIMALS = 18;
 /** Offset of decimals field in Chainlink aggregator account */
 declare const CHAINLINK_DECIMALS_OFFSET = 138;
-/** Offset of updated_at timestamp (i64 LE, Unix seconds) in Chainlink aggregator */
-declare const CHAINLINK_TIMESTAMP_OFFSET = 168;
 /** Offset of latest answer in Chainlink aggregator account */
 declare const CHAINLINK_ANSWER_OFFSET = 216;
 export interface OraclePrice {
     price: bigint;
     decimals: number;
-    /** Unix timestamp (seconds) of the last oracle update, if available. */
-    updatedAt?: number;
-}
-export interface ParseChainlinkOptions {
-    /** Maximum allowed staleness in seconds. If the oracle update is older, an error is thrown. */
-    maxStalenessSeconds?: number;
 }
 /**
  * Parse price data from a Chainlink aggregator account buffer.
@@ -42,11 +34,11 @@ export interface ParseChainlinkOptions {
  * @returns Parsed oracle price with decimals
  * @throws if the buffer is invalid or contains unreasonable data
  */
-export declare function parseChainlinkPrice(data: Uint8Array, options?: ParseChainlinkOptions): OraclePrice;
+export declare function parseChainlinkPrice(data: Uint8Array): OraclePrice;
 /**
  * Validate that a buffer looks like a valid Chainlink aggregator account.
  * Returns true if the buffer passes all validation checks, false otherwise.
  * Use this for non-throwing validation.
  */
 export declare function isValidChainlinkOracle(data: Uint8Array): boolean;
-export { CHAINLINK_MIN_SIZE, CHAINLINK_DECIMALS_OFFSET, CHAINLINK_TIMESTAMP_OFFSET, CHAINLINK_ANSWER_OFFSET, MAX_DECIMALS };
+export { CHAINLINK_MIN_SIZE, CHAINLINK_DECIMALS_OFFSET, CHAINLINK_ANSWER_OFFSET, MAX_DECIMALS };

package/dist/solana/pda.d.ts

@@ -4,16 +4,17 @@ import { PublicKey } from "@solana/web3.js";
  * Seeds: ["vault", slab_key]
  */
 export declare function deriveVaultAuthority(programId: PublicKey, slab: PublicKey): [PublicKey, number];
+/**
+ * Derive insurance LP mint PDA (a.k.a. LP vault mint PDA).
+ * Seeds: ["lp_vault_mint", slab_key]
+ * Wrapper anchor: src/percolator.rs:2543 derive_lp_vault_mint.
+ */
+export declare function deriveInsuranceLpMint(programId: PublicKey, slab: PublicKey): [PublicKey, number];
 /**
  * Derive LP PDA for TradeCpi.
  * Seeds: ["lp", slab_key, lp_idx as u16 LE]
  */
 export declare function deriveLpPda(programId: PublicKey, slab: PublicKey, lpIdx: number): [PublicKey, number];
-/**
- * Derive keeper fund PDA.
- * Seeds: ["keeper_fund", slab_key]
- */
-export declare function deriveKeeperFund(programId: PublicKey, slab: PublicKey): [PublicKey, number];
 /** PumpSwap AMM program ID. */
 export declare const PUMPSWAP_PROGRAM_ID: PublicKey;
 /** Raydium CLMM (Concentrated Liquidity) program ID. */

package/dist/solana/slab.d.ts

@@ -1,4 +1,6 @@
 import { Connection, PublicKey } from "@solana/web3.js";
+/** Slab magic number ("PERCOLAT" as little-endian u64). */
+export declare const SLAB_MAGIC: bigint;
 /**
  * Full slab layout descriptor. Returned by detectSlabLayout().
  * All engine field offsets are relative to engineOff.
@@ -50,6 +52,7 @@ export interface SlabLayout {
     hasInsuranceIsolation: boolean;
     engineInsuranceIsolatedOff: number;
     engineInsuranceIsolationBpsOff: number;
+    configMarkEwmaOff?: number;
 }
 export declare const ENGINE_OFF = 600;
 export declare const ENGINE_MARK_PRICE_OFF = 400;
@@ -130,10 +133,35 @@ export declare const SLAB_TIERS_V12_1: Record<string, {
     label: string;
     description: string;
 }>;
+/**
+ * V12_15 slab tier sizes — percolator v12.15 (engine+prog sync).
+ * ENGINE_OFF=624, BITMAP_OFF=862 (relative), ACCOUNT_SIZE=4400, postBitmap=18.
+ * MAX_ACCOUNTS default changed from 4096 to 2048. Verified SLAB_LEN=1,128,448 for small (256).
+ * Account layout completely redesigned with reserve cohort arrays.
+ */
+export declare const SLAB_TIERS_V12_15: Record<string, {
+    maxAccounts: number;
+    dataSize: number;
+    label: string;
+    description: string;
+}>;
+/**
+ * V12_17 slab tier sizes — percolator v12.17 (two-bucket warmup, per-side funding).
+ * Uses SBF sizes (on-chain layout) for the dataSize values.
+ * ENGINE_OFF=504 (SBF), ACCOUNT_SIZE=352 (SBF), BITMAP_OFF=712 (SBF), postBitmap=4.
+ * RISK_BUF_LEN=160 appended after engine.
+ * Supported tiers: small(256), medium(1024), large(4096).
+ */
+export declare const SLAB_TIERS_V12_17: Record<string, {
+    maxAccounts: number;
+    dataSize: number;
+    label: string;
+    description: string;
+}>;
 /**
  * Detect the slab layout version from the raw account data length.
  * Returns the full SlabLayout descriptor, or null if the size is unrecognised.
- * Checks V12_1, V_SETDEXPOOL, V1M2, V_ADL, V1M, V0, V1D, V1D-legacy, V1, and V1-legacy sizes.
+ * Checks V12_15, V12_1_EP, V12_1, V_SETDEXPOOL, V1M2, V_ADL, V1M, V0, V1D, V1D-legacy, V1, and V1-legacy sizes.
  *
  * When `data` is provided and the size matches V1D, the version field at offset 8 is read
  * to disambiguate V2 slabs (which produce identical sizes to V1D with postBitmap=2).
@@ -181,6 +209,10 @@ export interface MarketConfig {
     fundingInvScaleNotionalE6: bigint;
     fundingMaxPremiumBps: bigint;
     fundingMaxBpsPerSlot: bigint;
+    /** @deprecated Removed in V12_1 — always 0 */ fundingPremiumWeightBps: bigint;
+    /** @deprecated Removed in V12_1 — always 0 */ fundingSettlementIntervalSlots: bigint;
+    /** @deprecated Removed in V12_1 — always 0 */ fundingPremiumDampeningE6: bigint;
+    /** @deprecated Removed in V12_1 — always 0 */ fundingPremiumMaxBpsPerSlot: bigint;
     threshFloor: bigint;
     threshRiskBps: bigint;
     threshUpdateIntervalSlots: bigint;
@@ -225,6 +257,10 @@ export interface InsuranceFund {
     isolationBps: number;
 }
 export interface RiskParams {
+    /**
+     * @deprecated Split into hMin/hMax in v12.15 RiskParams. On V12_15 slabs this field returns
+     * hMin for backwards compatibility. On pre-v12.15 slabs hMin/hMax both mirror this value.
+     */
     warmupPeriodSlots: bigint;
     maintenanceMarginBps: bigint;
     initialMarginBps: bigint;
@@ -238,6 +274,18 @@ export interface RiskParams {
     liquidationFeeCap: bigint;
     liquidationBufferBps: bigint;
     minLiquidationAbs: bigint;
+    /** Minimum initial deposit to open an account (V12_1+ only) */
+    minInitialDeposit: bigint;
+    /** Minimum nonzero maintenance margin requirement (V12_1+ only) */
+    minNonzeroMmReq: bigint;
+    /** Minimum nonzero initial margin requirement (V12_1+ only) */
+    minNonzeroImReq: bigint;
+    /** Insurance fund floor (V12_1+ only) */
+    insuranceFloor: bigint;
+    /** Minimum horizon slots (v12.15+). Replaces warmupPeriodSlots. 0n on pre-v12.15 slabs. */
+    hMin: bigint;
+    /** Maximum horizon slots (v12.15+). 0n on pre-v12.15 slabs. */
+    hMax: bigint;
 }
 export interface EngineState {
     vault: bigint;
@@ -245,7 +293,20 @@ export interface EngineState {
     currentSlot: bigint;
     fundingIndexQpbE6: bigint;
     lastFundingSlot: bigint;
+    /**
+     * Funding rate per slot. On pre-v12.15 slabs: i64 in BPS units.
+     * On v12.15+ slabs: i128 in e9 units (field renamed `funding_rate_e9` on-chain).
+     */
     fundingRateBpsPerSlotLast: bigint;
+    /**
+     * Funding rate in e9 units (i128). v12.15+ only.
+     * 0n on pre-v12.15 slabs.
+     */
+    fundingRateE9: bigint;
+    /**
+     * Market mode. v12.15+ only. 0 = Live, 1 = Resolved. null on pre-v12.15 slabs.
+     */
+    marketMode: 0 | 1 | null;
     lastCrankSlot: bigint;
     maxCrankStalenessSlots: bigint;
     totalOpenInterest: bigint;
@@ -253,6 +314,10 @@ export interface EngineState {
     shortOi: bigint;
     cTot: bigint;
     pnlPosTot: bigint;
+    /**
+     * Matured (settled) positive PnL total (u128). v12.15+ only. 0n on pre-v12.15 slabs.
+     */
+    pnlMaturedPosTot: bigint;
     liqCursor: number;
     gcCursor: number;
     lastSweepStartSlot: bigint;
@@ -271,27 +336,94 @@ export interface EngineState {
     numUsedAccounts: number;
     nextAccountId: bigint;
     markPriceE6: bigint;
+    /** last_oracle_price (u64, e6). V12_15+ only. 0n on pre-v12.15. */
+    oraclePriceE6: bigint;
+    /** Cumulative funding numerator for long side (i128). 0n on pre-v12.17. */
+    fLongNum: bigint;
+    /** Cumulative funding numerator for short side (i128). 0n on pre-v12.17. */
+    fShortNum: bigint;
+    /** Count of accounts with negative PnL. 0n on pre-v12.17. */
+    negPnlAccountCount: bigint;
+    /** Last funding-sample price (u64 e6). 0n on pre-v12.17. */
+    fundPxLast: bigint;
+    /** Matured positive PnL total (u128). v12.15+ only. 0n on pre-v12.15 slabs. */
+    resolvedKLongTerminalDelta: bigint;
+    /** Terminal K delta for short side (i128). 0n on pre-v12.17. */
+    resolvedKShortTerminalDelta: bigint;
+    /** Live oracle price used during resolution (u64 e6). 0n on pre-v12.17. */
+    resolvedLivePrice: bigint;
 }
 export declare enum AccountKind {
     User = 0,
     LP = 1
 }
+/** Parsed reserve cohort (64 bytes on-chain). Raw bytes; structure is program-internal. */
+export type ReserveCohortBytes = Uint8Array;
 export interface Account {
     kind: AccountKind;
     accountId: bigint;
     capital: bigint;
     pnl: bigint;
     reservedPnl: bigint;
+    /** @deprecated Removed in v12.15. Always 0n on V12_15 slabs. */
     warmupStartedAtSlot: bigint;
+    /** @deprecated Removed in v12.15. Always 0n on V12_15 slabs. */
     warmupSlopePerStep: bigint;
     positionSize: bigint;
+    /** Entry price in e6 units. Present in V12_15 (offset 120) and V_ADL/V12_1_EP. -1 signals absent. */
     entryPrice: bigint;
     fundingIndex: bigint;
     matcherProgram: PublicKey;
     matcherContext: PublicKey;
     owner: PublicKey;
     feeCredits: bigint;
+    /** @deprecated Removed in v12.15. Always 0n on V12_15 slabs. */
     lastFeeSlot: bigint;
+    /** Total fees earned over account lifetime (u128). Present from v12.15. 0n on older layouts. */
+    feesEarnedTotal: bigint;
+    /**
+     * Reserve cohorts array (v12.15+). Up to 62 cohorts of 64 bytes each.
+     * `null` on pre-v12.15 slabs. Parse the raw bytes according to the on-chain ReserveCohort struct.
+     */
+    exactReserveCohorts: ReserveCohortBytes[] | null;
+    /** Number of active reserve cohorts (0-62). null on pre-v12.15 slabs. */
+    exactCohortCount: number | null;
+    /** Overflow (oldest) cohort raw bytes. null on pre-v12.15 slabs or when not present. */
+    overflowOlder: ReserveCohortBytes | null;
+    /** True if overflowOlder contains valid data. null on pre-v12.15 slabs. */
+    overflowOlderPresent: boolean | null;
+    /** Overflow (newest) cohort raw bytes. null on pre-v12.15 slabs or when not present. */
+    overflowNewest: ReserveCohortBytes | null;
+    /** True if overflowNewest contains valid data. null on pre-v12.15 slabs. */
+    overflowNewestPresent: boolean | null;
+    /** Per-account cumulative funding snapshot (i128). 0n on pre-v12.17 slabs. */
+    fSnap: bigint;
+    /** ADL A-basis snapshot (u128). 0n on pre-v12.17 slabs. */
+    adlABasis: bigint;
+    /** ADL K-coefficient snapshot (i128). 0n on pre-v12.17 slabs. */
+    adlKSnap: bigint;
+    /** ADL epoch snapshot (u64). 0n on pre-v12.17 slabs. */
+    adlEpochSnap: bigint;
+    /** True if the scheduled warmup bucket is active. null on pre-v12.17. */
+    schedPresent: boolean | null;
+    /** Remaining unreleased quantity in scheduled bucket. null on pre-v12.17. */
+    schedRemainingQ: bigint | null;
+    /** Anchor quantity for scheduled bucket. null on pre-v12.17. */
+    schedAnchorQ: bigint | null;
+    /** Start slot for scheduled bucket. null on pre-v12.17. */
+    schedStartSlot: bigint | null;
+    /** Warmup horizon for scheduled bucket. null on pre-v12.17. */
+    schedHorizon: bigint | null;
+    /** Release quantity for scheduled bucket. null on pre-v12.17. */
+    schedReleaseQ: bigint | null;
+    /** True if the pending warmup bucket is active. null on pre-v12.17. */
+    pendingPresent: boolean | null;
+    /** Remaining unreleased quantity in pending bucket. null on pre-v12.17. */
+    pendingRemainingQ: bigint | null;
+    /** Warmup horizon for pending bucket. null on pre-v12.17. */
+    pendingHorizon: bigint | null;
+    /** Creation slot for pending bucket. null on pre-v12.17. */
+    pendingCreatedSlot: bigint | null;
 }
 export declare function fetchSlab(connection: Connection, slabPubkey: PublicKey): Promise<Uint8Array>;
 export declare const RAMP_START_BPS = 1000n;
@@ -303,14 +435,6 @@ export declare function readLastThrUpdateSlot(data: Uint8Array): bigint;
  * Parse slab header (first 72 bytes — layout-independent).
  */
 export declare function parseHeader(data: Uint8Array): SlabHeader;
-/**
- * Parse market config. Layout-version aware.
- * For V0 slabs, fields beyond the basic config are read if present in the data,
- * otherwise defaults are returned.
- *
- * @param data - Slab data (may be a partial slice for discovery; pass layoutHint in that case)
- * @param layoutHint - Pre-detected layout to use; if omitted, detected from data.length.
- */
 export declare function parseConfig(data: Uint8Array, layoutHint?: SlabLayout | null): MarketConfig;
 /**
  * Parse RiskParams from engine data. Layout-version aware.

package/dist/solana/stake.d.ts

@@ -4,10 +4,10 @@
  *
  * Program: percolator-stake (dcccrypto/percolator-stake)
  * Deployed devnet:  6aJb1F9CDCVWCNYFwj8aQsVb696YnW6J1FznteHq4Q6k
- * Deployed mainnet: (pending deployment — DevOps must set STAKE_PROGRAM_ID env var or deploy and update STAKE_PROGRAM_IDS.mainnet)
+ * Deployed mainnet: DC5fovFQD5SZYsetwvEqd4Wi4PFY1Yfnc669VMe6oa7F
  */
 import { PublicKey } from '@solana/web3.js';
-/** Known stake program addresses per network. */
+/** Known stake program addresses per network. Mainnet is empty until deployed. */
 export declare const STAKE_PROGRAM_IDS: {
     readonly devnet: "6aJb1F9CDCVWCNYFwj8aQsVb696YnW6J1FznteHq4Q6k";
     readonly mainnet: "DC5fovFQD5SZYsetwvEqd4Wi4PFY1Yfnc669VMe6oa7F";
@@ -38,12 +38,21 @@ export declare const STAKE_IX: {
     readonly Withdraw: 2;
     readonly FlushToInsurance: 3;
     readonly UpdateConfig: 4;
+    /** @deprecated Removed on-chain in stake v3. This tag now rejects. */
     readonly TransferAdmin: 5;
+    /** @deprecated Removed on-chain in stake v3. This tag now rejects. */
     readonly AdminSetOracleAuthority: 6;
+    /** @deprecated Removed on-chain in stake v3. This tag now rejects. */
     readonly AdminSetRiskThreshold: 7;
+    /** @deprecated Removed on-chain in stake v3. This tag now rejects. */
     readonly AdminSetMaintenanceFee: 8;
+    /** @deprecated Removed on-chain in stake v3. This tag now rejects. */
     readonly AdminResolveMarket: 9;
+    /** Current on-chain tag 10: transfer withdrawn insurance back into the pool vault. */
+    readonly ReturnInsurance: 10;
+    /** @deprecated Legacy alias for ReturnInsurance. */
     readonly AdminWithdrawInsurance: 10;
+    /** @deprecated Removed on-chain in stake v3. This tag now rejects. */
     readonly AdminSetInsurancePolicy: 11;
     /** PERC-272: Accrue trading fees to LP vault */
     readonly AccrueFees: 12;
@@ -55,6 +64,8 @@ export declare const STAKE_IX: {
     readonly AdminSetTrancheConfig: 15;
     /** PERC-303: Deposit into junior (first-loss) tranche */
     readonly DepositJunior: 16;
+    /** Mark the pool as resolved after the wrapper market has been resolved directly. */
+    readonly SetMarketResolved: 18;
 };
 /** Derive the stake pool PDA for a given slab (market). */
 export declare function deriveStakePool(slab: PublicKey, programId?: PublicKey): [PublicKey, number];
@@ -72,17 +83,19 @@ export declare function encodeStakeWithdraw(lpAmount: bigint | number): Uint8Arr
 export declare function encodeStakeFlushToInsurance(amount: bigint | number): Uint8Array;
 /** Tag 4: UpdateConfig — update cooldown and/or deposit cap. */
 export declare function encodeStakeUpdateConfig(newCooldownSlots?: bigint | number, newDepositCap?: bigint | number): Uint8Array;
-/** Tag 5: TransferAdmin — transfer wrapper admin to pool PDA. */
+/** @deprecated Removed on-chain in stake v3. Throws instead of emitting a dead instruction. */
 export declare function encodeStakeTransferAdmin(): Uint8Array;
-/** Tag 6: AdminSetOracleAuthority — forward to wrapper via CPI. */
+/** @deprecated Removed on-chain in stake v3. Throws instead of emitting a dead instruction. */
 export declare function encodeStakeAdminSetOracleAuthority(newAuthority: PublicKey): Uint8Array;
-/** Tag 7: AdminSetRiskThreshold — forward to wrapper via CPI. */
+/** @deprecated Removed on-chain in stake v3. Throws instead of emitting a dead instruction. */
 export declare function encodeStakeAdminSetRiskThreshold(newThreshold: bigint | number): Uint8Array;
-/** Tag 8: AdminSetMaintenanceFee — forward to wrapper via CPI. */
+/** @deprecated Removed on-chain in stake v3. Throws instead of emitting a dead instruction. */
 export declare function encodeStakeAdminSetMaintenanceFee(newFee: bigint | number): Uint8Array;
-/** Tag 9: AdminResolveMarket — forward to wrapper via CPI. */
+/** @deprecated Removed on-chain in stake v3. Throws instead of emitting a dead instruction. */
 export declare function encodeStakeAdminResolveMarket(): Uint8Array;
-/** Tag 10: AdminWithdrawInsurance — withdraw insurance after market resolution. */
+/** Tag 10: ReturnInsurance — transfer withdrawn insurance back into the stake pool vault. */
+export declare function encodeStakeReturnInsurance(amount: bigint | number): Uint8Array;
+/** @deprecated Legacy alias for tag 10. Current on-chain semantics are ReturnInsurance. */
 export declare function encodeStakeAdminWithdrawInsurance(amount: bigint | number): Uint8Array;
 /** Tag 12: AccrueFees — permissionless: accrue trading fees to LP vault. */
 export declare function encodeStakeAccrueFees(): Uint8Array;
@@ -94,7 +107,9 @@ export declare function encodeStakeAdminSetHwmConfig(enabled: boolean, hwmFloorB
 export declare function encodeStakeAdminSetTrancheConfig(juniorFeeMultBps: number): Uint8Array;
 /** Tag 16 (PERC-303): DepositJunior — deposit into first-loss junior tranche. */
 export declare function encodeStakeDepositJunior(amount: bigint | number): Uint8Array;
-/** Tag 11: AdminSetInsurancePolicy — set withdrawal policy on wrapper. */
+/** Tag 18: SetMarketResolved — blocks new deposits after the wrapper market is resolved. */
+export declare function encodeStakeSetMarketResolved(): Uint8Array;
+/** @deprecated Removed on-chain in stake v3. Throws instead of emitting a dead instruction. */
 export declare function encodeStakeAdminSetInsurancePolicy(authority: PublicKey, minWithdrawBase: bigint | number, maxWithdrawBps: number, cooldownSlots: bigint | number): Uint8Array;
 /**
  * Decoded StakePool state (352 bytes on-chain).
@@ -105,6 +120,7 @@ export interface StakePoolState {
     bump: number;
     vaultAuthorityBump: number;
     adminTransferred: boolean;
+    marketResolved: boolean;
     slab: PublicKey;
     admin: PublicKey;
     collateralMint: PublicKey;
@@ -125,6 +141,7 @@ export interface StakePoolState {
     hwmEnabled: boolean;
     epochHighWaterTvl: bigint;
     hwmFloorBps: number;
+    hwmLastEpoch: bigint;
     trancheEnabled: boolean;
     juniorBalance: bigint;
     juniorTotalLp: bigint;
@@ -136,6 +153,31 @@ export declare const STAKE_POOL_SIZE = 352;
  * Decode a StakePool account from raw data buffer. * Uses DataView for all u64/u16 reads — browser-safe.
  */
 export declare function decodeStakePool(data: Uint8Array): StakePoolState;
+/** Size of StakeDeposit on-chain (bytes). */
+export declare const STAKE_DEPOSIT_SIZE = 152;
+/** Decoded StakeDeposit PDA state. */
+export interface StakeDepositState {
+    isInitialized: boolean;
+    bump: number;
+    pool: PublicKey;
+    user: PublicKey;
+    lastDepositSlot: bigint;
+    lpAmount: bigint;
+}
+/**
+ * Decode a StakeDeposit PDA account from raw data.
+ *
+ * On-chain layout (152 bytes, percolator-stake/src/state.rs):
+ *   [0]       is_initialized  u8
+ *   [1]       bump            u8
+ *   [2..8]    _padding
+ *   [8..40]   pool            [u8; 32]
+ *   [40..72]  user            [u8; 32]
+ *   [72..80]  last_deposit_slot u64
+ *   [80..88]  lp_amount       u64
+ *   [88..152] _reserved
+ */
+export declare function decodeDepositPda(data: Uint8Array): StakeDepositState;
 export interface StakeAccounts {
     /** InitPool accounts */
     initPool: {