@elemental-stv-core/sdk 0.9.3 → 0.11.0

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

@@ -23,6 +23,7 @@ const constants_2 = require("../p-stv-core/constants");
 const pda_3 = require("../elemental-lend/pda");
 const jupiter_lend_1 = require("../elemental-lend/jupiter-lend");
 const instructions_2 = require("../elemental-lend/instructions");
+const accounts_3 = require("../elemental-lend/accounts");
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -33,7 +34,7 @@ const JUPITER_API_BASE = "https://api.jup.ag/swap/v1";
  * 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;
+const JUPITER_API_KEY = process.env.NEXT_PUBLIC_JUPITER_API_KEY ?? process.env.JUPITER_API_KEY;
 function toBigInt(v) {
     if (typeof v === "bigint")
         return v;
@@ -53,7 +54,7 @@ function toBigInt(v) {
  *    4-byte jupiter_data_len (LE), ...jupiter_data_bytes]
  */
 function createSwapJlpIx(args, programId = constants_1.PROGRAM_ID) {
-    const { manager, config, managerRole, strategyState, strategyBaseAta, strategyJlpAta, vaultJlpAta, baseMint, jlpMint, tokenProgram, jupiterProgram, direction, amount, minOut, jupiterData, remainingAccounts = [], } = args;
+    const { manager, config, managerRole, strategyState, strategyBaseAta, strategyJlpAta, vaultJlpAta, baseMint, jlpMint, tokenProgram, jupiterProgram, priceOracle, jlpPool, jlpMintAccount, direction, amount, minOut, jupiterData, remainingAccounts = [], } = args;
     const amountBi = toBigInt(amount);
     const minOutBi = toBigInt(minOut);
     // Serialize instruction data
@@ -83,11 +84,22 @@ function createSwapJlpIx(args, programId = constants_1.PROGRAM_ID) {
         { pubkey: jlpMint, isSigner: false, isWritable: false },
         { pubkey: tokenProgram, isSigner: false, isWritable: false },
         { pubkey: jupiterProgram, isSigner: false, isWritable: false },
+        { pubkey: priceOracle, isSigner: false, isWritable: false },
+        { pubkey: jlpPool, isSigner: false, isWritable: false },
+        { pubkey: jlpMintAccount, isSigner: false, isWritable: false },
         ...remainingAccounts,
     ];
     return new web3_js_1.TransactionInstruction({ keys, programId, data });
 }
 // ---------------------------------------------------------------------------
+// Stable-asset detection
+// ---------------------------------------------------------------------------
+/** Mints that use a hardcoded $1 price on-chain (oracle account ignored). */
+const STABLE_MINTS = new Set(constants_1.JLPD_POOLS.filter((p) => p.name === "USDC" || p.name === "JupUSD").map((p) => p.mint));
+function isStableMint(mint) {
+    return STABLE_MINTS.has(mint.toBase58());
+}
+// ---------------------------------------------------------------------------
 // Jupiter API helpers
 // ---------------------------------------------------------------------------
 /**
@@ -123,9 +135,13 @@ async function getJupiterSwapQuote(args) {
  *
  * @param quoteResponse The quote from getJupiterSwapQuote
  * @param userPublicKey The account that signs the swap -- for JLPD this is the strategy_state PDA
+ * @param destinationTokenAccount Optional override for the destination token account.
+ *   For base_to_base_swap: must be base_out_ata (ATA owned by strategy_state_OUT) so
+ *   Jupiter routes output tokens there instead of to userPublicKey's default ATA.
+ *   For swap_jlp: omit — Jupiter defaults destination to userPublicKey's ATA which is correct.
  */
 async function getJupiterSwapInstructions(args) {
-    const { quoteResponse, userPublicKey } = args;
+    const { quoteResponse, userPublicKey, destinationTokenAccount } = args;
     const url = `${JUPITER_API_BASE}/swap-instructions`;
     const body = {
         quoteResponse,
@@ -134,6 +150,9 @@ async function getJupiterSwapInstructions(args) {
         dynamicComputeUnitLimit: true,
         skipUserAccountsRpcCalls: true,
     };
+    if (destinationTokenAccount !== undefined) {
+        body["destinationTokenAccount"] = destinationTokenAccount.toBase58();
+    }
     const headers = {
         "Content-Type": "application/json",
     };
@@ -214,22 +233,53 @@ async function buildSwapJlpTransaction(args) {
     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
+    // 2. Resolve oracle + pending swap_arb. Fetch the strategy state once if we need
+    //    the stored price_oracle (volatile asset, no override) OR swap_arb (BaseToJlp).
+    const needOracleFetch = !isStableMint(baseMint) && args.priceOracle === undefined;
+    const needArb = direction === "BaseToJlp";
+    const state = needOracleFetch || needArb
+        ? await (0, accounts_1.fetchJlpStrategyState)(connection, baseMint, programId)
+        : null;
+    let priceOracle;
+    if (isStableMint(baseMint)) {
+        priceOracle = web3_js_1.PublicKey.default;
+    }
+    else if (args.priceOracle !== undefined) {
+        priceOracle = args.priceOracle;
+    }
+    else {
+        priceOracle = state.priceOracle;
+    }
+    // 3. BaseToJlp folds pending swap_arb into the Jupiter input:
+    //    total_in = amount + swap_arb (signed; an unfavorable b2b banked a negative
+    //    deficit that reduces it). The on-chain handler pins base-spent == total_in,
+    //    so the Jupiter route MUST be quoted for total_in. The instruction `amount`
+    //    stays = principal (the program credits base_loaned with principal only).
+    let quoteAmount = amount;
+    if (direction === "BaseToJlp" && state) {
+        const arb = BigInt(state.swapArb.toString()); // signed i64
+        const totalIn = amount + arb;
+        if (totalIn <= 0n) {
+            throw new Error(`swap_arb deficit (${arb}) cancels principal (${amount}); cannot Base->JLP — wait for a settle or larger amount.`);
+        }
+        quoteAmount = totalIn;
+    }
+    // 4. Determine input/output mints for the Jupiter quote
     const inputMint = direction === "BaseToJlp" ? baseMint : jlpMint;
     const outputMint = direction === "BaseToJlp" ? jlpMint : baseMint;
-    // 3. Get Jupiter quote
+    // 5. Get Jupiter quote (for total_in on BaseToJlp; principal otherwise)
     const quote = await getJupiterSwapQuote({
         inputMint,
         outputMint,
-        amount,
+        amount: quoteAmount,
         slippageBps,
     });
-    // 4. Get Jupiter swap instructions (strategy_state PDA signs via CPI)
+    // 5. Get Jupiter swap instructions (strategy_state PDA signs via CPI)
     const jupSwap = await getJupiterSwapInstructions({
         quoteResponse: quote,
         userPublicKey: strategyState,
     });
-    // 5. Build the swap_jlp instruction
+    // 6. Build the swap_jlp instruction
     const minOut = BigInt(quote.otherAmountThreshold);
     const swapJlpIx = createSwapJlpIx({
         manager,
@@ -243,13 +293,16 @@ async function buildSwapJlpTransaction(args) {
         jlpMint,
         tokenProgram,
         jupiterProgram: constants_1.JUPITER_PROGRAM,
+        priceOracle,
+        jlpPool: constants_1.JLP_POOL_ACCOUNT,
+        jlpMintAccount: jlpMint,
         direction,
         amount,
         minOut,
         jupiterData: jupSwap.swapInstructionData,
         remainingAccounts: jupSwap.remainingAccounts,
     }, programId);
-    // 6. Fetch ALTs
+    // 7. Fetch ALTs
     const addressLookupTables = await fetchAddressLookupTables(connection, jupSwap.addressLookupTableAddresses);
     return {
         instructions: [swapJlpIx],
@@ -401,8 +454,12 @@ async function buildJlpToBaseRebalance(args) {
     const [jlpdStvPosition] = (0, pda_1.findStvPositionPda)(stvAddress, programId);
     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
+    // Build lend remaining_accounts for auto-sweep after withdraw:
+    //   [4 fixed lend, protocolAumCount protocol-AUM accounts]
+    // The protocol-AUM accounts feed the pre-sweep update_aum refresh; on-chain lend
+    // rejects an incomplete tail, so we must cover the strategy's full protocol set.
     const lendAccounts = [];
+    let lendProtocolAumCount = 0;
     const DEFAULT_PUBKEY = web3_js_1.PublicKey.default;
     if (!stv.lendProgram.equals(DEFAULT_PUBKEY)) {
         const [lendStrategyState] = (0, pda_3.findStrategyStatePda)(baseMint, stv.lendProgram);
@@ -414,6 +471,12 @@ async function buildJlpToBaseRebalance(args) {
             lendStvPosition: lendPosition,
             lendBaseAta,
         }));
+        const lendState = await (0, accounts_3.fetchLendStrategyState)(connection, baseMint, stv.lendProgram).catch(() => null);
+        if (lendState) {
+            const protocolAumAccounts = await (0, accounts_3.buildProtocolAccountsForAum)(connection, lendState, lendStrategyState, tokenProgram);
+            lendProtocolAumCount = protocolAumAccounts.length;
+            lendAccounts.push(...protocolAumAccounts);
+        }
     }
     const [configPda] = (0, pda_2.findConfigPda)(pStvProgramId);
     const withdrawIx = (0, instructions_1.createWithdrawFromStrategyIx)({
@@ -429,6 +492,7 @@ async function buildJlpToBaseRebalance(args) {
         strategyBaseAta,
         tokenProgram,
         shares: new bn_js_1.default(sharesToWithdraw.toString()),
+        protocolAumCount: lendProtocolAumCount,
         remainingAccounts: lendAccounts,
     }, pStvProgramId);
     // Build Jupiter Lend deposit instruction to route funds from Elemental Lend → Jupiter Lend.

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

@@ -22,9 +22,11 @@ export interface ManagerRole {
     manager: PublicKey;
     bump: number;
 }
-/** JLP StrategyState (160 bytes) — extends standard 104-byte header */
+/** JLP StrategyState (224 bytes) — extends standard 104-byte header */
 export interface JlpStrategyState extends StrategyStateHeader {
     baseLoaned: BN;
+    swapArb: BN;
+    priceOracle: PublicKey;
 }
 export type { StvPosition } from "../common/strategy-interface";
 export interface ConfigInitializedEvent {

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

@@ -1,7 +1,7 @@
 import { PublicKey } from "@solana/web3.js";
 import BN from "bn.js";
 import type { SolanaConnection } from "../common/connection";
-import { GlobalConfig, Stv, WithdrawRequest, ManagerRole } from "./types";
+import { GlobalConfig, Stv, WithdrawRequest, DelayedDepositRequest, ManagerRole } from "./types";
 /**
  * GlobalConfig — singleton protocol registry. Total 56 bytes.
  *
@@ -50,7 +50,14 @@ export declare function deserializeGlobalConfig(data: Buffer): GlobalConfig;
  *   [357..358]  version                       u8
  *   [358..359]  bump                          u8
  *   [359..360]  _padding                      [u8; 1]
- *   [360..664]  _reserved                     [u8; 304]
+ *   [360..362]  depositFeeBps                 u16
+ *   [362..364]  withdrawalFeeBps              u16
+ *   [364..368]  pendingDepositCount           u32
+ *   [368..376]  pendingDepositBase            u64      (delayed deposit principal not yet active)
+ *   [376..408]  feeReceiverEvAta              Pubkey   (pinned canonical fee receiver evX ATA)
+ *   [408..416]  lockedSeedShares              u64      (C-1 supply floor)
+ *   [416..417]  withdrawalMode                u8       (0=instant, 1=X, 2=X+1)
+ *   [417..664]  _reserved                     [u8; 247]
  */
 export declare function deserializeStv(data: Buffer): Stv;
 /**
@@ -65,9 +72,34 @@ export declare function deserializeStv(data: Buffer): Stv;
  *   [ 88.. 92]  epochId                  u32
  *   [ 92.. 96]  claimAvailableAfter      u32   (unix seconds)
  *   [ 96.. 97]  bump                     u8
- *   [ 97..168]  _reserved                [u8; 71]
+ *   [ 97.. 98]  version                  u8
+ *   [ 98.. 99]  requestFlags             u8   (bit0 WR_FLAG_MIGRATE: 0=withdraw, 1=migrate)
+ *   [ 99..104]  _padding                 [u8; 5]
+ *   [104..112]  destVaultId              u64  (migrate: dest STV vault_id; withdraw: 0)
+ *   [112..120]  minDestShares            u64  (migrate: slippage floor; withdraw: 0)
+ *   [120..168]  _reserved0               [u8; 48]
  */
 export declare function deserializeWithdrawRequest(data: Buffer): WithdrawRequest;
+/**
+ * WithdrawRequest kind from `requestFlags` bit 0.
+ * Returns `"migrate"` when WR_FLAG_MIGRATE (0x01) is set, else `"withdraw"`.
+ */
+export declare function withdrawRequestKind(wr: WithdrawRequest): "withdraw" | "migrate";
+/**
+ * DelayedDepositRequest — per-(STV, user, epoch) pending deposit. Total 152 bytes.
+ *
+ * Layout (offsets include the 8-byte discriminator):
+ *   [  0..  8]  discriminator           (sha256("account:DelayedDepositRequest")[..8])
+ *   [  8.. 40]  stv                      Pubkey
+ *   [ 40.. 72]  user                     Pubkey
+ *   [ 72.. 80]  amount                   u64
+ *   [ 80.. 84]  epochId                  u32   (offset_of == 80, asserted on-chain)
+ *   [ 84.. 85]  bump                     u8
+ *   [ 85.. 86]  version                  u8
+ *   [ 86.. 88]  _padding                 [u8; 2]
+ *   [ 88..152]  _reserved                [u8; 64]
+ */
+export declare function deserializeDelayedDepositRequest(data: Buffer): DelayedDepositRequest;
 /**
  * ManagerRole — per-(STV, manager) authorization record. Total 80 bytes.
  *
@@ -85,7 +117,10 @@ export declare function fetchStv(connection: SolanaConnection, vaultId: number |
 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 fetchDelayedDepositRequest(connection: SolanaConnection, stv: PublicKey, user: PublicKey, epochId: number, programId?: PublicKey): Promise<DelayedDepositRequest>;
+export declare function fetchDelayedDepositRequestByAddress(connection: SolanaConnection, address: PublicKey): Promise<DelayedDepositRequest>;
 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 fetchPendingDelayedDepositRequests(connection: SolanaConnection, stv: PublicKey, epochId: number, programId?: PublicKey): Promise<[PublicKey, DelayedDepositRequest][]>;
 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

@@ -3,14 +3,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.deserializeGlobalConfig = deserializeGlobalConfig;
 exports.deserializeStv = deserializeStv;
 exports.deserializeWithdrawRequest = deserializeWithdrawRequest;
+exports.withdrawRequestKind = withdrawRequestKind;
+exports.deserializeDelayedDepositRequest = deserializeDelayedDepositRequest;
 exports.deserializeManagerRole = deserializeManagerRole;
 exports.fetchGlobalConfig = fetchGlobalConfig;
 exports.fetchStv = fetchStv;
 exports.fetchStvByAddress = fetchStvByAddress;
 exports.fetchWithdrawRequest = fetchWithdrawRequest;
 exports.fetchWithdrawRequestByAddress = fetchWithdrawRequestByAddress;
+exports.fetchDelayedDepositRequest = fetchDelayedDepositRequest;
+exports.fetchDelayedDepositRequestByAddress = fetchDelayedDepositRequestByAddress;
 exports.fetchAllStvs = fetchAllStvs;
 exports.fetchPendingWithdrawRequests = fetchPendingWithdrawRequests;
+exports.fetchPendingDelayedDepositRequests = fetchPendingDelayedDepositRequests;
 exports.fetchManagerRole = fetchManagerRole;
 exports.fetchManagersForStv = fetchManagersForStv;
 const buffer_1 = require("../common/buffer");
@@ -88,7 +93,14 @@ function deserializeGlobalConfig(data) {
  *   [357..358]  version                       u8
  *   [358..359]  bump                          u8
  *   [359..360]  _padding                      [u8; 1]
- *   [360..664]  _reserved                     [u8; 304]
+ *   [360..362]  depositFeeBps                 u16
+ *   [362..364]  withdrawalFeeBps              u16
+ *   [364..368]  pendingDepositCount           u32
+ *   [368..376]  pendingDepositBase            u64      (delayed deposit principal not yet active)
+ *   [376..408]  feeReceiverEvAta              Pubkey   (pinned canonical fee receiver evX ATA)
+ *   [408..416]  lockedSeedShares              u64      (C-1 supply floor)
+ *   [416..417]  withdrawalMode                u8       (0=instant, 1=X, 2=X+1)
+ *   [417..664]  _reserved                     [u8; 247]
  */
 function deserializeStv(data) {
     if (data.length < constants_1.STV_SIZE) {
@@ -107,6 +119,7 @@ function deserializeStv(data) {
         evMint: (0, buffer_1.readPubkey)(data, 40),
         strategy: (0, buffer_1.readPubkey)(data, 72),
         feeReceiver: (0, buffer_1.readPubkey)(data, 104),
+        feeReceiverEvAta: (0, buffer_1.readPubkey)(data, 376),
         lendProgram: (0, buffer_1.readPubkey)(data, 136),
         vaultAta: (0, buffer_1.readPubkey)(data, 168),
         childVaults,
@@ -132,6 +145,12 @@ function deserializeStv(data) {
         childVaultCount: (0, buffer_1.readU8)(data, 356),
         version: (0, buffer_1.readU8)(data, 357),
         bump: (0, buffer_1.readU8)(data, 358),
+        depositFeeBps: (0, buffer_1.readU16)(data, 360),
+        withdrawalFeeBps: (0, buffer_1.readU16)(data, 362),
+        pendingDepositCount: (0, buffer_1.readU32)(data, 364),
+        pendingDepositBase: (0, buffer_1.readU64)(data, 368),
+        lockedSeedShares: (0, buffer_1.readU64)(data, 408),
+        withdrawalMode: (0, buffer_1.readU8)(data, 416),
     };
 }
 /**
@@ -146,7 +165,12 @@ function deserializeStv(data) {
  *   [ 88.. 92]  epochId                  u32
  *   [ 92.. 96]  claimAvailableAfter      u32   (unix seconds)
  *   [ 96.. 97]  bump                     u8
- *   [ 97..168]  _reserved                [u8; 71]
+ *   [ 97.. 98]  version                  u8
+ *   [ 98.. 99]  requestFlags             u8   (bit0 WR_FLAG_MIGRATE: 0=withdraw, 1=migrate)
+ *   [ 99..104]  _padding                 [u8; 5]
+ *   [104..112]  destVaultId              u64  (migrate: dest STV vault_id; withdraw: 0)
+ *   [112..120]  minDestShares            u64  (migrate: slippage floor; withdraw: 0)
+ *   [120..168]  _reserved0               [u8; 48]
  */
 function deserializeWithdrawRequest(data) {
     if (data.length < constants_1.WITHDRAW_REQUEST_SIZE) {
@@ -164,6 +188,47 @@ function deserializeWithdrawRequest(data) {
         epochId: (0, buffer_1.readU32)(data, 88),
         claimAvailableAfter: (0, buffer_1.readU32)(data, 92),
         bump: (0, buffer_1.readU8)(data, 96),
+        requestFlags: (0, buffer_1.readU8)(data, 98),
+        destVaultId: (0, buffer_1.readU64)(data, 104),
+        minDestShares: (0, buffer_1.readU64)(data, 112),
+    };
+}
+/**
+ * WithdrawRequest kind from `requestFlags` bit 0.
+ * Returns `"migrate"` when WR_FLAG_MIGRATE (0x01) is set, else `"withdraw"`.
+ */
+function withdrawRequestKind(wr) {
+    return (wr.requestFlags & 0x01) !== 0 ? "migrate" : "withdraw";
+}
+/**
+ * DelayedDepositRequest — per-(STV, user, epoch) pending deposit. Total 152 bytes.
+ *
+ * Layout (offsets include the 8-byte discriminator):
+ *   [  0..  8]  discriminator           (sha256("account:DelayedDepositRequest")[..8])
+ *   [  8.. 40]  stv                      Pubkey
+ *   [ 40.. 72]  user                     Pubkey
+ *   [ 72.. 80]  amount                   u64
+ *   [ 80.. 84]  epochId                  u32   (offset_of == 80, asserted on-chain)
+ *   [ 84.. 85]  bump                     u8
+ *   [ 85.. 86]  version                  u8
+ *   [ 86.. 88]  _padding                 [u8; 2]
+ *   [ 88..152]  _reserved                [u8; 64]
+ */
+function deserializeDelayedDepositRequest(data) {
+    if (data.length < constants_1.DELAYED_DEPOSIT_REQUEST_SIZE) {
+        throw new Error(`DelayedDepositRequest data too short: ${data.length} < ${constants_1.DELAYED_DEPOSIT_REQUEST_SIZE}`);
+    }
+    const disc = data.subarray(0, 8);
+    if (!disc.equals(constants_1.DISC_DELAYED_DEPOSIT_REQUEST)) {
+        throw new Error(`Invalid DelayedDepositRequest discriminator`);
+    }
+    return {
+        stv: (0, buffer_1.readPubkey)(data, 8),
+        user: (0, buffer_1.readPubkey)(data, 40),
+        amount: (0, buffer_1.readU64)(data, 72),
+        epochId: (0, buffer_1.readU32)(data, 80),
+        bump: (0, buffer_1.readU8)(data, 84),
+        version: (0, buffer_1.readU8)(data, 85),
     };
 }
 /**
@@ -227,6 +292,19 @@ async function fetchWithdrawRequestByAddress(connection, address) {
         throw new Error(`WithdrawRequest not found at ${address.toBase58()}`);
     return deserializeWithdrawRequest(info.data);
 }
+async function fetchDelayedDepositRequest(connection, stv, user, epochId, programId = constants_1.PROGRAM_ID) {
+    const [pda] = (0, pda_1.findDelayedDepositRequestPda)(stv, user, epochId, programId);
+    const info = await connection.getAccountInfo(pda);
+    if (!info)
+        throw new Error("DelayedDepositRequest account not found");
+    return deserializeDelayedDepositRequest(info.data);
+}
+async function fetchDelayedDepositRequestByAddress(connection, address) {
+    const info = await connection.getAccountInfo(address);
+    if (!info)
+        throw new Error(`DelayedDepositRequest not found at ${address.toBase58()}`);
+    return deserializeDelayedDepositRequest(info.data);
+}
 // ---------------------------------------------------------------------------
 // GPA Helpers
 // ---------------------------------------------------------------------------
@@ -252,6 +330,19 @@ async function fetchPendingWithdrawRequests(connection, stv, epochId, programId
     });
     return accounts.map((a) => [a.pubkey, deserializeWithdrawRequest(a.account.data)]);
 }
+async function fetchPendingDelayedDepositRequests(connection, stv, epochId, programId = constants_1.PROGRAM_ID) {
+    const epochBuf = Buffer.alloc(4);
+    epochBuf.writeUInt32LE(epochId, 0);
+    const accounts = await connection.getProgramAccounts(programId, {
+        filters: [
+            { dataSize: constants_1.DELAYED_DEPOSIT_REQUEST_SIZE },
+            { memcmp: { offset: 0, bytes: constants_1.DISC_DELAYED_DEPOSIT_REQUEST.toString("base64"), encoding: "base64" } },
+            { memcmp: { offset: 8, bytes: stv.toBuffer().toString("base64"), encoding: "base64" } },
+            { memcmp: { offset: 80, bytes: epochBuf.toString("base64"), encoding: "base64" } },
+        ],
+    });
+    return accounts.map((a) => [a.pubkey, deserializeDelayedDepositRequest(a.account.data)]);
+}
 async function fetchManagerRole(connection, stv, manager, programId = constants_1.PROGRAM_ID) {
     const [pda] = (0, pda_1.findStvManagerRolePda)(stv, manager, programId);
     const info = await connection.getAccountInfo(pda);

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

@@ -4,10 +4,13 @@ export declare const CONFIG_SEED: Buffer<ArrayBuffer>;
 export declare const STV_SEED: Buffer<ArrayBuffer>;
 export declare const EV_MINT_SEED: Buffer<ArrayBuffer>;
 export declare const WITHDRAW_REQUEST_SEED: Buffer<ArrayBuffer>;
+export declare const MIGRATE_REQUEST_SEED: Buffer<ArrayBuffer>;
+export declare const DELAYED_DEPOSIT_SEED: Buffer<ArrayBuffer>;
 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_DELAYED_DEPOSIT_REQUEST: 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;
@@ -22,6 +25,12 @@ 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 IX_MIGRATE_REQUEST = 13;
+export declare const IX_MIGRATE_EXECUTE = 14;
+export declare const IX_PROCESS_DELAYED_DEPOSIT = 15;
+export declare const IX_MIGRATE_CANCEL = 16;
+export declare const IX_INSTANT_WITHDRAW = 17;
+export declare const IX_SEED_STV = 18;
 export declare const EVT_CONFIG_INITIALIZED = 0;
 export declare const EVT_CONFIG_UPDATED = 1;
 export declare const EVT_STV_CREATED = 2;
@@ -40,13 +49,34 @@ 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 EVT_VAULT_ATA_BACKFILLED = 18;
+export declare const EVT_MIGRATE_REQUESTED = 18;
+export declare const EVT_MIGRATE_EXECUTED = 19;
+export declare const EVT_DELAYED_DEPOSIT_PROCESSED = 20;
+export declare const EVT_INSTANT_WITHDRAWN = 21;
+export declare const EVT_STV_SEEDED = 22;
 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;
+/** Skip the per-epoch withdraw rate-limit on this STV (claim_withdraw + migrate_execute). */
+export declare const FLAG_BYPASS_WITHDRAW_LIMIT = 64;
+/** Source STV: apply withdrawal_fee_bps when migrating OUT via migrate_request/migrate_execute. */
+export declare const FLAG_WITHDRAWAL_FEE_ON_MIGRATE = 128;
+/** Dest STV: apply deposit_fee_bps when migrating IN via migrate_execute. */
+export declare const FLAG_DEPOSIT_FEE_ON_MIGRATE = 256;
+/** Delay user deposits by at least one epoch before evX is minted. */
+export declare const FLAG_DELAYED_DEPOSIT = 512;
+/** Migrate exit (source) skips the +1 epoch cooldown — in-protocol move, no drain risk. */
+export declare const FLAG_BYPASS_MIGRATE_SRC_WAITOUT = 1024;
+/** Migrate entry (dest) skips its waitout. */
+export declare const FLAG_BYPASS_MIGRATE_DST_WAITOUT = 2048;
+/**
+ * C-1 seed gate. Program-owned (set by seed_stv, never via
+ * init_or_update_stv). When unset, every public path reverts VaultNotSeeded.
+ * When set with locked_seed_shares > 0, the vault may run instant_withdraw.
+ */
+export declare const FLAG_SEEDED = 4096;
 /**
  * Protocol-wide emergency pause. When set on `GlobalConfig.flags`, blocks
  * every value-movement instruction across every STV (deposit, request/claim
@@ -60,7 +90,12 @@ export { PPS_DECIMALS, BPS_DENOMINATOR, STALENESS_THRESHOLD } from "../common/co
 export declare const MAX_CHILD_VAULTS = 6;
 export declare const MAX_STRATEGIES = 6;
 export declare const FEE_CAP_BPS = 9900;
+/** Max deposit_fee_bps / withdrawal_fee_bps (enforced at init_or_update_stv). */
+export declare const MAX_FEE_BPS = 1000;
+/** WithdrawRequest.request_flags bit 0: 0 = withdraw, 1 = migrate. */
+export declare const WR_FLAG_MIGRATE = 1;
 export declare const GLOBAL_CONFIG_SIZE = 56;
 export declare const STV_SIZE = 664;
 export declare const WITHDRAW_REQUEST_SIZE = 168;
+export declare const DELAYED_DEPOSIT_REQUEST_SIZE = 152;
 export declare const MANAGER_ROLE_SIZE = 80;

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

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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_VAULT_ATA_BACKFILLED = 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 = exports.BPS_DENOMINATOR = void 0;
+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_SEED_STV = exports.IX_INSTANT_WITHDRAW = exports.IX_MIGRATE_CANCEL = exports.IX_PROCESS_DELAYED_DEPOSIT = exports.IX_MIGRATE_EXECUTE = exports.IX_MIGRATE_REQUEST = 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_DELAYED_DEPOSIT_REQUEST = exports.DISC_WITHDRAW_REQUEST = exports.DISC_STV = exports.DISC_GLOBAL_CONFIG = exports.MANAGER_SEED = exports.DELAYED_DEPOSIT_SEED = exports.MIGRATE_REQUEST_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.DELAYED_DEPOSIT_REQUEST_SIZE = exports.WITHDRAW_REQUEST_SIZE = exports.STV_SIZE = exports.GLOBAL_CONFIG_SIZE = exports.WR_FLAG_MIGRATE = exports.MAX_FEE_BPS = exports.FEE_CAP_BPS = exports.MAX_STRATEGIES = exports.MAX_CHILD_VAULTS = exports.STALENESS_THRESHOLD = exports.BPS_DENOMINATOR = exports.PPS_DECIMALS = exports.CFG_FLAG_GLOBAL_PAUSED = exports.FLAG_SEEDED = exports.FLAG_BYPASS_MIGRATE_DST_WAITOUT = exports.FLAG_BYPASS_MIGRATE_SRC_WAITOUT = exports.FLAG_DELAYED_DEPOSIT = exports.FLAG_DEPOSIT_FEE_ON_MIGRATE = exports.FLAG_WITHDRAWAL_FEE_ON_MIGRATE = exports.FLAG_BYPASS_WITHDRAW_LIMIT = exports.FLAG_ALLOCATOR = exports.FLAG_REBALANCE_DISABLED = exports.FLAG_WITHDRAWALS_DISABLED = exports.FLAG_DEPOSITS_DISABLED = exports.FLAG_PAUSED = exports.EVT_STV_SEEDED = exports.EVT_INSTANT_WITHDRAWN = exports.EVT_DELAYED_DEPOSIT_PROCESSED = exports.EVT_MIGRATE_EXECUTED = exports.EVT_MIGRATE_REQUESTED = void 0;
 const web3_js_1 = require("@solana/web3.js");
 // ---------------------------------------------------------------------------
 // Program ID
@@ -14,6 +14,8 @@ exports.CONFIG_SEED = Buffer.from("config");
 exports.STV_SEED = Buffer.from("stv");
 exports.EV_MINT_SEED = Buffer.from("ev_mint");
 exports.WITHDRAW_REQUEST_SEED = Buffer.from("withdraw_request");
+exports.MIGRATE_REQUEST_SEED = Buffer.from("migrate_request");
+exports.DELAYED_DEPOSIT_SEED = Buffer.from("delayed_deposit");
 exports.MANAGER_SEED = Buffer.from("manager");
 // ---------------------------------------------------------------------------
 // Account Discriminators (8-byte Anchor-compatible)
@@ -27,6 +29,9 @@ exports.DISC_STV = Buffer.from([
 exports.DISC_WITHDRAW_REQUEST = Buffer.from([
     0xba, 0xef, 0xae, 0xbf, 0xbd, 0x0d, 0x2f, 0xc4,
 ]);
+exports.DISC_DELAYED_DEPOSIT_REQUEST = Buffer.from([
+    0x33, 0x09, 0xc3, 0xd1, 0xbd, 0xee, 0x7b, 0xe1,
+]);
 // 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; } });
@@ -46,6 +51,12 @@ exports.IX_ADD_MANAGER = 9;
 exports.IX_REMOVE_MANAGER = 10;
 exports.IX_OVERRIDE_CLAIM_WITHDRAW = 11;
 exports.IX_MIGRATE_LEND = 12;
+exports.IX_MIGRATE_REQUEST = 13;
+exports.IX_MIGRATE_EXECUTE = 14;
+exports.IX_PROCESS_DELAYED_DEPOSIT = 15;
+exports.IX_MIGRATE_CANCEL = 16;
+exports.IX_INSTANT_WITHDRAW = 17;
+exports.IX_SEED_STV = 18;
 // ---------------------------------------------------------------------------
 // Event Discriminators (1-byte)
 // ---------------------------------------------------------------------------
@@ -67,7 +78,11 @@ exports.EVT_MANAGER_ADDED = 14;
 exports.EVT_MANAGER_REMOVED = 15;
 exports.EVT_WITHDRAW_OVERRIDE_CLAIMED = 16;
 exports.EVT_LEND_MIGRATED = 17;
-exports.EVT_VAULT_ATA_BACKFILLED = 18;
+exports.EVT_MIGRATE_REQUESTED = 18;
+exports.EVT_MIGRATE_EXECUTED = 19;
+exports.EVT_DELAYED_DEPOSIT_PROCESSED = 20;
+exports.EVT_INSTANT_WITHDRAWN = 21;
+exports.EVT_STV_SEEDED = 22;
 // ---------------------------------------------------------------------------
 // Vault Flags
 // ---------------------------------------------------------------------------
@@ -76,8 +91,25 @@ exports.FLAG_PAUSED = 0x0001;
 exports.FLAG_DEPOSITS_DISABLED = 0x0002;
 exports.FLAG_WITHDRAWALS_DISABLED = 0x0004;
 exports.FLAG_REBALANCE_DISABLED = 0x0008;
-exports.FLAG_TEST_MODE = 0x0010;
 exports.FLAG_ALLOCATOR = 0x0020;
+/** Skip the per-epoch withdraw rate-limit on this STV (claim_withdraw + migrate_execute). */
+exports.FLAG_BYPASS_WITHDRAW_LIMIT = 0x0040;
+/** Source STV: apply withdrawal_fee_bps when migrating OUT via migrate_request/migrate_execute. */
+exports.FLAG_WITHDRAWAL_FEE_ON_MIGRATE = 0x0080;
+/** Dest STV: apply deposit_fee_bps when migrating IN via migrate_execute. */
+exports.FLAG_DEPOSIT_FEE_ON_MIGRATE = 0x0100;
+/** Delay user deposits by at least one epoch before evX is minted. */
+exports.FLAG_DELAYED_DEPOSIT = 0x0200;
+/** Migrate exit (source) skips the +1 epoch cooldown — in-protocol move, no drain risk. */
+exports.FLAG_BYPASS_MIGRATE_SRC_WAITOUT = 0x0400;
+/** Migrate entry (dest) skips its waitout. */
+exports.FLAG_BYPASS_MIGRATE_DST_WAITOUT = 0x0800;
+/**
+ * C-1 seed gate. Program-owned (set by seed_stv, never via
+ * init_or_update_stv). When unset, every public path reverts VaultNotSeeded.
+ * When set with locked_seed_shares > 0, the vault may run instant_withdraw.
+ */
+exports.FLAG_SEEDED = 0x1000;
 // GlobalConfig flags
 /**
  * Protocol-wide emergency pause. When set on `GlobalConfig.flags`, blocks
@@ -98,10 +130,15 @@ Object.defineProperty(exports, "STALENESS_THRESHOLD", { enumerable: true, get: f
 exports.MAX_CHILD_VAULTS = 6;
 exports.MAX_STRATEGIES = exports.MAX_CHILD_VAULTS; // backward compat
 exports.FEE_CAP_BPS = 9900;
+/** Max deposit_fee_bps / withdrawal_fee_bps (enforced at init_or_update_stv). */
+exports.MAX_FEE_BPS = 1000;
+/** WithdrawRequest.request_flags bit 0: 0 = withdraw, 1 = migrate. */
+exports.WR_FLAG_MIGRATE = 0x01;
 // ---------------------------------------------------------------------------
 // Account Sizes
 // ---------------------------------------------------------------------------
 exports.GLOBAL_CONFIG_SIZE = 56;
 exports.STV_SIZE = 664;
 exports.WITHDRAW_REQUEST_SIZE = 168;
+exports.DELAYED_DEPOSIT_REQUEST_SIZE = 152;
 exports.MANAGER_ROLE_SIZE = 80;