@elmntl/jlpd-sdk 0.2.0 → 0.13.5

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

@@ -0,0 +1,83 @@
+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 392 bytes.
+ *
+ * Layout (offsets include the 8-byte discriminator). Matches the CURRENT
+ * `jlpd_config.rs::JlpdConfig` struct byte-for-byte (verified against that
+ * file's own `test_jlpd_config_field_offsets`) — the retired adapter-era
+ * `jlp_earn_amount`/`jlp_adapter_program` fields are GONE from the account;
+ * that byte range is now split between the divergence-breaker fields and
+ * `_reserved`/`_reserved_hi`:
+ *   [  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..248]  softBreakerTolBps               u16           (repurposed `_padding`; 0 ⇒ 1% default)
+ *   [248..250]  aumHardBreakerBps               u16           (retired `jlp_earn_amount` head; 0 ⇒ 3% default)
+ *   [250..288]  _reserved / _reserved_hi        [u8; 6] + [u8; 32]  (retired earn-adapter bytes, 38 total)
+ *   [288..320]  vaultJlpAta                     Pubkey        (canonical vault JLP ATA; write-once at init)
+ *   [320..328]  maxSwapArbUsdPerAsset            u64           (per-StrategyState swap_arb cap, USD 6-dec)
+ *   [328..392]  _reserved2 / _reserved3 / _reserved4  [u8; 24] + [u8; 32] + [u8; 8]
+ */
+export declare function deserializeJlpdConfig(data: Buffer): JlpdConfig;
+/**
+ * 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..128]  swapArb                         i64      (signed arb accumulator; read as BN)
+ *   [128..160]  priceOracle                     Pubkey   (per-strategy Doves price feed)
+ *   [160..192]  _reserved                       [u8; 32]
+ *   [192..224]  _reserved2                      [u8; 32]
+ */
+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: 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

@@ -0,0 +1,216 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deserializeJlpdConfig = deserializeJlpdConfig;
+exports.deserializeManagerRole = deserializeManagerRole;
+exports.deserializeJlpStrategyState = deserializeJlpStrategyState;
+exports.deserializeJlpStvPosition = deserializeJlpStvPosition;
+exports.fetchJlpdConfig = fetchJlpdConfig;
+exports.fetchJlpStrategyState = fetchJlpStrategyState;
+exports.fetchJlpStvPosition = fetchJlpStvPosition;
+exports.fetchAllJlpStrategyStates = fetchAllJlpStrategyStates;
+exports.fetchManagersForConfig = fetchManagersForConfig;
+const buffer_1 = require("../common/buffer");
+const strategy_interface_1 = require("../common/strategy-interface");
+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 392 bytes.
+ *
+ * Layout (offsets include the 8-byte discriminator). Matches the CURRENT
+ * `jlpd_config.rs::JlpdConfig` struct byte-for-byte (verified against that
+ * file's own `test_jlpd_config_field_offsets`) — the retired adapter-era
+ * `jlp_earn_amount`/`jlp_adapter_program` fields are GONE from the account;
+ * that byte range is now split between the divergence-breaker fields and
+ * `_reserved`/`_reserved_hi`:
+ *   [  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..248]  softBreakerTolBps               u16           (repurposed `_padding`; 0 ⇒ 1% default)
+ *   [248..250]  aumHardBreakerBps               u16           (retired `jlp_earn_amount` head; 0 ⇒ 3% default)
+ *   [250..288]  _reserved / _reserved_hi        [u8; 6] + [u8; 32]  (retired earn-adapter bytes, 38 total)
+ *   [288..320]  vaultJlpAta                     Pubkey        (canonical vault JLP ATA; write-once at init)
+ *   [320..328]  maxSwapArbUsdPerAsset            u64           (per-StrategyState swap_arb cap, USD 6-dec)
+ *   [328..392]  _reserved2 / _reserved3 / _reserved4  [u8; 24] + [u8; 32] + [u8; 8]
+ */
+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}`);
+    }
+    const disc = data.subarray(0, 8);
+    if (!disc.equals(constants_1.DISC_JLPD_CONFIG)) {
+        throw new Error(`Invalid JlpdConfig discriminator`);
+    }
+    const baseAssetMints = [];
+    for (let i = 0; i < constants_1.NUM_ASSETS; i++) {
+        baseAssetMints.push((0, buffer_1.readPubkey)(data, 72 + i * 32));
+    }
+    return {
+        admin: (0, buffer_1.readPubkey)(data, 8),
+        jlpMint: (0, buffer_1.readPubkey)(data, 40),
+        baseAssetMints,
+        oracleStalenessTh: (0, buffer_1.readU64)(data, 232),
+        flags: (0, buffer_1.readU16)(data, 240),
+        jlpSlippageBps: (0, buffer_1.readU16)(data, 242),
+        version: (0, buffer_1.readU8)(data, 244),
+        bump: (0, buffer_1.readU8)(data, 245),
+        softBreakerTolBps: (0, buffer_1.readU16)(data, 246),
+        aumHardBreakerBps: (0, buffer_1.readU16)(data, 248),
+        vaultJlpAta: (0, buffer_1.readPubkey)(data, 288),
+        maxSwapArbUsdPerAsset: (0, buffer_1.readU64)(data, 320),
+    };
+}
+/**
+ * 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}`);
+    }
+    const disc = data.subarray(0, 8);
+    if (!disc.equals(constants_1.DISC_MANAGER_ROLE)) {
+        throw new Error(`Invalid ManagerRole discriminator`);
+    }
+    return {
+        config: (0, buffer_1.readPubkey)(data, 8),
+        manager: (0, buffer_1.readPubkey)(data, 40),
+        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..128]  swapArb                         i64      (signed arb accumulator; read as BN)
+ *   [128..160]  priceOracle                     Pubkey   (per-strategy Doves price feed)
+ *   [160..192]  _reserved                       [u8; 32]
+ *   [192..224]  _reserved2                      [u8; 32]
+ */
+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}`);
+    }
+    const disc = data.subarray(0, 8);
+    if (!disc.equals(constants_1.DISC_STRATEGY_STATE)) {
+        throw new Error(`Invalid JlpStrategyState discriminator`);
+    }
+    return {
+        // Header
+        baseMint: (0, buffer_1.readPubkey)(data, 8),
+        authority: (0, buffer_1.readPubkey)(data, 40),
+        pps: (0, buffer_1.readU64)(data, 72),
+        totalAum: (0, buffer_1.readU64)(data, 80),
+        totalShares: (0, buffer_1.readU64)(data, 88),
+        lastUpdated: (0, buffer_1.readU64)(data, 96),
+        flags: (0, buffer_1.readU16)(data, 104),
+        version: (0, buffer_1.readU8)(data, 106),
+        bump: (0, buffer_1.readU8)(data, 107),
+        // Custom
+        baseLoaned: (0, buffer_1.readU64)(data, 112),
+        swapArb: (0, buffer_1.readI64)(data, 120),
+        priceOracle: (0, buffer_1.readPubkey)(data, 128),
+    };
+}
+/**
+ * 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}`);
+    }
+    const disc = data.subarray(0, 8);
+    if (!disc.equals(constants_1.DISC_STV_POSITION)) {
+        throw new Error(`Invalid StvPosition discriminator`);
+    }
+    return (0, strategy_interface_1.deserializeStvPosition)(data);
+}
+// ---------------------------------------------------------------------------
+// Fetch Helpers
+// ---------------------------------------------------------------------------
+async function fetchJlpdConfig(connection, programId = constants_1.PROGRAM_ID) {
+    const [pda] = (0, pda_1.findJlpdConfigPda)(programId);
+    const info = await connection.getAccountInfo(pda);
+    if (!info)
+        throw new Error("JlpdConfig account not found");
+    return deserializeJlpdConfig(info.data);
+}
+async function fetchJlpStrategyState(connection, baseMint, programId = constants_1.PROGRAM_ID) {
+    const [pda] = (0, pda_1.findStrategyStatePda)(baseMint, programId);
+    const info = await connection.getAccountInfo(pda);
+    if (!info)
+        throw new Error(`JlpStrategyState not found for mint ${baseMint.toBase58()}`);
+    return deserializeJlpStrategyState(info.data);
+}
+async function fetchJlpStvPosition(connection, stv, programId = constants_1.PROGRAM_ID) {
+    const [pda] = (0, pda_1.findStvPositionPda)(stv, programId);
+    const info = await connection.getAccountInfo(pda);
+    if (!info)
+        throw new Error(`StvPosition not found for stv ${stv.toBase58()}`);
+    return deserializeJlpStvPosition(info.data);
+}
+// ---------------------------------------------------------------------------
+// GPA Helpers
+// ---------------------------------------------------------------------------
+async function fetchAllJlpStrategyStates(connection, programId = constants_1.PROGRAM_ID) {
+    const accounts = await connection.getProgramAccounts(programId, {
+        filters: [
+            { dataSize: constants_1.STRATEGY_STATE_SIZE },
+            { memcmp: { offset: 0, bytes: constants_1.DISC_STRATEGY_STATE.toString("base64"), encoding: "base64" } },
+        ],
+    });
+    return accounts.map((a) => [a.pubkey, deserializeJlpStrategyState(a.account.data)]);
+}
+async function fetchManagersForConfig(connection, config, programId = constants_1.PROGRAM_ID) {
+    const accounts = await connection.getProgramAccounts(programId, {
+        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.toBuffer().toString("base64"), encoding: "base64" } },
+        ],
+    });
+    return accounts.map((a) => [a.pubkey, deserializeManagerRole(a.account.data)]);
+}

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

