@elemental-stv-core/sdk 0.4.0 → 0.6.0

package/dist/jlpd-strategy/settle-yield.d.ts

@@ -1,54 +1,21 @@
 import { PublicKey, TransactionInstruction } from "@solana/web3.js";
-/** Arguments for building a settle_yield instruction with explicit accounts */
+/** Arguments accepted by `createSettleYieldIx`. */
 export interface CreateSettleYieldIxArgs {
-    config: PublicKey;
-    managerRole: PublicKey;
-    vaultJlpAta: PublicKey;
-    stv0: PublicKey;
-    stv1: PublicKey;
-    stv2: PublicKey;
-    stv3: PublicKey;
-    stv4: PublicKey;
-    dovesBtcUsd: PublicKey;
-    dovesEthUsd: PublicKey;
-    dovesSolUsd: PublicKey;
-    jlpPool: PublicKey;
-    jlpMintAccount: PublicKey;
     manager: PublicKey;
+    /** 5 base asset mints in order: [BTC, ETH, SOL, USDC, JupUSD]. */
+    baseAssetMints: [PublicKey, PublicKey, PublicKey, PublicKey, PublicKey];
+    jlpMint?: PublicKey;
+    tokenProgram?: PublicKey;
+    programId?: PublicKey;
 }
 /**
- * Build the on-chain `settle_yield` instruction.
- *
- * settle_yield takes no params -- instruction data is just the 8-byte discriminator.
- *
- * Accounts (14 total):
- *   0: config (JlpdConfig PDA)
- *   1: manager_role (ManagerRole PDA)
- *   2: vault_jlp_ata (JLP ATA owned by config)
- *   3: stv_0 (BTC strategy_state, mut)
- *   4: stv_1 (ETH strategy_state, mut)
- *   5: stv_2 (SOL strategy_state, mut)
- *   6: stv_3 (USDC strategy_state, mut)
- *   7: stv_4 (JupUSD strategy_state, mut)
- *   8: doves_btc_usd (oracle)
- *   9: doves_eth_usd (oracle)
- *  10: doves_sol_usd (oracle)
- *  11: jlp_pool (Jupiter Perps Pool)
- *  12: jlp_mint_account
- *  13: manager (signer)
- */
-export declare function createSettleYieldIx(args: CreateSettleYieldIxArgs, programId?: PublicKey): TransactionInstruction;
-/**
- * Build a settle_yield instruction with automatic PDA derivation.
+ * Build a `settle_yield` instruction with automatic PDA derivation.
  *
  * Requires the 5 base asset mints in order: [BTC, ETH, SOL, USDC, JupUSD].
  * These must match the `base_asset_mints` array on the JlpdConfig account.
+ *
+ * Naming follows the SDK convention: low-level instruction builders are named
+ * `create*Ix` (this is the canonical name); high-level transaction wrappers
+ * (if any) are named `build*Transaction`.
  */
-export declare function buildSettleYieldIx(args: {
-    manager: PublicKey;
-    baseAssetMints: [PublicKey, PublicKey, PublicKey, PublicKey, PublicKey];
-    jlpMint?: PublicKey;
-    tokenProgram?: PublicKey;
-    programId?: PublicKey;
-}): TransactionInstruction;
-//# sourceMappingURL=settle-yield.d.ts.map
+export declare function createSettleYieldIx(args: CreateSettleYieldIxArgs): TransactionInstruction;

package/dist/jlpd-strategy/settle-yield.js

@@ -1,24 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSettleYieldIx = createSettleYieldIx;
-exports.buildSettleYieldIx = buildSettleYieldIx;
 const web3_js_1 = require("@solana/web3.js");
 const spl_token_1 = require("@solana/spl-token");
 const constants_1 = require("./constants");
 const pda_1 = require("./pda");
+const ata_1 = require("../common/ata");
 // ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-/** Derive ATA address */
-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;
-}
-// ---------------------------------------------------------------------------
-// Low-level instruction builder
+// Internal raw builder
 // ---------------------------------------------------------------------------
 /**
- * Build the on-chain `settle_yield` instruction.
+ * Build the on-chain `settle_yield` instruction from explicit account inputs.
  *
  * settle_yield takes no params -- instruction data is just the 8-byte discriminator.
  *
@@ -38,7 +30,7 @@ function findAta(mint, owner, tokenProgram) {
  *  12: jlp_mint_account
  *  13: manager (signer)
  */
