@percolatorct/sdk 1.0.0-beta.33 → 1.0.0-beta.35

package/dist/abi/instructions.d.ts

@@ -727,10 +727,30 @@ export interface VammMatcherParams {
     impactKBps: number;
     liquidityNotionalE6: bigint;
 }
-/** Magic bytes identifying a vAMM matcher context: "PERCMATC" as u64 LE */
+/** Magic bytes identifying a vAMM matcher context: "PERCMATC" as u64 LE = 0x504552434d415443 */
 export declare const VAMM_MAGIC = 5784119745439683651n;
-/** Offset into matcher context where vAMM params start */
+/** Alias matching the Rust constant name for parity tests */
+export declare const MATCHER_MAGIC = 5784119745439683651n;
+/** Offset where matcher return is written in the context account (always 0 per ABI) */
+export declare const CTX_RETURN_OFFSET = 0;
+/** Byte length of the MatcherReturn section of the context account */
+export declare const MATCHER_RETURN_LEN = 64;
+/** Offset into matcher context where vAMM params start (= MATCHER_RETURN_LEN) */
 export declare const CTX_VAMM_OFFSET = 64;
+/** Byte length of the MatcherCtx (vAMM state) section of the context account */
+export declare const CTX_VAMM_LEN = 256;
+/** Total matcher context account size: MATCHER_RETURN_LEN + CTX_VAMM_LEN */
+export declare const MATCHER_CONTEXT_LEN = 320;
+/** Byte length of a MatcherCall instruction (tag 0 CPI payload) */
+export declare const MATCHER_CALL_LEN = 67;
+/**
+ * Byte length of an InitMatcherCtx instruction payload sent to the matcher program.
+ * Layout: tag(1) + kind(1) + trading_fee_bps(4) + base_spread_bps(4) +
+ *   max_total_bps(4) + impact_k_bps(4) + liquidity_notional_e6(16) +
+ *   max_fill_abs(16) + max_inventory_abs(16) + fee_to_insurance_bps(2) +
+ *   skew_spread_mult_bps(2) + lp_account_id(8) = 78
+ */
+export declare const INIT_CTX_LEN = 78;
 /**
  * Compute execution price for a given LP quote.
  * For buys (isLong=true): price above oracle.

package/dist/index.js

@@ -560,7 +560,14 @@ function encodeAuditCrank() {
   return encU8(IX_TAG.AuditCrank);
 }
 var VAMM_MAGIC = 0x504552434d415443n;
+var MATCHER_MAGIC = VAMM_MAGIC;
+var CTX_RETURN_OFFSET = 0;
+var MATCHER_RETURN_LEN = 64;
 var CTX_VAMM_OFFSET = 64;
+var CTX_VAMM_LEN = 256;
+var MATCHER_CONTEXT_LEN = 320;
+var MATCHER_CALL_LEN = 67;
+var INIT_CTX_LEN = 78;
 var BPS_DENOM = 10000n;
 function computeVammQuote(params, oraclePriceE6, tradeSize, isLong) {
   const absSize = tradeSize < 0n ? -tradeSize : tradeSize;
@@ -2078,6 +2085,7 @@ var V12_17_ENGINE_OFF = 592;
 var V12_17_ACCOUNT_SIZE = 368;
 var V12_17_ENGINE_BITMAP_OFF = 752;
 var V12_17_RISK_BUF_LEN = 160;
+var V12_17_GEN_TABLE_ENTRY = 8;
 var V12_17_ENGINE_OFF_SBF = 584;
 var V12_17_ACCOUNT_SIZE_SBF = 352;
 var V12_17_ENGINE_BITMAP_OFF_SBF = 712;
@@ -2110,9 +2118,13 @@ var V12_17_ENGINE_MARKET_MODE_OFF = 232;
 var V12_17_ENGINE_RESOLVED_K_LONG_OFF = 304;
 var V12_17_ENGINE_RESOLVED_K_SHORT_OFF = 320;
 var V12_17_ENGINE_RESOLVED_LIVE_PRICE_OFF = 336;
+var V12_17_ENGINE_LAST_CRANK_SLOT_OFF = 344;
 var V12_17_ENGINE_C_TOT_OFF = 352;
 var V12_17_ENGINE_PNL_POS_TOT_OFF = 368;
 var V12_17_ENGINE_PNL_MATURED_POS_TOT_OFF = 384;
+var V12_17_ENGINE_GC_CURSOR_OFF = 400;
+var V12_17_ENGINE_OI_EFF_LONG_OFF = 528;
+var V12_17_ENGINE_OI_EFF_SHORT_OFF = 544;
 var V12_17_ENGINE_NEG_PNL_COUNT_OFF = 648;
 var V12_17_ENGINE_LAST_ORACLE_PRICE_OFF = 656;
 var V12_17_ENGINE_FUND_PX_LAST_OFF = 664;
@@ -2120,9 +2132,13 @@ var V12_17_ENGINE_F_LONG_NUM_OFF = 688;
 var V12_17_ENGINE_F_SHORT_NUM_OFF = 704;
 var V12_17_SBF_ENGINE_CURRENT_SLOT_OFF = 216;
 var V12_17_SBF_ENGINE_MARKET_MODE_OFF = 224;
+var V12_17_SBF_ENGINE_LAST_CRANK_SLOT_OFF = 328;
 var V12_17_SBF_ENGINE_C_TOT_OFF = 336;
 var V12_17_SBF_ENGINE_PNL_POS_TOT_OFF = 352;
 var V12_17_SBF_ENGINE_PNL_MATURED_POS_TOT_OFF = 368;
+var V12_17_SBF_ENGINE_GC_CURSOR_OFF = 384;
+var V12_17_SBF_ENGINE_OI_EFF_LONG_OFF = 504;
+var V12_17_SBF_ENGINE_OI_EFF_SHORT_OFF = 520;
 var V12_17_SBF_ENGINE_NEG_PNL_COUNT_OFF = 616;
 var V12_17_SBF_ENGINE_LAST_ORACLE_PRICE_OFF = 624;
 var V12_17_SBF_ENGINE_FUND_PX_LAST_OFF = 632;
@@ -2213,11 +2229,11 @@ for (const n of V12_17_TIERS) {
   const nextFreeBytes = n * 2;
   const preAccNative = V12_17_ENGINE_BITMAP_OFF + bitmapBytes + postBitmap + nextFreeBytes;
   const accountsOffNative = Math.ceil(preAccNative / 16) * 16;
-  const nativeSize = V12_17_ENGINE_OFF + accountsOffNative + n * V12_17_ACCOUNT_SIZE + V12_17_RISK_BUF_LEN;
+  const nativeSize = V12_17_ENGINE_OFF + accountsOffNative + n * V12_17_ACCOUNT_SIZE + V12_17_RISK_BUF_LEN + n * V12_17_GEN_TABLE_ENTRY;
   V12_17_SIZES.set(nativeSize, n);
   const preAccSbf = V12_17_ENGINE_BITMAP_OFF_SBF + bitmapBytes + postBitmap + nextFreeBytes;
   const accountsOffSbf = Math.ceil(preAccSbf / 8) * 8;
-  const sbfSize = V12_17_ENGINE_OFF_SBF + accountsOffSbf + n * V12_17_ACCOUNT_SIZE_SBF + V12_17_RISK_BUF_LEN;
+  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_1_SBF_ACCOUNT_SIZE = 280;
@@ -2712,7 +2728,7 @@ for (const [label, n] of [["Small", 256], ["Medium", 1024], ["Large", 4096]]) {
   const bitmapBytes = Math.ceil(n / 64) * 8;
   const preAcc = V12_17_ENGINE_BITMAP_OFF_SBF + bitmapBytes + 4 + n * 2;
   const accountsOff = Math.ceil(preAcc / 8) * 8;
-  const size = V12_17_ENGINE_OFF_SBF + accountsOff + n * V12_17_ACCOUNT_SIZE_SBF + V12_17_RISK_BUF_LEN;
+  const size = V12_17_ENGINE_OFF_SBF + accountsOff + n * V12_17_ACCOUNT_SIZE_SBF + V12_17_RISK_BUF_LEN + n * V12_17_GEN_TABLE_ENTRY;
   SLAB_TIERS_V12_17[label.toLowerCase()] = { maxAccounts: n, dataSize: size, label, description: `${n} slots (v12.17)` };
 }
 function buildLayoutVSetDexPool(maxAccounts) {
@@ -3018,7 +3034,7 @@ function buildLayoutV12_17(maxAccounts, dataLen) {
     const bitmapBytes2 = Math.ceil(maxAccounts / 64) * 8;
     const preAccNative = V12_17_ENGINE_BITMAP_OFF + bitmapBytes2 + 4 + maxAccounts * 2;
     const accountsOffNative = Math.ceil(preAccNative / 16) * 16;
-    const nativeSize = V12_17_ENGINE_OFF + accountsOffNative + maxAccounts * V12_17_ACCOUNT_SIZE + V12_17_RISK_BUF_LEN;
+    const nativeSize = V12_17_ENGINE_OFF + accountsOffNative + maxAccounts * V12_17_ACCOUNT_SIZE + V12_17_RISK_BUF_LEN + maxAccounts * V12_17_GEN_TABLE_ENTRY;
     return dataLen !== nativeSize;
   })();
   const engineOff = isSbf ? V12_17_ENGINE_OFF_SBF : V12_17_ENGINE_OFF;
@@ -3061,15 +3077,18 @@ function buildLayoutV12_17(maxAccounts, dataLen) {
     engineFundingRateBpsOff: -1,
     // no stored funding rate in v12.17
     engineMarkPriceOff: -1,
-    engineLastCrankSlotOff: -1,
+    // v12.17 computes mark from state; no stored field
+    engineLastCrankSlotOff: isSbf ? V12_17_SBF_ENGINE_LAST_CRANK_SLOT_OFF : V12_17_ENGINE_LAST_CRANK_SLOT_OFF,
     engineMaxCrankStalenessOff: -1,
     engineTotalOiOff: -1,
-    engineLongOiOff: -1,
-    engineShortOiOff: -1,
+    // parseEngine sums long + short when total offset is -1
+    engineLongOiOff: isSbf ? V12_17_SBF_ENGINE_OI_EFF_LONG_OFF : V12_17_ENGINE_OI_EFF_LONG_OFF,
+    engineShortOiOff: isSbf ? V12_17_SBF_ENGINE_OI_EFF_SHORT_OFF : V12_17_ENGINE_OI_EFF_SHORT_OFF,
     engineCTotOff: isSbf ? V12_17_SBF_ENGINE_C_TOT_OFF : V12_17_ENGINE_C_TOT_OFF,
     enginePnlPosTotOff: isSbf ? V12_17_SBF_ENGINE_PNL_POS_TOT_OFF : V12_17_ENGINE_PNL_POS_TOT_OFF,
     engineLiqCursorOff: -1,
-    engineGcCursorOff: -1,
+    // removed in v12.17
+    engineGcCursorOff: isSbf ? V12_17_SBF_ENGINE_GC_CURSOR_OFF : V12_17_ENGINE_GC_CURSOR_OFF,
     engineLastSweepStartOff: -1,
     engineLastSweepCompleteOff: -1,
     engineCrankCursorOff: -1,
@@ -3491,6 +3510,12 @@ function parseEngine(data) {
     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 longOi = readU128LE(data, base + oiEffLongOff);
+    const shortOi = readU128LE(data, base + oiEffShortOff);
     const bitmapEnd = layout.engineBitmapOff + layout.bitmapWords * 8;
     return {
       vault: readU128LE(data, base),
@@ -3509,16 +3534,16 @@ function parseEngine(data) {
       fundingRateE9: 0n,
       // no stored funding rate in v12.17
       marketMode: readU8(data, base + marketModeOff) === 1 ? 1 : 0,
-      lastCrankSlot: 0n,
+      lastCrankSlot: readU64LE(data, base + lastCrankSlotOff),
       maxCrankStalenessSlots: 0n,
-      totalOpenInterest: 0n,
-      longOi: 0n,
-      shortOi: 0n,
+      totalOpenInterest: longOi + shortOi,
+      longOi,
+      shortOi,
       cTot: readU128LE(data, base + cTotOff),
       pnlPosTot: readU128LE(data, base + pnlPosTotOff),
       pnlMaturedPosTot: readU128LE(data, base + pnlMaturedOff),
       liqCursor: 0,
-      gcCursor: 0,
+      gcCursor: readU16LE(data, base + gcCursorOff),
       lastSweepStartSlot: 0n,
       lastSweepCompleteSlot: 0n,
       crankCursor: 0,
@@ -5153,10 +5178,9 @@ function decodeStakePool(data) {
   const reservedStart = off;
   const marketResolved = bytes[reservedStart + 9] === 1;
   const hwmEnabled = bytes[reservedStart + 10] === 1;
-  const hwmTvlLow = readU64LE4(bytes, reservedStart + 11);
-  const hwmTvlHigh = readU64LE4(bytes, reservedStart + 19);
-  const epochHighWaterTvl = hwmTvlLow | hwmTvlHigh << 64n;
-  const hwmFloorBps = readU16LE3(bytes, reservedStart + 27);
+  const hwmFloorBps = readU16LE3(bytes, reservedStart + 11);
+  const epochHighWaterTvl = readU64LE4(bytes, reservedStart + 16);
+  const hwmLastEpoch = readU64LE4(bytes, reservedStart + 24);
   const trancheEnabled = bytes[reservedStart + 32] === 1;
   const juniorBalance = readU64LE4(bytes, reservedStart + 33);
   const juniorTotalLp = readU64LE4(bytes, reservedStart + 41);
@@ -5187,6 +5211,7 @@ function decodeStakePool(data) {
     hwmEnabled,
     epochHighWaterTvl,
     hwmFloorBps,
+    hwmLastEpoch,
     trancheEnabled,
     juniorBalance,
     juniorTotalLp,
@@ -6660,10 +6685,13 @@ export {
   CHAINLINK_DECIMALS_OFFSET,
   CHAINLINK_MIN_SIZE,
   CREATOR_LOCK_SEED,
+  CTX_RETURN_OFFSET,
+  CTX_VAMM_LEN,
   CTX_VAMM_OFFSET,
   DEFAULT_OI_RAMP_SLOTS,
   ENGINE_MARK_PRICE_OFF,
   ENGINE_OFF,
+  INIT_CTX_LEN,
   IX_TAG,
   LIGHTHOUSE_CONSTRAINT_ADDRESS,
   LIGHTHOUSE_ERROR_CODES,
@@ -6673,6 +6701,10 @@ export {
   LiquidationPolicyTag,
   MARK_PRICE_EMA_ALPHA_E6,
   MARK_PRICE_EMA_WINDOW_SLOTS,
+  MATCHER_CALL_LEN,
+  MATCHER_CONTEXT_LEN,
+  MATCHER_MAGIC,
+  MATCHER_RETURN_LEN,
   MAX_DECIMALS,
   METEORA_DLMM_PROGRAM_ID,
   NFT_IX_TAG,