@@ -0,0 +1,81 @@
+/**
+ * JLPD Adapter instruction builders.
+ *
+ * These build JLPD-side instructions (deposit_to_adapter, withdraw_from_adapter)
+ * that CPI into the JLPD Lend Adapter program.
+ */
+import { PublicKey, TransactionInstruction, AccountMeta } from "@solana/web3.js";
+import BN from "bn.js";
+export interface DepositToAdapterArgs {
+    manager: PublicKey;
+    config: PublicKey;
+    managerRole: PublicKey;
+    vaultJlpAta: PublicKey;
+    adapterState: PublicKey;
+    adapterProgram: PublicKey;
+    /**
+     * Token amount as a BN (u64). Must be BN — plain `number` silently truncates
+     * above 2^53 and would corrupt u64 token amounts on large balances.
+     */
+    amount: BN;
+    /** Protocol-specific remaining accounts for the adapter's deposit CPI */
+    remainingAccounts?: AccountMeta[];
+}
+/**
+ * Build `deposit_to_adapter` instruction.
+ *
+ * Anchor data: [8-byte disc, DepositToAdapterParams(u64 + bool + u16 + u32)]
+ */
+export declare function createDepositToAdapterIx(args: DepositToAdapterArgs, programId?: PublicKey): TransactionInstruction;
+export interface WithdrawFromAdapterArgs {
+    manager: PublicKey;
+    config: PublicKey;
+    managerRole: PublicKey;
+    vaultJlpAta: PublicKey;
+    adapterState: PublicKey;
+    adapterProgram: PublicKey;
+    /**
+     * Token amount as a BN (u64). Must be BN — plain `number` silently truncates
+     * above 2^53 and would corrupt u64 token amounts on large balances.
+     */
+    amount: BN;
+    remainingAccounts?: AccountMeta[];
+}
+export declare function createWithdrawFromAdapterIx(args: WithdrawFromAdapterArgs, programId?: PublicKey): TransactionInstruction;
+/** Adapter instruction discriminators for adapter_manage */
+export declare const ADAPTER_DISC_BORROW = 3;
+export declare const ADAPTER_DISC_DEPOSIT_EARN = 4;
+export declare const ADAPTER_DISC_WITHDRAW_EARN = 5;
+export declare const ADAPTER_DISC_REPAY = 6;
+export interface AdapterManageArgs {
+    manager: PublicKey;
+    config: PublicKey;
+    managerRole: PublicKey;
+    adapterState: PublicKey;
+    adapterProgram: PublicKey;
+    /**
+     * Adapter instruction discriminator. Must be an integer in [0x03, 0xFF].
+     * 0x00/0x01/0x02 are reserved for deposit/withdraw/update_yield and are
+     * rejected by the on-chain handler (`ReservedAdapterDiscriminator`).
+     */
+    adapterDisc: number;
+    /**
+     * Opaque payload forwarded verbatim after the discriminator. Provide either
+     * `data` (raw bytes) or `amount` (convenience: packed as u64 LE, which is
+     * what jlpd-lend-adapter's verbs expect). Total payload length must not
+     * exceed 128 bytes (on-chain limit at adapter_manage.rs:72).
+     */
+    data?: Buffer;
+    /**
+     * Convenience u64 amount, encoded as u64 LE. Must be a BN instance —
+     * plain `number` silently truncates above 2^53.
+     */
+    amount?: BN;
+    /**
+     * Protocol-specific remaining accounts for the adapter CPI. NOTE: the adapter
+     * authorizes on its `authority` (the config PDA, propagated as signer) — do
+     * NOT pass an adapter ManagerRole here; that system was retired.
+     */
+    remainingAccounts?: AccountMeta[];
+}
+export declare function createAdapterManageIx(args: AdapterManageArgs, programId?: PublicKey): TransactionInstruction;

