@elemental-stv-core/sdk 0.5.0 → 0.7.0

package/dist/elemental-lend/protocol-actions.d.ts

@@ -4,12 +4,14 @@
  * Builds complete instruction arrays for deposit/withdraw to/from
  * Kamino kVault and Jupiter Lend protocols. Ready to pass to sendSmartTx.
  */
-import { Connection, PublicKey, TransactionInstruction } from "@solana/web3.js";
+import { PublicKey, TransactionInstruction } from "@solana/web3.js";
 /**
- * Minimal connection interface to avoid nominal type mismatches when the
- * consumer has a different version of @solana/web3.js installed.
+ * Connection interface required by the protocol-action builders. This is a
+ * narrower subset of the canonical `SolanaConnection` defined in
+ * `common/connection.ts` — protocol actions only ever need to read accounts.
  */
-export type ProtocolActionConnection = Pick<Connection, "getAccountInfo" | "getMultipleAccountsInfo">;
+import type { SolanaConnection } from "../common/connection";
+export type ProtocolActionConnection = Pick<SolanaConnection, "getAccountInfo" | "getMultipleAccountsInfo">;
 import type { JupiterLendPool } from "./jupiter-lend";
 export type ProtocolType = "Kamino kVault" | "Jupiter Lend";
 export type ProtocolAction = "deposit" | "withdraw";
