@elemental-stv-core/sdk 0.4.0 → 0.6.0

package/dist/jlpd-strategy/constants.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.JLPD_VAULT_IDS = 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.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_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_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;
@@ -27,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]);
@@ -48,19 +46,21 @@ exports.IX_WITHDRAW = Buffer.from([183, 18, 70, 156, 148, 109, 161, 34]);
 exports.IX_UPDATE_AUM = Buffer.from([162, 40, 227, 16, 84, 169, 182, 185]);
 exports.IX_SWAP_JLP = Buffer.from([190, 44, 224, 191, 169, 243, 146, 127]);
 exports.IX_SETTLE_YIELD = Buffer.from([64, 28, 44, 24, 43, 204, 58, 215]);
+// sha256("global:deposit_to_adapter")[..8]
+exports.IX_DEPOSIT_TO_ADAPTER = Buffer.from([123, 167, 9, 180, 75, 80, 195, 219]);
+// sha256("global:withdraw_from_adapter")[..8]
+exports.IX_WITHDRAW_FROM_ADAPTER = Buffer.from([87, 57, 243, 113, 157, 131, 135, 83]);
+// sha256("global:adapter_manage")[..8]
+exports.IX_ADAPTER_MANAGE = Buffer.from([210, 30, 127, 237, 109, 210, 2, 212]);
 // sha256("global:add_manager")[..8]
 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 = 272;
+exports.JLPD_CONFIG_SIZE = 392;
 exports.MANAGER_ROLE_SIZE = 80;
-exports.STRATEGY_STATE_SIZE = 160;
-exports.STV_POSITION_SIZE = 56;
-/** @deprecated Use JLPD_CONFIG_SIZE instead */
-exports.JLP_VAULT_SIZE = exports.JLPD_CONFIG_SIZE;
+exports.STRATEGY_STATE_SIZE = 224;
+exports.STV_POSITION_SIZE = 120;
 // Flags
 exports.FLAG_PAUSED = 0x0001;
 exports.FLAG_DEPOSITS_DISABLED = 0x0002;
@@ -72,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

@@ -6,4 +6,6 @@ export * from "./instructions";
 export * from "./swap-jlp";
 export * from "./settle-yield";
 export * from "./jlp-data";
-//# sourceMappingURL=index.d.ts.map
+export * from "./jlp-borrow";
+export * from "./jupusd-earn";
+export * from "./adapter";

package/dist/jlpd-strategy/index.js

@@ -22,4 +22,6 @@ __exportStar(require("./instructions"), exports);
 __exportStar(require("./swap-jlp"), exports);
 __exportStar(require("./settle-yield"), exports);
 __exportStar(require("./jlp-data"), exports);
-//# sourceMappingURL=index.js.map
+__exportStar(require("./jlp-borrow"), exports);
+__exportStar(require("./jupusd-earn"), exports);
+__exportStar(require("./adapter"), exports);

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

