@percolatorct/sdk 1.0.0-beta.3 → 1.0.0-beta.31

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.
 
-> **⚠️ BETA** — `1.0.0-beta.1`. Security audit (0x-SquidSol) complete. All 709 tests passing. Pending Helius API key + mainnet market deployment before `1.0.0` stable.
+> **EXPERIMENTAL — NOT AUDITED.** `1.0.0-beta.31`. 742 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)
@@ -434,8 +434,10 @@ const markets = await discoverMarkets(connection);
 
 | Program | Network | Address |
 |---------|---------|---------|
-| Percolator | Mainnet | `GM8zjJ8LTBMv9xEsverh6H6wLyevgMHEJXcEzyY3rY24` |
+| Percolator | Mainnet | `ESa89R5Es3rJ5mnwGybVRG1GrNt9etP11Z5V2QWD4edv` |
 | Matcher | Mainnet | `DHP6DtwXP1yJsz8YzfoeigRFPB979gzmumkmCxDLSkUX` |
+| Stake | Mainnet | `DC5fovFQD5SZYsetwvEqd4Wi4PFY1Yfnc669VMe6oa7F` |
+| NFT | Mainnet | `FqhKJT9gtScjrmfUuRMjeg7cXNpif1fqsy5Jh65tJmTS` |
 | Percolator | Devnet | `FxfD37s1AZTeWfFQps9Zpebi2dNQ9QSSDtfMKdbsfKrD` |
 | Matcher | Devnet | `GTRgyTDfrMvBubALAqtHuQwT8tbGyXid7svXZKtWfC9k` |
 
