@elemental-stv-core/sdk 0.1.1 → 0.3.0

package/dist/p-stv-core/remaining-accounts.js

@@ -0,0 +1,262 @@
+"use strict";
+/**
+ * Remaining accounts builders for p-STV Core instructions.
+ *
+ * These functions build the complete `remainingAccounts` arrays needed for
+ * deposit, claim_withdraw, and process_epoch instructions, pulling all the
+ * lend + protocol AUM + strategy pair + auto-route/unroute account building
+ * logic out of the frontend and into the SDK.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDepositContext = buildDepositContext;
+exports.buildClaimWithdrawContext = buildClaimWithdrawContext;
+exports.buildDepositToStrategyContext = buildDepositToStrategyContext;
+exports.buildProcessEpochContext = buildProcessEpochContext;
+const web3_js_1 = require("@solana/web3.js");
+const pda_1 = require("../elemental-lend/pda");
+const accounts_1 = require("../elemental-lend/accounts");
+const jupiter_lend_1 = require("../elemental-lend/jupiter-lend");
+const kamino_vault_1 = require("../elemental-lend/kamino-vault");
+const spl_token_1 = require("@solana/spl-token");
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const DEFAULT_PUBKEY = web3_js_1.PublicKey.default;
+const TOKEN_PROGRAM = new web3_js_1.PublicKey("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
+const USDC_MINT = new web3_js_1.PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
+const STRATEGY_STATE_SEED = Buffer.from("strategy_state");
+const POSITION_SEED = Buffer.from("position");
+function isDefault(pubkey) {
+    return pubkey.equals(DEFAULT_PUBKEY);
+}
+/** Derive the ATA address (same logic as @solana/spl-token getAssociatedTokenAddressSync) */
+function findAta(mint, owner, tokenProgram) {
+    const [ata] = web3_js_1.PublicKey.findProgramAddressSync([owner.toBuffer(), tokenProgram.toBuffer(), mint.toBuffer()], spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
+    return ata;
+}
+/**
+ * Build the 4 fixed lend accounts: [lendProgram, lendStrategyState, lendPosition, lendBaseAta]
+ */
+function buildFixedLendAccounts(lendProgram, baseMint, stvAddress) {
+    const [lendStrategyState] = (0, pda_1.findStrategyStatePda)(baseMint, lendProgram);
+    const [lendPosition] = (0, pda_1.findStvPositionPda)(stvAddress, lendProgram);
+    const lendBaseAta = findAta(baseMint, lendStrategyState, TOKEN_PROGRAM);
+    return {
+        lendStrategyState,
+        accounts: [
+            { pubkey: lendProgram, isSigner: false, isWritable: false },
+            { pubkey: lendStrategyState, isSigner: false, isWritable: true },
+            { pubkey: lendPosition, isSigner: false, isWritable: true },
+            { pubkey: lendBaseAta, isSigner: false, isWritable: true },
+        ],
+    };
+}
+/**
+ * Build strategy pair accounts for NAV computation.
+ * For each active strategy: [strategy_state, stv_position, strategy_program (deduplicated)]
+ */
+function buildStrategyPairAccounts(vault) {
+    const accounts = [];
+    if (vault.strategyCount === 0)
+        return accounts;
+    for (let i = 0; i < vault.strategyCount; i++) {
+        const strategyProgram = vault.strategies[i];
+        if (isDefault(strategyProgram))
+            continue;
+        const [stratState] = web3_js_1.PublicKey.findProgramAddressSync([STRATEGY_STATE_SEED, vault.baseMint.toBuffer()], strategyProgram);
+        const [stratPos] = web3_js_1.PublicKey.findProgramAddressSync([POSITION_SEED, vault.address.toBuffer()], strategyProgram);
+        accounts.push({ pubkey: stratState, isSigner: false, isWritable: true }, { pubkey: stratPos, isSigner: false, isWritable: true });
+        // Note: strategy program is NOT added to remaining_accounts.
+        // The on-chain code expects exactly 2 accounts per strategy (state + position).
+        // The strategy program resolves from the transaction's account list via invoke_signed.
+    }
+    return accounts;
+}
+/**
+ */
+// ---------------------------------------------------------------------------
+// Context Builders
+// ---------------------------------------------------------------------------
+/**
+ * Build the complete remaining_accounts for a deposit instruction.
+ *
+ * Layout: [4 lend, N protocol_aum, M*2+P strategy_pairs, K auto_route]
+ *
+ * - If lend is active, derives lend PDAs and fetches protocol AUM accounts
+ * - Builds strategy pair accounts for each active strategy
+ * - If USDC + Jupiter Lend registered, appends auto-route accounts
+ * - Checks for stale kVaults (returned in preInstructions once invest ix is available)
+ */
+async function buildDepositContext(connection, vault, payer) {
+    const remainingAccounts = [];
+    const preInstructions = [];
+    let protocolAumCount = 0;
+    // 1. Lend accounts (if active)
+    if (!isDefault(vault.lendProgram)) {
+        const { accounts: lendAccounts, lendStrategyState } = buildFixedLendAccounts(vault.lendProgram, vault.baseMint, vault.address);
+        remainingAccounts.push(...lendAccounts);
+        // Protocol AUM accounts
+        const conn = connection;
+        try {
+            const lendState = await (0, accounts_1.fetchLendStrategyState)(conn, vault.baseMint, vault.lendProgram);
+            const protocolAccounts = await (0, accounts_1.buildProtocolAccountsForAum)(conn, lendState, lendStrategyState, TOKEN_PROGRAM);
+            protocolAumCount = protocolAccounts.length;
+            remainingAccounts.push(...protocolAccounts);
+        }
+        catch {
+            // If strategy state not found, skip protocol accounts
+        }
+        // Check kVault staleness — prepend invest ix if stale
+        try {
+            const conn = connection;
+            const lendState = await (0, accounts_1.fetchLendStrategyState)(conn, vault.baseMint, vault.lendProgram).catch(() => null);
+            if (lendState) {
+                const protocolKeys = lendState.protocols
+                    .filter((p) => !isDefault(p));
+                // Need a payer for the invest ix — will be set by the caller
+                // Use PublicKey.default as placeholder; the caller replaces it
+                const investIxs = payer ? await (0, kamino_vault_1.buildKaminoInvestIxsIfStale)(conn, payer, vault.baseMint, protocolKeys) : [];
+                preInstructions.push(...investIxs);
+            }
+        }
+        catch {
+            // Skip if staleness check fails
+        }
+    }
+    // 2. Strategy pair accounts (2 per strategy: state + position)
+    const strategyAccounts = buildStrategyPairAccounts(vault);
+    remainingAccounts.push(...strategyAccounts);
+    // 3. Auto-route to Jupiter Lend (for any asset with a configured pool)
+    let autoRouteCount = 0;
+    const jupPool = jupiter_lend_1.JUP_LEND_POOLS[vault.baseMint.toBase58()];
+    if (!isDefault(vault.lendProgram) && jupPool) {
+        try {
+            const [lendSS] = (0, pda_1.findStrategyStatePda)(vault.baseMint, vault.lendProgram);
+            const strategyBaseAta = findAta(vault.baseMint, lendSS, TOKEN_PROGRAM);
+            const strategyFtokenAta = findAta(jupPool.fTokenMint, lendSS, TOKEN_PROGRAM);
+            const autoRouteAccounts = (0, jupiter_lend_1.buildJupLendAutoRouteAccounts)(jupPool, lendSS, strategyBaseAta, strategyFtokenAta);
+            autoRouteCount = autoRouteAccounts.length;
+            for (const acc of autoRouteAccounts) {
+                remainingAccounts.push({ ...acc, isSigner: false });
+            }
+        }
+        catch {
+            // Skip auto-route if account resolution fails
+        }
+    }
+    // 4. Strategy programs (after auto-route, for CPI resolution)
+    // These must be in the transaction but are NOT counted as auto-route or strategy pairs.
+    // The on-chain code uses auto_route_count to bound the auto-route slice.
+    const seenPrograms = new Set();
+    for (let i = 0; i < vault.strategyCount; i++) {
+        const prog = vault.strategies[i];
+        if (isDefault(prog))
+            continue;
+        const key = prog.toBase58();
+        if (!seenPrograms.has(key)) {
+            seenPrograms.add(key);
+            remainingAccounts.push({ pubkey: prog, isSigner: false, isWritable: false });
+        }
+    }
+    return { remainingAccounts, protocolAumCount, autoRouteCount, preInstructions };
+}
+/**
+ * Build the complete remaining_accounts for a claim_withdraw instruction.
+ *
+ * Layout: [4 lend, K auto_unroute]
+ *
+ * - If lend is active, derives lend PDAs
+ * - If USDC + Jupiter Lend, appends auto-unroute accounts
+ */
+async function buildClaimWithdrawContext(connection, vault) {
+    const remainingAccounts = [];
+    const preInstructions = [];
+    let autoUnrouteCount = 0;
+    if (!isDefault(vault.lendProgram)) {
+        const { accounts: lendAccounts, lendStrategyState } = buildFixedLendAccounts(vault.lendProgram, vault.baseMint, vault.address);
+        remainingAccounts.push(...lendAccounts);
+        // Auto-unroute from Jupiter Lend (for any asset with a configured pool)
+        const jupPoolForUnroute = jupiter_lend_1.JUP_LEND_POOLS[vault.baseMint.toBase58()];
+        if (jupPoolForUnroute) {
+            try {
+                const lendBaseAta = findAta(vault.baseMint, lendStrategyState, TOKEN_PROGRAM);
+                const strategyFtokenAta = findAta(jupPoolForUnroute.fTokenMint, lendStrategyState, TOKEN_PROGRAM);
+                const autoUnrouteAccounts = (0, jupiter_lend_1.buildJupLendAutoUnrouteAccounts)(jupPoolForUnroute, lendStrategyState, strategyFtokenAta, lendBaseAta);
+                autoUnrouteCount = autoUnrouteAccounts.length;
+                remainingAccounts.push(...autoUnrouteAccounts.map(a => ({ ...a, isSigner: false })));
+            }
+            catch {
+                // Skip auto-unroute if resolution fails
+            }
+        }
+    }
+    return { remainingAccounts, autoUnrouteCount, preInstructions };
+}
+/**
+ * Build the complete remaining_accounts for a deposit_to_strategy instruction.
+ *
+ * Layout: [4 lend, K auto_unroute]
+ *
+ * Same as claim_withdraw: if lend is active, derives lend PDAs.
+ * If USDC + Jupiter Lend, appends auto-unroute accounts for unsweep.
+ *
+ * Note: no Kamino invest pre-instructions here — deposit_to_strategy unsweeps
+ * from the active protocol (Jupiter Lend for USDC), not Kamino.
+ */
+async function buildDepositToStrategyContext(connection, vault) {
+    const remainingAccounts = [];
+    let autoUnrouteCount = 0;
+    if (!isDefault(vault.lendProgram)) {
+        const { accounts: lendAccounts, lendStrategyState } = buildFixedLendAccounts(vault.lendProgram, vault.baseMint, vault.address);
+        remainingAccounts.push(...lendAccounts);
+        // Auto-unroute from Jupiter Lend (for any asset with a configured pool)
+        const jupPoolForUnroute = jupiter_lend_1.JUP_LEND_POOLS[vault.baseMint.toBase58()];
+        if (jupPoolForUnroute) {
+            try {
+                const lendBaseAta = findAta(vault.baseMint, lendStrategyState, TOKEN_PROGRAM);
+                const strategyFtokenAta = findAta(jupPoolForUnroute.fTokenMint, lendStrategyState, TOKEN_PROGRAM);
+                const autoUnrouteAccounts = (0, jupiter_lend_1.buildJupLendAutoUnrouteAccounts)(jupPoolForUnroute, lendStrategyState, strategyFtokenAta, lendBaseAta);
+                autoUnrouteCount = autoUnrouteAccounts.length;
+                remainingAccounts.push(...autoUnrouteAccounts.map(a => ({ ...a, isSigner: false })));
+            }
+            catch {
+                // Skip auto-unroute if resolution fails
+            }
+        }
+    }
+    return { remainingAccounts, autoUnrouteCount, preInstructions: [] };
+}
+/**
+ * Build the complete remaining_accounts for a process_epoch instruction.
+ *
+ * @param phase - 'lockPps': needs lend + protocol AUM + strategy pairs for NAV.
+ *                'advance': empty remaining_accounts.
+ */
+async function buildProcessEpochContext(connection, vault, phase) {
+    if (phase === "advance") {
+        return { remainingAccounts: [], protocolAumCount: 0, preInstructions: [] };
+    }
+    // lockPps: same as deposit (lend + protocol AUM + strategy pairs) but without auto-route
+    const remainingAccounts = [];
+    const preInstructions = [];
+    let protocolAumCount = 0;
+    if (!isDefault(vault.lendProgram)) {
+        const { accounts: lendAccounts, lendStrategyState } = buildFixedLendAccounts(vault.lendProgram, vault.baseMint, vault.address);
+        remainingAccounts.push(...lendAccounts);
+        const conn = connection;
+        try {
+            const lendState = await (0, accounts_1.fetchLendStrategyState)(conn, vault.baseMint, vault.lendProgram);
+            const protocolAccounts = await (0, accounts_1.buildProtocolAccountsForAum)(conn, lendState, lendStrategyState, TOKEN_PROGRAM);
+            protocolAumCount = protocolAccounts.length;
+            remainingAccounts.push(...protocolAccounts);
+        }
+        catch {
+            // Skip protocol accounts if unavailable
+        }
+    }
+    // Strategy pairs for NAV
+    const strategyAccounts = buildStrategyPairAccounts(vault);
+    remainingAccounts.push(...strategyAccounts);
+    return { remainingAccounts, protocolAumCount, preInstructions };
+}
+//# sourceMappingURL=remaining-accounts.js.map

package/dist/p-stv-core/remaining-accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remaining-accounts.js","sourceRoot":"","sources":["../../src/p-stv-core/remaining-accounts.ts"],"names":[],"mappings":"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"}

package/dist/p-stv-core/send-tx.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Smart transaction builder and sender.
+ *
+ * Features:
+ * - Simulates to get exact compute units, adds 10% buffer
+ * - Fetches priority fee from Helius (medium tier)
+ * - Pre-checks size to decide legacy vs versioned tx with LUT (no double-sign)
+ * - Uses lastValidBlockHeight for reliable confirmation
+ * - Parallel fetches where possible
+ */
+import { AddressLookupTableAccount, PublicKey, TransactionInstruction } from "@solana/web3.js";
+/** @deprecated Use DEFAULT_LUT_ADDRESSES instead */
+export declare const DEFAULT_LUT_ADDRESS: PublicKey;
+/**
+ * Default LUTs for Elemental Vaults.
+ * These are fetched in parallel and merged for every versioned transaction.
+ *
+ * After creating new LUTs with `scripts/create-luts.ts --create`,
+ * replace these placeholder addresses with the real ones.
+ */
+export declare const DEFAULT_LUT_ADDRESSES: {
+    /** Elemental Lend (Kamino + Jupiter Lend + protocol infra) */
+    lend: PublicKey;
+    /** p-STV Core (vaults, evMints, vault ATAs, config) */
+    stv: PublicKey;
+    /** JLPD Strategy (config, strategy states, positions, JLP, oracles) */
+    jlpd: PublicKey;
+};
+export type SignTransactionFn = (tx: any) => Promise<any>;
+export type SmartTxConnection = any;
+export interface SmartTxOptions {
+    /** Single LUT address (deprecated — use additionalLuts or DEFAULT_LUT_ADDRESSES) */
+    lutAddress?: PublicKey;
+    /** Additional pre-fetched ALTs to merge (e.g. Jupiter ALTs) */
+    additionalLuts?: AddressLookupTableAccount[];
+    /** Skip priority fee fetch (use 0) */
+    noPriorityFee?: boolean;
+    /** Custom compute unit limit (skips simulation) */
+    computeUnits?: number;
+}
+/**
+ * Build, simulate, and send a transaction with optimal compute budget.
+ *
+ * 1. Fetches blockhash + LUT + priority fee in parallel
+ * 2. Pre-checks serialized size to choose legacy vs versioned
+ * 3. Simulates to get exact CU, adds 10% buffer
+ * 4. Prepends ComputeBudget instructions
+ * 5. Signs and sends with lastValidBlockHeight confirmation
+ */
+export declare function sendSmartTx(connection: SmartTxConnection, instructions: TransactionInstruction[], payer: PublicKey, signTransaction: SignTransactionFn, optionsOrLut?: PublicKey | SmartTxOptions): Promise<string>;
+/**
+ * Simulate a transaction without signing. Returns true if simulation succeeds.
+ * Use this to gate combined-tx attempts before asking the wallet to sign.
+ */
+export declare function simulateSmartTx(connection: SmartTxConnection, instructions: TransactionInstruction[], payer: PublicKey, optionsOrLut?: PublicKey | SmartTxOptions): Promise<boolean>;
+//# sourceMappingURL=send-tx.d.ts.map

package/dist/p-stv-core/send-tx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-tx.d.ts","sourceRoot":"","sources":["../../src/p-stv-core/send-tx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,yBAAyB,EAGzB,SAAS,EAET,sBAAsB,EAGvB,MAAM,iBAAiB,CAAC;AAEzB,oDAAoD;AACpD,eAAO,MAAM,mBAAmB,WAE/B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;IAChC,8DAA8D;;IAE9D,uDAAuD;;IAEvD,uEAAuE;;CAExE,CAAC;AAeF,MAAM,MAAM,iBAAiB,GAAG,CAAC,EAAE,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAG1D,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAEpC,MAAM,WAAW,cAAc;IAC7B,oFAAoF;IACpF,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,yBAAyB,EAAE,CAAC;IAC7C,sCAAsC;IACtC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,iBAAiB,EAC7B,YAAY,EAAE,sBAAsB,EAAE,EACtC,KAAK,EAAE,SAAS,EAChB,eAAe,EAAE,iBAAiB,EAClC,YAAY,CAAC,EAAE,SAAS,GAAG,cAAc,GACxC,OAAO,CAAC,MAAM,CAAC,CA4FjB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,iBAAiB,EAC7B,YAAY,EAAE,sBAAsB,EAAE,EACtC,KAAK,EAAE,SAAS,EAChB,YAAY,CAAC,EAAE,SAAS,GAAG,cAAc,GACxC,OAAO,CAAC,OAAO,CAAC,CAwClB"}

package/dist/p-stv-core/send-tx.js

@@ -0,0 +1,299 @@
+"use strict";
+/**
+ * Smart transaction builder and sender.
+ *
+ * Features:
+ * - Simulates to get exact compute units, adds 10% buffer
+ * - Fetches priority fee from Helius (medium tier)
+ * - Pre-checks size to decide legacy vs versioned tx with LUT (no double-sign)
+ * - Uses lastValidBlockHeight for reliable confirmation
+ * - Parallel fetches where possible
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_LUT_ADDRESSES = exports.DEFAULT_LUT_ADDRESS = void 0;
+exports.sendSmartTx = sendSmartTx;
+exports.simulateSmartTx = simulateSmartTx;
+const web3_js_1 = require("@solana/web3.js");
+/** @deprecated Use DEFAULT_LUT_ADDRESSES instead */
+exports.DEFAULT_LUT_ADDRESS = new web3_js_1.PublicKey("CCkFGzcR7bMe1HZ9eRkpnu3Ts8EKXErfapbLtpcCAbQk");
+/**
+ * Default LUTs for Elemental Vaults.
+ * These are fetched in parallel and merged for every versioned transaction.
+ *
+ * After creating new LUTs with `scripts/create-luts.ts --create`,
+ * replace these placeholder addresses with the real ones.
+ */
+exports.DEFAULT_LUT_ADDRESSES = {
+    /** Elemental Lend (Kamino + Jupiter Lend + protocol infra) */
+    lend: new web3_js_1.PublicKey("AnZTDbTmVvCezuiFpTMUVrmELFJajT5c8GM3FBu115w7"),
+    /** p-STV Core (vaults, evMints, vault ATAs, config) */
+    stv: new web3_js_1.PublicKey("5fECdwxyeXL49PEKPK52RgwupuXvtND4X4hvjFKZ9J32"),
+    /** JLPD Strategy (config, strategy states, positions, JLP, oracles) */
+    jlpd: new web3_js_1.PublicKey("EMd8YPN5ak2Kht1aktgtWfjakJJQoh98KqCqA3tRTTAn"),
+};
+/** Max legacy transaction size */
+const MAX_LEGACY_SIZE = 1232;
+/** Compute unit buffer (10% above simulated) */
+const CU_BUFFER_MULTIPLIER = 1.05;
+/** Fallback compute units if simulation fails */
+const FALLBACK_CU = 400000;
+/** Fallback priority fee (micro-lamports per CU) if Helius is unavailable */
+const FALLBACK_PRIORITY_FEE = 50000;
+/**
+ * Build, simulate, and send a transaction with optimal compute budget.
+ *
+ * 1. Fetches blockhash + LUT + priority fee in parallel
+ * 2. Pre-checks serialized size to choose legacy vs versioned
+ * 3. Simulates to get exact CU, adds 10% buffer
+ * 4. Prepends ComputeBudget instructions
+ * 5. Signs and sends with lastValidBlockHeight confirmation
+ */
+async function sendSmartTx(connection, instructions, payer, signTransaction, optionsOrLut) {
+    // Backward compat: accept PublicKey as 5th arg (old signature)
+    const options = optionsOrLut instanceof web3_js_1.PublicKey
+        ? { lutAddress: optionsOrLut }
+        : (optionsOrLut ?? {});
+    // 1. Parallel fetch: blockhash + all LUTs + priority fee
+    const lutAddresses = buildLutAddressList(options);
+    const [blockhashResult, priorityFee, ...lutResults] = await Promise.all([
+        connection.getLatestBlockhash("confirmed"),
+        options.noPriorityFee ? Promise.resolve(0) : fetchPriorityFee(connection),
+        ...lutAddresses.map(addr => connection.getAddressLookupTable(addr)),
+    ]);
+    const { blockhash, lastValidBlockHeight } = blockhashResult;
+    // Merge all fetched LUTs + any pre-fetched additional LUTs
+    const allLuts = [];
+    for (const result of lutResults) {
+        if (result.value)
+            allLuts.push(result.value);
+    }
+    if (options.additionalLuts)
+        allLuts.push(...options.additionalLuts);
+    // 2. Determine if we need versioned tx (pre-check size without signing)
+    const needsVersionedTx = checkNeedsVersionedTx(instructions, payer, blockhash);
+    // 3. Simulate to get exact CU (use versioned tx for simulation if needed)
+    let computeUnits = options.computeUnits ?? 0;
+    if (!computeUnits) {
+        computeUnits = await simulateForCU(connection, instructions, payer, blockhash, needsVersionedTx && allLuts.length > 0 ? allLuts : undefined);
+    }
+    // 4. Prepend compute budget instructions
+    const finalIxs = [
+        web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: computeUnits }),
+        ...(priorityFee > 0
+            ? [web3_js_1.ComputeBudgetProgram.setComputeUnitPrice({ microLamports: priorityFee })]
+            : []),
+        ...instructions,
+    ];
+    // 5. Build transaction (legacy or versioned)
+    let signedTx;
+    if (needsVersionedTx && allLuts.length > 0) {
+        const msgV0 = new web3_js_1.TransactionMessage({
+            payerKey: payer,
+            recentBlockhash: blockhash,
+            instructions: finalIxs,
+        }).compileToV0Message(allLuts);
+        const vtx = new web3_js_1.VersionedTransaction(msgV0);
+        signedTx = await signTransaction(vtx);
+    }
+    else {
+        // Try legacy — if the compute budget ixs push it over, fall back to versioned
+        const tx = new web3_js_1.Transaction();
+        for (const ix of finalIxs)
+            tx.add(ix);
+        tx.feePayer = payer;
+        tx.recentBlockhash = blockhash;
+        try {
+            tx.serialize({ requireAllSignatures: false });
+            signedTx = await signTransaction(tx);
+        }
+        catch {
+            // Legacy too large with compute budget ixs — use versioned
+            if (allLuts.length > 0) {
+                const msgV0 = new web3_js_1.TransactionMessage({
+                    payerKey: payer,
+                    recentBlockhash: blockhash,
+                    instructions: finalIxs,
+                }).compileToV0Message(allLuts);
+                const vtx = new web3_js_1.VersionedTransaction(msgV0);
+                signedTx = await signTransaction(vtx);
+            }
+            else {
+                throw new Error("Transaction too large and no LUT available");
+            }
+        }
+    }
+    // 6. Send and confirm with lastValidBlockHeight
+    const sig = await connection.sendRawTransaction(signedTx instanceof web3_js_1.VersionedTransaction
+        ? signedTx.serialize()
+        : signedTx.serialize(), { skipPreflight: false, preflightCommitment: "confirmed" });
+    await connection.confirmTransaction({ signature: sig, blockhash, lastValidBlockHeight }, "confirmed");
+    return sig;
+}
+/**
+ * Simulate a transaction without signing. Returns true if simulation succeeds.
+ * Use this to gate combined-tx attempts before asking the wallet to sign.
+ */
+async function simulateSmartTx(connection, instructions, payer, optionsOrLut) {
+    const options = optionsOrLut instanceof web3_js_1.PublicKey
+        ? { lutAddress: optionsOrLut }
+        : (optionsOrLut ?? {});
+    const lutAddresses = buildLutAddressList(options);
+    const [blockhashResult, ...lutResults] = await Promise.all([
+        connection.getLatestBlockhash("confirmed"),
+        ...lutAddresses.map(addr => connection.getAddressLookupTable(addr)),
+    ]);
+    const { blockhash } = blockhashResult;
+    const allLuts = [];
+    for (const result of lutResults) {
+        if (result.value)
+            allLuts.push(result.value);
+    }
+    if (options.additionalLuts)
+        allLuts.push(...options.additionalLuts);
+    try {
+        const conn = connection;
+        const simIxs = [
+            web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: 1400000 }),
+            ...instructions,
+        ];
+        const msgV0 = new web3_js_1.TransactionMessage({
+            payerKey: payer,
+            recentBlockhash: blockhash,
+            instructions: simIxs,
+        }).compileToV0Message(allLuts);
+        const simTx = new web3_js_1.VersionedTransaction(msgV0);
+        const simResult = await conn.simulateTransaction(simTx, {
+            sigVerify: false,
+            replaceRecentBlockhash: true,
+        });
+        return !simResult.value.err;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Build the list of LUT addresses to fetch.
+ * Combines DEFAULT_LUT_ADDRESSES with any explicit lutAddress override.
+ */
+function buildLutAddressList(options) {
+    const addrs = [];
+    const seen = new Set();
+    function add(addr) {
+        if (!addr)
+            return;
+        const key = addr.toBase58();
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        addrs.push(addr);
+    }
+    // Always include configured default LUTs
+    add(exports.DEFAULT_LUT_ADDRESSES.lend);
+    add(exports.DEFAULT_LUT_ADDRESSES.stv);
+    add(exports.DEFAULT_LUT_ADDRESSES.jlpd);
+    // Include explicit override (backward compat)
+    if (options.lutAddress)
+        add(options.lutAddress);
+    return addrs;
+}
+/**
+ * Pre-check if instructions will fit in a legacy transaction.
+ * Cheaper than actually signing — just serialize without signatures.
+ */
+function checkNeedsVersionedTx(instructions, payer, blockhash) {
+    try {
+        const tx = new web3_js_1.Transaction();
+        // Add 2 placeholder compute budget ixs (they'll be prepended)
+        tx.add(web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: 200000 }));
+        tx.add(web3_js_1.ComputeBudgetProgram.setComputeUnitPrice({ microLamports: 50000 }));
+        for (const ix of instructions)
+            tx.add(ix);
+        tx.feePayer = payer;
+        tx.recentBlockhash = blockhash;
+        tx.serialize({ requireAllSignatures: false });
+        return false; // fits in legacy
+    }
+    catch {
+        return true; // needs versioned
+    }
+}
+/**
+ * Simulate transaction to get exact compute units consumed.
+ * Returns simulated CU + 10% buffer, or fallback if simulation fails.
+ */
+async function simulateForCU(connection, instructions, payer, blockhash, luts) {
+    try {
+        // Build a simulation tx with max CU to avoid hitting the limit during sim
+        const simIxs = [
+            web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: 1400000 }),
+            ...instructions,
+        ];
+        // Try versioned simulation first (works with LUTs)
+        const conn = connection;
+        const msgV0 = new web3_js_1.TransactionMessage({
+            payerKey: payer,
+            recentBlockhash: blockhash,
+            instructions: simIxs,
+        }).compileToV0Message(luts ?? []);
+        const simTx = new web3_js_1.VersionedTransaction(msgV0);
+        const simResult = await conn.simulateTransaction(simTx, {
+            sigVerify: false,
+            replaceRecentBlockhash: true,
+        });
+        if (simResult.value.err) {
+            // Simulation failed — use fallback
+            return FALLBACK_CU;
+        }
+        const unitsConsumed = simResult.value.unitsConsumed ?? FALLBACK_CU;
+        return Math.ceil(unitsConsumed * CU_BUFFER_MULTIPLIER);
+    }
+    catch {
+        return FALLBACK_CU;
+    }
+}
+/**
+ * Fetch recommended priority fee from Helius (medium tier).
+ * Falls back to a default if Helius is unavailable.
+ */
+async function fetchPriorityFee(connection) {
+    try {
+        // Extract RPC URL from connection
+        const conn = connection;
+        const rpcUrl = conn._rpcEndpoint ?? "";
+        // Only use Helius priority fee API if it's a Helius RPC
+        if (!rpcUrl.includes("helius")) {
+            return FALLBACK_PRIORITY_FEE;
+        }
+        const response = await fetch(rpcUrl, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                jsonrpc: "2.0",
+                id: "priority-fee",
+                method: "getPriorityFeeEstimate",
+                params: [{
+                        options: {
+                            priorityLevel: "Medium",
+                        },
+                    }],
+            }),
+        });
+        if (response.ok) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const data = await response.json();
+            const fee = data?.result?.priorityFeeEstimate;
+            if (typeof fee === "number" && fee > 0) {
+                return Math.ceil(fee);
+            }
+        }
+    }
+    catch {
+        // Priority fee fetch failed — use fallback
+    }
+    return FALLBACK_PRIORITY_FEE;
+}
+//# sourceMappingURL=send-tx.js.map

package/dist/p-stv-core/send-tx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-tx.js","sourceRoot":"","sources":["../../src/p-stv-core/send-tx.ts"],"names":[],"mappings":"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"}