@@ -0,0 +1,63 @@
+/**
+ * Jupiter Lend Borrow (Fluid Vaults) — account constants and position reading.
+ *
+ * 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";
+export declare const JUP_LEND_BORROW_PROGRAM: PublicKey;
+export declare const BORROW_VAULT_CONFIG: PublicKey;
+export declare const BORROW_VAULT_STATE: PublicKey;
+export declare const BORROW_ORACLE: PublicKey;
+export declare const SUPPLY_RESERVES_LIQUIDITY: PublicKey;
+export declare const BORROW_RESERVES_LIQUIDITY: PublicKey;
+export declare const VAULT_SUPPLY_POS_ON_LIQ: PublicKey;
+export declare const VAULT_BORROW_POS_ON_LIQ: PublicKey;
+export declare const SUPPLY_RATE_MODEL: PublicKey;
+export declare const BORROW_RATE_MODEL: PublicKey;
+export declare const VAULT_SUPPLY_ATA: PublicKey;
+export declare const VAULT_BORROW_ATA: PublicKey;
+export declare const NEW_BRANCH: PublicKey;
+export declare const LIQUIDITY: PublicKey;
+export declare const LIQUIDITY_PROGRAM: PublicKey;
+export declare const ORACLE_PROGRAM: PublicKey;
+export declare const JLP_JUPUSD_VAULT_ID = 58;
+export declare const POSITION_DISCRIMINATOR: Buffer<ArrayBuffer>;
+export interface BorrowPosition {
+    tick: number;
+    supplyAmount: BN;
+    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;

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

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * Jupiter Lend Borrow (Fluid Vaults) — account constants and position reading.
+ *
+ * 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`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.POSITION_DISCRIMINATOR = exports.JLP_JUPUSD_VAULT_ID = exports.ORACLE_PROGRAM = exports.LIQUIDITY_PROGRAM = exports.LIQUIDITY = exports.NEW_BRANCH = exports.VAULT_BORROW_ATA = exports.VAULT_SUPPLY_ATA = exports.BORROW_RATE_MODEL = exports.SUPPLY_RATE_MODEL = exports.VAULT_BORROW_POS_ON_LIQ = exports.VAULT_SUPPLY_POS_ON_LIQ = exports.BORROW_RESERVES_LIQUIDITY = exports.SUPPLY_RESERVES_LIQUIDITY = exports.BORROW_ORACLE = exports.BORROW_VAULT_STATE = exports.BORROW_VAULT_CONFIG = exports.JUP_LEND_BORROW_PROGRAM = void 0;
+exports.parsePosition = parsePosition;
+exports.readBorrowExchangePrice = readBorrowExchangePrice;
+const web3_js_1 = require("@solana/web3.js");
+const buffer_1 = require("../common/buffer");
+// ============================================================================
+// Jupiter Lend Borrow Program
+// ============================================================================
+exports.JUP_LEND_BORROW_PROGRAM = new web3_js_1.PublicKey("jupr81YtYssSyPt8jbnGuiWon5f6x9TcDEFxYe3Bdzi");
+// ============================================================================
+// JLP → JupUSD Fluid Vault — Static Accounts
+// ============================================================================
+exports.BORROW_VAULT_CONFIG = new web3_js_1.PublicKey("3b5bK5PspMmVmA6ZkqXcKtLTskPJGvkJZqjCezspLBu8");
+exports.BORROW_VAULT_STATE = new web3_js_1.PublicKey("4nzptpV8dMv9D6CnsqmNMQJ5TVnRGQDES75a1FWi23YL");
+exports.BORROW_ORACLE = new web3_js_1.PublicKey("25UZhqEoQeMA2ovbM1PgwZbU3NGUA8eM2y5g1j58YmFV");
+exports.SUPPLY_RESERVES_LIQUIDITY = new web3_js_1.PublicKey("2cYcYwTWHkiszdzDs8aPq1fkcpipJ8zVEzwCXo5RzXpx");
+exports.BORROW_RESERVES_LIQUIDITY = new web3_js_1.PublicKey("2tQE8jVR5ezDw3PDa21BNzfyQ14Ug5cTf6n3swJNjkod");
+exports.VAULT_SUPPLY_POS_ON_LIQ = new web3_js_1.PublicKey("fHbvnrFe9ywN9hc8SZHdxFUcMWrgSMmVXfYdizQALkR");
+exports.VAULT_BORROW_POS_ON_LIQ = new web3_js_1.PublicKey("2fewCticRvPLQbC1EczxF7Fv46J7HK9hdyTHVopy1Wg9");
+exports.SUPPLY_RATE_MODEL = new web3_js_1.PublicKey("9miY226e1qR9YgHfCE6hTKTxMRiyFZSUUTcdeZD6Ntmw");
+exports.BORROW_RATE_MODEL = new web3_js_1.PublicKey("2hT44GA9r5PiqsbbmqN5CuF7ymtquoEdokRncAs9CVej");
+exports.VAULT_SUPPLY_ATA = new web3_js_1.PublicKey("EJ6CLvJPJErjkUnPQicVahzw4Q4NHLfpDV9knoP7iqfK");
+exports.VAULT_BORROW_ATA = new web3_js_1.PublicKey("9kGqd5zsQGaFfFPdUuEgbRM4V7x72Jdt7WTS4uRouAQ7");
+exports.NEW_BRANCH = new web3_js_1.PublicKey("BpdVtFA1FmQkXdcdjPNDb3TL86VdKcHqRU9dNfBrRD1i");
+exports.LIQUIDITY = new web3_js_1.PublicKey("7s1da8DduuBFqGra5bJBjpnvL5E9mGzCuMk1Qkh4or2Z");
+exports.LIQUIDITY_PROGRAM = new web3_js_1.PublicKey("jupeiUmn818Jg1ekPURTpr4mFo29p46vygyykFJ3wZC");
+exports.ORACLE_PROGRAM = new web3_js_1.PublicKey("jupnw4B6Eqs7ft6rxpzYLJZYSnrpRgPcr589n5Kv4oc");
+exports.JLP_JUPUSD_VAULT_ID = 58;
+// ============================================================================
+// Position Account Parsing
+// ============================================================================
+exports.POSITION_DISCRIMINATOR = Buffer.from([0xaa, 0xbc, 0x8f, 0xe4, 0x7a, 0x40, 0xf7, 0xd0]);
+/**
+ * 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)
+ */
+function parsePosition(data) {
+    if (data.length < 71)
+        throw new Error(`Position data too short: ${data.length}`);
+    const disc = data.subarray(0, 8);
+    if (!disc.equals(exports.POSITION_DISCRIMINATOR))
+        throw new Error("Invalid Position discriminator");
+    return {
+        positionMint: new web3_js_1.PublicKey(data.subarray(14, 46)),
+        tick: data.readInt32LE(47),
+        supplyAmount: (0, buffer_1.readU64)(data, 55),
+        dustDebtAmount: (0, buffer_1.readU64)(data, 63),
+    };
+}
+/**
+ * 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.
+ */
+function readBorrowExchangePrice(vaultStateData) {
+    if (vaultStateData.length < 115)
+        throw new Error("VaultState data too short");
+    return (0, buffer_1.readU64)(vaultStateData, 107);
+}

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