@@ -46,4 +48,3 @@ export interface ProtocolActionArgs {
  * @returns TransactionInstruction[] ready for sendSmartTx
  */
 export declare function buildProtocolActionIxs(args: ProtocolActionArgs): Promise<TransactionInstruction[]>;
-//# sourceMappingURL=protocol-actions.d.ts.map

package/dist/elemental-lend/protocol-actions.js

@@ -9,18 +9,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildProtocolActionIxs = buildProtocolActionIxs;
 const web3_js_1 = require("@solana/web3.js");
 const spl_token_1 = require("@solana/spl-token");
+const ata_1 = require("../common/ata");
 const constants_1 = require("./constants");
 const pda_1 = require("./pda");
 const kamino_vault_1 = require("./kamino-vault");
 const jupiter_lend_1 = require("./jupiter-lend");
 // ---------------------------------------------------------------------------
-// ATA derivation (inline to avoid spl-token runtime dep)
-// ---------------------------------------------------------------------------
-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;
-}
-// ---------------------------------------------------------------------------
 // Main Builder
 // ---------------------------------------------------------------------------
 /**
@@ -40,8 +34,8 @@ async function buildProtocolActionIxs(args) {
     const [strategyStatePda] = args.strategyState
         ? [args.strategyState]
         : (0, pda_1.findStrategyStatePda)(baseMint, programId);
-    const strategyBaseAta = findAta(baseMint, strategyStatePda, tokenProgram);
-    const [managerRolePda] = (0, pda_1.findManagerRolePda)(strategyStatePda, manager, programId);
+    const strategyBaseAta = (0, ata_1.findAta)(baseMint, strategyStatePda, tokenProgram);
+    const [managerRolePda] = (0, pda_1.findLendManagerRolePda)(strategyStatePda, manager, programId);
     if (protocolType === "Jupiter Lend") {
         return buildJupLendActionIxs({
             connection,
@@ -76,7 +70,7 @@ async function buildProtocolActionIxs(args) {
 }
 function buildJupLendActionIxs(params) {
     const { manager, strategyStatePda, strategyBaseAta, managerRolePda, action, amount, tokenProgram, pool, programId, } = params;
-    const strategyFtokenAta = findAta(pool.fTokenMint, strategyStatePda, tokenProgram);
+    const strategyFtokenAta = (0, ata_1.findAta)(pool.fTokenMint, strategyStatePda, tokenProgram);
     const JUP_LEND_PROG = new web3_js_1.PublicKey("jup3YeL8QhtSx1e253b2FDvsMNC87fDrgQZivbrndc9");
     // Fixed accounts for the Anchor instruction
     const fixedAccounts = [
@@ -132,18 +126,25 @@ async function buildKvaultActionIxs(params) {
             break;
         }
     }
-    // Fetch all reserves to read their lending_market field
+    // Fetch all reserves to read their lending_market field. `readReserveAccounts`
+    // (from kamino-vault.ts) is the canonical parser — keeps the KLend Reserve
+    // layout constants in one place.
     const reserveInfos = await connection.getMultipleAccountsInfo(reserveKeys);
     const klendReserves = [];
     for (let i = 0; i < reserveKeys.length; i++) {
         const rInfo = reserveInfos[i];
-        if (rInfo && rInfo.data.length >= 64) {
-            const lendingMarket = new web3_js_1.PublicKey(rInfo.data.subarray(32, 64));
+        if (!rInfo)
+            continue;
+        try {
+            const { lendingMarket } = (0, kamino_vault_1.readReserveAccounts)(rInfo.data);
             klendReserves.push({ reserve: reserveKeys[i], lendingMarket });
         }
+        catch {
+            // Skip reserves whose data isn't long enough for a full parse
+        }
     }
     const [sharesMint] = (0, kamino_vault_1.findKvaultSharesMint)(vaultState);
-    const strategySharesAta = findAta(sharesMint, strategyStatePda, tokenProgram);
+    const strategySharesAta = (0, ata_1.findAta)(sharesMint, strategyStatePda, tokenProgram);
     // Fixed accounts for the Anchor instruction
     const fixedAccounts = [
         { pubkey: manager, isSigner: true, isWritable: true },
@@ -188,7 +189,8 @@ async function buildKvaultWithdrawIxs(connection, fixedAccounts, vaultState, vau
     else {
         withdrawShares = amount; // fallback: 1:1
     }
-    // Cap to actual kvToken balance
+    // Cap to actual kvToken balance.
+    // SPL Token Account layout: [mint(0..32)][owner(32..64)][amount(64..72)]…
     const sharesAtaInfo = await connection.getAccountInfo(strategySharesAta);
     if (sharesAtaInfo) {
         const actualBalance = sharesAtaInfo.data.readBigUInt64LE(64);
@@ -196,7 +198,11 @@ async function buildKvaultWithdrawIxs(connection, fixedAccounts, vaultState, vau
             withdrawShares = actualBalance;
         }
     }
-    // Read reserve data for withdraw accounts
+    // Read reserve data for withdraw accounts.
+    // Kamino VaultState — first allocation slot starts at offset 312:
+    //   [312..344]  reserve       Pubkey
+    //   [344..376]  ctokenVault   Pubkey
+    // (See `kamino-vault.ts:VAULT_ALLOCATION_OFFSET` for the full table.)
     const reserveKey = new web3_js_1.PublicKey(vaultData.subarray(312, 344));
     const reserveInfo = await connection.getAccountInfo(reserveKey);
     if (!reserveInfo)
@@ -225,4 +231,3 @@ async function buildKvaultWithdrawIxs(connection, fixedAccounts, vaultState, vau
     });
     return [ix];
 }
-//# sourceMappingURL=protocol-actions.js.map

package/dist/elemental-lend/types.d.ts

@@ -110,4 +110,3 @@ export interface ManagerRemovedEvent {
     manager: PublicKey;
 }
 export type LendEvent = StrategyInitializedEvent | StrategyUpdatedEvent | PositionInitializedEvent | LendDepositEvent | LendWithdrawEvent | AumUpdatedEvent | KvaultDepositEvent | KvaultWithdrawEvent | JupLendDepositEvent | JupLendWithdrawEvent | ProtocolAddedEvent | ProtocolRemovedEvent | ManagerAddedEvent | ManagerRemovedEvent;
-//# sourceMappingURL=types.d.ts.map

package/dist/elemental-lend/types.js

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

package/dist/index.d.ts

@@ -2,4 +2,3 @@ export * as common from "./common";
 export * as pStvCore from "./p-stv-core";
 export * as elementalLend from "./elemental-lend";
 export * as jlpdStrategy from "./jlpd-strategy";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -38,4 +38,3 @@ exports.common = __importStar(require("./common"));
 exports.pStvCore = __importStar(require("./p-stv-core"));
 exports.elementalLend = __importStar(require("./elemental-lend"));
 exports.jlpdStrategy = __importStar(require("./jlpd-strategy"));
-//# sourceMappingURL=index.js.map

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

@@ -1,17 +1,70 @@
-import { Connection, PublicKey } from "@solana/web3.js";
+import { PublicKey } from "@solana/web3.js";
 import type { StvPosition } from "../common/strategy-interface";
+import type { SolanaConnection } from "../common/connection";
 import { JlpdConfig, ManagerRole, JlpStrategyState } from "./types";
+/**
+ * JlpdConfig — singleton config shared across all five base-asset strategies.
+ * Total 272 bytes.
+ *
+ * Layout (offsets include the 8-byte discriminator):
+ *   [  0..  8]  discriminator                  (sha256("account:JlpdConfig")[..8])
+ *   [  8.. 40]  admin                           Pubkey
+ *   [ 40.. 72]  jlpMint                         Pubkey
+ *   [ 72..232]  baseAssetMints[5]               [Pubkey; 5]   (BTC, ETH, SOL, USDC, JupUSD)
+ *   [232..240]  oracleStalenessTh               u64           (max age in seconds)
+ *   [240..242]  flags                           u16
+ *   [242..244]  jlpSlippageBps                  u16           (max slippage on swap_jlp)
+ *   [244..245]  version                         u8
+ *   [245..246]  bump                            u8
+ *   [246..272]  _reserved                       [u8; 26]
+ */
 export declare function deserializeJlpdConfig(data: Buffer): JlpdConfig;
-/** @deprecated Use deserializeJlpdConfig instead */
-export declare const deserializeJlpVault: typeof deserializeJlpdConfig;
+/**
+ * ManagerRole — per-(config, manager) authorization. Total 80 bytes.
+ *
+ * Layout (offsets include the 8-byte discriminator):
+ *   [  0..  8]  discriminator       (sha256("account:ManagerRole")[..8] —
+ *                                     shared with p-stv-core + elemental-lend)
+ *   [  8.. 40]  config               Pubkey
+ *   [ 40.. 72]  manager              Pubkey
+ *   [ 72.. 73]  bump                 u8
+ *   [ 73.. 80]  _padding             [u8; 7]
+ */
 export declare function deserializeManagerRole(data: Buffer): ManagerRole;