package/dist/jlpd-strategy/adapter.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * JLPD Adapter instruction builders.
+ *
+ * These build JLPD-side instructions (deposit_to_adapter, withdraw_from_adapter)
+ * that CPI into the JLPD Lend Adapter program.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADAPTER_DISC_REPAY = exports.ADAPTER_DISC_WITHDRAW_EARN = exports.ADAPTER_DISC_DEPOSIT_EARN = exports.ADAPTER_DISC_BORROW = void 0;
+exports.createDepositToAdapterIx = createDepositToAdapterIx;
+exports.createWithdrawFromAdapterIx = createWithdrawFromAdapterIx;
+exports.createAdapterManageIx = createAdapterManageIx;
+const web3_js_1 = require("@solana/web3.js");
+const bn_js_1 = __importDefault(require("bn.js"));
+const constants_1 = require("./constants");
+/**
+ * Internal helper — builds the instruction for deposit_to_adapter or
+ * withdraw_from_adapter. Both share the same account layout and data
+ * format (8-byte disc + u64 amount); only the discriminator differs.
+ */
+function buildAdapterIx(disc, args, programId) {
+    const { manager, config, managerRole, vaultJlpAta, adapterState, adapterProgram, amount, remainingAccounts = [], } = args;
+    if (!(amount instanceof bn_js_1.default)) {
+        throw new TypeError("adapter amount must be a BN instance (not number) to avoid u64 truncation");
+    }
+    const data = Buffer.alloc(16);
+    disc.copy(data, 0);
+    amount.toArrayLike(Buffer, "le", 8).copy(data, 8);
+    return new web3_js_1.TransactionInstruction({
+        programId,
+        keys: [
+            { pubkey: manager, isSigner: true, isWritable: false },
+            { pubkey: config, isSigner: false, isWritable: true },
+            { pubkey: managerRole, isSigner: false, isWritable: false },
+            { pubkey: vaultJlpAta, isSigner: false, isWritable: true },
+            { pubkey: adapterState, isSigner: false, isWritable: true },
+            { pubkey: adapterProgram, isSigner: false, isWritable: false },
+            ...remainingAccounts,
+        ],
+        data,
+    });
+}
+/**
+ * Build `deposit_to_adapter` instruction.
+ *
+ * Anchor data: [8-byte disc, DepositToAdapterParams(u64 + bool + u16 + u32)]
+ */
+function createDepositToAdapterIx(args, programId = constants_1.PROGRAM_ID) {
+    return buildAdapterIx(constants_1.IX_DEPOSIT_TO_ADAPTER, args, programId);
+}
+function createWithdrawFromAdapterIx(args, programId = constants_1.PROGRAM_ID) {
+    return buildAdapterIx(constants_1.IX_WITHDRAW_FROM_ADAPTER, args, programId);
+}
+// ============================================================================
+// adapter_manage (generic: borrow, repay, deposit_earn, withdraw_earn)
+// ============================================================================
+/** Adapter instruction discriminators for adapter_manage */
+exports.ADAPTER_DISC_BORROW = 0x03;
+exports.ADAPTER_DISC_DEPOSIT_EARN = 0x04;
+exports.ADAPTER_DISC_WITHDRAW_EARN = 0x05;
+exports.ADAPTER_DISC_REPAY = 0x06;
+/**
+ * Build `adapter_manage` instruction (Adapter Interface v1, opaque passthrough).
+ *
+ * Routes a management op (disc >= 0x03) through JLPD for config PDA signer
+ * propagation. Anchor data: [8-byte ix disc, adapter_disc: u8, data: Vec<u8>].
+ */
+/** Maximum opaque payload length accepted by the on-chain handler (adapter_manage.rs:49). */
+const MAX_MANAGE_PAYLOAD_LEN = 128;
+function createAdapterManageIx(args, programId = constants_1.PROGRAM_ID) {
+    const { manager, config, managerRole, adapterState, adapterProgram, adapterDisc, data: rawData, amount, remainingAccounts = [], } = args;
+    // Validate adapterDisc: must be an integer in [0x03, 0xFF].
+    // 0x00/0x01/0x02 are reserved — on-chain handler rejects them with
+    // ReservedAdapterDiscriminator (adapter_manage.rs:67-70).
+    if (!Number.isInteger(adapterDisc) || adapterDisc < 0x03 || adapterDisc > 0xff) {
+        throw new RangeError(`createAdapterManageIx: adapterDisc must be an integer in [0x03, 0xFF], got ${adapterDisc}`);
+    }
+    // Resolve the opaque payload: explicit bytes, or a u64-LE amount.
+    let payload;
+    if (rawData !== undefined) {
+        payload = rawData;
+    }
+    else if (amount !== undefined) {
+        if (!(amount instanceof bn_js_1.default)) {
+            throw new TypeError("createAdapterManageIx: amount must be a BN instance (not number) to avoid u64 truncation");
+        }
+        payload = amount.toArrayLike(Buffer, "le", 8);
+    }
+    else {
+        throw new Error("createAdapterManageIx: provide either `data` or `amount`");
+    }
+    // Validate payload length against on-chain limit (adapter_manage.rs:71-74).
+    if (payload.length > MAX_MANAGE_PAYLOAD_LEN) {
+        throw new RangeError(`createAdapterManageIx: payload length ${payload.length} exceeds on-chain maximum of ${MAX_MANAGE_PAYLOAD_LEN} bytes`);
+    }
+    // Anchor data: [8-byte ix disc][adapter_disc: u8][Vec<u8>: u32 LE len + bytes]
+    const data = Buffer.alloc(8 + 1 + 4 + payload.length);
+    constants_1.IX_ADAPTER_MANAGE.copy(data, 0);
+    data[8] = adapterDisc;
+    data.writeUInt32LE(payload.length, 9);
+    payload.copy(data, 13);
+    return new web3_js_1.TransactionInstruction({
+        programId,
+        keys: [
+            { pubkey: manager, isSigner: true, isWritable: false },
+            { pubkey: config, isSigner: false, isWritable: true },
+            { pubkey: managerRole, isSigner: false, isWritable: false },
+            // remaining_accounts: [adapter_state, adapter_program, ...protocol accounts]
+            { pubkey: adapterState, isSigner: false, isWritable: true },
+            { pubkey: adapterProgram, isSigner: false, isWritable: false },
+            ...remainingAccounts,
+        ],
+        data,
+    });
+}