-function createSettleYieldIx(args, programId = constants_1.PROGRAM_ID) {
+function buildRawSettleYieldIx(args, programId = constants_1.PROGRAM_ID) {
     const { config, managerRole, vaultJlpAta, stv0, stv1, stv2, stv3, stv4, dovesBtcUsd, dovesEthUsd, dovesSolUsd, jlpPool, jlpMintAccount, manager, } = args;
     // Instruction data: just the 8-byte discriminator (no params)
     const data = Buffer.alloc(8);
@@ -62,19 +54,23 @@ function createSettleYieldIx(args, programId = constants_1.PROGRAM_ID) {
     return new web3_js_1.TransactionInstruction({ keys, programId, data });
 }
 // ---------------------------------------------------------------------------
-// High-level builder
+// Public instruction builder
 // ---------------------------------------------------------------------------
 /**
- * Build a settle_yield instruction with automatic PDA derivation.
+ * Build a `settle_yield` instruction with automatic PDA derivation.
  *
  * Requires the 5 base asset mints in order: [BTC, ETH, SOL, USDC, JupUSD].
  * These must match the `base_asset_mints` array on the JlpdConfig account.
+ *
+ * Naming follows the SDK convention: low-level instruction builders are named
+ * `create*Ix` (this is the canonical name); high-level transaction wrappers
+ * (if any) are named `build*Transaction`.
  */
-function buildSettleYieldIx(args) {
+function createSettleYieldIx(args) {
     const { manager, baseAssetMints, jlpMint = constants_1.JLP_MINT, tokenProgram = spl_token_1.TOKEN_PROGRAM_ID, programId = constants_1.PROGRAM_ID, } = args;
     // 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);
     // Derive strategy_state PDAs for all 5 base assets
     const [stv0] = (0, pda_1.findStrategyStatePda)(baseAssetMints[0], programId);
     const [stv1] = (0, pda_1.findStrategyStatePda)(baseAssetMints[1], programId);
@@ -82,8 +78,8 @@ function buildSettleYieldIx(args) {
     const [stv3] = (0, pda_1.findStrategyStatePda)(baseAssetMints[3], programId);
     const [stv4] = (0, pda_1.findStrategyStatePda)(baseAssetMints[4], programId);
     // Derive vault JLP ATA (owned by config PDA)
-    const vaultJlpAta = findAta(jlpMint, config, tokenProgram);
-    return createSettleYieldIx({
+    const vaultJlpAta = (0, ata_1.findAta)(jlpMint, config, tokenProgram);
+    return buildRawSettleYieldIx({
         config,
         managerRole,
         vaultJlpAta,
@@ -100,4 +96,3 @@ function buildSettleYieldIx(args) {
         manager,
     }, programId);
 }
-//# sourceMappingURL=settle-yield.js.map

package/dist/jlpd-strategy/swap-jlp.d.ts

@@ -1,4 +1,5 @@
-import { PublicKey, TransactionInstruction, Connection, AddressLookupTableAccount, AccountMeta } from "@solana/web3.js";
+import { PublicKey, TransactionInstruction, AddressLookupTableAccount, AccountMeta } from "@solana/web3.js";
+import type { SolanaConnection } from "../common/connection";
 import BN from "bn.js";
 /** Direction of the JLP swap */
 export type SwapDirection = "BaseToJlp" | "JlpToBase";
@@ -97,7 +98,7 @@ export declare function getJupiterSwapInstructions(args: {
  * 5. Returns instructions + ALTs for a versioned transaction
  */
 export declare function buildSwapJlpTransaction(args: {
-    connection: Connection;
+    connection: SolanaConnection;
     manager: PublicKey;
     baseMint: PublicKey;
     direction: SwapDirection;
@@ -113,7 +114,7 @@ export declare function buildSwapJlpTransaction(args: {
     quoteInAmount: bigint;
 }>;
 export interface RebalanceArgs {
-    connection: Connection;
+    connection: SolanaConnection;
     manager: PublicKey;
     baseMint: PublicKey;
     vaultId: number;
@@ -150,4 +151,3 @@ export interface RebalanceResult {
  * For JlpToBase: builds swap_jlp + withdraw_from_strategy in 1 tx.
  */
 export declare function buildRebalanceTransaction(args: RebalanceArgs): Promise<RebalanceResult>;
-//# sourceMappingURL=swap-jlp.d.ts.map

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