@elemental-stv-core/sdk 0.2.0 → 0.3.0

package/dist/p-stv-core/remaining-accounts.d.ts

@@ -0,0 +1,99 @@
+/**
+ * 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.
+ */
+import { AccountMeta, Connection, PublicKey, TransactionInstruction } from "@solana/web3.js";
+/**
+ * Minimal connection interface accepted by the context builders.
+ * Using a structural type avoids nominal type mismatches when the
+ * consumer has a different version of @solana/web3.js installed.
+ */
+export type SolanaConnection = Pick<Connection, "getAccountInfo" | "getMultipleAccountsInfo" | "getTokenAccountsByOwner" | "getSlot" | "getEpochInfo" | "getBlockTime">;
+/** Minimal vault shape required by the context builders. */
+export interface VaultInfo {
+    /** STV account address */
+    address: PublicKey;
+    /** Base token mint */
+    baseMint: PublicKey;
+    /** Lend program (PublicKey.default if not active) */
+    lendProgram: PublicKey;
+    /** Strategy program keys (10-element array) */
+    strategies: PublicKey[];
+    /** Number of active strategies */
+    strategyCount: number;
+}
+export interface DepositContext {
+    remainingAccounts: AccountMeta[];
+    protocolAumCount: number;
+    autoRouteCount: number;
+    preInstructions: TransactionInstruction[];
+}
+export interface ClaimWithdrawContext {
+    remainingAccounts: AccountMeta[];
+    autoUnrouteCount: number;
+    /**
+     * Pre-instructions to add before the claim_withdraw ix.
+     * Currently always empty — see DepositContext.preInstructions.
+     */
+    preInstructions: TransactionInstruction[];
+}
+export interface DepositToStrategyContext {
+    remainingAccounts: AccountMeta[];
+    autoUnrouteCount: number;
+    preInstructions: TransactionInstruction[];
+}
+export interface ProcessEpochContext {
+    remainingAccounts: AccountMeta[];
+    protocolAumCount: number;
+    /**
+     * Pre-instructions to add before the process_epoch ix.
+     * Currently always empty — see DepositContext.preInstructions.
+     */
+    preInstructions: TransactionInstruction[];
+}
+/**
+ */
+/**
+ * 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)
+ */
+export declare function buildDepositContext(connection: SolanaConnection, vault: VaultInfo, payer?: PublicKey): Promise<DepositContext>;
+/**
+ * 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
+ */
+export declare function buildClaimWithdrawContext(connection: SolanaConnection, vault: VaultInfo): Promise<ClaimWithdrawContext>;
+/**
+ * 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.
+ */
+export declare function buildDepositToStrategyContext(connection: SolanaConnection, vault: VaultInfo): Promise<DepositToStrategyContext>;
+/**
+ * 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.
+ */
+export declare function buildProcessEpochContext(connection: SolanaConnection, vault: VaultInfo, phase: "lockPps" | "advance"): Promise<ProcessEpochContext>;
+//# sourceMappingURL=remaining-accounts.d.ts.map

package/dist/p-stv-core/remaining-accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remaining-accounts.d.ts","sourceRoot":"","sources":["../../src/p-stv-core/remaining-accounts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,WAAW,EACX,UAAU,EACV,SAAS,EACT,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AAoBzB;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,EAC1C,gBAAgB,GAChB,yBAAyB,GACzB,yBAAyB,GACzB,SAAS,GACT,cAAc,GACd,cAAc,CACjB,CAAC;AAMF,4DAA4D;AAC5D,MAAM,WAAW,SAAS;IACxB,0BAA0B;IAC1B,OAAO,EAAE,SAAS,CAAC;IACnB,sBAAsB;IACtB,QAAQ,EAAE,SAAS,CAAC;IACpB,qDAAqD;IACrD,WAAW,EAAE,SAAS,CAAC;IACvB,+CAA+C;IAC/C,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,iBAAiB,EAAE,WAAW,EAAE,CAAC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,sBAAsB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,WAAW,EAAE,CAAC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,eAAe,EAAE,sBAAsB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,wBAAwB;IACvC,iBAAiB,EAAE,WAAW,EAAE,CAAC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,sBAAsB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,EAAE,WAAW,EAAE,CAAC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,eAAe,EAAE,sBAAsB,EAAE,CAAC;CAC3C;AAkFD;GACG;AAMH;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,gBAAgB,EAC5B,KAAK,EAAE,SAAS,EAChB,KAAK,CAAC,EAAE,SAAS,GAChB,OAAO,CAAC,cAAc,CAAC,CAsFzB;AAED;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,gBAAgB,EAC5B,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,oBAAoB,CAAC,CAiC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,gBAAgB,EAC5B,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,wBAAwB,CAAC,CA+BnC;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,gBAAgB,EAC5B,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,GAAG,SAAS,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CAoC9B"}

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"}