package/dist/jlpd-strategy/base-to-base-swap.d.ts

@@ -0,0 +1,74 @@
+import { PublicKey, TransactionInstruction, AddressLookupTableAccount, AccountMeta } from "@solana/web3.js";
+import type { SolanaConnection } from "../common/connection";
+import BN from "bn.js";
+import { type JupiterQuote } from "./swap-jlp";
+/** Arguments for building a base_to_base_swap instruction. */
+export interface CreateBaseToBaseSwapIxArgs {
+    manager: PublicKey;
+    config: PublicKey;
+    managerRole: PublicKey;
+    strategyStateIn: PublicKey;
+    strategyStateOut: PublicKey;
+    baseInAta: PublicKey;
+    baseOutAta: PublicKey;
+    baseInMint: PublicKey;
+    baseOutMint: PublicKey;
+    tokenProgram: PublicKey;
+    jupiterProgram: PublicKey;
+    priceOracleIn: PublicKey;
+    priceOracleOut: PublicKey;
+    amountIn: bigint | BN;
+    minOut: bigint | BN;
+    jupiterData: Buffer | Uint8Array;
+    remainingAccounts?: AccountMeta[];
+}
+/**
+ * Build the on-chain `base_to_base_swap` instruction.
+ *
+ * Instruction data layout (Anchor Borsh):
+ *   [8-byte disc, 8-byte amount_in (LE), 8-byte min_out (LE),
+ *    4-byte jupiter_data_len (LE), ...jupiter_data_bytes]
+ */
+export declare function createBaseToBaseSwapIx(args: CreateBaseToBaseSwapIxArgs, programId?: PublicKey): TransactionInstruction;
+/**
+ * Build a complete base_to_base_swap transaction:
+ *   1. Derive PDAs for both strategies
+ *   2. Resolve oracle accounts (from strategy_state.price_oracle on-chain, or overrides)
+ *   3. Get Jupiter quote (base_in → base_out)
+ *   4. Get Jupiter swap instructions (strategy_state_in PDA signs)
+ *   5. Build instruction + return ALTs
+ *
+ * Oracle resolution:
+ *   - Stablecoins (USDC/JupUSD): always PublicKey.default (program ignores oracle for $1 assets).
+ *   - Volatile assets: use caller-supplied override, or fetch strategy_state on-chain
+ *     to read the stored price_oracle field. To avoid two extra RPC calls, pass
+ *     priceOracleIn/priceOracleOut when you already have the strategy states.
+ */
+export declare function buildBaseToBaseSwapTransaction(args: {
+    connection: SolanaConnection;
+    manager: PublicKey;
+    baseInMint: PublicKey;
+    baseOutMint: PublicKey;
+    /** Amount of base_in to swap, raw u64. */
+    amountIn: bigint;
+    /**
+     * Override oracle for base_in. If omitted and base_in is not a stable,
+     * the strategy_state_in account is fetched to read price_oracle.
+     */
+    priceOracleIn?: PublicKey;
+    /**
+     * Override oracle for base_out. If omitted and base_out is not a stable,
+     * the strategy_state_out account is fetched to read price_oracle.
+     */
+    priceOracleOut?: PublicKey;
+    slippageBps?: number;
+    tokenProgram?: PublicKey;
+    programId?: PublicKey;
+}): Promise<{
+    instructions: TransactionInstruction[];
+    addressLookupTables: AddressLookupTableAccount[];
+    quoteInAmount: bigint;
+    quoteOutAmount: bigint;
+    minOut: bigint;
+    quote: JupiterQuote;
+}>;