@@ -689,19 +691,26 @@ const markets = await getMarketsByAddress(
 ```bash
 pnpm install              # Install dependencies
 pnpm build                # Build with tsup (outputs to dist/)
-pnpm test                 # Run test suite (vitest)
+pnpm test                 # Run all 742 tests (vitest)
 pnpm lint                 # Type-check (tsc --noEmit)
+pnpm verify-layout        # Verify ABI byte offsets against on-chain layout
 ```
 
 ### Testing
 
-Tests cover ABI encoding roundtrips, PDA derivation, slab parsing, validation, and trading math:
+Tests cover ABI encoding roundtrips, PDA derivation, slab parsing, validation, and trading math. 742 tests, 0 failures.
 
 ```bash
 pnpm test                 # Run all tests
 pnpm test -- --watch      # Watch mode
 ```
 
+### v12.17 Layout Support
+
+The SDK supports the v12.17 slab layout natively via `detectSlabLayout()`. The layout detection function inspects account size to select the correct field offsets for header, config, and per-account data.
+
+A key fix in this version corrects the SBF byte offsets for `d1`/`d2` delta fields that were misaligned in earlier SDK versions. The `parseAllAccounts()` function applies the correct offsets for both devnet (legacy layout) and mainnet (v12.17 layout) slabs automatically.
+
 ### Publishing
 
 ```bash

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[];
 /**
@@ -50,7 +58,7 @@ export declare const ACCOUNTS_CLOSE_ACCOUNT: readonly AccountSpec[];
  */
 export declare const ACCOUNTS_TOPUP_INSURANCE: readonly AccountSpec[];
 /**
- * TradeCpi: 7 accounts (PERC-199: clock sysvar removed — uses Clock::get() syscall)
+ * TradeCpi: 8 accounts (deployed program expects clock sysvar at index 3)
  */
 export declare const ACCOUNTS_TRADE_CPI: 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[];
 /**
@@ -73,21 +97,11 @@ export declare const ACCOUNTS_UPDATE_CONFIG: readonly AccountSpec[];
  * SetMaintenanceFee: 2 accounts
  */
 export declare const ACCOUNTS_SET_MAINTENANCE_FEE: readonly AccountSpec[];
-/**
- * SetOracleAuthority: 2 accounts
- * Sets the oracle price authority (admin only)
- */
-export declare const ACCOUNTS_SET_ORACLE_AUTHORITY: readonly AccountSpec[];
 /**
  * SetOraclePriceCap: 2 accounts
  * Set oracle price circuit breaker cap (admin only)
  */
 export declare const ACCOUNTS_SET_ORACLE_PRICE_CAP: readonly AccountSpec[];
-/**
- * PushOraclePrice: 2 accounts
- * Push oracle price (oracle authority only)
- */
-export declare const ACCOUNTS_PUSH_ORACLE_PRICE: readonly AccountSpec[];
 /**
  * ResolveMarket: 2 accounts
  * Resolves a binary/premarket (admin only)
@@ -98,6 +112,15 @@ export declare const ACCOUNTS_RESOLVE_MARKET: readonly AccountSpec[];
  * Withdraw insurance fund after market resolution (admin only)
  */
 export declare const ACCOUNTS_WITHDRAW_INSURANCE: readonly AccountSpec[];
+/**
+ * WithdrawInsuranceLimited (tag 23): 7 or 8 accounts.
+ * On live markets the 8th oracle account is REQUIRED (upstream 8ce8d54):
+ * the handler does a same-instruction accrue_market_to against the fresh
+ * oracle price to prevent withdrawals against overstated insurance.
+ * On resolved markets the oracle is frozen — 7 accounts suffice.
+ */
+export declare const ACCOUNTS_WITHDRAW_INSURANCE_LIMITED_RESOLVED: readonly AccountSpec[];
+export declare const ACCOUNTS_WITHDRAW_INSURANCE_LIMITED_LIVE: readonly AccountSpec[];
 /**
  * PauseMarket: 2 accounts
  */
@@ -117,6 +140,21 @@ export declare const ACCOUNTS_UNPAUSE_MARKET: readonly AccountSpec[];
  * remember the positional order, and errors clearly on missing names.
  */
 export declare function buildAccountMetas(spec: readonly AccountSpec[], keys: PublicKey[] | Record<string, PublicKey>): AccountMeta[];
+/**
+ * CreateInsuranceMint: 9 accounts
+ * Creates SPL mint PDA for insurance LP tokens. Admin only, once per market.
+ */
+export declare const ACCOUNTS_CREATE_INSURANCE_MINT: readonly AccountSpec[];
+/**
+ * DepositInsuranceLP: 8 accounts
+ * Deposit collateral into insurance fund, receive LP tokens.
+ */
+export declare const ACCOUNTS_DEPOSIT_INSURANCE_LP: readonly AccountSpec[];
+/**
+ * WithdrawInsuranceLP: 8 accounts
+ * Burn LP tokens and withdraw proportional share of insurance fund.
+ */
+export declare const ACCOUNTS_WITHDRAW_INSURANCE_LP: readonly AccountSpec[];
 /**
  * LpVaultWithdraw: 10 accounts (tag 39, PERC-627 / GH#1926 / PERC-8287)
  *
@@ -192,11 +230,6 @@ export declare const ACCOUNTS_AUDIT_CRANK: readonly AccountSpec[];
  * Permissionless — no signer required beyond fee payer.
  */
 export declare const ACCOUNTS_ADVANCE_ORACLE_PHASE: readonly AccountSpec[];
-/**
- * TopUpKeeperFund: 3 accounts
- * Permissionless — anyone can fund. Transfers lamports directly (no system program).
- */
-export declare const ACCOUNTS_TOPUP_KEEPER_FUND: readonly AccountSpec[];
 /**
  * SetOiImbalanceHardBlock: 2 accounts
  * Sets the OI imbalance hard-block threshold (admin only)
@@ -234,6 +267,12 @@ export declare const ACCOUNTS_CLEAR_PENDING_SETTLEMENT: readonly AccountSpec[];
  * Sets the per-wallet position cap (admin only). capE6=0 disables.
  */
 export declare const ACCOUNTS_SET_WALLET_CAP: readonly AccountSpec[];
+/**
+ * SetDexPool: 3 accounts
+ * Admin pins the approved DEX pool address for a HYPERP market.
+ * After this call, UpdateHyperpMark rejects any pool that does not match.
+ */
+export declare const ACCOUNTS_SET_DEX_POOL: readonly AccountSpec[];
 /**
  * InitMatcherCtx: 5 accounts
  * Admin CPI-initializes the matcher context account for an LP slot.

package/dist/abi/errors.d.ts

@@ -19,27 +19,16 @@ export declare function getErrorName(code: number): string;
  * Get actionable hint for error code.
  */
 export declare function getErrorHint(code: number): string | undefined;
-/**
- * Check whether an error code is in the Anchor framework error range
- * (used by Lighthouse, not Percolator).
- */
-export declare function isAnchorErrorCode(code: number): boolean;
 /**
  * Parse error from transaction logs.
  * Looks for "Program ... failed: custom program error: 0x..."
  *
  * Hex capture is bounded (1–8 digits) so pathological logs cannot feed unbounded
  * strings into `parseInt` or produce precision-loss codes above u32.
- *
- * Distinguishes between:
- * - Percolator program errors (codes 0–65): returns Percolator error info
- * - Anchor/Lighthouse errors (codes 0x1770–0x1FFF): returns Lighthouse-specific
- *   name and hint so callers can handle wallet middleware failures
  */
 export declare function parseErrorFromLogs(logs: string[]): {
     code: number;
     name: string;
     hint?: string;
-    source?: "percolator" | "lighthouse" | "unknown";
 } | null;
 export {};

package/dist/abi/index.d.ts

@@ -2,3 +2,4 @@ export * from "./encode.js";
 export * from "./instructions.js";
 export * from "./accounts.js";
 export * from "./errors.js";
+export * from "./nft.js";