@elemental-stv-core/sdk 0.2.0 → 0.4.0

package/dist/elemental-lend/kamino-vault.js

@@ -0,0 +1,460 @@
+"use strict";
+/**
+ * Kamino kVault account builders for deposit/withdraw.
+ *
+ * Builds the remaining_accounts arrays needed by elemental-lend's
+ * kvault_deposit and kvault_withdraw instructions.
+ *
+ * For deposit: 11 fixed accounts derived from vault_state PDAs.
+ * For withdraw: 21 fixed accounts — first 12 derivable, then 9 KLend-specific
+ *   accounts read from vault_state and reserve on-chain data.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KVAULT_STALENESS_THRESHOLD = exports.KAMINO_GLOBAL_CONFIG = exports.KLEND_PROGRAM = void 0;
+exports.findKvaultTokenVault = findKvaultTokenVault;
+exports.findKvaultAuthority = findKvaultAuthority;
+exports.findKvaultSharesMint = findKvaultSharesMint;
+exports.findKvaultEventAuthority = findKvaultEventAuthority;
+exports.findLendingMarketAuthority = findLendingMarketAuthority;
+exports.readVaultAllocation = readVaultAllocation;
+exports.readReserveAccounts = readReserveAccounts;
+exports.buildKvaultDepositAccounts = buildKvaultDepositAccounts;
+exports.buildKvaultWithdrawReserveConfig = buildKvaultWithdrawReserveConfig;
+exports.buildKvaultWithdrawAccounts = buildKvaultWithdrawAccounts;
+exports.readKvaultLastFeeChargeTs = readKvaultLastFeeChargeTs;
+exports.isKvaultStale = isKvaultStale;
+exports.findStaleKvaults = findStaleKvaults;
+exports.buildKaminoInvestIx = buildKaminoInvestIx;
+exports.buildKaminoInvestIxsIfStale = buildKaminoInvestIxsIfStale;
+const web3_js_1 = require("@solana/web3.js");
+const constants_1 = require("./constants");
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** KLend program ID */
+exports.KLEND_PROGRAM = new web3_js_1.PublicKey("KLend2g3cP87fffoy8q1mQqGKjrxjC8boSyAYavgmjD");
+/** Kamino Vault global config (singleton, mainnet) */
+exports.KAMINO_GLOBAL_CONFIG = new web3_js_1.PublicKey("BKyTcUe6daNG8HbgBix2ugdRHbykG2dK9hPBBqhUyoEX");
+/** SPL Token program */
+const SPL_TOKEN_PROGRAM = new web3_js_1.PublicKey("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
+/** Sysvar Instructions */
+const SYSVAR_INSTRUCTIONS = new web3_js_1.PublicKey("Sysvar1nstructions1111111111111111111111111");
+// ---------------------------------------------------------------------------
+// PDA Derivation Helpers
+// ---------------------------------------------------------------------------
+/** Derive token_vault PDA: ["token_vault", vault_state] under Kamino Vault */
+function findKvaultTokenVault(vaultState) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("token_vault"), vaultState.toBuffer()], constants_1.KAMINO_VAULT_PROGRAM);
+}
+/** Derive base_vault_authority PDA: ["authority", vault_state] under Kamino Vault */
+function findKvaultAuthority(vaultState) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("authority"), vaultState.toBuffer()], constants_1.KAMINO_VAULT_PROGRAM);
+}
+/** Derive shares_mint PDA: ["shares", vault_state] under Kamino Vault */
+function findKvaultSharesMint(vaultState) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("shares"), vaultState.toBuffer()], constants_1.KAMINO_VAULT_PROGRAM);
+}
+/** Derive event_authority PDA: ["__event_authority"] under Kamino Vault */
+function findKvaultEventAuthority() {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("__event_authority")], constants_1.KAMINO_VAULT_PROGRAM);
+}
+/** Derive lending_market_authority PDA: ["lma", lending_market] under KLend */
+function findLendingMarketAuthority(lendingMarket) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("lma"), lendingMarket.toBuffer()], exports.KLEND_PROGRAM);
+}
+// ---------------------------------------------------------------------------
+// VaultState / Reserve Data Readers
+// ---------------------------------------------------------------------------
+/**
+ * Kamino VaultState layout offsets (from account data start, including 8-byte discriminator).
+ *
+ * VaultAllocation[0] starts at offset 312:
+ *   [312..344]  reserve (Pubkey)
+ *   [344..376]  ctokenVault (Pubkey)
+ *   Each VaultAllocation is 2160 bytes. Index N starts at 312 + N*2160.
+ */
+const VAULT_ALLOCATION_OFFSET = 312; // 8 disc + 304 struct offset
+const VAULT_ALLOCATION_SIZE = 2160;
+/**
+ * KLend Reserve layout offsets (from account data start, including 8-byte discriminator).
+ *   [32..64]     lendingMarket (Pubkey)
+ *   [160..192]   liquidity.supplyVault (Pubkey)
+ *   [408..440]   liquidity.tokenProgram (Pubkey)
+ *   [2560..2592] collateral.mintPubkey (Pubkey)
+ */
+const RESERVE_LENDING_MARKET_OFFSET = 32;
+const RESERVE_LIQUIDITY_SUPPLY_OFFSET = 160;
+const RESERVE_LIQUIDITY_TOKEN_PROGRAM_OFFSET = 408;
+const RESERVE_COLLATERAL_MINT_OFFSET = 2560;
+/** Read a Pubkey from a Buffer at a given offset */
+function readPubkey(data, offset) {
+    return new web3_js_1.PublicKey(data.slice(offset, offset + 32));
+}
+/**
+ * Read the first VaultAllocation's reserve and ctokenVault from VaultState data.
+ *
+ * @param vaultStateData - Raw account data (including 8-byte discriminator)
+ * @param allocationIndex - Which allocation slot to read (default 0)
+ */
+function readVaultAllocation(vaultStateData, allocationIndex = 0) {
+    const base = VAULT_ALLOCATION_OFFSET + allocationIndex * VAULT_ALLOCATION_SIZE;
+    if (vaultStateData.length < base + 64) {
+        throw new Error(`VaultState data too short for allocation ${allocationIndex}: need ${base + 64}, got ${vaultStateData.length}`);
+    }
+    return {
+        reserve: readPubkey(vaultStateData, base),
+        ctokenVault: readPubkey(vaultStateData, base + 32),
+    };
+}
+/**
+ * Read KLend-specific accounts from a Reserve account's raw data.
+ *
+ * @param reserveData - Raw KLend Reserve account data (including 8-byte discriminator)
+ */
+function readReserveAccounts(reserveData) {
+    if (reserveData.length < RESERVE_COLLATERAL_MINT_OFFSET + 32) {
+        throw new Error(`Reserve data too short: need ${RESERVE_COLLATERAL_MINT_OFFSET + 32}, got ${reserveData.length}`);
+    }
+    return {
+        lendingMarket: readPubkey(reserveData, RESERVE_LENDING_MARKET_OFFSET),
+        reserveLiquiditySupply: readPubkey(reserveData, RESERVE_LIQUIDITY_SUPPLY_OFFSET),
+        reserveCollateralMint: readPubkey(reserveData, RESERVE_COLLATERAL_MINT_OFFSET),
+        reserveCollateralTokenProgram: readPubkey(reserveData, RESERVE_LIQUIDITY_TOKEN_PROGRAM_OFFSET),
+    };
+}
+// ---------------------------------------------------------------------------
+// Deposit Account Builder (11 fixed accounts)
+// ---------------------------------------------------------------------------
+/**
+ * Build the 11 remaining_accounts for elemental-lend's kvault_deposit instruction.
+ *
+ * Account order matches kamino_vault::deposit_accounts:
+ *   0.  strategy_state PDA (signer, mut)
+ *   1.  vault_state (mut)
+ *   2.  token_vault (mut) — PDA ["token_vault", vault_state]
+ *   3.  token_mint — base token mint
+ *   4.  base_vault_authority — PDA ["authority", vault_state]
+ *   5.  shares_mint (mut) — PDA ["shares", vault_state]
+ *   6.  user_token_ata (mut) — strategy's base ATA
+ *   7.  user_shares_ata (mut) — strategy's kvToken ATA
+ *   8.  klend_program
+ *   9.  token_program — SPL Token
+ *  10.  shares_token_program — SPL Token
+ *
+ * After the 11 fixed accounts, callers should append reserve accounts for refresh.
+ */
+function buildKvaultDepositAccounts(vaultState, strategyStatePda, strategyBaseAta, strategySharesAta, baseMint, reserves = []) {
+    const [tokenVault] = findKvaultTokenVault(vaultState);
+    const [authority] = findKvaultAuthority(vaultState);
+    const [sharesMint] = findKvaultSharesMint(vaultState);
+    const [eventAuthority] = findKvaultEventAuthority();
+    const accounts = [
+        { pubkey: strategyStatePda, isSigner: true, isWritable: true }, // 0
+        { pubkey: vaultState, isSigner: false, isWritable: true }, // 1
+        { pubkey: tokenVault, isSigner: false, isWritable: true }, // 2
+        { pubkey: baseMint, isSigner: false, isWritable: false }, // 3
+        { pubkey: authority, isSigner: false, isWritable: false }, // 4
+        { pubkey: sharesMint, isSigner: false, isWritable: true }, // 5
+        { pubkey: strategyBaseAta, isSigner: false, isWritable: true }, // 6
+        { pubkey: strategySharesAta, isSigner: false, isWritable: true }, // 7
+        { pubkey: exports.KLEND_PROGRAM, isSigner: false, isWritable: false }, // 8
+        { pubkey: SPL_TOKEN_PROGRAM, isSigner: false, isWritable: false }, // 9
+        { pubkey: SPL_TOKEN_PROGRAM, isSigner: false, isWritable: false }, // 10
+        { pubkey: eventAuthority, isSigner: false, isWritable: false }, // 11 (Anchor event CPI)
+        { pubkey: constants_1.KAMINO_VAULT_PROGRAM, isSigner: false, isWritable: false }, // 12 (program self-ref)
+    ];
+    // Append reserve accounts for KLend batch refresh (writable), then unique lending markets (readonly).
+    // Kamino's cpi_refresh_reserves uses .take(reserves_count) to get just the reserves,
+    // then reads lending_market from each reserve's data for the CPI. The lending_market
+    // AccountInfo must be in the transaction but after the reserves.
+    const seenMarkets = new Set();
+    for (const { reserve } of reserves) {
+        accounts.push({ pubkey: reserve, isSigner: false, isWritable: true });
+    }
+    for (const { lendingMarket } of reserves) {
+        const key = lendingMarket.toBase58();
+        if (!seenMarkets.has(key)) {
+            seenMarkets.add(key);
+            accounts.push({ pubkey: lendingMarket, isSigner: false, isWritable: false });
+        }
+    }
+    return accounts;
+}
+/**
+ * Build the KvaultWithdrawReserveConfig from raw on-chain data.
+ *
+ * @param vaultStateData - Raw Kamino VaultState account data
+ * @param reserveData - Raw KLend Reserve account data
+ * @param allocationIndex - VaultAllocation index (default 0)
+ */
+function buildKvaultWithdrawReserveConfig(vaultStateData, reserveData, allocationIndex = 0) {
+    const alloc = readVaultAllocation(vaultStateData, allocationIndex);
+    const res = readReserveAccounts(reserveData);
+    const [lendingMarketAuthority] = findLendingMarketAuthority(res.lendingMarket);
+    return {
+        reserve: alloc.reserve,
+        ctokenVault: alloc.ctokenVault,
+        lendingMarket: res.lendingMarket,
+        lendingMarketAuthority,
+        reserveLiquiditySupply: res.reserveLiquiditySupply,
+        reserveCollateralMint: res.reserveCollateralMint,
+        reserveCollateralTokenProgram: res.reserveCollateralTokenProgram,
+    };
+}
+/**
+ * Build the 21 remaining_accounts for elemental-lend's kvault_withdraw instruction.
+ *
+ * Account order matches kamino_vault::withdraw_accounts:
+ *   WithdrawFromAvailable (0-11):
+ *     0.  strategy_state PDA (signer, mut)
+ *     1.  vault_state (mut)
+ *     2.  global_config
+ *     3.  token_vault (mut)
+ *     4.  base_vault_authority
+ *     5.  user_token_ata (mut) — strategy's base ATA
+ *     6.  token_mint (mut)
+ *     7.  user_shares_ata (mut) — strategy's kvToken ATA
+ *     8.  shares_mint (mut)
+ *     9.  token_program
+ *    10.  shares_token_program
+ *    11.  klend_program
+ *   WithdrawFromInvested (12-20):
+ *    12.  vault_state (mut, dup)
+ *    13.  reserve (mut)
+ *    14.  ctoken_vault (mut)
+ *    15.  lending_market
+ *    16.  lending_market_authority
+ *    17.  reserve_liquidity_supply (mut)
+ *    18.  reserve_collateral_mint (mut)
+ *    19.  reserve_collateral_token_program
+ *    20.  instruction_sysvar_account
+ *
+ * After the 21 fixed accounts, callers should append reserve accounts for refresh.
+ */
+function buildKvaultWithdrawAccounts(vaultState, strategyStatePda, strategyBaseAta, strategySharesAta, baseMint, reserveConfig, globalConfig = exports.KAMINO_GLOBAL_CONFIG) {
+    const [tokenVault] = findKvaultTokenVault(vaultState);
+    const [authority] = findKvaultAuthority(vaultState);
+    const [sharesMint] = findKvaultSharesMint(vaultState);
+    const [eventAuthority] = findKvaultEventAuthority();
+    return [
+        // WithdrawFromAvailable (0-11)
+        { pubkey: strategyStatePda, isSigner: true, isWritable: true }, // 0
+        { pubkey: vaultState, isSigner: false, isWritable: true }, // 1
+        { pubkey: globalConfig, isSigner: false, isWritable: false }, // 2
+        { pubkey: tokenVault, isSigner: false, isWritable: true }, // 3
+        { pubkey: authority, isSigner: false, isWritable: false }, // 4
+        { pubkey: strategyBaseAta, isSigner: false, isWritable: true }, // 5
+        { pubkey: baseMint, isSigner: false, isWritable: true }, // 6
+        { pubkey: strategySharesAta, isSigner: false, isWritable: true }, // 7
+        { pubkey: sharesMint, isSigner: false, isWritable: true }, // 8
+        { pubkey: SPL_TOKEN_PROGRAM, isSigner: false, isWritable: false }, // 9
+        { pubkey: SPL_TOKEN_PROGRAM, isSigner: false, isWritable: false }, // 10
+        { pubkey: exports.KLEND_PROGRAM, isSigner: false, isWritable: false }, // 11
+        // WithdrawFromAvailable event CPI (12-13)
+        { pubkey: eventAuthority, isSigner: false, isWritable: false }, // 12
+        { pubkey: constants_1.KAMINO_VAULT_PROGRAM, isSigner: false, isWritable: false }, // 13
+        // WithdrawFromInvested (14-22)
+        { pubkey: vaultState, isSigner: false, isWritable: true }, // 14 (dup)
+        { pubkey: reserveConfig.reserve, isSigner: false, isWritable: true }, // 15
+        { pubkey: reserveConfig.ctokenVault, isSigner: false, isWritable: true }, // 16
+        { pubkey: reserveConfig.lendingMarket, isSigner: false, isWritable: false }, // 17
+        { pubkey: reserveConfig.lendingMarketAuthority, isSigner: false, isWritable: false }, // 18
+        { pubkey: reserveConfig.reserveLiquiditySupply, isSigner: false, isWritable: true }, // 19
+        { pubkey: reserveConfig.reserveCollateralMint, isSigner: false, isWritable: true }, // 20
+        { pubkey: reserveConfig.reserveCollateralTokenProgram, isSigner: false, isWritable: false }, // 21
+        { pubkey: SYSVAR_INSTRUCTIONS, isSigner: false, isWritable: false }, // 22
+        // Withdraw event CPI (23-24)
+        { pubkey: eventAuthority, isSigner: false, isWritable: false }, // 23
+        { pubkey: constants_1.KAMINO_VAULT_PROGRAM, isSigner: false, isWritable: false }, // 24
+    ];
+}
+// ---------------------------------------------------------------------------
+// Kamino kVault Staleness Check
+// ---------------------------------------------------------------------------
+/** Offset of `last_fee_charge_timestamp` (u64) in Kamino VaultState account data */
+const KVAULT_LAST_FEE_CHARGE_TS_OFFSET = 272; // 8 disc + 264
+/** Minimum data length to read `last_fee_charge_timestamp` */
+const KVAULT_MIN_READ_SIZE = KVAULT_LAST_FEE_CHARGE_TS_OFFSET + 8;
+/** Staleness threshold in seconds (matches elemental-lend KVAULT_STALENESS_THRESHOLD) */
+exports.KVAULT_STALENESS_THRESHOLD = 120;
+/**
+ * Read `last_fee_charge_timestamp` from raw Kamino VaultState account data.
+ * Returns undefined if data is too short.
+ */
+function readKvaultLastFeeChargeTs(data) {
+    if (data.length < KVAULT_MIN_READ_SIZE)
+        return undefined;
+    const buf = Buffer.from(data);
+    // Read as u64 LE — timestamp fits in a regular number
+    return Number(buf.readBigUInt64LE(KVAULT_LAST_FEE_CHARGE_TS_OFFSET));
+}
+/**
+ * Check if a Kamino kVault is stale (needs an `invest` call to refresh).
+ *
+ * @param vaultStateData - Raw account data for the Kamino VaultState
+ * @param currentSlotTimestamp - Current cluster timestamp (seconds)
+ * @returns true if the vault is stale (last_fee_charge_timestamp is older than threshold)
+ */
+function isKvaultStale(vaultStateData, currentSlotTimestamp) {
+    const ts = readKvaultLastFeeChargeTs(vaultStateData);
+    if (ts === undefined)
+        return true; // can't read — assume stale
+    return (currentSlotTimestamp - ts) > exports.KVAULT_STALENESS_THRESHOLD;
+}
+/**
+ * Check if any registered kVault protocol is stale and return the stale vault states.
+ *
+ * @param connection - Solana connection
+ * @param protocols - Protocol pubkeys from the lend strategy state
+ * @returns Array of stale kVault state pubkeys
+ */
+async function findStaleKvaults(connection, protocols) {
+    if (protocols.length === 0)
+        return [];
+    const [accountInfos, slot] = await Promise.all([
+        connection.getMultipleAccountsInfo(protocols),
+        connection.getSlot("confirmed"),
+    ]);
+    // Estimate timestamp from slot (not exact, but close enough for staleness)
+    const epochInfo = await connection.getEpochInfo("confirmed");
+    const blockTime = await connection.getBlockTime(slot);
+    const currentTs = blockTime ?? Math.floor(Date.now() / 1000);
+    const stale = [];
+    for (let i = 0; i < protocols.length; i++) {
+        const info = accountInfos[i];
+        if (!info)
+            continue;
+        // Only check accounts owned by Kamino Vault program
+        if (!info.owner.equals(constants_1.KAMINO_VAULT_PROGRAM))
+            continue;
+        if (isKvaultStale(info.data, currentTs)) {
+            stale.push(protocols[i]);
+        }
+    }
+    void epochInfo; // suppress unused warning
+    return stale;
+}
+// ---------------------------------------------------------------------------
+// Kamino Invest Instruction Builder
+// ---------------------------------------------------------------------------
+/** Anchor discriminator: sha256("global:invest")[..8] */
+const IX_INVEST = Buffer.from([13, 245, 180, 103, 254, 182, 121, 4]);
+/** PDA seed for ctoken_vault: ["ctoken_vault", vault_state, reserve] */
+const CTOKEN_VAULT_SEED = Buffer.from("ctoken_vault");
+/** PDA seed for whitelisted_reserves: ["whitelisted_reserves", reserve] */
+const WHITELISTED_RESERVES_SEED = Buffer.from("whitelisted_reserves");
+/**
+ * Build a Kamino `invest` instruction to refresh a stale kVault.
+ *
+ * `invest` is permissionless — anyone can call it. It refreshes the vault's
+ * `last_fee_charge_timestamp` which is required for elemental-lend's update_aum
+ * staleness check (120s threshold).
+ *
+ * @param payer - Transaction signer (pays for any crank fee, usually 0)
+ * @param payerTokenAccount - Payer's base token ATA (for crank fee)
+ * @param vaultState - Kamino vault_state pubkey
+ * @param baseMint - Base token mint (e.g., USDC)
+ * @param vaultStateData - Raw vault_state account data (for reading allocation)
+ * @param reserveData - Raw KLend reserve account data (for reading lending_market, etc.)
+ * @param allocationIndex - Which vault allocation to invest (default 0)
+ */
+function buildKaminoInvestIx(payer, payerTokenAccount, vaultState, baseMint, vaultStateData, reserveData, allocationIndex = 0) {
+    const alloc = readVaultAllocation(vaultStateData, allocationIndex);
+    const res = readReserveAccounts(reserveData);
+    const [lendingMarketAuthority] = findLendingMarketAuthority(res.lendingMarket);
+    const [tokenVault] = findKvaultTokenVault(vaultState);
+    const [authority] = findKvaultAuthority(vaultState);
+    // ctoken_vault PDA: ["ctoken_vault", vault_state, reserve] under Kamino
+    const [ctokenVault] = web3_js_1.PublicKey.findProgramAddressSync([CTOKEN_VAULT_SEED, vaultState.toBuffer(), alloc.reserve.toBuffer()], constants_1.KAMINO_VAULT_PROGRAM);
+    // reserve_whitelist_entry PDA: ["whitelisted_reserves", reserve] under Kamino (optional)
+    const [reserveWhitelist] = web3_js_1.PublicKey.findProgramAddressSync([WHITELISTED_RESERVES_SEED, alloc.reserve.toBuffer()], constants_1.KAMINO_VAULT_PROGRAM);
+    const keys = [
+        { pubkey: payer, isSigner: true, isWritable: true }, // 0: payer
+        { pubkey: payerTokenAccount, isSigner: false, isWritable: true }, // 1: payer_token_account
+        { pubkey: vaultState, isSigner: false, isWritable: true }, // 2: vault_state
+        { pubkey: tokenVault, isSigner: false, isWritable: true }, // 3: token_vault
+        { pubkey: baseMint, isSigner: false, isWritable: true }, // 4: token_mint
+        { pubkey: authority, isSigner: false, isWritable: true }, // 5: base_vault_authority
+        { pubkey: ctokenVault, isSigner: false, isWritable: true }, // 6: ctoken_vault
+        { pubkey: alloc.reserve, isSigner: false, isWritable: true }, // 7: reserve
+        { pubkey: res.lendingMarket, isSigner: false, isWritable: false }, // 8: lending_market
+        { pubkey: lendingMarketAuthority, isSigner: false, isWritable: false }, // 9: lending_market_authority
+        { pubkey: res.reserveLiquiditySupply, isSigner: false, isWritable: true }, // 10: reserve_liquidity_supply
+        { pubkey: res.reserveCollateralMint, isSigner: false, isWritable: true }, // 11: reserve_collateral_mint
+        { pubkey: reserveWhitelist, isSigner: false, isWritable: false }, // 12: reserve_whitelist_entry (optional)
+        { pubkey: exports.KLEND_PROGRAM, isSigner: false, isWritable: false }, // 13: klend_program
+        { pubkey: SPL_TOKEN_PROGRAM, isSigner: false, isWritable: false }, // 14: reserve_collateral_token_program
+        { pubkey: SPL_TOKEN_PROGRAM, isSigner: false, isWritable: false }, // 15: token_program
+        { pubkey: SYSVAR_INSTRUCTIONS, isSigner: false, isWritable: false }, // 16: instruction_sysvar_account
+    ];
+    // Append ALL reserves for batch refresh, then lending_market at the end.
+    // cpi_refresh_reserves uses .take(reserves_count) to get just reserves.
+    // The lending_market must be in the transaction but AFTER reserves.
+    const allReserves = [];
+    for (let ai = 0; ai < 10; ai++) {
+        try {
+            const a = readVaultAllocation(vaultStateData, ai);
+            if (a.reserve.equals(web3_js_1.PublicKey.default))
+                break;
+            allReserves.push(a.reserve);
+        }
+        catch {
+            break;
+        }
+    }
+    for (const r of allReserves) {
+        keys.push({ pubkey: r, isSigner: false, isWritable: true });
+    }
+    // Lending market after reserves (for CPI resolution, not counted as a reserve)
+    keys.push({ pubkey: res.lendingMarket, isSigner: false, isWritable: false });
+    return new web3_js_1.TransactionInstruction({
+        programId: constants_1.KAMINO_VAULT_PROGRAM,
+        keys,
+        data: IX_INVEST,
+    });
+}
+/**
+ * Build Kamino `invest` instructions for all stale kVaults in a lend strategy.
+ *
+ * Checks each registered protocol for staleness and returns invest instructions
+ * for any that are stale.
+ *
+ * @param connection - Solana connection
+ * @param payer - Transaction signer
+ * @param baseMint - Base token mint
+ * @param protocols - Registered protocol pubkeys from lend strategy state
+ */
+async function buildKaminoInvestIxsIfStale(connection, payer, baseMint, protocols) {
+    const staleVaults = await findStaleKvaults(connection, protocols);
+    if (staleVaults.length === 0)
+        return [];
+    const TOKEN_PROG = new web3_js_1.PublicKey("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
+    const ATA_PROG = new web3_js_1.PublicKey("ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL");
+    // Payer's base ATA (for crank fee — usually 0)
+    const [payerAta] = web3_js_1.PublicKey.findProgramAddressSync([payer.toBuffer(), TOKEN_PROG.toBuffer(), baseMint.toBuffer()], ATA_PROG);
+    const ixs = [];
+    for (const vaultState of staleVaults) {
+        try {
+            // Fetch vault_state and its first reserve
+            const vaultInfo = await connection.getAccountInfo(vaultState);
+            if (!vaultInfo)
+                continue;
+            const alloc = readVaultAllocation(vaultInfo.data, 0);
+            if (alloc.reserve.equals(web3_js_1.PublicKey.default))
+                continue;
+            const reserveInfo = await connection.getAccountInfo(alloc.reserve);
+            if (!reserveInfo)
+                continue;
+            // Validate reserve is owned by KLend (skip if migrated/closed)
+            if (!reserveInfo.owner.equals(exports.KLEND_PROGRAM))
+                continue;
+            ixs.push(buildKaminoInvestIx(payer, payerAta, vaultState, baseMint, vaultInfo.data, reserveInfo.data, 0));
+        }
+        catch {
+            // Skip vault if any account data is unreadable
+            continue;
+        }
+    }
+    return ixs;
+}
+//# sourceMappingURL=kamino-vault.js.map

package/dist/elemental-lend/kamino-vault.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kamino-vault.js","sourceRoot":"","sources":["../../src/elemental-lend/kamino-vault.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,49 @@
+/**
+ * Protocol action transaction builders for Elemental Lend.
+ *
+ * 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";
+/**
+ * Minimal connection interface to avoid nominal type mismatches when the
+ * consumer has a different version of @solana/web3.js installed.
+ */
+export type ProtocolActionConnection = Pick<Connection, "getAccountInfo" | "getMultipleAccountsInfo">;
+import type { JupiterLendPool } from "./jupiter-lend";
+export type ProtocolType = "Kamino kVault" | "Jupiter Lend";
+export type ProtocolAction = "deposit" | "withdraw";
+export interface ProtocolActionArgs {
+    connection: ProtocolActionConnection;
+    /** Manager wallet (signer) */
+    manager: PublicKey;
+    /** Lend strategy state PDA (derived from baseMint if not provided) */
+    strategyState?: PublicKey;
+    /** Protocol address (Kamino vault_state or Jupiter Lend lending account) */
+    protocol: PublicKey;
+    protocolType: ProtocolType;
+    action: ProtocolAction;
+    /** Amount in base token units (e.g. USDC lamports) */
+    amount: bigint;
+    baseMint: PublicKey;
+    /** Token program for the base mint (defaults to SPL Token) */
+    tokenProgram?: PublicKey;
+    /** Jupiter Lend pool config (defaults to USDC_POOL) */
+    jupLendPool?: JupiterLendPool;
+    /** Elemental Lend program ID (defaults to PROGRAM_ID) */
+    programId?: PublicKey;
+}
+/**
+ * Build complete instruction array for a protocol deposit or withdraw.
+ *
+ * Returns instructions including a compute budget instruction (400k CU)
+ * and the protocol-specific instruction with all accounts resolved.
+ *
+ * For Kamino kVault withdraw: reads vault_state on-chain to convert
+ * base amount to kvToken shares, and reads KLend reserves for the
+ * withdraw accounts.
+ *
+ * @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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-actions.d.ts","sourceRoot":"","sources":["../../src/elemental-lend/protocol-actions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,UAAU,EACV,SAAS,EACT,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AAGzB;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,UAAU,EAClD,gBAAgB,GAChB,yBAAyB,CAC5B,CAAC;AAsBF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAsBtD,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,cAAc,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,wBAAwB,CAAC;IACrC,8BAA8B;IAC9B,OAAO,EAAE,SAAS,CAAC;IACnB,sEAAsE;IACtE,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,4EAA4E;IAC5E,QAAQ,EAAE,SAAS,CAAC;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS,CAAC;IACpB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,uDAAuD;IACvD,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,yDAAyD;IACzD,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAmDnC"}