@percolatorct/sdk 2.0.0 → 2.0.2

package/README.md

@@ -2,7 +2,7 @@
 
 TypeScript SDK for building clients, bots, and UIs on top of the [Percolator](https://github.com/dcccrypto/percolator) perpetual futures protocol on Solana.
 
-> **EXPERIMENTAL. NOT AUDITED.** `2.0.0`. v12.19 single-target. 792 tests passing. Do NOT use with real funds.
+> **EXPERIMENTAL. NOT AUDITED.** `2.0.2`. v12.19 single-target. 792 tests passing. Do NOT use with real funds.
 
 ## Target wrapper
 

package/dist/index.js

@@ -2308,25 +2308,72 @@ for (const n of V12_17_TIERS) {
   const sbfSize = V12_17_ENGINE_OFF_SBF + accountsOffSbf + n * V12_17_ACCOUNT_SIZE_SBF + V12_17_RISK_BUF_LEN + n * V12_17_GEN_TABLE_ENTRY;
   V12_17_SIZES.set(sbfSize, n);
 }
-var V12_19_CONFIG_LEN = 528;
-var V12_19_ENGINE_OFF_SBF = 600;
+var V12_19_HEADER_LEN_SBF = 136;
+var V12_19_CONFIG_LEN = 480;
+var V12_19_ENGINE_OFF_SBF = 616;
+var V12_19_ACCOUNT_SIZE_SBF = 360;
+var V12_19_SBF_ENGINE_BITMAP_OFF = 712;
+var V12_19_SBF_ENGINE_CURRENT_SLOT_OFF = 200;
+var V12_19_SBF_ENGINE_MARKET_MODE_OFF = 208;
+var V12_19_SBF_ENGINE_RESOLVED_LIVE_PRICE_OFF = 304;
+var V12_19_SBF_ENGINE_C_TOT_OFF = 312;
+var V12_19_SBF_ENGINE_PNL_POS_TOT_OFF = 328;
+var V12_19_SBF_ENGINE_PNL_MATURED_POS_TOT_OFF = 344;
+var V12_19_SBF_ENGINE_OI_EFF_LONG_OFF = 472;
+var V12_19_SBF_ENGINE_OI_EFF_SHORT_OFF = 488;
+var V12_19_SBF_ENGINE_NEG_PNL_COUNT_OFF = 584;
+var V12_19_SBF_ENGINE_RR_CURSOR_OFF = 592;
+var V12_19_SBF_ENGINE_LAST_ORACLE_PRICE_OFF = 624;
+var V12_19_SBF_ENGINE_FUND_PX_LAST_OFF = 632;
+var V12_19_SBF_ENGINE_LAST_MARKET_SLOT_OFF = 640;
+var V12_19_SBF_ENGINE_F_LONG_NUM_OFF = 648;
+var V12_19_SBF_ENGINE_F_SHORT_NUM_OFF = 664;
 var V12_19_SIZES = /* @__PURE__ */ new Map([
-  [19640, 64],
-  // --features micro
-  [94168, 256],
-  // --features small (deployed mainnet ESa89R5...)
-  [372280, 1024],
-  // --features medium
-  [1484728, 4096]
-  // default features (large)
+  [26848, 64],
+  // --features micro (derived)
+  [96760, 256],
+  // --features small (probe-confirmed; deployed mainnet ESa89R5...)
+  [376408, 1024],
+  // --features medium (derived)
+  [1495e3, 4096]
+  // default features / large (derived)
 ]);
-function buildLayoutV12_19(maxAccounts, dataLen) {
-  const base = buildLayoutV12_17(maxAccounts, dataLen);
+function buildLayoutV12_19(maxAccounts, _dataLen) {
+  const bitmapWords = Math.ceil(maxAccounts / 64);
+  const bitmapBytes = bitmapWords * 8;
+  const numUsedOff = V12_19_SBF_ENGINE_BITMAP_OFF + bitmapBytes;
+  const freeHeadOff = numUsedOff + 2;
+  const nextFreeOff = freeHeadOff + 2;
+  const prevFreeOff = nextFreeOff + maxAccounts * 2;
+  const accountsRelEnd = prevFreeOff + maxAccounts * 2;
+  const accountsOffRel = Math.ceil(accountsRelEnd / 8) * 8;
+  const accountsOff = V12_19_ENGINE_OFF_SBF + accountsOffRel;
+  const base = buildLayoutV12_17(
+    maxAccounts,
+    /* synthetic V12_17 SBF size */
+    94168
+  );
   return {
     ...base,
+    headerLen: V12_19_HEADER_LEN_SBF,
     configLen: V12_19_CONFIG_LEN,
+    configOffset: V12_19_HEADER_LEN_SBF,
+    // header runs 0..136 in v12.19
     engineOff: V12_19_ENGINE_OFF_SBF,
-    accountsOff: V12_19_ENGINE_OFF_SBF + (base.accountsOff - base.engineOff)
+    accountSize: V12_19_ACCOUNT_SIZE_SBF,
+    accountsOff,
+    bitmapWords,
+    engineBitmapOff: V12_19_SBF_ENGINE_BITMAP_OFF,
+    // V12_19-specific engine field offsets (probe-confirmed):
+    engineCurrentSlotOff: V12_19_SBF_ENGINE_CURRENT_SLOT_OFF,
+    engineCTotOff: V12_19_SBF_ENGINE_C_TOT_OFF,
+    enginePnlPosTotOff: V12_19_SBF_ENGINE_PNL_POS_TOT_OFF,
+    engineLongOiOff: V12_19_SBF_ENGINE_OI_EFF_LONG_OFF,
+    engineShortOiOff: V12_19_SBF_ENGINE_OI_EFF_SHORT_OFF,
+    // last_market_slot replaces V12_17 last_crank_slot semantics.
+    engineLastCrankSlotOff: V12_19_SBF_ENGINE_LAST_MARKET_SLOT_OFF,
+    // rr_cursor_position replaces V12_17 gc_cursor semantics.
+    engineGcCursorOff: V12_19_SBF_ENGINE_RR_CURSOR_OFF
   };
 }
 var V12_1_SBF_ACCOUNT_SIZE = 280;
@@ -3674,25 +3721,26 @@ function parseEngine(data) {
   const base = layout.engineOff;
   const isV12_17 = layout.accountSize === V12_17_ACCOUNT_SIZE || layout.accountSize === V12_17_ACCOUNT_SIZE_SBF;
   const isV12_15 = !isV12_17 && (layout.accountSize === V12_15_ACCOUNT_SIZE || layout.accountSize === V12_15_ACCOUNT_SIZE_SMALL) && (layout.engineOff === V12_15_ENGINE_OFF || layout.engineOff === V12_15_ENGINE_OFF_SBF);
-  if (isV12_17) {
-    const isSbf = layout.engineOff === V12_17_ENGINE_OFF_SBF || layout.engineOff === V12_19_ENGINE_OFF_SBF;
-    const currentSlotOff = isSbf ? V12_17_SBF_ENGINE_CURRENT_SLOT_OFF : V12_17_ENGINE_CURRENT_SLOT_OFF;
-    const marketModeOff = isSbf ? V12_17_SBF_ENGINE_MARKET_MODE_OFF : V12_17_ENGINE_MARKET_MODE_OFF;
-    const cTotOff = isSbf ? V12_17_SBF_ENGINE_C_TOT_OFF : V12_17_ENGINE_C_TOT_OFF;
-    const pnlPosTotOff = isSbf ? V12_17_SBF_ENGINE_PNL_POS_TOT_OFF : V12_17_ENGINE_PNL_POS_TOT_OFF;
-    const pnlMaturedOff = isSbf ? V12_17_SBF_ENGINE_PNL_MATURED_POS_TOT_OFF : V12_17_ENGINE_PNL_MATURED_POS_TOT_OFF;
-    const negPnlOff = isSbf ? V12_17_SBF_ENGINE_NEG_PNL_COUNT_OFF : V12_17_ENGINE_NEG_PNL_COUNT_OFF;
-    const oraclePriceOff = isSbf ? V12_17_SBF_ENGINE_LAST_ORACLE_PRICE_OFF : V12_17_ENGINE_LAST_ORACLE_PRICE_OFF;
-    const fundPxLastOff = isSbf ? V12_17_SBF_ENGINE_FUND_PX_LAST_OFF : V12_17_ENGINE_FUND_PX_LAST_OFF;
-    const fLongNumOff = isSbf ? V12_17_SBF_ENGINE_F_LONG_NUM_OFF : V12_17_ENGINE_F_LONG_NUM_OFF;
-    const fShortNumOff = isSbf ? V12_17_SBF_ENGINE_F_SHORT_NUM_OFF : V12_17_ENGINE_F_SHORT_NUM_OFF;
-    const resolvedKLongOff = isSbf ? 288 : V12_17_ENGINE_RESOLVED_K_LONG_OFF;
-    const resolvedKShortOff = isSbf ? 304 : V12_17_ENGINE_RESOLVED_K_SHORT_OFF;
-    const resolvedLivePriceOff = isSbf ? 320 : V12_17_ENGINE_RESOLVED_LIVE_PRICE_OFF;
-    const lastCrankSlotOff = isSbf ? V12_17_SBF_ENGINE_LAST_CRANK_SLOT_OFF : V12_17_ENGINE_LAST_CRANK_SLOT_OFF;
-    const gcCursorOff = isSbf ? V12_17_SBF_ENGINE_GC_CURSOR_OFF : V12_17_ENGINE_GC_CURSOR_OFF;
-    const oiEffLongOff = isSbf ? V12_17_SBF_ENGINE_OI_EFF_LONG_OFF : V12_17_ENGINE_OI_EFF_LONG_OFF;
-    const oiEffShortOff = isSbf ? V12_17_SBF_ENGINE_OI_EFF_SHORT_OFF : V12_17_ENGINE_OI_EFF_SHORT_OFF;
+  const isV12_19 = layout.accountSize === V12_19_ACCOUNT_SIZE_SBF;
+  if (isV12_17 || isV12_19) {
+    const isSbf = layout.engineOff === V12_17_ENGINE_OFF_SBF || isV12_19;
+    const currentSlotOff = isV12_19 ? V12_19_SBF_ENGINE_CURRENT_SLOT_OFF : isSbf ? V12_17_SBF_ENGINE_CURRENT_SLOT_OFF : V12_17_ENGINE_CURRENT_SLOT_OFF;
+    const marketModeOff = isV12_19 ? V12_19_SBF_ENGINE_MARKET_MODE_OFF : isSbf ? V12_17_SBF_ENGINE_MARKET_MODE_OFF : V12_17_ENGINE_MARKET_MODE_OFF;
+    const cTotOff = isV12_19 ? V12_19_SBF_ENGINE_C_TOT_OFF : isSbf ? V12_17_SBF_ENGINE_C_TOT_OFF : V12_17_ENGINE_C_TOT_OFF;
+    const pnlPosTotOff = isV12_19 ? V12_19_SBF_ENGINE_PNL_POS_TOT_OFF : isSbf ? V12_17_SBF_ENGINE_PNL_POS_TOT_OFF : V12_17_ENGINE_PNL_POS_TOT_OFF;
+    const pnlMaturedOff = isV12_19 ? V12_19_SBF_ENGINE_PNL_MATURED_POS_TOT_OFF : isSbf ? V12_17_SBF_ENGINE_PNL_MATURED_POS_TOT_OFF : V12_17_ENGINE_PNL_MATURED_POS_TOT_OFF;
+    const negPnlOff = isV12_19 ? V12_19_SBF_ENGINE_NEG_PNL_COUNT_OFF : isSbf ? V12_17_SBF_ENGINE_NEG_PNL_COUNT_OFF : V12_17_ENGINE_NEG_PNL_COUNT_OFF;
+    const oraclePriceOff = isV12_19 ? V12_19_SBF_ENGINE_LAST_ORACLE_PRICE_OFF : isSbf ? V12_17_SBF_ENGINE_LAST_ORACLE_PRICE_OFF : V12_17_ENGINE_LAST_ORACLE_PRICE_OFF;
+    const fundPxLastOff = isV12_19 ? V12_19_SBF_ENGINE_FUND_PX_LAST_OFF : isSbf ? V12_17_SBF_ENGINE_FUND_PX_LAST_OFF : V12_17_ENGINE_FUND_PX_LAST_OFF;
+    const fLongNumOff = isV12_19 ? V12_19_SBF_ENGINE_F_LONG_NUM_OFF : isSbf ? V12_17_SBF_ENGINE_F_LONG_NUM_OFF : V12_17_ENGINE_F_LONG_NUM_OFF;
+    const fShortNumOff = isV12_19 ? V12_19_SBF_ENGINE_F_SHORT_NUM_OFF : isSbf ? V12_17_SBF_ENGINE_F_SHORT_NUM_OFF : V12_17_ENGINE_F_SHORT_NUM_OFF;
+    const resolvedKLongOff = isV12_19 ? 288 : isSbf ? 288 : V12_17_ENGINE_RESOLVED_K_LONG_OFF;
+    const resolvedKShortOff = isV12_19 ? 304 : isSbf ? 304 : V12_17_ENGINE_RESOLVED_K_SHORT_OFF;
+    const resolvedLivePriceOff = isV12_19 ? V12_19_SBF_ENGINE_RESOLVED_LIVE_PRICE_OFF : isSbf ? 320 : V12_17_ENGINE_RESOLVED_LIVE_PRICE_OFF;
+    const lastCrankSlotOff = isV12_19 ? V12_19_SBF_ENGINE_LAST_MARKET_SLOT_OFF : isSbf ? V12_17_SBF_ENGINE_LAST_CRANK_SLOT_OFF : V12_17_ENGINE_LAST_CRANK_SLOT_OFF;
+    const gcCursorOff = isV12_19 ? V12_19_SBF_ENGINE_RR_CURSOR_OFF : isSbf ? V12_17_SBF_ENGINE_GC_CURSOR_OFF : V12_17_ENGINE_GC_CURSOR_OFF;
+    const oiEffLongOff = isV12_19 ? V12_19_SBF_ENGINE_OI_EFF_LONG_OFF : isSbf ? V12_17_SBF_ENGINE_OI_EFF_LONG_OFF : V12_17_ENGINE_OI_EFF_LONG_OFF;
+    const oiEffShortOff = isV12_19 ? V12_19_SBF_ENGINE_OI_EFF_SHORT_OFF : isSbf ? V12_17_SBF_ENGINE_OI_EFF_SHORT_OFF : V12_17_ENGINE_OI_EFF_SHORT_OFF;
     const longOi = readU128LE(data, base + oiEffLongOff);
     const shortOi = readU128LE(data, base + oiEffShortOff);
     const bitmapEnd = layout.engineBitmapOff + layout.bitmapWords * 8;