@elemental-stv-core/sdk 0.5.0 → 0.7.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,22 +324,23 @@ 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,
         baseMint,
         lendProgram: stv.lendProgram,
-        strategies: stv.strategies,
-        strategyCount: stv.strategyCount,
+        strategy: stv.strategy,
     };
     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 +351,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 +397,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 +415,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 +439,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 +470,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 (v2 layout).
+ *
+ * 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   (immutable strategy program)
+ *   [104..136]  feeReceiver                   Pubkey
+ *   [136..168]  lendProgram                   Pubkey   (zero pubkey if lend not opted-in)
+ *   [168..248]  childVaults[10]               [u64; 10]  (allocator child vault IDs)
+ *   [248..256]  vaultId                       u64
+ *   [256..264]  reservedBase                  u64      (base reserved for pending claims)
+ *   [264..272]  requestedBase                 u64      (base requested via request_withdraw)
+ *   [272..280]  vaultCapacity                 u64      (0 = uncapped)
+ *   [280..288]  minDeposit                    u64
+ *   [288..296]  hwm                           u64      (high-water mark for perf fees)
+ *   [296..304]  lastFeeTs                     u64      (last fee crystallization timestamp)
+ *   [304..312]  epochPps                      u64      (locked PPS for current epoch claims)
+ *   [312..320]  lastNav                       u64      (snapshot for the rate-limit window)
+ *   [320..328]  dailyWithdrawnBase            u64      (rate-limit accumulator)
+ *   [328..332]  nextEpochTs                   u32
+ *   [332..336]  epochSec                      u32
+ *   [336..340]  currentEpochId                u32
+ *   [340..344]  pendingWithdrawals            u32
+ *   [344..348]  withdrawWindowStart           u32
+ *   [348..350]  mgmtFeeBps                    u16
+ *   [350..352]  perfFeeBps                    u16
+ *   [352..354]  flags                         u16      (FLAG_PAUSED / DEPOSITS_DISABLED / …)
+ *   [354..356]  dailyWithdrawLimitBps         u16
+ *   [356..357]  childVaultCount               u8
+ *   [357..358]  version                       u8
+ *   [358..359]  bump                          u8
+ *   [359..360]  _padding                      [u8; 1]
+ *   [360..664]  _reserved                     [u8; 304]
+ */
 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 (v2 layout).