+/**
+ * JlpStrategyState — per-base-asset JLPD strategy account. Total 224 bytes.
+ *
+ * Layout (offsets include the 8-byte discriminator):
+ *   [  0..  8]  discriminator                  (sha256("account:StrategyState")[..8] —
+ *                                                shared with elemental-lend)
+ *   --- StrategyStateHeader (104 bytes, identical across all strategy programs) ---
+ *   [  8.. 40]  baseMint                        Pubkey
+ *   [ 40.. 72]  authority                       Pubkey   (p-stv-core program)
+ *   [ 72.. 80]  pps                             u64      (scaled by PPS_DECIMALS = 10^9)
+ *   [ 80.. 88]  totalAum                        u64
+ *   [ 88.. 96]  totalShares                     u64
+ *   [ 96..104]  lastUpdated                     u64      (unix seconds)
+ *   [104..106]  flags                           u16
+ *   [106..107]  version                         u8
+ *   [107..108]  bump                            u8
+ *   [108..112]  _headerPadding                  [u8; 4]
+ *   --- Custom JLPD fields (112 bytes) ---
+ *   [112..120]  baseLoaned                      u64      (base assets swapped into JLP)
+ *   [120..224]  _reserved                       [u8; 104]
+ */
 export declare function deserializeJlpStrategyState(data: Buffer): JlpStrategyState;
+/**
+ * StvPosition — per-STV virtual share record. Total 120 bytes.
+ *
+ * The on-disk layout is identical across elemental-lend and jlpd-strategy
+ * (`StvPosition` from `common/strategy-interface.ts`). The 8-byte
+ * discriminator validation here distinguishes the two so a `LendStvPosition`
+ * can't be parsed as a JLPD position by mistake. See
+ * `common/strategy-interface.ts` for the field-by-field layout.
+ */
 export declare function deserializeJlpStvPosition(data: Buffer): StvPosition;
-export declare function fetchJlpdConfig(connection: Connection, programId?: PublicKey): Promise<JlpdConfig>;
-/** @deprecated Use fetchJlpdConfig instead */
-export declare const fetchJlpVault: typeof fetchJlpdConfig;
-export declare function fetchJlpStrategyState(connection: Connection, baseMint: PublicKey, programId?: PublicKey): Promise<JlpStrategyState>;
-export declare function fetchJlpStvPosition(connection: Connection, stv: PublicKey, programId?: PublicKey): Promise<StvPosition>;
-export declare function fetchAllJlpStrategyStates(connection: Connection, programId?: PublicKey): Promise<[PublicKey, JlpStrategyState][]>;
-export declare function fetchManagersForConfig(connection: Connection, config: PublicKey, programId?: PublicKey): Promise<[PublicKey, ManagerRole][]>;
-//# sourceMappingURL=accounts.d.ts.map
+export declare function fetchJlpdConfig(connection: SolanaConnection, programId?: PublicKey): Promise<JlpdConfig>;
+export declare function fetchJlpStrategyState(connection: SolanaConnection, baseMint: PublicKey, programId?: PublicKey): Promise<JlpStrategyState>;
+export declare function fetchJlpStvPosition(connection: SolanaConnection, stv: PublicKey, programId?: PublicKey): Promise<StvPosition>;
+export declare function fetchAllJlpStrategyStates(connection: SolanaConnection, programId?: PublicKey): Promise<[PublicKey, JlpStrategyState][]>;
+export declare function fetchManagersForConfig(connection: SolanaConnection, config: PublicKey, programId?: PublicKey): Promise<[PublicKey, ManagerRole][]>;

package/dist/jlpd-strategy/accounts.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchJlpVault = exports.deserializeJlpVault = void 0;
 exports.deserializeJlpdConfig = deserializeJlpdConfig;
 exports.deserializeManagerRole = deserializeManagerRole;
 exports.deserializeJlpStrategyState = deserializeJlpStrategyState;
@@ -16,7 +15,29 @@ 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.
 // ---------------------------------------------------------------------------
