@parqxchange/sdk 0.1.0 → 0.2.0

package/dist/actions/liquidity.js

@@ -8,7 +8,8 @@ async function addLiquidity(opts, accounts, args) {
     const [vaultAuthority] = (0, pda_1.vaultAuthorityPDA)(opts.marketId, opts.poolProgramId);
     const [lpMint] = (0, pda_1.lpMintPDA)(opts.marketId, opts.poolProgramId);
     const [usdcVault] = (0, pda_1.usdcVaultPDA)(opts.marketId, opts.poolProgramId);
-    const ix = await opts.poolClient.depositIx({ poolState, usdcVault, vaultAuthority, lpMint, userLp: accounts.userLp, userUsdc: accounts.userUsdc, depositor: accounts.depositor }, { amount: args.amountUsdc, minLpOut: args.minLpOut });
+    const [lpDead] = (0, pda_1.lpDeadPDA)(opts.marketId, opts.poolProgramId);
+    const ix = await opts.poolClient.depositIx({ poolState, usdcVault, vaultAuthority, lpMint, userLp: accounts.userLp, userUsdc: accounts.userUsdc, lpDead, depositor: accounts.depositor }, { amount: args.amountUsdc, minLpOut: args.minLpOut });
     return [ix];
 }
 async function removeLiquidity(opts, accounts, args) {

package/dist/decode/index.js

@@ -18,10 +18,10 @@ exports.decodeStakePosition = decodeStakePosition;
 exports.decodePayoutQueueEntry = decodePayoutQueueEntry;
 exports.decodeUserQueueClaims = decodeUserQueueClaims;
 exports.identifyAccountType = identifyAccountType;
-const node_crypto_1 = require("node:crypto");
+const sha256_1 = require("@noble/hashes/sha256");
 const web3_js_1 = require("@solana/web3.js");
 function sha256Disc(name) {
-    const hash = (0, node_crypto_1.createHash)("sha256").update(`account:${name}`).digest();
+    const hash = Buffer.from((0, sha256_1.sha256)(new TextEncoder().encode(`account:${name}`)));
     return hash.subarray(0, 8);
 }
 exports.DISCRIMINATORS = {
@@ -148,8 +148,8 @@ function decodePosition(data) {
 }
 function decodeMarketState(data) {
     checkDisc(data, exports.DISCRIMINATORS.MarketState, "MarketState");
-    if (data.length !== 460 && data.length !== 476 && data.length !== 511) {
-        checkLen(data, 511, "MarketState");
+    if (data.length !== 460 && data.length !== 476 && data.length !== 511 && data.length !== 515) {
+        checkLen(data, 515, "MarketState");
     }
     const v = makeView(data);
     const base = {
@@ -199,7 +199,7 @@ function decodeMarketState(data) {
             offHoursMaxOiShort: readU64LE(v, 468),
         };
         if (data.length >= 511) {
-            return {
+            const v3 = {
                 ...v2,
                 adlFrozen: readU8(v, 476),
                 adlTailTriggerUsdcRth: readU64LE(v, 477),
@@ -212,6 +212,14 @@ function decodeMarketState(data) {
                 adlMaxFeedDivergenceBps: readU16LE(v, 507),
                 initialMarginBps: readU16LE(v, 509),
             };
+            if (data.length >= 515) {
+                return {
+                    ...v3,
+                    liqFeeBps: readU16LE(v, 511),
+                    partialLiqTargetHealth: readU16LE(v, 513),
+                };
+            }
+            return v3;
         }
         return v2;
     }
@@ -363,8 +371,11 @@ function decodeFeePool(data) {
 }
 function decodeStakingPool(data) {
     checkDisc(data, exports.DISCRIMINATORS.StakingPool, "StakingPool");
-    checkLen(data, 282, "StakingPool");
+    if (data.byteLength !== 282 && data.byteLength !== 290) {
+        throw new DecoderError(`StakingPool: expected 282 or 290 bytes, got ${data.byteLength}`);
+    }
     const v = makeView(data);
+    const hasTotalClaimed = data.byteLength >= 290;
     return {
         admin: readPubkey(v, 8),
         tokenMint: readPubkey(v, 40),
@@ -382,6 +393,7 @@ function decodeStakingPool(data) {
         emittedSoFar: readU64LE(v, 265),
         lastUpdateTs: readI64LE(v, 273),
         bump: readU8(v, 281),
+        totalClaimed: hasTotalClaimed ? readU64LE(v, 282) : 0n,
     };
 }
 function decodeStakePosition(data) {

package/dist/events/decoder.d.ts

@@ -1,4 +1,4 @@
-import type { PositionOpenedEvent, PositionClosedEvent, LiquidatedEvent, BadDebtEvent, FundingUpdatedEvent, EnqueuedEvent, HarvestedEvent, EntryVoidedEvent, SideBucketCreditedEvent, QueueDrainedEvent, PhantomCreditDrainedEvent, FeesSweptEvent, FeesDistributedEvent, TreasuryWithdrawalEvent, StakedEvent, UnstakedEvent, RewardClaimedEvent, RewardIndexUpdatedEvent, CompoundedRewardEvent } from "../types";
+import type { PositionOpenedEvent, PositionClosedEvent, LiquidatedEvent, BadDebtEvent, FundingUpdatedEvent, EnqueuedEvent, HarvestedEvent, EntryVoidedEvent, SideBucketCreditedEvent, QueueDrainedEvent, QueueLpDrawEvent, PhantomCreditDrainedEvent, FeesSweptEvent, FeesDistributedEvent, TreasuryWithdrawalEvent, StakedEvent, UnstakedEvent, RewardClaimedEvent, RewardIndexUpdatedEvent, CompoundedRewardEvent } from "../types";
 export type DecodedEvent = {
     type: "positionOpened";
     data: PositionOpenedEvent;
@@ -29,6 +29,9 @@ export type DecodedEvent = {
 } | {
     type: "queueDrained";
     data: QueueDrainedEvent;
+} | {
+    type: "queueLpDraw";
+    data: QueueLpDrawEvent;
 } | {
     type: "phantomCreditDrained";
     data: PhantomCreditDrainedEvent;

package/dist/events/decoder.js

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.decodeAnchorEvent = decodeAnchorEvent;
 const web3_js_1 = require("@solana/web3.js");
-const node_crypto_1 = require("node:crypto");
+const sha256_1 = require("@noble/hashes/sha256");
 function sha256Disc(name) {
-    return (0, node_crypto_1.createHash)("sha256").update(name).digest().subarray(0, 8);
+    return Buffer.from((0, sha256_1.sha256)(new TextEncoder().encode(name))).subarray(0, 8);
 }
 const EVENT_DISCS = {
     PositionOpened: sha256Disc("event:PositionOpened"),
@@ -17,6 +17,7 @@ const EVENT_DISCS = {
     EntryVoided: sha256Disc("event:EntryVoided"),
     SideBucketCredited: sha256Disc("event:SideBucketCredited"),
     QueueDrained: sha256Disc("event:QueueDrained"),
+    QueueLpDraw: sha256Disc("event:QueueLpDraw"),
     PhantomCreditDrained: sha256Disc("event:PhantomCreditDrained"),
     FeesSwept: sha256Disc("event:FeesSwept"),
     FeesDistributed: sha256Disc("event:FeesDistributed"),
@@ -160,6 +161,16 @@ function decodeQueueDrained(data) {
         residualToTreasury: readU64LE(v, 40),
     };
 }
+function decodeQueueLpDraw(data) {
+    const v = makeView(data);
+    return {
+        marketId: readBytes(v, 8, 32),
+        idx: readU64LE(v, 40),
+        owner: readPubkey(v, 48),
+        amount: readU64LE(v, 80),
+        totalUsdcAfter: readU64LE(v, 88),
+    };
+}
 function decodePhantomCreditDrained(data) {
     const v = makeView(data);
     return {
@@ -311,6 +322,12 @@ function decodeAnchorEvent(base64Data) {
             return { type: "queueDrained", data };
         return null;
     }
+    if (discMatches(raw, EVENT_DISCS.QueueLpDraw)) {
+        const data = tryDecodePayload(() => decodeQueueLpDraw(raw));
+        if (data)
+            return { type: "queueLpDraw", data };
+        return null;
+    }
     if (discMatches(raw, EVENT_DISCS.PhantomCreditDrained)) {
         const data = tryDecodePayload(() => decodePhantomCreditDrained(raw));
         if (data)

package/dist/programs/pool.d.ts

@@ -33,6 +33,7 @@ export declare class PoolClient {
         lpMint: PublicKey;
         userLp: PublicKey;
         userUsdc: PublicKey;
+        lpDead: PublicKey;
         depositor: PublicKey;
     }, args: {
         amount: bigint;
@@ -93,6 +94,17 @@ export declare class PoolClient {
     }, args: {
         amount: bigint;
     }): Promise<TransactionInstruction>;
+    sweepStrandedToInsuranceIx(accounts: {
+        poolState: PublicKey;
+        poolVaultUsdc: PublicKey;
+        vaultAuthority: PublicKey;
+        lpMint: PublicKey;
+        insuranceFund: PublicKey;
+        insuranceVault: PublicKey;
+        admin: PublicKey;
+    }, args: {
+        amount: bigint;
+    }): Promise<TransactionInstruction>;
     withdrawInsuranceIx(accounts: {
         insuranceFund: PublicKey;
         insuranceVault: PublicKey;

package/dist/programs/pool.js

@@ -45,7 +45,11 @@ class PoolClient {
     async depositIx(accounts, args) {
         return this.program.methods
             .deposit(new anchor_1.BN(args.amount.toString()), new anchor_1.BN(args.minLpOut.toString()))
-            .accounts({ ...accounts, tokenProgram: spl_token_1.TOKEN_PROGRAM_ID })
+            .accounts({
+            ...accounts,
+            tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+            systemProgram: web3_js_1.SystemProgram.programId,
+        })
             .instruction();
     }
     async withdrawIx(accounts, args) {
@@ -104,6 +108,15 @@ class PoolClient {
         })
             .instruction();
     }
+    async sweepStrandedToInsuranceIx(accounts, args) {
+        return this.program.methods
+            .sweepStrandedToInsurance(new anchor_1.BN(args.amount.toString()))
+            .accounts({
+            ...accounts,
+            tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+        })
+            .instruction();
+    }
     async withdrawInsuranceIx(accounts, args) {
         return this.program.methods
             .withdrawInsurance(new anchor_1.BN(args.amount.toString()))

package/dist/types/index.d.ts

@@ -65,6 +65,8 @@ export interface MarketState {
     adlMaxHaircutBps?: number;
     adlMaxFeedDivergenceBps?: number;
     initialMarginBps?: number;
+    liqFeeBps?: number;
+    partialLiqTargetHealth?: number;
 }
 export interface Market {
     marketId: Uint8Array;
@@ -199,6 +201,7 @@ export interface StakingPool {
     emittedSoFar: bigint;
     lastUpdateTs: bigint;
     bump: number;
+    totalClaimed: bigint;
 }
 export interface StakePosition {
     pool: PublicKey;
@@ -292,6 +295,13 @@ export interface QueueDrainedEvent {
     marketId: Uint8Array;
     residualToTreasury: bigint;
 }
+export interface QueueLpDrawEvent {
+    marketId: Uint8Array;
+    idx: bigint;
+    owner: PublicKey;
+    amount: bigint;
+    totalUsdcAfter: bigint;
+}
 export interface PhantomCreditDrainedEvent {
     owner: PublicKey;
     marketId: Uint8Array;

package/dist/utils/pda.d.ts

@@ -3,6 +3,7 @@ export declare function poolStatePDA(marketId: Uint8Array, programId: PublicKey)
 export declare function vaultAuthorityPDA(marketId: Uint8Array, programId: PublicKey): [PublicKey, number];
 export declare function usdcVaultPDA(marketId: Uint8Array, programId: PublicKey): [PublicKey, number];
 export declare function lpMintPDA(marketId: Uint8Array, programId: PublicKey): [PublicKey, number];
+export declare function lpDeadPDA(marketId: Uint8Array, programId: PublicKey): [PublicKey, number];
 export declare function marketStatePDA(marketId: Uint8Array, programId: PublicKey): [PublicKey, number];
 export declare function positionPDA(owner: PublicKey, marketId: Uint8Array, nonce: bigint, programId: PublicKey): [PublicKey, number];
 export declare function tradingKeyPDA(wallet: PublicKey, programId: PublicKey): [PublicKey, number];

package/dist/utils/pda.js

@@ -4,6 +4,7 @@ exports.poolStatePDA = poolStatePDA;
 exports.vaultAuthorityPDA = vaultAuthorityPDA;
 exports.usdcVaultPDA = usdcVaultPDA;
 exports.lpMintPDA = lpMintPDA;
+exports.lpDeadPDA = lpDeadPDA;
 exports.marketStatePDA = marketStatePDA;
 exports.positionPDA = positionPDA;
 exports.tradingKeyPDA = tradingKeyPDA;
@@ -40,6 +41,9 @@ function usdcVaultPDA(marketId, programId) {
 function lpMintPDA(marketId, programId) {
     return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("lp_mint"), marketId instanceof Buffer ? marketId : Buffer.from(marketId)], programId);
 }
+function lpDeadPDA(marketId, programId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("lp_dead"), marketId instanceof Buffer ? marketId : Buffer.from(marketId)], programId);
+}
 function marketStatePDA(marketId, programId) {
     return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("market"), marketId instanceof Buffer ? marketId : Buffer.from(marketId)], programId);
 }

package/idl/perp_engine.json

@@ -267,7 +267,7 @@
         {
           "name": "lp_mint",
           "docs": [
-            "Ref 123 — pool-program reads these 3 from CPI remaining_accounts to",
+            "Followup #123 — pool-program reads these 3 from CPI remaining_accounts to",
             "decide whether lp_gain on a Treasury-routed losing close should be swept",
             "to insurance_vault (when lp_mint.supply == 0) instead of stranding in",
             "pool.total_usdc. Pool-program does all validation; perp-engine just",
@@ -996,7 +996,7 @@
         {
           "name": "lp_mint",
           "docs": [
-            "Ref 123 — pool-program's release_and_settle reads lp_mint.supply",
+            "Followup #123 — pool-program's release_and_settle reads lp_mint.supply",
             "to decide whether a Treasury-routed lp_gain should be swept to",
             "insurance_vault (lp_supply == 0) instead of stranding in pool.total_usdc.",
             "Pool-program verifies vs pool.lp_mint."
@@ -1214,6 +1214,98 @@
         }
       ]
     },
+    {
+      "name": "migrate_market_state_v4",
+      "docs": [
+        "MarketState V3 → V4 (2026-06-09): appends liq_fee_bps (default 2000 = 20%) +",
+        "partial_liq_target_health (default 0 = partial disabled) at offset 511. LEN 511→515."
+      ],
+      "discriminator": [
+        223,
+        134,
+        45,
+        244,
+        94,
+        137,
+        150,
+        101
+      ],
+      "accounts": [
+        {
+          "name": "market_state",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  109,
+                  97,
+                  114,
+                  107,
+                  101,
+                  116
+                ]
+              },
+              {
+                "kind": "arg",
+                "path": "market_id"
+              }
+            ]
+          }
+        },
+        {
+          "name": "protocol_config",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  112,
+                  114,
+                  111,
+                  116,
+                  111,
+                  99,
+                  111,
+                  108,
+                  95,
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "admin",
+          "writable": true,
+          "signer": true,
+          "relations": [
+            "protocol_config"
+          ]
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "market_id",
+          "type": {
+            "array": [
+              "u8",
+              32
+            ]
+          }
+        }
+      ]
+    },
     {
       "name": "migrate_protocol_config_v2",
       "discriminator": [
@@ -3057,6 +3149,14 @@
           {
             "name": "initial_margin_bps",
             "type": "u16"
+          },
+          {
+            "name": "liq_fee_bps",
+            "type": "u16"
+          },
+          {
+            "name": "partial_liq_target_health",
+            "type": "u16"
           }
         ]
       }
@@ -3338,6 +3438,15 @@
           {
             "name": "exit_price",
             "type": "u64"
+          },
+          {
+            "name": "funding_charge",
+            "docs": [
+              "Signed funding settled at close, 6-dec USDC. `> 0` = trader paid funding,",
+              "`< 0` = trader received it; subtracted from `net_return` on-chain. Appended",
+              "last so the field is byte-additive (old decoders read the prefix unchanged)."
+            ],
+            "type": "i64"
           }
         ]
       }
@@ -3530,7 +3639,7 @@
         "without joining against `PositionClosed` rows — `size_usdc` is the close",
         "notional (for `volumeReferred`), `amount` is the rebate (for",
         "`rebatesEarned`), and the trade-count aggregate is just `COUNT(*)` filtered",
-        "by `affiliate`. Closes ref 99 (path A — emit canonical event from the",
+        "by `affiliate`. Closes followup #99 (path A — emit canonical event from the",
         "rebate-credit site instead of polling AffiliateReward PDAs or approximating",
         "from referral-attribution PDAs)."
       ],
@@ -3847,6 +3956,18 @@
             "type": {
               "option": "u16"
             }
+          },
+          {
+            "name": "liq_fee_bps",
+            "type": {
+              "option": "u16"
+            }
+          },
+          {
+            "name": "partial_liq_target_health",
+            "type": {
+              "option": "u16"
+            }
           }
         ]
       }