@@ -1,4 +1,5 @@
-import { Connection, PublicKey } from "@solana/web3.js";
+import { PublicKey } from "@solana/web3.js";
+import type { SolanaConnection } from "../common/connection";
 export type CustodyName = "SOL" | "ETH" | "WBTC" | "USDC" | "USDT";
 export interface JlpCustody {
     name: CustodyName;
@@ -43,7 +44,7 @@ export interface JlpPoolDetails {
  * Reads the Pool account for fees and aumUsd, Custody accounts for per-asset
  * data including target weights, and the JLP mint for total supply.
  */
-export declare function fetchJlpPoolDetails(connection: Connection): Promise<JlpPoolDetails>;
+export declare function fetchJlpPoolDetails(connection: SolanaConnection): Promise<JlpPoolDetails>;
 /**
  * Estimate the addLiquidity fee for depositing into a specific JLP custody.
  *
@@ -69,5 +70,4 @@ export declare function computeAddLiquidityFee(args: {
     feeBps: number;
     isDiscount: boolean;
 };
-export declare function fetchJlpCustodyData(connection: Connection): Promise<JlpData>;
-//# sourceMappingURL=jlp-data.d.ts.map
+export declare function fetchJlpCustodyData(connection: SolanaConnection): Promise<JlpData>;

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

@@ -403,4 +403,3 @@ async function fetchJlpCustodyData(connection) {
         custodies: results,
     };
 }
-//# sourceMappingURL=jlp-data.js.map

package/dist/jlpd-strategy/jupusd-earn.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Jupiter Lend Earn SDK helpers for JLPD Strategy.
+ *
+ * Provides position reading and APR computation for the JupUSD Earn
+ * pool used by the JLP Borrow / JupUSD Earn route.
+ *
+ * Reuses the JupUSD pool config from elemental-lend/jupiter-lend.ts
+ * since it's the same Jupiter Lend Earn program and pool.
+ *
+ * @remarks
+ * Read-only utilities for displaying JupUSD Earn positions. This module exports
+ * **no instruction builders** — all on-chain operations against the Jupiter
+ * Lend Earn program are routed through `adapter.ts`. The exports here are:
+ *
+ *   - Static program / account constants for the JupUSD Earn pool
+ *   - `computeExchangeRate`, `computeFTokenValue`, `computeEarnApr` — math
+ *   - `fetchEarnPosition` — read-only position fetcher
+ *
+ * Anything new that needs to *send transactions* should live in `adapter.ts`.
+ */
+import { PublicKey } from "@solana/web3.js";
+import BN from "bn.js";
+import type { SolanaConnection } from "../common/connection";
+import { JUP_LEND_EARN_PROGRAM } from "../elemental-lend/constants";
+/**
+ * Jupiter Lend Earn program ID. Re-exported from `elemental-lend/constants`
+ * so callers of `jlpd-strategy/jupusd-earn` can reach it without an extra
+ * import path.
+ */
+export { JUP_LEND_EARN_PROGRAM };
+export declare const JUPUSD_LENDING: PublicKey;
+export declare const JUPUSD_FTOKEN_MINT: PublicKey;
+export declare const JUPUSD_RESERVES_LIQUIDITY: PublicKey;
+export declare const JUPUSD_SUPPLY_POS_ON_LIQ: PublicKey;
+export declare const JUPUSD_RATE_MODEL: PublicKey;
+export declare const JUPUSD_VAULT: PublicKey;
+export declare const JUPUSD_REWARDS_RATE_MODEL: PublicKey;
+export declare const JUPUSD_LENDING_ADMIN: PublicKey;
+/**
+ * Read the earn exchange rate from lending account + rewards model.
+ * Returns the rate scaled to 1e12.
+ *
+ * Jupiter Lend Earn lending account layout (relevant fields):
+ *   [115..123]  baseExchangePrice    u64   (1e12 precision)
+ *   [123..131]  lastUpdate            u64   (unix seconds)
+ *
+ * Jupiter Lend rewards rate model layout (relevant fields):
+ *   [ 56.. 64]  startTime             u64   (unix seconds)
+ *   [ 64.. 72]  yearlyReward          u64   (rewards distributed per year)
+ */
+export declare function computeExchangeRate(lendingData: Buffer, rewardsModelData: Buffer, fTokenTotalSupply: BN, currentTimestamp: number): bigint;
+/**
+ * Compute the value of fTokens in JupUSD (native 6-decimal).
+ */
+export declare function computeFTokenValue(fTokenBalance: BN, exchangeRate: bigint): BN;
+export interface EarnAprBreakdown {
+    lendingApr: number;
+    rewardsApr: number;
+    totalApr: number;
+}
+/**
+ * Compute earn APR breakdown: base lending + rewards.
+ *
+ * Total APR is derived by projecting the exchange rate 1 year forward
+ * (captures both lending yield and rewards). Rewards APR is isolated
+ * from yearly_reward / total_assets. Base = total - rewards.
+ */
+/**
+ * Compute earn APR breakdown: base lending + rewards.
+ *
+ * Reads the liquidity pool's supply rate from the liquidity account,
+ * and the rewards rate from the rewards model. Requires the liquidity
+ * account data as an additional parameter.
+ *
+ * @param rewardsModelData - Rewards rate model account data
+ * @param fTokenTotalSupply - fToken total supply (from mint)
+ * @param tokenExchangePrice - From lending account offset 115
+ * @param liquiditySupplyRate - Supply rate from liquidity pool (pass 0 if unknown)
+ */
+export declare function computeEarnApr(rewardsModelData: Buffer, fTokenTotalSupply: BN, tokenExchangePrice: bigint, liquiditySupplyRate?: number): EarnAprBreakdown;
+export interface EarnPositionInfo {
+    fTokenBalance: BN;
+    jupusdValue: BN;
+    apr: EarnAprBreakdown;
+}
+/**
+ * Fetch the earn position for a jlpd_config PDA.
+ * Returns null if no fToken ATA exists.
+ */
+export declare function fetchEarnPosition(connection: SolanaConnection, fTokenAta: PublicKey): Promise<EarnPositionInfo | null>;

package/dist/jlpd-strategy/jupusd-earn.js

@@ -0,0 +1,166 @@
+"use strict";
+/**
+ * Jupiter Lend Earn SDK helpers for JLPD Strategy.
+ *
+ * Provides position reading and APR computation for the JupUSD Earn
+ * pool used by the JLP Borrow / JupUSD Earn route.
+ *
+ * Reuses the JupUSD pool config from elemental-lend/jupiter-lend.ts
+ * since it's the same Jupiter Lend Earn program and pool.
+ *
+ * @remarks
+ * Read-only utilities for displaying JupUSD Earn positions. This module exports
+ * **no instruction builders** — all on-chain operations against the Jupiter
+ * Lend Earn program are routed through `adapter.ts`. The exports here are:
+ *
+ *   - Static program / account constants for the JupUSD Earn pool
+ *   - `computeExchangeRate`, `computeFTokenValue`, `computeEarnApr` — math
+ *   - `fetchEarnPosition` — read-only position fetcher
+ *
+ * Anything new that needs to *send transactions* should live in `adapter.ts`.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JUPUSD_LENDING_ADMIN = exports.JUPUSD_REWARDS_RATE_MODEL = exports.JUPUSD_VAULT = exports.JUPUSD_RATE_MODEL = exports.JUPUSD_SUPPLY_POS_ON_LIQ = exports.JUPUSD_RESERVES_LIQUIDITY = exports.JUPUSD_FTOKEN_MINT = exports.JUPUSD_LENDING = exports.JUP_LEND_EARN_PROGRAM = void 0;
+exports.computeExchangeRate = computeExchangeRate;
+exports.computeFTokenValue = computeFTokenValue;
+exports.computeEarnApr = computeEarnApr;
+exports.fetchEarnPosition = fetchEarnPosition;
+const bn_js_1 = __importDefault(require("bn.js"));
+const buffer_1 = require("../common/buffer");
+const jupiter_lend_1 = require("../elemental-lend/jupiter-lend");
+const constants_1 = require("../elemental-lend/constants");
+Object.defineProperty(exports, "JUP_LEND_EARN_PROGRAM", { enumerable: true, get: function () { return constants_1.JUP_LEND_EARN_PROGRAM; } });
+// ============================================================================
+// JupUSD Earn Pool — Static Accounts
+// ----------------------------------------------------------------------------
+// All pool addresses are imported from `elemental-lend/jupiter-lend.ts` so
+// there is exactly one canonical definition. The named re-exports below are
+// preserved for backwards compatibility with any external consumers.
+// ============================================================================
+exports.JUPUSD_LENDING = jupiter_lend_1.JUPUSD_POOL.lending;
+exports.JUPUSD_FTOKEN_MINT = jupiter_lend_1.JUPUSD_POOL.fTokenMint;
+exports.JUPUSD_RESERVES_LIQUIDITY = jupiter_lend_1.JUPUSD_POOL.tokenReservesLiquidity;
+exports.JUPUSD_SUPPLY_POS_ON_LIQ = jupiter_lend_1.JUPUSD_POOL.supplyPositionOnLiquidity;
+exports.JUPUSD_RATE_MODEL = jupiter_lend_1.JUPUSD_POOL.rateModel;
+exports.JUPUSD_VAULT = jupiter_lend_1.JUPUSD_POOL.vault;
+exports.JUPUSD_REWARDS_RATE_MODEL = jupiter_lend_1.JUPUSD_POOL.rewardsRateModel;
+exports.JUPUSD_LENDING_ADMIN = jupiter_lend_1.LENDING_ADMIN;
+// ============================================================================
+// Exchange Rate / APR Computation
+// ============================================================================
+const EXCHANGE_PRICES_PRECISION = 1000000000000n; // 1e12
+const SECONDS_PER_YEAR = 31536000;
+/**
+ * Read the earn exchange rate from lending account + rewards model.
+ * Returns the rate scaled to 1e12.
+ *
+ * Jupiter Lend Earn lending account layout (relevant fields):
+ *   [115..123]  baseExchangePrice    u64   (1e12 precision)
+ *   [123..131]  lastUpdate            u64   (unix seconds)
+ *
+ * Jupiter Lend rewards rate model layout (relevant fields):
+ *   [ 56.. 64]  startTime             u64   (unix seconds)
+ *   [ 64.. 72]  yearlyReward          u64   (rewards distributed per year)
+ */
+function computeExchangeRate(lendingData, rewardsModelData, fTokenTotalSupply, currentTimestamp) {
+    if (lendingData.length < 131)
+        throw new Error("Lending data too short");
+    const baseRate = (0, buffer_1.readU64)(lendingData, 115).toNumber();
+    const lastUpdate = (0, buffer_1.readU64)(lendingData, 123).toNumber();
+    if (rewardsModelData.length < 72)
+        return BigInt(baseRate);
+    const startTime = (0, buffer_1.readU64)(rewardsModelData, 56).toNumber();
+    const yearlyReward = (0, buffer_1.readU64)(rewardsModelData, 64).toNumber();
+    if (yearlyReward === 0 || fTokenTotalSupply.isZero())
+        return BigInt(baseRate);
+    // Compute time-accrued rewards since last update
+    const elapsed = Math.max(0, currentTimestamp - Math.max(lastUpdate, startTime));
+    const totalAssets = Number((BigInt(fTokenTotalSupply.toString()) * BigInt(baseRate)) / EXCHANGE_PRICES_PRECISION);
+    if (totalAssets === 0)
+        return BigInt(baseRate);
+    // rewards_return = yearly_reward * elapsed / SECONDS_PER_YEAR / total_assets
+    // new_rate = base_rate + base_rate * rewards_return / 1e14
+    const rewardAmount = (yearlyReward * elapsed) / SECONDS_PER_YEAR;
+    const rewardsReturn = Math.floor((rewardAmount * 1e14) / totalAssets);
+    const newRate = BigInt(baseRate) + (BigInt(baseRate) * BigInt(rewardsReturn)) / 100000000000000n;
+    return newRate;
+}
+/**
+ * Compute the value of fTokens in JupUSD (native 6-decimal).
+ */
+function computeFTokenValue(fTokenBalance, exchangeRate) {
+    const value = (BigInt(fTokenBalance.toString()) * exchangeRate) / EXCHANGE_PRICES_PRECISION;
+    return new bn_js_1.default(value.toString());
+}
+/**
+ * Compute earn APR breakdown: base lending + rewards.
+ *
+ * Total APR is derived by projecting the exchange rate 1 year forward
+ * (captures both lending yield and rewards). Rewards APR is isolated
+ * from yearly_reward / total_assets. Base = total - rewards.
+ */
+/**
+ * Compute earn APR breakdown: base lending + rewards.
+ *
+ * Reads the liquidity pool's supply rate from the liquidity account,
+ * and the rewards rate from the rewards model. Requires the liquidity
+ * account data as an additional parameter.
+ *
+ * @param rewardsModelData - Rewards rate model account data
+ * @param fTokenTotalSupply - fToken total supply (from mint)
+ * @param tokenExchangePrice - From lending account offset 115
+ * @param liquiditySupplyRate - Supply rate from liquidity pool (pass 0 if unknown)
+ */
+function computeEarnApr(rewardsModelData, fTokenTotalSupply, tokenExchangePrice, liquiditySupplyRate) {
+    const zero = { lendingApr: 0, rewardsApr: 0, totalApr: 0 };
+    if (rewardsModelData.length < 72)
+        return zero;
+    if (fTokenTotalSupply.isZero() || tokenExchangePrice === 0n)
+        return zero;
+    // Rewards APR: yearly_reward / total_assets * 100
+    const yearlyReward = Number((0, buffer_1.readU64)(rewardsModelData, 64).toString());
+    const totalAssets = Number(BigInt(fTokenTotalSupply.toString()) * tokenExchangePrice / EXCHANGE_PRICES_PRECISION);
+    const rewardsApr = totalAssets > 0 ? (yearlyReward / totalAssets) * 100 : 0;
+    // Lending APR: from liquidity pool supply rate if provided
+    // The lend-read SDK returns supplyRate as an integer where /100 = %
+    const lendingApr = liquiditySupplyRate != null ? liquiditySupplyRate / 100 : 0;
+    return {
+        lendingApr,
+        rewardsApr,
+        totalApr: lendingApr + rewardsApr,
+    };
+}
+/**
+ * Fetch the earn position for a jlpd_config PDA.
+ * Returns null if no fToken ATA exists.
+ */
+async function fetchEarnPosition(connection, fTokenAta) {
+    const [ataInfo, lendingInfo, rewardsInfo, mintInfo] = await connection.getMultipleAccountsInfo([
+        fTokenAta,
+        exports.JUPUSD_LENDING,
+        exports.JUPUSD_REWARDS_RATE_MODEL,
+        exports.JUPUSD_FTOKEN_MINT,
+    ]);
+    if (!ataInfo || !lendingInfo || !rewardsInfo || !mintInfo)
+        return null;
+    // SPL Token Account layout: [mint(0..32)][owner(32..64)][amount(64..72)]…
+    const ataData = ataInfo.data;
+    if (ataData.length < 72)
+        return null;
+    const fTokenBalance = (0, buffer_1.readU64)(ataData, 64);
+    // SPL Token Mint layout: [mintAuthority(0..36)][supply(36..44)][decimals(44..45)]…
+    const mintData = mintInfo.data;
+    const fTokenSupply = (0, buffer_1.readU64)(mintData, 36);
+    // baseExchangePrice from Jupiter Lend Earn lending account (offset 115)
+    const lendingData = lendingInfo.data;
+    const rewardsData = rewardsInfo.data;
+    const tokenExchangePrice = BigInt((0, buffer_1.readU64)(lendingData, 115).toString());
+    const now = Math.floor(Date.now() / 1000);
+    const exchangeRate = computeExchangeRate(lendingData, rewardsData, fTokenSupply, now);
+    const jupusdValue = computeFTokenValue(fTokenBalance, exchangeRate);
+    const apr = computeEarnApr(rewardsData, fTokenSupply, tokenExchangePrice);
+    return { fTokenBalance, jupusdValue, apr };
+}

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

@@ -1,8 +1,13 @@
 import { PublicKey } from "@solana/web3.js";
 export declare function findJlpdConfigPda(programId?: PublicKey): [PublicKey, number];
-/** @deprecated Use findJlpdConfigPda instead */
-export declare const findJlpVaultPda: typeof findJlpdConfigPda;
-export declare function findManagerRolePda(config: PublicKey, manager: PublicKey, programId?: PublicKey): [PublicKey, number];
+/**
+ * Derive the per-JlpdConfig `ManagerRole` PDA for JLPD Strategy.
+ * Seeds: `["manager", config, manager]`.
+ *
+ * Note the per-program prefix on the name: each Elemental program has its
+ * own `ManagerRole` PDA scoped to a different anchor account (`p-stv-core`
+ * → STV, `elemental-lend` → strategy_state).
+ */
+export declare function findJlpdManagerRolePda(config: PublicKey, manager: PublicKey, programId?: PublicKey): [PublicKey, number];
 export declare function findStrategyStatePda(baseMint: PublicKey, programId?: PublicKey): [PublicKey, number];
 export declare function findStvPositionPda(stv: PublicKey, programId?: PublicKey): [PublicKey, number];
-//# sourceMappingURL=pda.d.ts.map

package/dist/jlpd-strategy/pda.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.findJlpVaultPda = void 0;
 exports.findJlpdConfigPda = findJlpdConfigPda;
-exports.findManagerRolePda = findManagerRolePda;
+exports.findJlpdManagerRolePda = findJlpdManagerRolePda;
 exports.findStrategyStatePda = findStrategyStatePda;
 exports.findStvPositionPda = findStvPositionPda;
 const web3_js_1 = require("@solana/web3.js");
@@ -10,9 +9,15 @@ const constants_1 = require("./constants");
 function findJlpdConfigPda(programId = constants_1.PROGRAM_ID) {
     return web3_js_1.PublicKey.findProgramAddressSync([constants_1.CONFIG_SEED], programId);
 }
-/** @deprecated Use findJlpdConfigPda instead */
-exports.findJlpVaultPda = findJlpdConfigPda;
-function findManagerRolePda(config, manager, programId = constants_1.PROGRAM_ID) {
+/**
+ * Derive the per-JlpdConfig `ManagerRole` PDA for JLPD Strategy.
+ * Seeds: `["manager", config, manager]`.
+ *
+ * Note the per-program prefix on the name: each Elemental program has its
+ * own `ManagerRole` PDA scoped to a different anchor account (`p-stv-core`
+ * → STV, `elemental-lend` → strategy_state).
+ */
+function findJlpdManagerRolePda(config, manager, programId = constants_1.PROGRAM_ID) {
     return web3_js_1.PublicKey.findProgramAddressSync([constants_1.MANAGER_SEED, config.toBuffer(), manager.toBuffer()], programId);
 }
 function findStrategyStatePda(baseMint, programId = constants_1.PROGRAM_ID) {
@@ -21,4 +26,3 @@ function findStrategyStatePda(baseMint, programId = constants_1.PROGRAM_ID) {
 function findStvPositionPda(stv, programId = constants_1.PROGRAM_ID) {
     return web3_js_1.PublicKey.findProgramAddressSync([constants_1.POSITION_SEED, stv.toBuffer()], programId);
 }
-//# sourceMappingURL=pda.js.map