+/**
+ * JlpdConfig — singleton config shared across all five base-asset strategies.
+ * Total 272 bytes.
+ *
+ * Layout (offsets include the 8-byte discriminator):
+ *   [  0..  8]  discriminator                  (sha256("account:JlpdConfig")[..8])
+ *   [  8.. 40]  admin                           Pubkey
+ *   [ 40.. 72]  jlpMint                         Pubkey
+ *   [ 72..232]  baseAssetMints[5]               [Pubkey; 5]   (BTC, ETH, SOL, USDC, JupUSD)
+ *   [232..240]  oracleStalenessTh               u64           (max age in seconds)
+ *   [240..242]  flags                           u16
+ *   [242..244]  jlpSlippageBps                  u16           (max slippage on swap_jlp)
+ *   [244..245]  version                         u8
+ *   [245..246]  bump                            u8
+ *   [246..272]  _reserved                       [u8; 26]
+ */
 function deserializeJlpdConfig(data) {
     if (data.length < constants_1.JLPD_CONFIG_SIZE) {
         throw new Error(`JlpdConfig data too short: ${data.length} < ${constants_1.JLPD_CONFIG_SIZE}`);
@@ -38,10 +59,21 @@ function deserializeJlpdConfig(data) {
         jlpSlippageBps: (0, buffer_1.readU16)(data, 242),
         version: (0, buffer_1.readU8)(data, 244),
         bump: (0, buffer_1.readU8)(data, 245),
+        jlpEarnAmount: (0, buffer_1.readU64)(data, 248),
+        jlpAdapterProgram: (0, buffer_1.readPubkey)(data, 256),
     };
 }
-/** @deprecated Use deserializeJlpdConfig instead */
-exports.deserializeJlpVault = deserializeJlpdConfig;
+/**
+ * ManagerRole — per-(config, manager) authorization. Total 80 bytes.
+ *
+ * Layout (offsets include the 8-byte discriminator):
+ *   [  0..  8]  discriminator       (sha256("account:ManagerRole")[..8] —
+ *                                     shared with p-stv-core + elemental-lend)
+ *   [  8.. 40]  config               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}`);
@@ -56,6 +88,27 @@ function deserializeManagerRole(data) {
         bump: (0, buffer_1.readU8)(data, 72),
     };
 }
+/**
+ * JlpStrategyState — per-base-asset JLPD strategy account. Total 224 bytes.
+ *
+ * Layout (offsets include the 8-byte discriminator):
+ *   [  0..  8]  discriminator                  (sha256("account:StrategyState")[..8] —
+ *                                                shared with elemental-lend)
+ *   --- StrategyStateHeader (104 bytes, identical across all strategy programs) ---
+ *   [  8.. 40]  baseMint                        Pubkey
+ *   [ 40.. 72]  authority                       Pubkey   (p-stv-core program)
+ *   [ 72.. 80]  pps                             u64      (scaled by PPS_DECIMALS = 10^9)
+ *   [ 80.. 88]  totalAum                        u64
+ *   [ 88.. 96]  totalShares                     u64
+ *   [ 96..104]  lastUpdated                     u64      (unix seconds)
+ *   [104..106]  flags                           u16
+ *   [106..107]  version                         u8
+ *   [107..108]  bump                            u8
+ *   [108..112]  _headerPadding                  [u8; 4]
+ *   --- Custom JLPD fields (112 bytes) ---
+ *   [112..120]  baseLoaned                      u64      (base assets swapped into JLP)
+ *   [120..224]  _reserved                       [u8; 104]
+ */
 function deserializeJlpStrategyState(data) {
     if (data.length < constants_1.STRATEGY_STATE_SIZE) {
         throw new Error(`JlpStrategyState data too short: ${data.length} < ${constants_1.STRATEGY_STATE_SIZE}`);
@@ -79,6 +132,15 @@ function deserializeJlpStrategyState(data) {
         baseLoaned: (0, buffer_1.readU64)(data, 112),
     };
 }
+/**
+ * StvPosition — per-STV virtual share record. Total 120 bytes.
+ *
+ * The on-disk layout is identical across elemental-lend and jlpd-strategy
+ * (`StvPosition` from `common/strategy-interface.ts`). The 8-byte
+ * discriminator validation here distinguishes the two so a `LendStvPosition`
+ * can't be parsed as a JLPD position by mistake. See
+ * `common/strategy-interface.ts` for the field-by-field layout.
+ */
 function deserializeJlpStvPosition(data) {
     if (data.length < constants_1.STV_POSITION_SIZE) {
         throw new Error(`StvPosition data too short: ${data.length} < ${constants_1.STV_POSITION_SIZE}`);
@@ -99,8 +161,6 @@ async function fetchJlpdConfig(connection, programId = constants_1.PROGRAM_ID) {
         throw new Error("JlpdConfig account not found");
     return deserializeJlpdConfig(info.data);
 }
-/** @deprecated Use fetchJlpdConfig instead */
-exports.fetchJlpVault = fetchJlpdConfig;
 async function fetchJlpStrategyState(connection, baseMint, programId = constants_1.PROGRAM_ID) {
     const [pda] = (0, pda_1.findStrategyStatePda)(baseMint, programId);
     const info = await connection.getAccountInfo(pda);
@@ -132,9 +192,8 @@ async function fetchManagersForConfig(connection, config, programId = constants_
         filters: [
             { dataSize: constants_1.MANAGER_ROLE_SIZE },
             { memcmp: { offset: 0, bytes: constants_1.DISC_MANAGER_ROLE.toString("base64"), encoding: "base64" } },
-            { memcmp: { offset: 8, bytes: config.toBase58() } },
+            { memcmp: { offset: 8, bytes: config.toBuffer().toString("base64"), encoding: "base64" } },
         ],
     });
     return accounts.map((a) => [a.pubkey, deserializeManagerRole(a.account.data)]);
 }
-//# sourceMappingURL=accounts.js.map

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

@@ -2,7 +2,7 @@
  * JLPD Adapter instruction builders.
  *
  * These build JLPD-side instructions (deposit_to_adapter, withdraw_from_adapter)
- * that CPI into the earn adapter program.
+ * that CPI into the JLPD Lend Adapter program.
  */
 import { PublicKey, TransactionInstruction, AccountMeta } from "@solana/web3.js";
 import BN from "bn.js";
@@ -58,4 +58,3 @@ export interface AdapterManageArgs {
  * Anchor data: [8-byte disc, AdapterManageParams(u8 + u64)]
  */
 export declare function createAdapterManageIx(args: AdapterManageArgs, programId?: PublicKey): TransactionInstruction;
-//# sourceMappingURL=adapter.d.ts.map

package/dist/jlpd-strategy/adapter.js

@@ -3,7 +3,7 @@
  * JLPD Adapter instruction builders.
  *
  * These build JLPD-side instructions (deposit_to_adapter, withdraw_from_adapter)
- * that CPI into the earn adapter program.
+ * that CPI into the JLPD Lend Adapter program.
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
@@ -88,4 +88,3 @@ function createAdapterManageIx(args, programId = constants_1.PROGRAM_ID) {
         data,
     });
 }
-//# sourceMappingURL=adapter.js.map

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

@@ -20,14 +20,8 @@ export declare const CONFIG_SEED: Buffer<ArrayBuffer>;
 export declare const MANAGER_SEED: Buffer<ArrayBuffer>;
 export declare const STRATEGY_STATE_SEED: Buffer<ArrayBuffer>;
 export declare const POSITION_SEED: Buffer<ArrayBuffer>;
-/** @deprecated Use CONFIG_SEED instead */
-export declare const JLP_VAULT_SEED: Buffer<ArrayBuffer>;
 export declare const DISC_JLPD_CONFIG: Buffer<ArrayBuffer>;
-export declare const DISC_MANAGER_ROLE: Buffer<ArrayBuffer>;
-export declare const DISC_STRATEGY_STATE: Buffer<ArrayBuffer>;
-export declare const DISC_STV_POSITION: Buffer<ArrayBuffer>;
-/** @deprecated Use DISC_JLPD_CONFIG instead */
-export declare const DISC_JLP_VAULT: Buffer<ArrayBuffer>;
+export { DISC_STRATEGY_STATE, DISC_STV_POSITION, DISC_MANAGER_ROLE, } from "../common/constants";
 export declare const IX_INIT_OR_UPDATE_CONFIG: Buffer<ArrayBuffer>;
 export declare const IX_INIT_OR_UPDATE_STRATEGY_STATE: Buffer<ArrayBuffer>;
 export declare const IX_INIT_POSITION: Buffer<ArrayBuffer>;
@@ -42,14 +36,10 @@ export declare const IX_WITHDRAW_FROM_ADAPTER: Buffer<ArrayBuffer>;
 export declare const IX_ADAPTER_MANAGE: Buffer<ArrayBuffer>;
 export declare const IX_ADD_MANAGER: Buffer<ArrayBuffer>;
 export declare const IX_REMOVE_MANAGER: Buffer<ArrayBuffer>;
-/** @deprecated Use IX_INIT_OR_UPDATE_CONFIG instead */
-export declare const IX_INIT_OR_UPDATE_JLP_VAULT: Buffer<ArrayBuffer>;
 export declare const JLPD_CONFIG_SIZE = 392;
 export declare const MANAGER_ROLE_SIZE = 80;
 export declare const STRATEGY_STATE_SIZE = 224;
 export declare const STV_POSITION_SIZE = 120;
-/** @deprecated Use JLPD_CONFIG_SIZE instead */
-export declare const JLP_VAULT_SIZE = 392;
 export declare const FLAG_PAUSED = 1;
 export declare const FLAG_DEPOSITS_DISABLED = 2;
 export declare const FLAG_WITHDRAWALS_DISABLED = 4;
@@ -60,6 +50,24 @@ export declare const NUM_ASSETS = 5;
 export declare const MAX_MGMT_FEE_BPS = 500;
 export declare const MAX_PERF_FEE_BPS = 3000;
 export { PPS_DECIMALS, BPS_DENOMINATOR } from "../common/constants";
-/** Maps base_mint address → p-STV Core vault_id for JLPD strategy STVs */
+/** Stable per-pool registry for JLPD strategy STVs.
+ *
+ * Each entry is the canonical record for a pool: short symbol, base mint
+ * address (base58), p-STV Core vault id, and base mint decimals. The
+ * `JLPD_VAULT_IDS` and `JLPD_POOL_NAMES_BY_VAULT_ID` lookups below are
+ * derived from this single table so consumers cannot get out of sync.
+ */
+export declare const JLPD_POOLS: ReadonlyArray<{
+    readonly name: "BTC" | "ETH" | "SOL" | "USDC" | "JupUSD";
+    readonly mint: string;
+    readonly vaultId: number;
+    readonly decimals: number;
+}>;
+/** Pool symbol type derived from `JLPD_POOLS`. */
+export type JlpdPoolName = (typeof JLPD_POOLS)[number]["name"];
+/** Lookup: base_mint (base58) → vault_id. Derived from `JLPD_POOLS`. */
 export declare const JLPD_VAULT_IDS: Record<string, number>;
-//# sourceMappingURL=constants.d.ts.map
+/** Lookup: pool symbol → vault_id. Derived from `JLPD_POOLS`. */
+export declare const JLPD_VAULT_IDS_BY_POOL: Record<JlpdPoolName, number>;
+/** Lookup: pool symbol → base mint decimals. Derived from `JLPD_POOLS`. */
+export declare const JLPD_POOL_DECIMALS: Record<JlpdPoolName, number>;

package/dist/jlpd-strategy/constants.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PPS_DECIMALS = exports.MAX_PERF_FEE_BPS = exports.MAX_MGMT_FEE_BPS = exports.NUM_ASSETS = exports.FLAG_TEST_MODE = exports.FLAG_REBALANCE_DISABLED = exports.FLAG_JLP_DISABLED = exports.FLAG_WITHDRAWALS_DISABLED = exports.FLAG_DEPOSITS_DISABLED = exports.FLAG_PAUSED = exports.JLP_VAULT_SIZE = exports.STV_POSITION_SIZE = exports.STRATEGY_STATE_SIZE = exports.MANAGER_ROLE_SIZE = exports.JLPD_CONFIG_SIZE = exports.IX_INIT_OR_UPDATE_JLP_VAULT = exports.IX_REMOVE_MANAGER = exports.IX_ADD_MANAGER = exports.IX_ADAPTER_MANAGE = exports.IX_WITHDRAW_FROM_ADAPTER = exports.IX_DEPOSIT_TO_ADAPTER = exports.IX_SETTLE_YIELD = exports.IX_SWAP_JLP = exports.IX_UPDATE_AUM = exports.IX_WITHDRAW = exports.IX_DEPOSIT = exports.IX_CLOSE_POSITION = exports.IX_INIT_POSITION = exports.IX_INIT_OR_UPDATE_STRATEGY_STATE = exports.IX_INIT_OR_UPDATE_CONFIG = exports.DISC_JLP_VAULT = exports.DISC_STV_POSITION = exports.DISC_STRATEGY_STATE = exports.DISC_MANAGER_ROLE = exports.DISC_JLPD_CONFIG = exports.JLP_VAULT_SEED = exports.POSITION_SEED = exports.STRATEGY_STATE_SEED = exports.MANAGER_SEED = exports.CONFIG_SEED = exports.JUPITER_PERPS_PROGRAM = exports.JLP_POOL_ACCOUNT = exports.DOVES_SOL_USD = exports.DOVES_ETH_USD = exports.DOVES_BTC_USD = exports.JUPITER_PROGRAM = exports.JLP_MINT = exports.PROGRAM_ID_DEVNET = exports.PROGRAM_ID_MAINNET = exports.PROGRAM_ID = void 0;
-exports.JLPD_VAULT_IDS = exports.BPS_DENOMINATOR = void 0;
+exports.JLPD_VAULT_IDS_BY_POOL = exports.JLPD_VAULT_IDS = exports.JLPD_POOLS = exports.BPS_DENOMINATOR = exports.PPS_DECIMALS = exports.MAX_PERF_FEE_BPS = exports.MAX_MGMT_FEE_BPS = exports.NUM_ASSETS = exports.FLAG_TEST_MODE = exports.FLAG_REBALANCE_DISABLED = exports.FLAG_JLP_DISABLED = exports.FLAG_WITHDRAWALS_DISABLED = exports.FLAG_DEPOSITS_DISABLED = exports.FLAG_PAUSED = exports.STV_POSITION_SIZE = exports.STRATEGY_STATE_SIZE = exports.MANAGER_ROLE_SIZE = exports.JLPD_CONFIG_SIZE = exports.IX_REMOVE_MANAGER = exports.IX_ADD_MANAGER = exports.IX_ADAPTER_MANAGE = exports.IX_WITHDRAW_FROM_ADAPTER = exports.IX_DEPOSIT_TO_ADAPTER = exports.IX_SETTLE_YIELD = exports.IX_SWAP_JLP = exports.IX_UPDATE_AUM = exports.IX_WITHDRAW = exports.IX_DEPOSIT = exports.IX_CLOSE_POSITION = exports.IX_INIT_POSITION = exports.IX_INIT_OR_UPDATE_STRATEGY_STATE = exports.IX_INIT_OR_UPDATE_CONFIG = exports.DISC_MANAGER_ROLE = exports.DISC_STV_POSITION = exports.DISC_STRATEGY_STATE = exports.DISC_JLPD_CONFIG = exports.POSITION_SEED = exports.STRATEGY_STATE_SEED = exports.MANAGER_SEED = exports.CONFIG_SEED = exports.JUPITER_PERPS_PROGRAM = exports.JLP_POOL_ACCOUNT = exports.DOVES_SOL_USD = exports.DOVES_ETH_USD = exports.DOVES_BTC_USD = exports.JUPITER_PROGRAM = exports.JLP_MINT = exports.PROGRAM_ID_DEVNET = exports.PROGRAM_ID_MAINNET = exports.PROGRAM_ID = void 0;
+exports.JLPD_POOL_DECIMALS = void 0;
 const web3_js_1 = require("@solana/web3.js");
 exports.PROGRAM_ID = new web3_js_1.PublicKey("GXqt4ZH2UUBsLWwMNJiZMXza3q7xEGChfW8XjVRjLxr5");
 exports.PROGRAM_ID_MAINNET = exports.PROGRAM_ID;
@@ -28,17 +28,14 @@ exports.CONFIG_SEED = Buffer.from("config");
 exports.MANAGER_SEED = Buffer.from("manager");
 exports.STRATEGY_STATE_SEED = Buffer.from("strategy_state");
 exports.POSITION_SEED = Buffer.from("position");
-/** @deprecated Use CONFIG_SEED instead */
-exports.JLP_VAULT_SEED = exports.CONFIG_SEED;
 // Account discriminators (Anchor 8-byte)
-// sha256("account:JlpdConfig")[..8]
+// sha256("account:JlpdConfig")[..8] — JLPD-specific
 exports.DISC_JLPD_CONFIG = Buffer.from([185, 146, 185, 28, 172, 71, 122, 38]);
-// sha256("account:ManagerRole")[..8]
-exports.DISC_MANAGER_ROLE = Buffer.from([37, 232, 100, 233, 170, 233, 219, 185]);
-exports.DISC_STRATEGY_STATE = Buffer.from([83, 18, 224, 109, 174, 100, 39, 139]);
-exports.DISC_STV_POSITION = Buffer.from([47, 212, 251, 176, 138, 160, 30, 87]);
-/** @deprecated Use DISC_JLPD_CONFIG instead */
-exports.DISC_JLP_VAULT = exports.DISC_JLPD_CONFIG;
+// Shared types — defined once in common/, re-exported here
+var constants_1 = require("../common/constants");
+Object.defineProperty(exports, "DISC_STRATEGY_STATE", { enumerable: true, get: function () { return constants_1.DISC_STRATEGY_STATE; } });
+Object.defineProperty(exports, "DISC_STV_POSITION", { enumerable: true, get: function () { return constants_1.DISC_STV_POSITION; } });
+Object.defineProperty(exports, "DISC_MANAGER_ROLE", { enumerable: true, get: function () { return constants_1.DISC_MANAGER_ROLE; } });
 // Instruction discriminators (Anchor 8-byte)
 exports.IX_INIT_OR_UPDATE_CONFIG = Buffer.from([234, 24, 218, 120, 213, 149, 245, 213]);
 exports.IX_INIT_OR_UPDATE_STRATEGY_STATE = Buffer.from([223, 7, 93, 99, 12, 44, 180, 255]);
@@ -59,15 +56,11 @@ exports.IX_ADAPTER_MANAGE = Buffer.from([210, 30, 127, 237, 109, 210, 2, 212]);
 exports.IX_ADD_MANAGER = Buffer.from([125, 38, 192, 212, 101, 91, 179, 16]);
 // sha256("global:remove_manager")[..8]
 exports.IX_REMOVE_MANAGER = Buffer.from([150, 55, 157, 77, 128, 148, 7, 15]);
-/** @deprecated Use IX_INIT_OR_UPDATE_CONFIG instead */
-exports.IX_INIT_OR_UPDATE_JLP_VAULT = exports.IX_INIT_OR_UPDATE_CONFIG;
 // Account sizes
 exports.JLPD_CONFIG_SIZE = 392;
 exports.MANAGER_ROLE_SIZE = 80;
 exports.STRATEGY_STATE_SIZE = 224;
 exports.STV_POSITION_SIZE = 120;
-/** @deprecated Use JLPD_CONFIG_SIZE instead */
-exports.JLP_VAULT_SIZE = exports.JLPD_CONFIG_SIZE;
 // Flags
 exports.FLAG_PAUSED = 0x0001;
 exports.FLAG_DEPOSITS_DISABLED = 0x0002;
@@ -79,15 +72,26 @@ exports.FLAG_TEST_MODE = 0x0020;
 exports.NUM_ASSETS = 5;
 exports.MAX_MGMT_FEE_BPS = 500;
 exports.MAX_PERF_FEE_BPS = 3000;
-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; } });
-/** Maps base_mint address → p-STV Core vault_id for JLPD strategy STVs */
-exports.JLPD_VAULT_IDS = {
-    "3NZ9JMVBmGAqocybic2c7LQCJScmgsAZ6vQqTDzcqmJh": 11, // BTC
-    "7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs": 12, // ETH
-    "So11111111111111111111111111111111111111112": 13, // SOL
-    "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v": 14, // USDC
-    "JuprjznTrTSp2UFa3ZBUFgwdAmtZCq4MQCwysN55USD": 15, // JupUSD
-};
-//# sourceMappingURL=constants.js.map
+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; } });
+/** Stable per-pool registry for JLPD strategy STVs.
+ *
+ * Each entry is the canonical record for a pool: short symbol, base mint
+ * address (base58), p-STV Core vault id, and base mint decimals. The
+ * `JLPD_VAULT_IDS` and `JLPD_POOL_NAMES_BY_VAULT_ID` lookups below are
+ * derived from this single table so consumers cannot get out of sync.
+ */
+exports.JLPD_POOLS = [
+    { name: "BTC", mint: "3NZ9JMVBmGAqocybic2c7LQCJScmgsAZ6vQqTDzcqmJh", vaultId: 11, decimals: 8 },
+    { name: "ETH", mint: "7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs", vaultId: 12, decimals: 8 },
+    { name: "SOL", mint: "So11111111111111111111111111111111111111112", vaultId: 13, decimals: 9 },
+    { name: "USDC", mint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", vaultId: 14, decimals: 6 },
+    { name: "JupUSD", mint: "JuprjznTrTSp2UFa3ZBUFgwdAmtZCq4MQCwysN55USD", vaultId: 15, decimals: 6 },
+];
+/** Lookup: base_mint (base58) → vault_id. Derived from `JLPD_POOLS`. */
+exports.JLPD_VAULT_IDS = Object.fromEntries(exports.JLPD_POOLS.map((p) => [p.mint, p.vaultId]));
+/** Lookup: pool symbol → vault_id. Derived from `JLPD_POOLS`. */
+exports.JLPD_VAULT_IDS_BY_POOL = Object.fromEntries(exports.JLPD_POOLS.map((p) => [p.name, p.vaultId]));
+/** Lookup: pool symbol → base mint decimals. Derived from `JLPD_POOLS`. */
+exports.JLPD_POOL_DECIMALS = Object.fromEntries(exports.JLPD_POOLS.map((p) => [p.name, p.decimals]));

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

@@ -9,4 +9,3 @@ export * from "./jlp-data";
 export * from "./jlp-borrow";
 export * from "./jupusd-earn";
 export * from "./adapter";
-//# sourceMappingURL=index.d.ts.map

package/dist/jlpd-strategy/index.js

@@ -25,4 +25,3 @@ __exportStar(require("./jlp-data"), exports);
 __exportStar(require("./jlp-borrow"), exports);
 __exportStar(require("./jupusd-earn"), exports);
 __exportStar(require("./adapter"), exports);
-//# sourceMappingURL=index.js.map

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

@@ -38,4 +38,3 @@ export interface RemoveManagerArgs {
  *   3. manager_role  (writable — closed)
  */
 export declare function createRemoveManagerIx(args: RemoveManagerArgs, programId?: PublicKey): TransactionInstruction;
-//# sourceMappingURL=instructions.d.ts.map

package/dist/jlpd-strategy/instructions.js

@@ -61,4 +61,3 @@ function createRemoveManagerIx(args, programId = constants_1.PROGRAM_ID) {
         data,
     });
 }
