@elemental-stv-core/sdk 0.4.0 → 0.6.0

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

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

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

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

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

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

@@ -8,4 +8,3 @@ export * from "./remaining-accounts";
 export * from "./send-tx";
 export * from "./sol-wrap";
 export * from "./prices";
-//# sourceMappingURL=index.d.ts.map

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

@@ -24,4 +24,3 @@ __exportStar(require("./remaining-accounts"), exports);
 __exportStar(require("./send-tx"), exports);
 __exportStar(require("./sol-wrap"), exports);
 __exportStar(require("./prices"), exports);
-//# sourceMappingURL=index.js.map

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

@@ -42,6 +42,8 @@ export interface InitOrUpdateStvArgs {
 export declare function createInitOrUpdateStvIx(args: InitOrUpdateStvArgs, programId?: PublicKey): TransactionInstruction;
 export interface DepositArgs {
     user: PublicKey;
+    /** GlobalConfig PDA — checked for CFG_FLAG_GLOBAL_PAUSED */
+    config: PublicKey;
     stv: PublicKey;
     vaultAta: PublicKey;
     userBaseAta: PublicKey;
@@ -61,6 +63,8 @@ export interface DepositArgs {
 export declare function createDepositIx(args: DepositArgs, programId?: PublicKey): TransactionInstruction;
 export interface RequestWithdrawArgs {
     user: PublicKey;
+    /** GlobalConfig PDA — checked for CFG_FLAG_GLOBAL_PAUSED */
+    config: PublicKey;
     stv: PublicKey;
     withdrawRequest: PublicKey;
     userEvAta: PublicKey;
@@ -74,6 +78,8 @@ export interface RequestWithdrawArgs {
 export declare function createRequestWithdrawIx(args: RequestWithdrawArgs, programId?: PublicKey): TransactionInstruction;
 export interface ClaimWithdrawArgs {
     user: PublicKey;
+    /** GlobalConfig PDA — checked for CFG_FLAG_GLOBAL_PAUSED */
+    config: PublicKey;
     stv: PublicKey;
     withdrawRequest: PublicKey;
     vaultAta: PublicKey;
@@ -88,6 +94,8 @@ export declare function createClaimWithdrawIx(args: ClaimWithdrawArgs, programId
 export interface OverrideClaimWithdrawArgs {
     manager: PublicKey;
     managerRole: PublicKey;
+    /** GlobalConfig PDA — checked for CFG_FLAG_GLOBAL_PAUSED */
+    config: PublicKey;
     user: PublicKey;
     stv: PublicKey;
     withdrawRequest: PublicKey;
@@ -101,6 +109,8 @@ export interface OverrideClaimWithdrawArgs {
 export declare function createOverrideClaimWithdrawIx(args: OverrideClaimWithdrawArgs, programId?: PublicKey): TransactionInstruction;
 export interface ProcessEpochArgs {
     payer: PublicKey;
+    /** GlobalConfig PDA — checked for CFG_FLAG_GLOBAL_PAUSED */
+    config: PublicKey;
     stv: PublicKey;
     evMint: PublicKey;
     feeReceiverEvAta: PublicKey;
@@ -116,6 +126,8 @@ export declare function createProcessEpochIx(args: ProcessEpochArgs, programId?:
 export interface DepositToStrategyArgs {
     manager: PublicKey;
     managerRole: PublicKey;
+    /** GlobalConfig PDA — checked for CFG_FLAG_GLOBAL_PAUSED */
+    config: PublicKey;
     stv: PublicKey;
     vaultAta: PublicKey;
     baseMint: PublicKey;
@@ -126,7 +138,13 @@ export interface DepositToStrategyArgs {
     tokenProgram: PublicKey;
     amount: BN | number;
     minShares: BN | number;
-    /** Number of auto-unroute accounts appended after lend accounts (0 = no auto-unroute) */
+    /**
+     * Number of protocol AUM accounts (kVault: 2/protocol, Jupiter Lend: 3/protocol)
+     * used by update_lend_aum for fresh lend valuation before the reserved_base
+     * liquidity lock check. Always required (0 if lend has no active protocols).
+     */
+    protocolAumCount: number;
+    /** Number of auto-unroute accounts appended after protocol accounts (0 = no auto-unroute) */
     autoUnrouteCount?: number;
     remainingAccounts?: AccountMeta[];
 }
@@ -134,6 +152,8 @@ export declare function createDepositToStrategyIx(args: DepositToStrategyArgs, p
 export interface WithdrawFromStrategyArgs {
     manager: PublicKey;
     managerRole: PublicKey;
+    /** GlobalConfig PDA — checked for CFG_FLAG_GLOBAL_PAUSED */
+    config: PublicKey;
     stv: PublicKey;
     vaultAta: PublicKey;
     baseMint: PublicKey;
@@ -153,9 +173,7 @@ export interface CloseStvArgs {
     stv: PublicKey;
     evMint: PublicKey;
     vaultAta: PublicKey;
-    baseMint: PublicKey;
     tokenProgram: PublicKey;
-    remainingAccounts?: AccountMeta[];
 }
 export declare function createCloseStvIx(args: CloseStvArgs, programId?: PublicKey): TransactionInstruction;
 export interface AddManagerArgs {
@@ -176,6 +194,34 @@ export interface RemoveManagerArgs {
     managerRole: PublicKey;
 }
 export declare function createRemoveManagerIx(args: RemoveManagerArgs, programId?: PublicKey): TransactionInstruction;
+export interface MigrateLendArgs {
+    admin: PublicKey;
+    payer: PublicKey;
+    config: PublicKey;
+    stv: PublicKey;
+    vaultAta: PublicKey;
+    baseMint: PublicKey;
+    tokenProgram: PublicKey;
+    systemProgram?: PublicKey;
+    /** Current lend program — must match stv.lend_program on-chain. */
+    oldLendProgram: PublicKey;
+    /** New lend program (PublicKey.default to deactivate lend entirely). */
+    newLendProgram: PublicKey;
+    /** Protocol AUM accounts for old lend update_aum. */
+    protocolAumCount: number;
+    /** Auto-unroute accounts for old lend withdraw. */
+    autoUnrouteCount: number;
+    /**
+     * remaining_accounts layout:
+     *   Old section (4 + protocolAumCount + autoUnrouteCount):
+     *     [oldLendProgram, oldStrategyState, oldStvPosition, oldBaseAta,
+     *      ...protocolAumAccounts, ...autoUnrouteAccounts]
+     *   New section (if newLendProgram != default, 4 accounts):
+     *     [newLendProgram, newStrategyState, newPositionPda, newBaseAta]
+     */
+    remainingAccounts?: AccountMeta[];
+}
+export declare function createMigrateLendIx(args: MigrateLendArgs, programId?: PublicKey): TransactionInstruction;
 export declare function buildLendRemainingAccounts(lend: {
     lendProgram: PublicKey;
     lendStrategyState: PublicKey;
@@ -186,4 +232,3 @@ export declare function buildStrategyRemainingAccounts(strategies: {
     strategyState: PublicKey;
     stvPosition: PublicKey;
 }[]): AccountMeta[];
-//# sourceMappingURL=instructions.d.ts.map

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

@@ -12,6 +12,7 @@ exports.createWithdrawFromStrategyIx = createWithdrawFromStrategyIx;
 exports.createCloseStvIx = createCloseStvIx;
 exports.createAddManagerIx = createAddManagerIx;
 exports.createRemoveManagerIx = createRemoveManagerIx;
+exports.createMigrateLendIx = createMigrateLendIx;
 exports.buildLendRemainingAccounts = buildLendRemainingAccounts;
 exports.buildStrategyRemainingAccounts = buildStrategyRemainingAccounts;
 const web3_js_1 = require("@solana/web3.js");
@@ -71,7 +72,7 @@ function createInitOrUpdateStvIx(args, programId = constants_1.PROGRAM_ID) {
     });
 }
 function createDepositIx(args, programId = constants_1.PROGRAM_ID) {
-    const { user, stv, vaultAta, userBaseAta, userEvAta, evMint, feeReceiverEvAta, baseMint, tokenProgram, amount, minShares, protocolAumCount = 0, autoRouteCount = 0, remainingAccounts = [], } = args;
+    const { user, config, stv, vaultAta, userBaseAta, userEvAta, evMint, feeReceiverEvAta, baseMint, tokenProgram, amount, minShares, protocolAumCount = 0, autoRouteCount = 0, remainingAccounts = [], } = args;
     const data = [constants_1.IX_DEPOSIT];
     (0, buffer_1.writeU64)(data, amount);
     (0, buffer_1.writeU64)(data, minShares);
@@ -80,6 +81,7 @@ function createDepositIx(args, programId = constants_1.PROGRAM_ID) {
     return new web3_js_1.TransactionInstruction({
         keys: [
             { pubkey: user, isSigner: true, isWritable: true },
+            { pubkey: config, isSigner: false, isWritable: false },
             { pubkey: stv, isSigner: false, isWritable: true },
             { pubkey: vaultAta, isSigner: false, isWritable: true },
             { pubkey: userBaseAta, isSigner: false, isWritable: true },
@@ -95,13 +97,14 @@ function createDepositIx(args, programId = constants_1.PROGRAM_ID) {
     });
 }
 function createRequestWithdrawIx(args, programId = constants_1.PROGRAM_ID) {
-    const { user, stv, withdrawRequest, userEvAta, escrowEvAta, evMint, tokenProgram, systemProgram = web3_js_1.SystemProgram.programId, shares, wrBump, } = args;
+    const { user, config, stv, withdrawRequest, userEvAta, escrowEvAta, evMint, tokenProgram, systemProgram = web3_js_1.SystemProgram.programId, shares, wrBump, } = args;
     const data = [constants_1.IX_REQUEST_WITHDRAW];
     (0, buffer_1.writeU64)(data, shares);
     data.push(wrBump & 0xff);
     return new web3_js_1.TransactionInstruction({
         keys: [
             { pubkey: user, isSigner: true, isWritable: true },
+            { pubkey: config, isSigner: false, isWritable: false },
             { pubkey: stv, isSigner: false, isWritable: true },
             { pubkey: withdrawRequest, isSigner: false, isWritable: true },
             { pubkey: userEvAta, isSigner: false, isWritable: true },
@@ -115,13 +118,15 @@ function createRequestWithdrawIx(args, programId = constants_1.PROGRAM_ID) {
     });
 }
 function createClaimWithdrawIx(args, programId = constants_1.PROGRAM_ID) {
-    const { user, stv, withdrawRequest, vaultAta, userBaseAta, baseMint, tokenProgram, remainingAccounts = [], autoUnrouteCount = 0, } = args;
-    const data = autoUnrouteCount > 0
-        ? Buffer.from([constants_1.IX_CLAIM_WITHDRAW, autoUnrouteCount & 0xff])
-        : Buffer.from([constants_1.IX_CLAIM_WITHDRAW]);
+    const { user, config, stv, withdrawRequest, vaultAta, userBaseAta, baseMint, tokenProgram, remainingAccounts = [], autoUnrouteCount = 0, } = args;
+    // Always serialize the auto_unroute_count byte (write 0 when there's no
+    // auto-unroute). The on-chain handler always reads this byte from
+    // instruction data.
+    const data = Buffer.from([constants_1.IX_CLAIM_WITHDRAW, autoUnrouteCount & 0xff]);
     return new web3_js_1.TransactionInstruction({
         keys: [
             { pubkey: user, isSigner: true, isWritable: true },
+            { pubkey: config, isSigner: false, isWritable: false },
             { pubkey: stv, isSigner: false, isWritable: true },
             { pubkey: withdrawRequest, isSigner: false, isWritable: true },
             { pubkey: vaultAta, isSigner: false, isWritable: true },
@@ -135,7 +140,7 @@ function createClaimWithdrawIx(args, programId = constants_1.PROGRAM_ID) {
     });
 }
 function createOverrideClaimWithdrawIx(args, programId = constants_1.PROGRAM_ID) {
-    const { manager, managerRole, user, stv, withdrawRequest, vaultAta, userBaseAta, baseMint, tokenProgram, remainingAccounts = [], autoUnrouteCount = 0, } = args;
+    const { manager, managerRole, config, user, stv, withdrawRequest, vaultAta, userBaseAta, baseMint, tokenProgram, remainingAccounts = [], autoUnrouteCount = 0, } = args;
     const data = autoUnrouteCount > 0
         ? Buffer.from([constants_1.IX_OVERRIDE_CLAIM_WITHDRAW, autoUnrouteCount & 0xff])
         : Buffer.from([constants_1.IX_OVERRIDE_CLAIM_WITHDRAW]);
@@ -143,6 +148,7 @@ function createOverrideClaimWithdrawIx(args, programId = constants_1.PROGRAM_ID)
         keys: [
             { pubkey: manager, isSigner: true, isWritable: false },
             { pubkey: managerRole, isSigner: false, isWritable: false },
+            { pubkey: config, isSigner: false, isWritable: false },
             { pubkey: user, isSigner: false, isWritable: true },
             { pubkey: stv, isSigner: false, isWritable: true },
             { pubkey: withdrawRequest, isSigner: false, isWritable: true },
@@ -157,10 +163,11 @@ function createOverrideClaimWithdrawIx(args, programId = constants_1.PROGRAM_ID)
     });
 }
 function createProcessEpochIx(args, programId = constants_1.PROGRAM_ID) {
-    const { payer, stv, evMint, feeReceiverEvAta, escrowEvAta, vaultAta, tokenProgram, advanceEpoch, protocolAumCount = 0, remainingAccounts = [], } = args;
+    const { payer, config, stv, evMint, feeReceiverEvAta, escrowEvAta, vaultAta, tokenProgram, advanceEpoch, protocolAumCount = 0, remainingAccounts = [], } = args;
     return new web3_js_1.TransactionInstruction({
         keys: [
             { pubkey: payer, isSigner: true, isWritable: true },
+            { pubkey: config, isSigner: false, isWritable: false },
             { pubkey: stv, isSigner: false, isWritable: true },
             { pubkey: evMint, isSigner: false, isWritable: true },
             { pubkey: feeReceiverEvAta, isSigner: false, isWritable: true },
@@ -174,10 +181,13 @@ function createProcessEpochIx(args, programId = constants_1.PROGRAM_ID) {
     });
 }
 function createDepositToStrategyIx(args, programId = constants_1.PROGRAM_ID) {
-    const { manager, managerRole, stv, vaultAta, baseMint, strategyProgram, strategyState, stvPosition, strategyBaseAta, tokenProgram, amount, minShares, autoUnrouteCount = 0, remainingAccounts = [], } = args;
+    const { manager, managerRole, config, stv, vaultAta, baseMint, strategyProgram, strategyState, stvPosition, strategyBaseAta, tokenProgram, amount, minShares, protocolAumCount, autoUnrouteCount = 0, remainingAccounts = [], } = args;
     const data = [constants_1.IX_DEPOSIT_TO_STRATEGY];
     (0, buffer_1.writeU64)(data, amount);
     (0, buffer_1.writeU64)(data, minShares);
+    // Always emit protocol_aum_count at offset 16 (even if 0); auto_unroute_count
+    // remains optional and is appended only when > 0.
+    data.push(protocolAumCount & 0xff);
     if (autoUnrouteCount > 0) {
         data.push(autoUnrouteCount & 0xff);
     }
@@ -185,6 +195,7 @@ function createDepositToStrategyIx(args, programId = constants_1.PROGRAM_ID) {
         keys: [
             { pubkey: manager, isSigner: true, isWritable: true },
             { pubkey: managerRole, isSigner: false, isWritable: false },
+            { pubkey: config, isSigner: false, isWritable: false },
             { pubkey: stv, isSigner: false, isWritable: true },
             { pubkey: vaultAta, isSigner: false, isWritable: true },
             { pubkey: baseMint, isSigner: false, isWritable: false },
@@ -200,13 +211,14 @@ function createDepositToStrategyIx(args, programId = constants_1.PROGRAM_ID) {
     });
 }
 function createWithdrawFromStrategyIx(args, programId = constants_1.PROGRAM_ID) {
-    const { manager, managerRole, stv, vaultAta, baseMint, strategyProgram, strategyState, stvPosition, strategyBaseAta, tokenProgram, shares, remainingAccounts = [], } = args;
+    const { manager, managerRole, config, stv, vaultAta, baseMint, strategyProgram, strategyState, stvPosition, strategyBaseAta, tokenProgram, shares, remainingAccounts = [], } = args;
     const data = [constants_1.IX_WITHDRAW_FROM_STRATEGY];
     (0, buffer_1.writeU64)(data, shares);
     return new web3_js_1.TransactionInstruction({
         keys: [
             { pubkey: manager, isSigner: true, isWritable: true },
             { pubkey: managerRole, isSigner: false, isWritable: false },
+            { pubkey: config, isSigner: false, isWritable: false },
             { pubkey: stv, isSigner: false, isWritable: true },
             { pubkey: vaultAta, isSigner: false, isWritable: true },
             { pubkey: baseMint, isSigner: false, isWritable: false },
@@ -222,7 +234,7 @@ function createWithdrawFromStrategyIx(args, programId = constants_1.PROGRAM_ID)
     });
 }
 function createCloseStvIx(args, programId = constants_1.PROGRAM_ID) {
-    const { admin, payer, config, stv, evMint, vaultAta, baseMint, tokenProgram, remainingAccounts = [] } = args;
+    const { admin, payer, config, stv, evMint, vaultAta, tokenProgram } = args;
     return new web3_js_1.TransactionInstruction({
         keys: [
             { pubkey: admin, isSigner: true, isWritable: false },
@@ -231,9 +243,7 @@ function createCloseStvIx(args, programId = constants_1.PROGRAM_ID) {
             { pubkey: stv, isSigner: false, isWritable: true },
             { pubkey: evMint, isSigner: false, isWritable: true },
             { pubkey: vaultAta, isSigner: false, isWritable: true },
-            { pubkey: baseMint, isSigner: false, isWritable: false },
             { pubkey: tokenProgram, isSigner: false, isWritable: false },
-            ...remainingAccounts,
         ],
         programId,
         data: Buffer.from([constants_1.IX_CLOSE_STV]),
@@ -269,6 +279,29 @@ function createRemoveManagerIx(args, programId = constants_1.PROGRAM_ID) {
         data: Buffer.from([constants_1.IX_REMOVE_MANAGER]),
     });
 }
+function createMigrateLendIx(args, programId = constants_1.PROGRAM_ID) {
+    const { admin, payer, config, stv, vaultAta, baseMint, tokenProgram, systemProgram = web3_js_1.SystemProgram.programId, oldLendProgram, newLendProgram, protocolAumCount, autoUnrouteCount, remainingAccounts = [], } = args;
+    const data = [constants_1.IX_MIGRATE_LEND];
+    data.push(...oldLendProgram.toBuffer());
+    data.push(...newLendProgram.toBuffer());
+    data.push(protocolAumCount & 0xff);
+    data.push(autoUnrouteCount & 0xff);
+    return new web3_js_1.TransactionInstruction({
+        keys: [
+            { pubkey: admin, isSigner: true, isWritable: false },
+            { pubkey: payer, isSigner: true, isWritable: true },
+            { pubkey: config, isSigner: false, isWritable: false },
+            { pubkey: stv, isSigner: false, isWritable: true },
+            { pubkey: vaultAta, isSigner: false, isWritable: true },
+            { pubkey: baseMint, isSigner: false, isWritable: false },
+            { pubkey: tokenProgram, isSigner: false, isWritable: false },
+            { pubkey: systemProgram, isSigner: false, isWritable: false },
+            ...remainingAccounts,
+        ],
+        programId,
+        data: Buffer.from(data),
+    });
+}
 // ---------------------------------------------------------------------------
 // Remaining Accounts Helpers
 // ---------------------------------------------------------------------------
@@ -287,4 +320,3 @@ function buildStrategyRemainingAccounts(strategies) {
     }
     return accounts;
 }
-//# sourceMappingURL=instructions.js.map

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

@@ -4,5 +4,12 @@ export declare function findConfigPda(programId?: PublicKey): [PublicKey, number
 export declare function findStvPda(vaultId: number | BN, programId?: PublicKey): [PublicKey, number];
 export declare function findEvMintPda(vaultId: number | BN, programId?: PublicKey): [PublicKey, number];
 export declare function findWithdrawRequestPda(stv: PublicKey, user: PublicKey, epochId: number, programId?: PublicKey): [PublicKey, number];
-export declare function findManagerRolePda(stv: PublicKey, manager: PublicKey, programId?: PublicKey): [PublicKey, number];
-//# sourceMappingURL=pda.d.ts.map
+/**
+ * Derive the per-STV `ManagerRole` PDA for p-STV Core.
+ * Seeds: `["manager", stv, manager]`.
+ *
+ * Note the per-program prefix on the name: each Elemental program has its
+ * own `ManagerRole` PDA scoped to a different anchor account
+ * (`elemental-lend` → strategy_state, `jlpd-strategy` → config).
+ */
+export declare function findStvManagerRolePda(stv: PublicKey, manager: PublicKey, programId?: PublicKey): [PublicKey, number];

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

@@ -7,7 +7,7 @@ exports.findConfigPda = findConfigPda;
 exports.findStvPda = findStvPda;
 exports.findEvMintPda = findEvMintPda;
 exports.findWithdrawRequestPda = findWithdrawRequestPda;
-exports.findManagerRolePda = findManagerRolePda;
+exports.findStvManagerRolePda = findStvManagerRolePda;
 const web3_js_1 = require("@solana/web3.js");
 const bn_js_1 = __importDefault(require("bn.js"));
 const constants_1 = require("./constants");
@@ -27,7 +27,14 @@ function findWithdrawRequestPda(stv, user, epochId, programId = constants_1.PROG
     epochBuf.writeUInt32LE(epochId, 0);
     return web3_js_1.PublicKey.findProgramAddressSync([constants_1.WITHDRAW_REQUEST_SEED, stv.toBuffer(), user.toBuffer(), epochBuf], programId);
 }
-function findManagerRolePda(stv, manager, programId = constants_1.PROGRAM_ID) {
+/**
+ * Derive the per-STV `ManagerRole` PDA for p-STV Core.
+ * Seeds: `["manager", stv, manager]`.
+ *
+ * Note the per-program prefix on the name: each Elemental program has its
+ * own `ManagerRole` PDA scoped to a different anchor account
+ * (`elemental-lend` → strategy_state, `jlpd-strategy` → config).
+ */
+function findStvManagerRolePda(stv, manager, programId = constants_1.PROGRAM_ID) {
     return web3_js_1.PublicKey.findProgramAddressSync([constants_1.MANAGER_SEED, stv.toBuffer(), manager.toBuffer()], programId);
 }
-//# sourceMappingURL=pda.js.map

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

@@ -18,4 +18,3 @@ export interface TokenPrice {
  * @returns Record<mint, usdPrice>
  */
 export declare function fetchUsdPrices(mints: string[]): Promise<Record<string, number>>;
-//# sourceMappingURL=prices.d.ts.map

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

@@ -75,4 +75,3 @@ async function fetchUsdPrices(mints) {
     }
     return prices;
 }
-//# sourceMappingURL=prices.js.map

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

@@ -6,13 +6,9 @@
  * lend + protocol AUM + strategy pair + auto-route/unroute account building
  * logic out of the frontend and into the SDK.
  */
-import { AccountMeta, Connection, PublicKey, TransactionInstruction } from "@solana/web3.js";
-/**
- * Minimal connection interface accepted by the context builders.
- * Using a structural type avoids nominal type mismatches when the
- * consumer has a different version of @solana/web3.js installed.
- */
-export type SolanaConnection = Pick<Connection, "getAccountInfo" | "getMultipleAccountsInfo" | "getTokenAccountsByOwner" | "getSlot" | "getEpochInfo" | "getBlockTime">;
+import { AccountMeta, PublicKey, TransactionInstruction } from "@solana/web3.js";
+import type { SolanaConnection } from "../common/connection";
+export type { SolanaConnection };
 /** Minimal vault shape required by the context builders. */
 export interface VaultInfo {
     /** STV account address */
@@ -43,6 +39,8 @@ export interface ClaimWithdrawContext {
 }
 export interface DepositToStrategyContext {
     remainingAccounts: AccountMeta[];
+    /** Number of protocol AUM accounts (after the 4 fixed lend accounts). */
+    protocolAumCount: number;
     autoUnrouteCount: number;
     preInstructions: TransactionInstruction[];
 }
@@ -76,17 +74,19 @@ export declare function buildDepositContext(connection: SolanaConnection, vault:
  * - If lend is active, derives lend PDAs
  * - If USDC + Jupiter Lend, appends auto-unroute accounts
  */
-export declare function buildClaimWithdrawContext(connection: SolanaConnection, vault: VaultInfo): Promise<ClaimWithdrawContext>;
+export declare function buildClaimWithdrawContext(vault: VaultInfo): Promise<ClaimWithdrawContext>;
 /**
  * Build the complete remaining_accounts for a deposit_to_strategy instruction.
  *
- * Layout: [4 lend, K auto_unroute]
+ * Layout: [4 fixed lend, N protocol_aum, K auto_unroute]
  *
- * Same as claim_withdraw: if lend is active, derives lend PDAs.
- * If USDC + Jupiter Lend, appends auto-unroute accounts for unsweep.
+ * - Fixed lend accounts (if lend is active)
+ * - Protocol AUM accounts: required by the on-chain handler to refresh lend
+ *   valuation via update_lend_aum before the reserved_base liquidity lock check
+ * - Auto-unroute accounts: forwarded to the lend withdraw CPI for unsweep
  *
- * Note: no Kamino invest pre-instructions here — deposit_to_strategy unsweeps
- * from the active protocol (Jupiter Lend for USDC), not Kamino.
+ * The `connection` parameter is required to fetch LendStrategyState and
+ * resolve protocol AUM accounts.
  */
 export declare function buildDepositToStrategyContext(connection: SolanaConnection, vault: VaultInfo): Promise<DepositToStrategyContext>;
 /**
@@ -96,4 +96,3 @@ export declare function buildDepositToStrategyContext(connection: SolanaConnecti
  *                'advance': empty remaining_accounts.
  */
 export declare function buildProcessEpochContext(connection: SolanaConnection, vault: VaultInfo, phase: "lockPps" | "advance"): Promise<ProcessEpochContext>;
-//# sourceMappingURL=remaining-accounts.d.ts.map