@percolatorct/sdk 1.0.0-beta.30 → 1.0.0-beta.32

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.** `1.0.0-beta.25`. 742 tests passing. Do NOT use with real funds.
+> **EXPERIMENTAL — NOT AUDITED.** `1.0.0-beta.32`. 755 tests passing. Do NOT use with real funds.
 
 [![npm](https://img.shields.io/npm/v/@percolator/sdk?color=14F195)](https://www.npmjs.com/package/@percolator/sdk)
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)

package/dist/abi/accounts.d.ts

@@ -17,7 +17,15 @@ export declare const ACCOUNTS_INIT_MARKET: readonly AccountSpec[];
  */
 export declare const ACCOUNTS_INIT_USER: readonly AccountSpec[];
 /**
- * InitLP: 5 accounts (clock/oracle removed in commit 410f947)
+ * InitLP: 6 accounts
+ * Program at percolator.rs:6607 calls expect_len(accounts, 6).
+ * The 6th account (accounts[5]) is the clock sysvar — used via Clock::from_account_info.
+ * [0] user         signer, writable (LP owner; pays fee)
+ * [1] slab         writable
+ * [2] userAta      writable (collateral source for fee)
+ * [3] vault        writable (collateral destination)
+ * [4] tokenProgram read-only
+ * [5] clock        read-only (SYSVAR_CLOCK_PUBKEY)
  */
 export declare const ACCOUNTS_INIT_LP: readonly AccountSpec[];
 /**
@@ -62,7 +70,23 @@ export declare const ACCOUNTS_SET_RISK_THRESHOLD: readonly AccountSpec[];
  */
 export declare const ACCOUNTS_UPDATE_ADMIN: readonly AccountSpec[];
 /**
- * CloseSlab: 2 accounts
+ * AcceptAdmin: 2 accounts (tag 82)
+ * Second half of two-step admin transfer. The proposed new admin must sign to
+ * complete the transfer. Program at percolator.rs:7994 calls expect_len(accounts, 2).
+ * [0] pendingAdmin  signer, writable (must match config.pending_admin)
+ * [1] slab          writable
+ */
+export declare const ACCOUNTS_ACCEPT_ADMIN: readonly AccountSpec[];
+/**
+ * CloseSlab: 6 accounts
+ * Drains vault and recovers rent after market is fully resolved and all accounts closed.
+ * Program at percolator.rs:8033 calls expect_len(accounts, 6).
+ * [0] dest            signer, writable (receives rent + drained vault tokens)
+ * [1] slab            writable
+ * [2] vault           writable (token account — drained)
+ * [3] vaultAuthority  read-only (PDA that signs the drain transfer)
+ * [4] destAta         writable (dest's token ATA receiving drained tokens)
+ * [5] tokenProgram    read-only
  */
 export declare const ACCOUNTS_CLOSE_SLAB: readonly AccountSpec[];
 /**

package/dist/abi/instructions.d.ts

@@ -135,6 +135,46 @@ export declare const IX_TAG: {
  * Note: indexFeedId is the Pyth Pull feed ID (32 bytes hex), NOT an oracle pubkey.
  * The program validates PriceUpdateV2 accounts against this feed ID at runtime.
  */
+/**
+ * Optional 66-byte extended tail for InitMarket (S-4).
+ *
+ * When present and any field is non-zero the encoder appends a 66-byte block
+ * in the exact order that the program reads it (percolator.rs:1516-1545):
+ *   insurance_withdraw_max_bps          u16  (2 bytes)
+ *   insurance_withdraw_cooldown_slots   u64  (8 bytes)
+ *   permissionless_resolve_stale_slots  u64  (8 bytes)
+ *   funding_horizon_slots               u64  (8 bytes)
+ *   funding_k_bps                       u64  (8 bytes)
+ *   funding_max_premium_bps             i64  (8 bytes)
+ *   funding_max_bps_per_slot            i64  (8 bytes)
+ *   mark_min_fee                        u64  (8 bytes)
+ *   force_close_delay_slots             u64  (8 bytes)
+ *   total = 2 + 8*8 = 66 bytes
+ *
+ * When absent (or all fields are zero) the encoder omits the tail and the
+ * program treats all extended fields as their default zero values. This
+ * preserves full backward compatibility with existing 344-byte payloads.
+ */
+export interface InitMarketExtendedTail {
+    /** Maximum percentage of insurance fund withdrawable per cooldown window (0–10 000 bps). */
+    insuranceWithdrawMaxBps: number;
+    /** Slots that must elapse between insurance withdrawals. Required when insuranceWithdrawMaxBps > 0. */
+    insuranceWithdrawCooldownSlots: bigint | string;
+    /** Slots after which an unresolved market may be permissionlessly resolved. */
+    permissionlessResolveStaleSlots: bigint | string;
+    /** Funding rate horizon in slots (custom_funding_k denominator). */
+    fundingHorizonSlots: bigint | string;
+    /** Funding rate K parameter in bps (0 = disabled). */
+    fundingKBps: bigint | string;
+    /** Maximum funding premium in bps (i64 — may be negative to flip direction). */
+    fundingMaxPremiumBps: bigint | string;
+    /** Maximum funding rate change per slot in bps (i64). */
+    fundingMaxBpsPerSlot: bigint | string;
+    /** Minimum fee charged per mark-price update (u64, in collateral base units). */
+    markMinFee: bigint | string;
+    /** Slots to delay forced close after trigger condition is met (0 = immediate). */
+    forceCloseDelaySlots: bigint | string;
+}
 export interface InitMarketArgs {
     admin: PublicKey | string;
     collateralMint: PublicKey | string;
@@ -171,7 +211,49 @@ export interface InitMarketArgs {
     minInitialDeposit: bigint | string;
     minNonzeroMmReq: bigint | string;
     minNonzeroImReq: bigint | string;
+    /**
+     * Optional 66-byte extended tail (S-4).
+     * When present and any field is non-zero, appended after the 344-byte base payload.
+     * When absent (or all zeros), the base 344-byte payload is sent and the program
+     * uses default zero values for all extended fields.
+     * @see InitMarketExtendedTail
+     */
+    extendedTail?: InitMarketExtendedTail;
 }
+/**
+ * Encode InitMarket instruction data.
+ *
+ * Produces either a 344-byte base payload (no extended tail) or a 410-byte
+ * payload (344 + 66 extended tail) depending on whether `args.extendedTail`
+ * is provided and contains at least one non-zero field.
+ *
+ * The program (percolator.rs:1527-1545) treats an empty `rest` as all-zero
+ * defaults, so the 344-byte form is fully backward-compatible.
+ *
+ * @param args InitMarket arguments
+ * @returns Encoded instruction bytes
+ *
+ * @example
+ * ```ts
+ * const ix = encodeInitMarket({
+ *   admin: adminPk,
+ *   collateralMint: mintPk,
+ *   indexFeedId: "0000...0000",
+ *   // ... required fields ...
+ *   extendedTail: {
+ *     insuranceWithdrawMaxBps: 500,
+ *     insuranceWithdrawCooldownSlots: 216000n,
+ *     permissionlessResolveStaleSlots: 0n,
+ *     fundingHorizonSlots: 0n,
+ *     fundingKBps: 0n,
+ *     fundingMaxPremiumBps: 0n,
+ *     fundingMaxBpsPerSlot: 0n,
+ *     markMinFee: 0n,
+ *     forceCloseDelaySlots: 0n,
+ *   },
+ * });
+ * ```
+ */
 export declare function encodeInitMarket(args: InitMarketArgs): Uint8Array;
 /**
  * InitUser instruction data (9 bytes)

package/dist/index.js

@@ -258,11 +258,29 @@ function encodeFeedId(feedId) {
   }
   return bytes;
 }
-var INIT_MARKET_DATA_LEN = 344;
+var INIT_MARKET_BASE_LEN = 344;
+var INIT_MARKET_EXTENDED_TAIL_LEN = 66;
+function extendedTailHasNonZero(t) {
+  const toBigInt = (v) => typeof v === "string" ? BigInt(v) : v;
+  return t.insuranceWithdrawMaxBps !== 0 || toBigInt(t.insuranceWithdrawCooldownSlots) !== 0n || toBigInt(t.permissionlessResolveStaleSlots) !== 0n || toBigInt(t.fundingHorizonSlots) !== 0n || toBigInt(t.fundingKBps) !== 0n || toBigInt(t.fundingMaxPremiumBps) !== 0n || toBigInt(t.fundingMaxBpsPerSlot) !== 0n || toBigInt(t.markMinFee) !== 0n || toBigInt(t.forceCloseDelaySlots) !== 0n;
+}
+function encodeExtendedTail(t) {
+  return concatBytes(
+    encU16(t.insuranceWithdrawMaxBps),
+    encU64(t.insuranceWithdrawCooldownSlots),
+    encU64(t.permissionlessResolveStaleSlots),
+    encU64(t.fundingHorizonSlots),
+    encU64(t.fundingKBps),
+    encI64(t.fundingMaxPremiumBps),
+    encI64(t.fundingMaxBpsPerSlot),
+    encU64(t.markMinFee),
+    encU64(t.forceCloseDelaySlots)
+  );
+}
 function encodeInitMarket(args) {
   const hMin = args.hMin ?? args.warmupPeriodSlots ?? 0n;
   const hMax = args.hMax ?? args.warmupPeriodSlots ?? 0n;
-  const data = concatBytes(
+  const base = concatBytes(
     encU8(IX_TAG.InitMarket),
     encPubkey(args.admin),
     encPubkey(args.collateralMint),
@@ -300,12 +318,21 @@ function encodeInitMarket(args) {
     encU128(args.minNonzeroMmReq),
     encU128(args.minNonzeroImReq)
   );
-  if (data.length !== INIT_MARKET_DATA_LEN) {
+  if (base.length !== INIT_MARKET_BASE_LEN) {
     throw new Error(
-      `encodeInitMarket: expected ${INIT_MARKET_DATA_LEN} bytes, got ${data.length}`
+      `encodeInitMarket: base payload expected ${INIT_MARKET_BASE_LEN} bytes, got ${base.length}`
     );
   }
-  return data;
+  if (args.extendedTail && extendedTailHasNonZero(args.extendedTail)) {
+    const tail = encodeExtendedTail(args.extendedTail);
+    if (tail.length !== INIT_MARKET_EXTENDED_TAIL_LEN) {
+      throw new Error(
+        `encodeInitMarket: extended tail expected ${INIT_MARKET_EXTENDED_TAIL_LEN} bytes, got ${tail.length}`
+      );
+    }
+    return concatBytes(base, tail);
+  }
+  return base;
 }
 function encodeInitUser(args) {
   return concatBytes(encU8(IX_TAG.InitUser), encU64(args.feePayment));
@@ -800,7 +827,8 @@ var ACCOUNTS_INIT_LP = [
   { name: "slab", signer: false, writable: true },
   { name: "userAta", signer: false, writable: true },
   { name: "vault", signer: false, writable: true },
-  { name: "tokenProgram", signer: false, writable: false }
+  { name: "tokenProgram", signer: false, writable: false },
+  { name: "clock", signer: false, writable: false }
 ];
 var ACCOUNTS_DEPOSIT_COLLATERAL = [
   { name: "user", signer: true, writable: true },
@@ -874,10 +902,18 @@ var ACCOUNTS_UPDATE_ADMIN = [
   { name: "admin", signer: true, writable: true },
   { name: "slab", signer: false, writable: true }
 ];
-var ACCOUNTS_CLOSE_SLAB = [
-  { name: "admin", signer: true, writable: true },
+var ACCOUNTS_ACCEPT_ADMIN = [
+  { name: "pendingAdmin", signer: true, writable: true },
   { name: "slab", signer: false, writable: true }
 ];
+var ACCOUNTS_CLOSE_SLAB = [
+  { name: "dest", signer: true, writable: true },
+  { name: "slab", signer: false, writable: true },
+  { name: "vault", signer: false, writable: true },
+  { name: "vaultAuthority", signer: false, writable: false },
+  { name: "destAta", signer: false, writable: true },
+  { name: "tokenProgram", signer: false, writable: false }
+];
 var ACCOUNTS_UPDATE_CONFIG = [
   { name: "admin", signer: true, writable: true },
   { name: "slab", signer: false, writable: true }
@@ -1568,6 +1604,16 @@ function deriveMintAuthority(programId = NFT_PROGRAM_ID) {
   );
 }
 var POSITION_NFT_STATE_LEN = 208;
+function readI128FromView(view, offset) {
+  const lo = view.getBigUint64(offset, true);
+  const hi = view.getBigUint64(offset + 8, true);
+  const unsigned = hi << 64n | lo;
+  const SIGN_BIT = 1n << 127n;
+  if (unsigned >= SIGN_BIT) {
+    return unsigned - (1n << 128n);
+  }
+  return unsigned;
+}
 function parsePositionNftAccount(data) {
   if (data.length < POSITION_NFT_STATE_LEN) {
     throw new Error(
@@ -1584,8 +1630,8 @@ function parsePositionNftAccount(data) {
     entryPriceE6: view.getBigUint64(88, true),
     positionSize: view.getBigUint64(96, true),
     isLong: data[104] === 1,
-    positionBasisQ: view.getBigInt64(112, true) | view.getBigInt64(120, true) << 64n,
-    lastFundingIndexE18: view.getBigInt64(128, true) | view.getBigInt64(136, true) << 64n,
+    positionBasisQ: readI128FromView(view, 112),
+    lastFundingIndexE18: readI128FromView(view, 128),
     mintedAt: view.getBigInt64(144, true),
     accountId: view.getBigUint64(152, true)
   };
@@ -1899,11 +1945,11 @@ var V12_15_ENGINE_PNL_POS_TOT_OFF = 368;
 var V12_15_ENGINE_PNL_MATURED_POS_TOT_OFF = 384;
 var V12_15_ENGINE_BITMAP_OFF = 862;
 var V12_15_SIZES = /* @__PURE__ */ new Map();
-var V12_17_ENGINE_OFF = 512;
+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_ENGINE_OFF_SBF = 504;
+var V12_17_ENGINE_OFF_SBF = 584;
 var V12_17_ACCOUNT_SIZE_SBF = 352;
 var V12_17_ENGINE_BITMAP_OFF_SBF = 712;
 var V12_17_ACCT_CAPITAL_OFF = 0;
@@ -2862,8 +2908,12 @@ function buildLayoutV12_17(maxAccounts, dataLen) {
     // 72
     configOffset: V0_HEADER_LEN,
     // 72
-    configLen: 432,
-    // upstream 400 + dex_pool 32
+    // configLen = 512 (SBF-aligned MarketConfig size after Phase A/B/E).
+    // Verified field-by-field against percolator-prog/src/percolator.rs MarketConfig struct.
+    // Missing 80 bytes from prior value 432: max_pnl_cap, last_audit_pause_slot,
+    // oi_cap_multiplier_bps, dispute_window_slots, dispute_bond_amount,
+    // lp_collateral_enabled, lp_collateral_ltv_bps, _new_fields_pad, pending_admin.
+    configLen: 512,
     reservedOff: V1_RESERVED_OFF,
     // 80
     engineOff,
@@ -6400,6 +6450,7 @@ async function resolvePrice(mint, signal, options) {
   };
 }
 export {
+  ACCOUNTS_ACCEPT_ADMIN,
   ACCOUNTS_ADVANCE_ORACLE_PHASE,
   ACCOUNTS_AUDIT_CRANK,
   ACCOUNTS_BURN_POSITION_NFT,