-//# sourceMappingURL=instructions.js.map

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

@@ -3,6 +3,17 @@
  *
  * The instruction builders for deposit/withdraw are in adapter.ts.
  * This file provides static account addresses and position parsing utilities.
+ *
+ * @remarks
+ * Read-only utilities for displaying JLP Borrow positions. This module exports
+ * **no instruction builders** — all on-chain operations against the Jupiter
+ * Lend Borrow program are routed through `adapter.ts`. The exports here are:
+ *
+ *   - Static program / account constants (program IDs, vault accounts, oracles)
+ *   - `parsePosition` — deserializes a position account
+ *   - `readBorrowExchangePrice` — reads the vault state exchange price
+ *
+ * Anything new that needs to *send transactions* should live in `adapter.ts`.
  */
 import { PublicKey } from "@solana/web3.js";
 import BN from "bn.js";
@@ -30,6 +41,23 @@ export interface BorrowPosition {
     dustDebtAmount: BN;
     positionMint: PublicKey;
 }
+/**
+ * Parse a Jupiter Lend Borrow Position account.
+ *
+ * Layout (offsets include the 8-byte discriminator):
+ *   [  0..  8]  discriminator         (sha256("account:Position")[..8] —
+ *                                       value documented in `POSITION_DISCRIMINATOR`)
+ *   [  8.. 14]  _padding              [u8; 6]
+ *   [ 14.. 46]  positionMint          Pubkey   (NFT mint that owns this position)
+ *   [ 46.. 47]  _padding              u8
+ *   [ 47.. 51]  tick                  i32      (signed Fluid Vaults tick)
+ *   [ 51.. 55]  _padding              [u8; 4]
+ *   [ 55.. 63]  supplyAmount          u64      (collateral)
+ *   [ 63.. 71]  dustDebtAmount        u64      (residual borrow)
+ */
 export declare function parsePosition(data: Buffer): BorrowPosition;
+/**
+ * Read the exchange price (1e12 precision) from a Jupiter Lend Borrow VaultState
+ * account. The price is at offset 107 (u64 LE) within the account data.
+ */
 export declare function readBorrowExchangePrice(vaultStateData: Buffer): BN;
-//# sourceMappingURL=jlp-borrow.d.ts.map