@elemental-stv-core/sdk 0.5.0 → 0.6.0

package/dist/jlpd-strategy/swap-jlp.js

@@ -10,6 +10,7 @@ exports.buildSwapJlpTransaction = buildSwapJlpTransaction;
 exports.buildRebalanceTransaction = buildRebalanceTransaction;
 const web3_js_1 = require("@solana/web3.js");
 const spl_token_1 = require("@solana/spl-token");
+const ata_1 = require("../common/ata");
 const bn_js_1 = __importDefault(require("bn.js"));
 const constants_1 = require("./constants");
 const pda_1 = require("./pda");
@@ -26,15 +27,20 @@ const instructions_2 = require("../elemental-lend/instructions");
 // Helpers
 // ---------------------------------------------------------------------------
 const JUPITER_API_BASE = "https://api.jup.ag/swap/v1";
-/** Derive ATA address (same logic as @solana/spl-token getAssociatedTokenAddressSync) */
-function findAta(mint, owner, tokenProgram) {
-    const [ata] = web3_js_1.PublicKey.findProgramAddressSync([owner.toBuffer(), tokenProgram.toBuffer(), mint.toBuffer()], spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
-    return ata;
-}
+/**
+ * Optional Jupiter API key, read once at module load time. When set,
+ * outbound Jupiter requests include an `x-api-key` header for higher rate
+ * limits. Read once instead of per-call so the env var is consistent across
+ * the lifetime of the process.
+ */
+const JUPITER_API_KEY = process.env.NEXT_PUBLIC_JUPITER_API_KEY;
 function toBigInt(v) {
     if (typeof v === "bigint")
         return v;
-    return BigInt(v.toString());
+    const bn = v;
+    if (typeof bn.toBigInt === "function")
+        return bn.toBigInt();
+    return BigInt(bn.toString());
 }
 // ---------------------------------------------------------------------------
 // Low-level instruction builder
@@ -89,7 +95,6 @@ function createSwapJlpIx(args, programId = constants_1.PROGRAM_ID) {
  */
 async function getJupiterSwapQuote(args) {
     const { inputMint, outputMint, amount, slippageBps = 50, maxAccounts = 40 } = args;
-    const apiKey = process.env.NEXT_PUBLIC_JUPITER_API_KEY;
     const params = new URLSearchParams({
         inputMint: inputMint.toBase58(),
         outputMint: outputMint.toBase58(),
@@ -99,8 +104,8 @@ async function getJupiterSwapQuote(args) {
     });
     const url = `${JUPITER_API_BASE}/quote?${params.toString()}`;
     const headers = {};
-    if (apiKey) {
-        headers["x-api-key"] = apiKey;
+    if (JUPITER_API_KEY) {
+        headers["x-api-key"] = JUPITER_API_KEY;
     }
     const response = await fetch(url, { headers });
     if (!response.ok) {
@@ -121,7 +126,6 @@ async function getJupiterSwapQuote(args) {
  */
 async function getJupiterSwapInstructions(args) {
     const { quoteResponse, userPublicKey } = args;
-    const apiKey = process.env.NEXT_PUBLIC_JUPITER_API_KEY;
     const url = `${JUPITER_API_BASE}/swap-instructions`;
     const body = {
         quoteResponse,
@@ -133,8 +137,8 @@ async function getJupiterSwapInstructions(args) {
     const headers = {
         "Content-Type": "application/json",
     };
-    if (apiKey) {
-        headers["x-api-key"] = apiKey;
+    if (JUPITER_API_KEY) {
+        headers["x-api-key"] = JUPITER_API_KEY;
     }
     const response = await fetch(url, {
         method: "POST",
@@ -204,12 +208,12 @@ async function buildSwapJlpTransaction(args) {
     const { connection, manager, baseMint, direction, amount, slippageBps = 50, jlpMint = constants_1.JLP_MINT, tokenProgram = spl_token_1.TOKEN_PROGRAM_ID, programId = constants_1.PROGRAM_ID, } = args;
     // 1. Derive PDAs
     const [config] = (0, pda_1.findJlpdConfigPda)(programId);
-    const [managerRole] = (0, pda_1.findManagerRolePda)(config, manager, programId);
+    const [managerRole] = (0, pda_1.findJlpdManagerRolePda)(config, manager, programId);
     const [strategyState] = (0, pda_1.findStrategyStatePda)(baseMint, programId);
     // Derive ATAs
-    const strategyBaseAta = findAta(baseMint, strategyState, tokenProgram);
-    const strategyJlpAta = findAta(jlpMint, strategyState, tokenProgram);
-    const vaultJlpAta = findAta(jlpMint, config, tokenProgram);
+    const strategyBaseAta = (0, ata_1.findAta)(baseMint, strategyState, tokenProgram);
+    const strategyJlpAta = (0, ata_1.findAta)(jlpMint, strategyState, tokenProgram);
+    const vaultJlpAta = (0, ata_1.findAta)(jlpMint, config, tokenProgram);
     // 2. Determine input/output mints for the Jupiter quote
     const inputMint = direction === "BaseToJlp" ? baseMint : jlpMint;
     const outputMint = direction === "BaseToJlp" ? jlpMint : baseMint;
@@ -284,7 +288,7 @@ async function buildBaseToJlpRebalance(args) {
     const { connection, manager, baseMint, vaultId, amount, slippageBps, jlpMint, tokenProgram, programId, pStvProgramId, liquidity, } = args;
     // Derive JLPD PDAs
     const [strategyState] = (0, pda_1.findStrategyStatePda)(baseMint, programId);
-    const strategyBaseAta = findAta(baseMint, strategyState, tokenProgram);
+    const strategyBaseAta = (0, ata_1.findAta)(baseMint, strategyState, tokenProgram);
     // Check if strategy_base_ata already has enough
     let strategyBalance = liquidity?.strategyAtaBalance ?? 0n;
     if (!liquidity) {
@@ -320,7 +324,7 @@ async function buildBaseToJlpRebalance(args) {
     // Fetch STV on-chain for lend info
     const stv = await (0, accounts_2.fetchStv)(connection, vaultId, pStvProgramId);
     const [stvAddress] = (0, pda_2.findStvPda)(vaultId, pStvProgramId);
-    const [stvManagerRole] = (0, pda_2.findManagerRolePda)(stvAddress, manager, pStvProgramId);
+    const [stvManagerRole] = (0, pda_2.findStvManagerRolePda)(stvAddress, manager, pStvProgramId);
     // Build deposit_to_strategy remaining accounts (lend + auto-unroute)
     const vaultInfo = {
         address: stvAddress,
@@ -332,10 +336,12 @@ async function buildBaseToJlpRebalance(args) {
     const depositCtx = await (0, remaining_accounts_1.buildDepositToStrategyContext)(connection, vaultInfo);
     // Derive the JLPD strategy's position PDA in p-STV Core
     const [jlpdStvPosition] = (0, pda_1.findStvPositionPda)(stvAddress, programId);
-    const vaultAta = findAta(baseMint, stvAddress, tokenProgram);
+    const vaultAta = (0, ata_1.findAta)(baseMint, stvAddress, tokenProgram);
+    const [configPda] = (0, pda_2.findConfigPda)(pStvProgramId);
     const depositIx = (0, instructions_1.createDepositToStrategyIx)({
         manager,
         managerRole: stvManagerRole,
+        config: configPda,
         stv: stvAddress,
         vaultAta,
         baseMint,
@@ -346,6 +352,7 @@ async function buildBaseToJlpRebalance(args) {
         tokenProgram,
         amount: new bn_js_1.default(deficit.toString()),
         minShares: new bn_js_1.default(0),
+        protocolAumCount: depositCtx.protocolAumCount,
         autoUnrouteCount: depositCtx.autoUnrouteCount,
         remainingAccounts: depositCtx.remainingAccounts,
     }, pStvProgramId);
@@ -391,17 +398,17 @@ async function buildJlpToBaseRebalance(args) {
         sharesToWithdraw = positionShares;
     }
     // Build withdraw_from_strategy
-    const [stvManagerRole] = (0, pda_2.findManagerRolePda)(stvAddress, manager, pStvProgramId);
+    const [stvManagerRole] = (0, pda_2.findStvManagerRolePda)(stvAddress, manager, pStvProgramId);
     const [jlpdStvPosition] = (0, pda_1.findStvPositionPda)(stvAddress, programId);
-    const strategyBaseAta = findAta(baseMint, strategyState, tokenProgram);
-    const vaultAta = findAta(baseMint, stvAddress, tokenProgram);
+    const strategyBaseAta = (0, ata_1.findAta)(baseMint, strategyState, tokenProgram);
+    const vaultAta = (0, ata_1.findAta)(baseMint, stvAddress, tokenProgram);
     // Build lend remaining_accounts for auto-sweep after withdraw
     const lendAccounts = [];
     const DEFAULT_PUBKEY = web3_js_1.PublicKey.default;
     if (!stv.lendProgram.equals(DEFAULT_PUBKEY)) {
         const [lendStrategyState] = (0, pda_3.findStrategyStatePda)(baseMint, stv.lendProgram);
         const [lendPosition] = (0, pda_3.findStvPositionPda)(stvAddress, stv.lendProgram);
-        const lendBaseAta = findAta(baseMint, lendStrategyState, tokenProgram);
+        const lendBaseAta = (0, ata_1.findAta)(baseMint, lendStrategyState, tokenProgram);
         lendAccounts.push(...(0, instructions_1.buildLendRemainingAccounts)({
             lendProgram: stv.lendProgram,
             lendStrategyState,
@@ -409,9 +416,11 @@ async function buildJlpToBaseRebalance(args) {
             lendBaseAta,
         }));
     }
+    const [configPda] = (0, pda_2.findConfigPda)(pStvProgramId);
     const withdrawIx = (0, instructions_1.createWithdrawFromStrategyIx)({
         manager,
         managerRole: stvManagerRole,
+        config: configPda,
         stv: stvAddress,
         vaultAta,
         baseMint,
@@ -431,9 +440,9 @@ async function buildJlpToBaseRebalance(args) {
     if (!stv.lendProgram.equals(DEFAULT_PUBKEY) && jupPool) {
         const lendProgramId = stv.lendProgram;
         const [lendStrategyState] = (0, pda_3.findStrategyStatePda)(baseMint, lendProgramId);
-        const [lendManagerRole] = (0, pda_3.findManagerRolePda)(lendStrategyState, manager, lendProgramId);
-        const lendBaseAta = findAta(baseMint, lendStrategyState, tokenProgram);
-        const lendFtokenAta = findAta(jupPool.fTokenMint, lendStrategyState, tokenProgram);
+        const [lendManagerRole] = (0, pda_3.findLendManagerRolePda)(lendStrategyState, manager, lendProgramId);
+        const lendBaseAta = (0, ata_1.findAta)(baseMint, lendStrategyState, tokenProgram);
+        const lendFtokenAta = (0, ata_1.findAta)(jupPool.fTokenMint, lendStrategyState, tokenProgram);
         const JUP_LEND_PROG = new web3_js_1.PublicKey("jup3YeL8QhtSx1e253b2FDvsMNC87fDrgQZivbrndc9");
         const jupLendAccounts = [
             ...(0, jupiter_lend_1.buildJupLendDepositAccounts)(jupPool, lendStrategyState, lendBaseAta, lendFtokenAta).map((a) => ({ ...a, isSigner: false })),
@@ -462,4 +471,3 @@ async function buildJlpToBaseRebalance(args) {
             : "Swap JLP → base → withdraw to vault",
     };
 }
-//# sourceMappingURL=swap-jlp.js.map

package/dist/jlpd-strategy/types.d.ts

@@ -1,7 +1,7 @@
 import { PublicKey } from "@solana/web3.js";
 import BN from "bn.js";
 import type { StrategyStateHeader } from "../common/strategy-interface";
-/** JlpdConfig global config (272 bytes) */
+/** JlpdConfig global config (392 bytes) */
 export interface JlpdConfig {
     admin: PublicKey;
     jlpMint: PublicKey;
@@ -11,9 +11,11 @@ export interface JlpdConfig {
     jlpSlippageBps: number;
     version: number;
     bump: number;
+    /** JLP loaned to the JLPD Lend Adapter (not in vault ATA). Total JLP = vault_jlp_ata + jlpEarnAmount. */
+    jlpEarnAmount: BN;
+    /** Whitelisted adapter program. PublicKey.default = no adapter. */
+    jlpAdapterProgram: PublicKey;
 }
-/** @deprecated Use JlpdConfig instead */
-export type JLPVault = JlpdConfig;
 /** ManagerRole PDA (80 bytes) — grants manager access to rebalance operations */
 export interface ManagerRole {
     config: PublicKey;
@@ -53,4 +55,3 @@ export interface ManagerRemovedEvent {
     config: PublicKey;
     manager: PublicKey;
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/jlpd-strategy/types.js

@@ -1,3 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map

package/dist/p-stv-core/accounts.d.ts

@@ -1,17 +1,90 @@
-import { Connection, PublicKey } from "@solana/web3.js";
+import { PublicKey } from "@solana/web3.js";
 import BN from "bn.js";
+import type { SolanaConnection } from "../common/connection";
 import { GlobalConfig, Stv, WithdrawRequest, ManagerRole } from "./types";
+/**
+ * GlobalConfig — singleton protocol registry. Total 56 bytes.
+ *
+ * Layout (offsets include the 8-byte discriminator):
+ *   [  0..  8]  discriminator         (sha256("account:GlobalConfig")[..8])
+ *   [  8.. 40]  admin                  Pubkey
+ *   [ 40.. 48]  nextVaultId            u64
+ *   [ 48.. 50]  flags                  u16  (CFG_FLAG_*)
+ *   [ 50.. 51]  version                u8
+ *   [ 51.. 52]  bump                   u8
+ *   [ 52.. 56]  _padding               [u8; 4]
+ */
 export declare function deserializeGlobalConfig(data: Buffer): GlobalConfig;
+/**
+ * STV — per-vault state. Total 664 bytes.
+ *
+ * Layout (offsets include the 8-byte discriminator):
+ *   [  0..  8]  discriminator                (sha256("account:Stv")[..8])
+ *   [  8.. 40]  baseMint                      Pubkey
+ *   [ 40.. 72]  evMint                        Pubkey
+ *   [ 72..104]  strategy                      Pubkey   (legacy single-strategy slot)
+ *   [104..136]  feeReceiver                   Pubkey
+ *   [136..168]  lendProgram                   Pubkey   (zero pubkey if lend not opted-in)
+ *   [168..488]  strategies[10]                [Pubkey; 10]  (whitelisted strategy programs)
+ *   [488..496]  vaultId                       u64
+ *   [496..504]  reservedBase                  u64      (base reserved for pending claims)
+ *   [504..512]  requestedBase                 u64      (base requested via request_withdraw)
+ *   [512..520]  vaultCapacity                 u64      (0 = uncapped)
+ *   [520..528]  minDeposit                    u64
+ *   [528..536]  hwm                           u64      (high-water mark for perf fees)
+ *   [536..544]  lastFeeTs                     u64      (last fee crystallization timestamp)
+ *   [544..552]  epochPps                      u64      (locked PPS for current epoch claims)
+ *   [552..560]  lastNav                       u64      (snapshot for the rate-limit window)
+ *   [560..568]  dailyWithdrawnBase            u64      (rate-limit accumulator)
+ *   [568..572]  nextEpochTs                   u32
+ *   [572..576]  epochSec                      u32
+ *   [576..580]  currentEpochId                u32
+ *   [580..584]  pendingWithdrawals            u32
+ *   [584..588]  withdrawWindowStart           u32
+ *   [588..590]  mgmtFeeBps                    u16
+ *   [590..592]  perfFeeBps                    u16
+ *   [592..594]  flags                         u16      (FLAG_PAUSED / DEPOSITS_DISABLED / …)
+ *   [594..596]  dailyWithdrawLimitBps         u16
+ *   [596..597]  strategyCount                 u8
+ *   [597..598]  version                       u8
+ *   [598..599]  bump                          u8
+ *   [599..600]  _padding                      [u8; 1]
+ *   [600..664]  _reserved                     [u8; 64]
+ */
 export declare function deserializeStv(data: Buffer): Stv;
+/**
+ * WithdrawRequest — per-(STV, user, epoch) withdraw escrow. Total 168 bytes.
+ *
+ * Layout (offsets include the 8-byte discriminator):
+ *   [  0..  8]  discriminator           (sha256("account:WithdrawRequest")[..8])
+ *   [  8.. 40]  stv                      Pubkey
+ *   [ 40.. 72]  user                     Pubkey
+ *   [ 72.. 80]  shares                   u64
+ *   [ 80.. 88]  pps                      u64   (locked at process_epoch time)
+ *   [ 88.. 92]  epochId                  u32
+ *   [ 92.. 96]  claimAvailableAfter      u32   (unix seconds)
+ *   [ 96.. 97]  bump                     u8
+ *   [ 97..168]  _reserved                [u8; 71]
+ */
 export declare function deserializeWithdrawRequest(data: Buffer): WithdrawRequest;
+/**
+ * ManagerRole — per-(STV, manager) authorization record. Total 80 bytes.
+ *
+ * Layout (offsets include the 8-byte discriminator):
+ *   [  0..  8]  discriminator       (sha256("account:ManagerRole")[..8] —
+ *                                     shared with elemental-lend + jlpd-strategy)
+ *   [  8.. 40]  stv                  Pubkey
+ *   [ 40.. 72]  manager              Pubkey
+ *   [ 72.. 73]  bump                 u8
+ *   [ 73.. 80]  _padding             [u8; 7]
+ */
 export declare function deserializeManagerRole(data: Buffer): ManagerRole;
-export declare function fetchGlobalConfig(connection: Connection, programId?: PublicKey): Promise<GlobalConfig>;
-export declare function fetchStv(connection: Connection, vaultId: number | BN, programId?: PublicKey): Promise<Stv>;
-export declare function fetchStvByAddress(connection: Connection, address: PublicKey): Promise<Stv>;
-export declare function fetchWithdrawRequest(connection: Connection, stv: PublicKey, user: PublicKey, epochId: number, programId?: PublicKey): Promise<WithdrawRequest>;
-export declare function fetchWithdrawRequestByAddress(connection: Connection, address: PublicKey): Promise<WithdrawRequest>;
-export declare function fetchAllStvs(connection: Connection, programId?: PublicKey): Promise<[PublicKey, Stv][]>;
-export declare function fetchPendingWithdrawRequests(connection: Connection, stv: PublicKey, epochId: number, programId?: PublicKey): Promise<[PublicKey, WithdrawRequest][]>;
-export declare function fetchManagerRole(connection: Connection, stv: PublicKey, manager: PublicKey, programId?: PublicKey): Promise<ManagerRole | null>;
-export declare function fetchManagersForStv(connection: Connection, stv: PublicKey, programId?: PublicKey): Promise<[PublicKey, ManagerRole][]>;
-//# sourceMappingURL=accounts.d.ts.map
+export declare function fetchGlobalConfig(connection: SolanaConnection, programId?: PublicKey): Promise<GlobalConfig>;
+export declare function fetchStv(connection: SolanaConnection, vaultId: number | BN, programId?: PublicKey): Promise<Stv>;
+export declare function fetchStvByAddress(connection: SolanaConnection, address: PublicKey): Promise<Stv>;
+export declare function fetchWithdrawRequest(connection: SolanaConnection, stv: PublicKey, user: PublicKey, epochId: number, programId?: PublicKey): Promise<WithdrawRequest>;
+export declare function fetchWithdrawRequestByAddress(connection: SolanaConnection, address: PublicKey): Promise<WithdrawRequest>;
+export declare function fetchAllStvs(connection: SolanaConnection, programId?: PublicKey): Promise<[PublicKey, Stv][]>;
+export declare function fetchPendingWithdrawRequests(connection: SolanaConnection, stv: PublicKey, epochId: number, programId?: PublicKey): Promise<[PublicKey, WithdrawRequest][]>;
+export declare function fetchManagerRole(connection: SolanaConnection, stv: PublicKey, manager: PublicKey, programId?: PublicKey): Promise<ManagerRole | null>;
+export declare function fetchManagersForStv(connection: SolanaConnection, stv: PublicKey, programId?: PublicKey): Promise<[PublicKey, ManagerRole][]>;

package/dist/p-stv-core/accounts.js

@@ -18,7 +18,25 @@ const constants_1 = require("./constants");
 const pda_1 = require("./pda");
 // ---------------------------------------------------------------------------
 // Deserialization
+//
+// All offsets below INCLUDE the 8-byte Anchor account discriminator. Layout
+// blocks above each parser show the field map; the helpers in
+// `common/buffer.ts` validate that `offset + width <= data.length` so a
+// drift between this file and the on-chain layout fails loudly with a
+// `RangeError` rather than returning garbage.
 // ---------------------------------------------------------------------------
+/**
+ * GlobalConfig — singleton protocol registry. Total 56 bytes.
+ *
+ * Layout (offsets include the 8-byte discriminator):
+ *   [  0..  8]  discriminator         (sha256("account:GlobalConfig")[..8])
+ *   [  8.. 40]  admin                  Pubkey
+ *   [ 40.. 48]  nextVaultId            u64
+ *   [ 48.. 50]  flags                  u16  (CFG_FLAG_*)
+ *   [ 50.. 51]  version                u8
+ *   [ 51.. 52]  bump                   u8
+ *   [ 52.. 56]  _padding               [u8; 4]
+ */
 function deserializeGlobalConfig(data) {
     if (data.length < constants_1.GLOBAL_CONFIG_SIZE) {
         throw new Error(`GlobalConfig data too short: ${data.length} < ${constants_1.GLOBAL_CONFIG_SIZE}`);
@@ -35,6 +53,42 @@ function deserializeGlobalConfig(data) {
         bump: (0, buffer_1.readU8)(data, 51),
     };
 }
+/**
+ * STV — per-vault state. Total 664 bytes.
+ *
+ * Layout (offsets include the 8-byte discriminator):
+ *   [  0..  8]  discriminator                (sha256("account:Stv")[..8])
+ *   [  8.. 40]  baseMint                      Pubkey
+ *   [ 40.. 72]  evMint                        Pubkey
+ *   [ 72..104]  strategy                      Pubkey   (legacy single-strategy slot)
+ *   [104..136]  feeReceiver                   Pubkey
+ *   [136..168]  lendProgram                   Pubkey   (zero pubkey if lend not opted-in)
+ *   [168..488]  strategies[10]                [Pubkey; 10]  (whitelisted strategy programs)
+ *   [488..496]  vaultId                       u64
+ *   [496..504]  reservedBase                  u64      (base reserved for pending claims)
+ *   [504..512]  requestedBase                 u64      (base requested via request_withdraw)
+ *   [512..520]  vaultCapacity                 u64      (0 = uncapped)
+ *   [520..528]  minDeposit                    u64
+ *   [528..536]  hwm                           u64      (high-water mark for perf fees)
+ *   [536..544]  lastFeeTs                     u64      (last fee crystallization timestamp)
+ *   [544..552]  epochPps                      u64      (locked PPS for current epoch claims)
+ *   [552..560]  lastNav                       u64      (snapshot for the rate-limit window)
+ *   [560..568]  dailyWithdrawnBase            u64      (rate-limit accumulator)
+ *   [568..572]  nextEpochTs                   u32
+ *   [572..576]  epochSec                      u32
+ *   [576..580]  currentEpochId                u32
+ *   [580..584]  pendingWithdrawals            u32
+ *   [584..588]  withdrawWindowStart           u32
+ *   [588..590]  mgmtFeeBps                    u16
+ *   [590..592]  perfFeeBps                    u16
+ *   [592..594]  flags                         u16      (FLAG_PAUSED / DEPOSITS_DISABLED / …)
+ *   [594..596]  dailyWithdrawLimitBps         u16
+ *   [596..597]  strategyCount                 u8
+ *   [597..598]  version                       u8
+ *   [598..599]  bump                          u8
+ *   [599..600]  _padding                      [u8; 1]
+ *   [600..664]  _reserved                     [u8; 64]
+ */
 function deserializeStv(data) {
     if (data.length < constants_1.STV_SIZE) {
         throw new Error(`Stv data too short: ${data.length} < ${constants_1.STV_SIZE}`);
@@ -44,7 +98,7 @@ function deserializeStv(data) {
         throw new Error(`Invalid Stv discriminator`);
     }
     const strategies = [];
-    for (let i = 0; i < 10; i++) {
+    for (let i = 0; i < constants_1.MAX_STRATEGIES; i++) {
         strategies.push((0, buffer_1.readPubkey)(data, 168 + i * 32));
     }
     return {
@@ -78,6 +132,20 @@ function deserializeStv(data) {
         bump: (0, buffer_1.readU8)(data, 598),
     };
 }
+/**
+ * WithdrawRequest — per-(STV, user, epoch) withdraw escrow. Total 168 bytes.
+ *
+ * Layout (offsets include the 8-byte discriminator):
+ *   [  0..  8]  discriminator           (sha256("account:WithdrawRequest")[..8])
+ *   [  8.. 40]  stv                      Pubkey
+ *   [ 40.. 72]  user                     Pubkey
+ *   [ 72.. 80]  shares                   u64
+ *   [ 80.. 88]  pps                      u64   (locked at process_epoch time)
+ *   [ 88.. 92]  epochId                  u32
+ *   [ 92.. 96]  claimAvailableAfter      u32   (unix seconds)
+ *   [ 96.. 97]  bump                     u8
+ *   [ 97..168]  _reserved                [u8; 71]
+ */
 function deserializeWithdrawRequest(data) {
     if (data.length < constants_1.WITHDRAW_REQUEST_SIZE) {
         throw new Error(`WithdrawRequest data too short: ${data.length} < ${constants_1.WITHDRAW_REQUEST_SIZE}`);
@@ -96,6 +164,17 @@ function deserializeWithdrawRequest(data) {
         bump: (0, buffer_1.readU8)(data, 96),
     };
 }
+/**
+ * ManagerRole — per-(STV, manager) authorization record. Total 80 bytes.
+ *
+ * Layout (offsets include the 8-byte discriminator):
+ *   [  0..  8]  discriminator       (sha256("account:ManagerRole")[..8] —
+ *                                     shared with elemental-lend + jlpd-strategy)
+ *   [  8.. 40]  stv                  Pubkey
+ *   [ 40.. 72]  manager              Pubkey
+ *   [ 72.. 73]  bump                 u8
+ *   [ 73.. 80]  _padding             [u8; 7]
+ */
 function deserializeManagerRole(data) {
     if (data.length < constants_1.MANAGER_ROLE_SIZE) {
         throw new Error(`ManagerRole data too short: ${data.length} < ${constants_1.MANAGER_ROLE_SIZE}`);
@@ -165,14 +244,14 @@ async function fetchPendingWithdrawRequests(connection, stv, epochId, programId
         filters: [
             { dataSize: constants_1.WITHDRAW_REQUEST_SIZE },
             { memcmp: { offset: 0, bytes: constants_1.DISC_WITHDRAW_REQUEST.toString("base64"), encoding: "base64" } },
-            { memcmp: { offset: 8, bytes: stv.toBase58() } },
+            { memcmp: { offset: 8, bytes: stv.toBuffer().toString("base64"), encoding: "base64" } },
             { memcmp: { offset: 88, bytes: epochBuf.toString("base64"), encoding: "base64" } },
         ],
     });
     return accounts.map((a) => [a.pubkey, deserializeWithdrawRequest(a.account.data)]);
 }
 async function fetchManagerRole(connection, stv, manager, programId = constants_1.PROGRAM_ID) {
-    const [pda] = (0, pda_1.findManagerRolePda)(stv, manager, programId);
+    const [pda] = (0, pda_1.findStvManagerRolePda)(stv, manager, programId);
     const info = await connection.getAccountInfo(pda);
     if (!info)
         return null;
@@ -183,9 +262,8 @@ async function fetchManagersForStv(connection, stv, programId = constants_1.PROG
         filters: [
             { dataSize: constants_1.MANAGER_ROLE_SIZE },
             { memcmp: { offset: 0, bytes: constants_1.DISC_MANAGER_ROLE.toString("base64"), encoding: "base64" } },
-            { memcmp: { offset: 8, bytes: stv.toBase58() } },
+            { memcmp: { offset: 8, bytes: stv.toBuffer().toString("base64"), encoding: "base64" } },
         ],
     });
     return accounts.map((a) => [a.pubkey, deserializeManagerRole(a.account.data)]);
 }
-//# sourceMappingURL=accounts.js.map

package/dist/p-stv-core/constants.d.ts

@@ -8,7 +8,7 @@ export declare const MANAGER_SEED: Buffer<ArrayBuffer>;
 export declare const DISC_GLOBAL_CONFIG: Buffer<ArrayBuffer>;
 export declare const DISC_STV: Buffer<ArrayBuffer>;
 export declare const DISC_WITHDRAW_REQUEST: Buffer<ArrayBuffer>;
-export declare const DISC_MANAGER_ROLE: Buffer<ArrayBuffer>;
+export { DISC_MANAGER_ROLE } from "../common/constants";
 export declare const IX_INIT_OR_UPDATE_CONFIG = 0;
 export declare const IX_INIT_OR_UPDATE_STV = 1;
 export declare const IX_DEPOSIT = 2;
@@ -21,6 +21,7 @@ export declare const IX_CLOSE_STV = 8;
 export declare const IX_ADD_MANAGER = 9;
 export declare const IX_REMOVE_MANAGER = 10;
 export declare const IX_OVERRIDE_CLAIM_WITHDRAW = 11;
+export declare const IX_MIGRATE_LEND = 12;
 export declare const EVT_CONFIG_INITIALIZED = 0;
 export declare const EVT_CONFIG_UPDATED = 1;
 export declare const EVT_STV_CREATED = 2;
@@ -38,13 +39,22 @@ export declare const EVT_STV_CLOSED = 13;
 export declare const EVT_MANAGER_ADDED = 14;
 export declare const EVT_MANAGER_REMOVED = 15;
 export declare const EVT_WITHDRAW_OVERRIDE_CLAIMED = 16;
+export declare const EVT_LEND_MIGRATED = 17;
 export declare const FLAG_PAUSED = 1;
 export declare const FLAG_DEPOSITS_DISABLED = 2;
 export declare const FLAG_WITHDRAWALS_DISABLED = 4;
 export declare const FLAG_REBALANCE_DISABLED = 8;
 export declare const FLAG_TEST_MODE = 16;
 export declare const FLAG_ALLOCATOR = 32;
-export declare const CFG_FLAG_ADMIN_LOCKED = 1;
+/**
+ * Protocol-wide emergency pause. When set on `GlobalConfig.flags`, blocks
+ * every value-movement instruction across every STV (deposit, request/claim
+ * withdraw, process_epoch, deposit/withdraw_from_strategy,
+ * override_claim_withdraw). Admin/rescue paths
+ * (init_or_update_config, init_or_update_stv, close_stv, add/remove_manager)
+ * remain open so the admin can reconfigure and clear the pause.
+ */
+export declare const CFG_FLAG_GLOBAL_PAUSED = 1;
 export { PPS_DECIMALS, BPS_DENOMINATOR, STALENESS_THRESHOLD } from "../common/constants";
 export declare const MAX_STRATEGIES = 10;
 export declare const FEE_CAP_BPS = 9900;
@@ -52,4 +62,3 @@ export declare const GLOBAL_CONFIG_SIZE = 56;
 export declare const STV_SIZE = 664;
 export declare const WITHDRAW_REQUEST_SIZE = 168;
 export declare const MANAGER_ROLE_SIZE = 80;
-//# sourceMappingURL=constants.d.ts.map

package/dist/p-stv-core/constants.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_STRATEGIES = exports.STALENESS_THRESHOLD = exports.BPS_DENOMINATOR = exports.PPS_DECIMALS = exports.CFG_FLAG_ADMIN_LOCKED = exports.FLAG_ALLOCATOR = exports.FLAG_TEST_MODE = exports.FLAG_REBALANCE_DISABLED = exports.FLAG_WITHDRAWALS_DISABLED = exports.FLAG_DEPOSITS_DISABLED = exports.FLAG_PAUSED = exports.EVT_WITHDRAW_OVERRIDE_CLAIMED = exports.EVT_MANAGER_REMOVED = exports.EVT_MANAGER_ADDED = exports.EVT_STV_CLOSED = exports.EVT_FEES_SETTLED = exports.EVT_EPOCH_ADVANCED = exports.EVT_EPOCH_PROCESSED = exports.EVT_WITHDRAWN_FROM_STRATEGY = exports.EVT_DEPOSITED_TO_STRATEGY = exports.EVT_WITHDRAW_CLAIMED = exports.EVT_WITHDRAW_REQUEST_INCREASED = exports.EVT_WITHDRAW_REQUESTED = exports.EVT_DEPOSITED = exports.EVT_STV_UPDATED = exports.EVT_STV_CREATED = exports.EVT_CONFIG_UPDATED = exports.EVT_CONFIG_INITIALIZED = exports.IX_OVERRIDE_CLAIM_WITHDRAW = exports.IX_REMOVE_MANAGER = exports.IX_ADD_MANAGER = exports.IX_CLOSE_STV = exports.IX_WITHDRAW_FROM_STRATEGY = exports.IX_DEPOSIT_TO_STRATEGY = exports.IX_PROCESS_EPOCH = exports.IX_CLAIM_WITHDRAW = exports.IX_REQUEST_WITHDRAW = exports.IX_DEPOSIT = exports.IX_INIT_OR_UPDATE_STV = exports.IX_INIT_OR_UPDATE_CONFIG = exports.DISC_MANAGER_ROLE = exports.DISC_WITHDRAW_REQUEST = exports.DISC_STV = exports.DISC_GLOBAL_CONFIG = exports.MANAGER_SEED = exports.WITHDRAW_REQUEST_SEED = exports.EV_MINT_SEED = exports.STV_SEED = exports.CONFIG_SEED = exports.PROGRAM_ID = void 0;
-exports.MANAGER_ROLE_SIZE = exports.WITHDRAW_REQUEST_SIZE = exports.STV_SIZE = exports.GLOBAL_CONFIG_SIZE = exports.FEE_CAP_BPS = void 0;
+exports.BPS_DENOMINATOR = exports.PPS_DECIMALS = exports.CFG_FLAG_GLOBAL_PAUSED = exports.FLAG_ALLOCATOR = exports.FLAG_TEST_MODE = exports.FLAG_REBALANCE_DISABLED = exports.FLAG_WITHDRAWALS_DISABLED = exports.FLAG_DEPOSITS_DISABLED = exports.FLAG_PAUSED = exports.EVT_LEND_MIGRATED = exports.EVT_WITHDRAW_OVERRIDE_CLAIMED = exports.EVT_MANAGER_REMOVED = exports.EVT_MANAGER_ADDED = exports.EVT_STV_CLOSED = exports.EVT_FEES_SETTLED = exports.EVT_EPOCH_ADVANCED = exports.EVT_EPOCH_PROCESSED = exports.EVT_WITHDRAWN_FROM_STRATEGY = exports.EVT_DEPOSITED_TO_STRATEGY = exports.EVT_WITHDRAW_CLAIMED = exports.EVT_WITHDRAW_REQUEST_INCREASED = exports.EVT_WITHDRAW_REQUESTED = exports.EVT_DEPOSITED = exports.EVT_STV_UPDATED = exports.EVT_STV_CREATED = exports.EVT_CONFIG_UPDATED = exports.EVT_CONFIG_INITIALIZED = exports.IX_MIGRATE_LEND = exports.IX_OVERRIDE_CLAIM_WITHDRAW = exports.IX_REMOVE_MANAGER = exports.IX_ADD_MANAGER = exports.IX_CLOSE_STV = exports.IX_WITHDRAW_FROM_STRATEGY = exports.IX_DEPOSIT_TO_STRATEGY = exports.IX_PROCESS_EPOCH = exports.IX_CLAIM_WITHDRAW = exports.IX_REQUEST_WITHDRAW = exports.IX_DEPOSIT = exports.IX_INIT_OR_UPDATE_STV = exports.IX_INIT_OR_UPDATE_CONFIG = exports.DISC_MANAGER_ROLE = exports.DISC_WITHDRAW_REQUEST = exports.DISC_STV = exports.DISC_GLOBAL_CONFIG = exports.MANAGER_SEED = exports.WITHDRAW_REQUEST_SEED = exports.EV_MINT_SEED = exports.STV_SEED = exports.CONFIG_SEED = exports.PROGRAM_ID = void 0;
+exports.MANAGER_ROLE_SIZE = exports.WITHDRAW_REQUEST_SIZE = exports.STV_SIZE = exports.GLOBAL_CONFIG_SIZE = exports.FEE_CAP_BPS = exports.MAX_STRATEGIES = exports.STALENESS_THRESHOLD = void 0;
 const web3_js_1 = require("@solana/web3.js");
 // ---------------------------------------------------------------------------
 // Program ID
@@ -27,9 +27,9 @@ exports.DISC_STV = Buffer.from([
 exports.DISC_WITHDRAW_REQUEST = Buffer.from([
     0xba, 0xef, 0xae, 0xbf, 0xbd, 0x0d, 0x2f, 0xc4,
 ]);
-exports.DISC_MANAGER_ROLE = Buffer.from([
-    0x25, 0xe8, 0x64, 0xe9, 0xaa, 0xe9, 0xdb, 0xb9,
-]);
+// Shared with elemental-lend and jlpd-strategy — defined once in common/
+var constants_1 = require("../common/constants");
+Object.defineProperty(exports, "DISC_MANAGER_ROLE", { enumerable: true, get: function () { return constants_1.DISC_MANAGER_ROLE; } });
 // ---------------------------------------------------------------------------
 // Instruction Discriminators (1-byte)
 // ---------------------------------------------------------------------------
@@ -45,6 +45,7 @@ exports.IX_CLOSE_STV = 8;
 exports.IX_ADD_MANAGER = 9;
 exports.IX_REMOVE_MANAGER = 10;
 exports.IX_OVERRIDE_CLAIM_WITHDRAW = 11;
+exports.IX_MIGRATE_LEND = 12;
 // ---------------------------------------------------------------------------
 // Event Discriminators (1-byte)
 // ---------------------------------------------------------------------------
@@ -65,6 +66,7 @@ exports.EVT_STV_CLOSED = 13;
 exports.EVT_MANAGER_ADDED = 14;
 exports.EVT_MANAGER_REMOVED = 15;
 exports.EVT_WITHDRAW_OVERRIDE_CLAIMED = 16;
+exports.EVT_LEND_MIGRATED = 17;
 // ---------------------------------------------------------------------------
 // Vault Flags
 // ---------------------------------------------------------------------------
@@ -76,14 +78,22 @@ exports.FLAG_REBALANCE_DISABLED = 0x0008;
 exports.FLAG_TEST_MODE = 0x0010;
 exports.FLAG_ALLOCATOR = 0x0020;
 // GlobalConfig flags
-exports.CFG_FLAG_ADMIN_LOCKED = 0x0001;
+/**
+ * Protocol-wide emergency pause. When set on `GlobalConfig.flags`, blocks
+ * every value-movement instruction across every STV (deposit, request/claim
+ * withdraw, process_epoch, deposit/withdraw_from_strategy,
+ * override_claim_withdraw). Admin/rescue paths
+ * (init_or_update_config, init_or_update_stv, close_stv, add/remove_manager)
+ * remain open so the admin can reconfigure and clear the pause.
+ */
+exports.CFG_FLAG_GLOBAL_PAUSED = 0x0001;
 // ---------------------------------------------------------------------------
 // Protocol Constants
 // ---------------------------------------------------------------------------
-var constants_1 = require("../common/constants");
-Object.defineProperty(exports, "PPS_DECIMALS", { enumerable: true, get: function () { return constants_1.PPS_DECIMALS; } });
-Object.defineProperty(exports, "BPS_DENOMINATOR", { enumerable: true, get: function () { return constants_1.BPS_DENOMINATOR; } });
-Object.defineProperty(exports, "STALENESS_THRESHOLD", { enumerable: true, get: function () { return constants_1.STALENESS_THRESHOLD; } });
+var constants_2 = require("../common/constants");
+Object.defineProperty(exports, "PPS_DECIMALS", { enumerable: true, get: function () { return constants_2.PPS_DECIMALS; } });
+Object.defineProperty(exports, "BPS_DENOMINATOR", { enumerable: true, get: function () { return constants_2.BPS_DENOMINATOR; } });
+Object.defineProperty(exports, "STALENESS_THRESHOLD", { enumerable: true, get: function () { return constants_2.STALENESS_THRESHOLD; } });
 exports.MAX_STRATEGIES = 10;
 exports.FEE_CAP_BPS = 9900;
 // ---------------------------------------------------------------------------
@@ -93,4 +103,3 @@ exports.GLOBAL_CONFIG_SIZE = 56;
 exports.STV_SIZE = 664;
 exports.WITHDRAW_REQUEST_SIZE = 168;
 exports.MANAGER_ROLE_SIZE = 80;
-//# sourceMappingURL=constants.js.map

package/dist/p-stv-core/events.d.ts

@@ -5,4 +5,3 @@ import type { StvEvent } from "./types";
  * p-stv-core uses 1-byte event discriminators via sol_log_data.
  */
 export declare function parseEventsFromLogs(logs: string[], programId?: PublicKey): StvEvent[];
-//# sourceMappingURL=events.d.ts.map

package/dist/p-stv-core/events.js

@@ -40,6 +40,45 @@ function parseEventsFromLogs(logs, programId = constants_1.PROGRAM_ID) {
     }
     return events;
 }
+/**
+ * p-stv-core event payload layout reference (offsets are within the
+ * `Program data: …` log buffer; see also `EVT_*` discriminators in
+ * `constants.ts`):
+ *
+ *   ConfigInitialized           [0..1] disc | [1..33]  admin
+ *   ConfigUpdated               [0..1] disc | [1..33]  admin     | [33..35] flags
+ *   StvCreated                  [0..1] disc | [1..9]  vaultId    | [9..41]  baseMint     |
+ *                               [41..73] evMint | [73..105] feeReceiver | [105..137] strategy |
+ *                               [137..169] lendProgram | [169..173] epochSec |
+ *                               [173..175] mgmtFeeBps | [175..177] perfFeeBps
+ *   StvUpdated                  [0..1] disc | [1..9]  vaultId    | [9..41]  feeReceiver  |
+ *                               [41..43] flags | [43..45] mgmtFeeBps | [45..47] perfFeeBps |
+ *                               [47..55] vaultCapacity | [55..63] minDeposit |
+ *                               [63..64] strategyCount | [64..96] lendProgram
+ *   Deposited                   [0..1] disc | [1..9]  vaultId    | [9..41]  user         |
+ *                               [41..49] amount | [49..57] sharesMinted | [57..65] pps
+ *   WithdrawRequested           [0..1] disc | [1..9]  vaultId    | [9..41]  user         |
+ *                               [41..49] shares | [49..53] epochId
+ *   WithdrawRequestIncreased    [0..1] disc | [1..9]  vaultId    | [9..41]  user         |
+ *                               [41..49] additionalShares | [49..57] totalShares |
+ *                               [57..61] epochId
+ *   WithdrawClaimed             [0..1] disc | [1..9]  vaultId    | [9..41]  user         |
+ *                               [41..49] shares | [49..57] baseAmount | [57..61] epochId
+ *   DepositedToStrategy         [0..1] disc | [1..9]  vaultId    | [9..41]  strategy     |
+ *                               [41..49] amount | [49..57] sharesReceived
+ *   WithdrawnFromStrategy       [0..1] disc | [1..9]  vaultId    | [9..41]  strategy     |
+ *                               [41..49] shares | [49..57] baseReceived
+ *   EpochProcessed              [0..1] disc | [1..9]  vaultId    | [9..13]  epochId      |
+ *                               [13..21] epochPps | [21..29] feeSharesMinted
+ *   EpochAdvanced               [0..1] disc | [1..9]  vaultId    | [9..13]  newEpochId   |
+ *                               [13..17] nextEpochTs
+ *   FeesSettled                 [0..1] disc | [1..9]  vaultId    | [9..17]  mgmtFeeBase  |
+ *                               [17..25] perfFeeBase | [25..33] feeSharesMinted |
+ *                               [33..41] postFeePps | [41..49] hwm
+ *   StvClosed                   [0..1] disc | [1..9]  vaultId
+ *   ManagerAdded                [0..1] disc | [1..33] stv        | [33..65] manager
+ *   ManagerRemoved              [0..1] disc | [1..33] stv        | [33..65] manager
+ */
 function parseEventBuffer(data) {
     if (data.length === 0)
         return null;
@@ -120,8 +159,18 @@ function parseEventBuffer(data) {
             return data.length >= 65 ? {
                 name: "ManagerRemoved", stv: (0, buffer_1.readPubkey)(data, 1), manager: (0, buffer_1.readPubkey)(data, 33),
             } : null;
+        case constants_1.EVT_WITHDRAW_OVERRIDE_CLAIMED:
+            return data.length >= 109 ? {
+                name: "WithdrawOverrideClaimed", vaultId: (0, buffer_1.readU64)(data, 1), manager: (0, buffer_1.readPubkey)(data, 9),
+                user: (0, buffer_1.readPubkey)(data, 41), shares: (0, buffer_1.readU64)(data, 73), baseAmount: (0, buffer_1.readU64)(data, 81),
+                epochId: (0, buffer_1.readU32)(data, 89), dailyWithdrawnBase: (0, buffer_1.readU64)(data, 93), dailyLimit: (0, buffer_1.readU64)(data, 101),
+            } : null;
+        case constants_1.EVT_LEND_MIGRATED:
+            return data.length >= 89 ? {
+                name: "LendMigrated", vaultId: (0, buffer_1.readU64)(data, 1), oldLendProgram: (0, buffer_1.readPubkey)(data, 9),
+                newLendProgram: (0, buffer_1.readPubkey)(data, 41), sharesWithdrawn: (0, buffer_1.readU64)(data, 73), baseMigrated: (0, buffer_1.readU64)(data, 81),
+            } : null;
         default:
             return null;
     }
 }
-//# sourceMappingURL=events.js.map