+ *
+ * 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   (immutable strategy program)
+ *   [104..136]  feeReceiver                   Pubkey
+ *   [136..168]  lendProgram                   Pubkey   (zero pubkey if lend not opted-in)
+ *   [168..248]  childVaults[10]               [u64; 10]  (allocator child vault IDs)
+ *   [248..256]  vaultId                       u64
+ *   [256..264]  reservedBase                  u64      (base reserved for pending claims)
+ *   [264..272]  requestedBase                 u64      (base requested via request_withdraw)
+ *   [272..280]  vaultCapacity                 u64      (0 = uncapped)
+ *   [280..288]  minDeposit                    u64
+ *   [288..296]  hwm                           u64      (high-water mark for perf fees)
+ *   [296..304]  lastFeeTs                     u64      (last fee crystallization timestamp)
+ *   [304..312]  epochPps                      u64      (locked PPS for current epoch claims)
+ *   [312..320]  lastNav                       u64      (snapshot for the rate-limit window)
+ *   [320..328]  dailyWithdrawnBase            u64      (rate-limit accumulator)
+ *   [328..332]  nextEpochTs                   u32
+ *   [332..336]  epochSec                      u32
+ *   [336..340]  currentEpochId                u32
+ *   [340..344]  pendingWithdrawals            u32
+ *   [344..348]  withdrawWindowStart           u32
+ *   [348..350]  mgmtFeeBps                    u16
+ *   [350..352]  perfFeeBps                    u16
+ *   [352..354]  flags                         u16      (FLAG_PAUSED / DEPOSITS_DISABLED / …)
+ *   [354..356]  dailyWithdrawLimitBps         u16
+ *   [356..357]  childVaultCount               u8
+ *   [357..358]  version                       u8
+ *   [358..359]  bump                          u8
+ *   [359..360]  _padding                      [u8; 1]
+ *   [360..664]  _reserved                     [u8; 304]
+ */
 function deserializeStv(data) {
     if (data.length < constants_1.STV_SIZE) {
         throw new Error(`Stv data too short: ${data.length} < ${constants_1.STV_SIZE}`);
@@ -43,9 +97,9 @@ function deserializeStv(data) {
     if (!disc.equals(constants_1.DISC_STV)) {
         throw new Error(`Invalid Stv discriminator`);
     }
-    const strategies = [];
-    for (let i = 0; i < 10; i++) {
-        strategies.push((0, buffer_1.readPubkey)(data, 168 + i * 32));
+    const childVaults = [];
+    for (let i = 0; i < constants_1.MAX_STRATEGIES; i++) {
+        childVaults.push((0, buffer_1.readU64)(data, 168 + i * 8));
     }
     return {
         baseMint: (0, buffer_1.readPubkey)(data, 8),
@@ -53,31 +107,45 @@ function deserializeStv(data) {
         strategy: (0, buffer_1.readPubkey)(data, 72),
         feeReceiver: (0, buffer_1.readPubkey)(data, 104),
         lendProgram: (0, buffer_1.readPubkey)(data, 136),
-        strategies,
-        vaultId: (0, buffer_1.readU64)(data, 488),
-        reservedBase: (0, buffer_1.readU64)(data, 496),
-        requestedBase: (0, buffer_1.readU64)(data, 504),
-        vaultCapacity: (0, buffer_1.readU64)(data, 512),
-        minDeposit: (0, buffer_1.readU64)(data, 520),
-        hwm: (0, buffer_1.readU64)(data, 528),
-        lastFeeTs: (0, buffer_1.readU64)(data, 536),
-        epochPps: (0, buffer_1.readU64)(data, 544),
-        lastNav: (0, buffer_1.readU64)(data, 552),
-        dailyWithdrawnBase: (0, buffer_1.readU64)(data, 560),
-        nextEpochTs: (0, buffer_1.readU32)(data, 568),
-        epochSec: (0, buffer_1.readU32)(data, 572),
-        currentEpochId: (0, buffer_1.readU32)(data, 576),
-        pendingWithdrawals: (0, buffer_1.readU32)(data, 580),
-        withdrawWindowStart: (0, buffer_1.readU32)(data, 584),
-        mgmtFeeBps: (0, buffer_1.readU16)(data, 588),
-        perfFeeBps: (0, buffer_1.readU16)(data, 590),
-        flags: (0, buffer_1.readU16)(data, 592),
-        dailyWithdrawLimitBps: (0, buffer_1.readU16)(data, 594),
-        strategyCount: (0, buffer_1.readU8)(data, 596),
-        version: (0, buffer_1.readU8)(data, 597),
-        bump: (0, buffer_1.readU8)(data, 598),
+        childVaults,
+        vaultId: (0, buffer_1.readU64)(data, 248),
+        reservedBase: (0, buffer_1.readU64)(data, 256),
+        requestedBase: (0, buffer_1.readU64)(data, 264),
+        vaultCapacity: (0, buffer_1.readU64)(data, 272),
+        minDeposit: (0, buffer_1.readU64)(data, 280),
+        hwm: (0, buffer_1.readU64)(data, 288),
+        lastFeeTs: (0, buffer_1.readU64)(data, 296),
+        epochPps: (0, buffer_1.readU64)(data, 304),
+        lastNav: (0, buffer_1.readU64)(data, 312),
+        dailyWithdrawnBase: (0, buffer_1.readU64)(data, 320),
+        nextEpochTs: (0, buffer_1.readU32)(data, 328),
+        epochSec: (0, buffer_1.readU32)(data, 332),
+        currentEpochId: (0, buffer_1.readU32)(data, 336),
+        pendingWithdrawals: (0, buffer_1.readU32)(data, 340),
+        withdrawWindowStart: (0, buffer_1.readU32)(data, 344),
+        mgmtFeeBps: (0, buffer_1.readU16)(data, 348),
+        perfFeeBps: (0, buffer_1.readU16)(data, 350),
+        flags: (0, buffer_1.readU16)(data, 352),
+        dailyWithdrawLimitBps: (0, buffer_1.readU16)(data, 354),
+        childVaultCount: (0, buffer_1.readU8)(data, 356),
+        version: (0, buffer_1.readU8)(data, 357),
+        bump: (0, buffer_1.readU8)(data, 358),
     };
 }
+/**
+ * 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,18 +39,27 @@ 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_CHILD_VAULTS = 10;
 export declare const MAX_STRATEGIES = 10;
 export declare const FEE_CAP_BPS = 9900;
 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.MAX_CHILD_VAULTS = 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,15 +78,24 @@ 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; } });
-exports.MAX_STRATEGIES = 10;
+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_CHILD_VAULTS = 10;
+exports.MAX_STRATEGIES = exports.MAX_CHILD_VAULTS; // backward compat
 exports.FEE_CAP_BPS = 9900;
 // ---------------------------------------------------------------------------
 // Account Sizes
@@ -93,4 +104,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