@percolatorct/sdk 1.0.0-beta.2 → 1.0.0-beta.20

package/dist/solana/pda.d.ts

@@ -4,21 +4,11 @@ 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.
- * Seeds: ["ins_lp", slab_key]
- */
-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

@@ -130,10 +130,22 @@ 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;
+}>;
 /**
  * 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, 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,10 +193,10 @@ export interface MarketConfig {
     fundingInvScaleNotionalE6: bigint;
     fundingMaxPremiumBps: bigint;
     fundingMaxBpsPerSlot: bigint;
-    fundingPremiumWeightBps: bigint;
-    fundingSettlementIntervalSlots: bigint;
-    fundingPremiumDampeningE6: bigint;
-    fundingPremiumMaxBpsPerSlot: 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;
@@ -229,6 +241,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;
@@ -242,6 +258,10 @@ export interface RiskParams {
     liquidationFeeCap: bigint;
     liquidationBufferBps: bigint;
     minLiquidationAbs: 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;
@@ -249,7 +269,22 @@ 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).
+     * Use `fundingRateE9` for v12.15-aware code.
+     */
     fundingRateBpsPerSlotLast: bigint;
+    /**
+     * Funding rate in e9 units (i128). v12.15+ only.
+     * 0n on pre-v12.15 slabs (use `fundingRateBpsPerSlotLast` instead).
+     */
+    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;
@@ -257,6 +292,11 @@ 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;
@@ -280,22 +320,45 @@ 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;
 }
 export declare function fetchSlab(connection: Connection, slabPubkey: PublicKey): Promise<Uint8Array>;
 export declare const RAMP_START_BPS = 1000n;

package/dist/solana/stake.d.ts

@@ -7,10 +7,10 @@
  * Deployed mainnet: (pending deployment — DevOps must set STAKE_PROGRAM_ID env var or deploy and update STAKE_PROGRAM_IDS.mainnet)
  */
 import { PublicKey } from '@solana/web3.js';
-/** Known stake program addresses per network. Mainnet is empty until deployed. */
+/** Known stake program addresses per network. */
 export declare const STAKE_PROGRAM_IDS: {
     readonly devnet: "6aJb1F9CDCVWCNYFwj8aQsVb696YnW6J1FznteHq4Q6k";
-    readonly mainnet: "";
+    readonly mainnet: "DC5fovFQD5SZYsetwvEqd4Wi4PFY1Yfnc669VMe6oa7F";
 };
 /**
  * Resolve the stake program ID for the given network.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@percolatorct/sdk",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.20",
   "license": "Apache-2.0",
   "type": "module",
   "engines": {
@@ -31,6 +31,7 @@
   },
   "devDependencies": {
     "@types/node": "^20.17.10",
+    "dotenv": "^17.4.1",
     "tsup": "^8.3.5",
     "tsx": "^4.21.0",
     "typescript": "^5.7.2",