@exponent-labs/exponent-sdk 0.1.7 → 0.9.0

package/build/exponentVaults/syncTransaction.js

@@ -0,0 +1,341 @@
+"use strict";
+/**
+ * Sync Transaction utilities for Squads Smart Account Program
+ *
+ * This module provides utilities to wrap arbitrary Solana instructions
+ * into Squads `sync_transaction` format, allowing authorized signers
+ * to execute transactions through a Squads policy.
+ *
+ * The payload format depends on the consensus account type:
+ * - Settings: SyncPayload::Transaction(compiled_instructions_bytes)
+ * - Policy:   SyncPayload::Policy(PolicyPayload::ProgramInteraction(...))
+ *
+ * Based on: https://github.com/Squads-Protocol/smart-account-program
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrapInstructionsInSyncTransaction = exports.buildSyncTransactionInstruction = exports.compileToSyncTransactionPayload = exports.SQUADS_PROGRAM_ID = void 0;
+const web3_js_1 = require("@solana/web3.js");
+/** Squads Smart Account Program ID (mainnet) */
+exports.SQUADS_PROGRAM_ID = new web3_js_1.PublicKey("SMRTzfY6DfH5ik3TKiyLFfXexV8uSG3d2UksSCYdunG");
+/** Set DEBUG_SYNC_TX=1 to log detailed account mapping for debugging ProgramInteractionProgramIdMismatch */
+const DEBUG = typeof process !== "undefined" && process.env?.DEBUG_SYNC_TX === "1";
+function logSyncTx(...args) {
+    if (DEBUG) {
+        console.log("[SYNC_TX]", ...args);
+    }
+}
+// ============================================================================
+// Instruction discriminator for sync_transaction (executeTransactionSyncV2)
+// ============================================================================
+const EXECUTE_TRANSACTION_SYNC_V2_DISCRIMINATOR = Buffer.from([90, 81, 187, 81, 39, 70, 128, 78]);
+// ============================================================================
+// Core Functions
+// ============================================================================
+/**
+ * Compile transaction instructions into the format required by sync_transaction
+ *
+ * Account order in remaining_accounts:
+ * 1. Signers
+ * 2. Policy prefix accounts (if any, e.g. settings for SettingsState expiration)
+ * 3. Pre-hook accounts (if any)
+ * 4. Post-hook accounts (if any)
+ * 5. Instruction accounts (from the compiled instructions)
+ */
+function compileToSyncTransactionPayload({ vaultPda, signers, instructions, leadingAccounts = [], preHookAccounts = [], postHookAccounts = [], }) {
+    logSyncTx("=== compileToSyncTransactionPayload START ===");
+    logSyncTx("Input: vaultPda=", vaultPda.toBase58().slice(0, 12), " signers=", signers.length, " instructions=", instructions.length);
+    logSyncTx("  preHookAccounts=", preHookAccounts.length, " postHookAccounts=", postHookAccounts.length, " leadingAccounts=", leadingAccounts.length);
+    // Build account list from all instructions
+    const accountMap = new Map();
+    // First pass: collect all unique accounts from instructions
+    for (const ix of instructions) {
+        // Add program ID
+        const programKey = ix.programId.toBase58();
+        if (!accountMap.has(programKey)) {
+            accountMap.set(programKey, {
+                pubkey: ix.programId,
+                isSigner: false,
+                isWritable: false,
+            });
+        }
+        // Add instruction accounts
+        for (const key of ix.keys) {
+            const keyStr = key.pubkey.toBase58();
+            const existing = accountMap.get(keyStr);
+            if (existing) {
+                existing.isWritable = existing.isWritable || key.isWritable;
+                existing.isSigner = existing.isSigner || key.isSigner;
+            }
+            else {
+                accountMap.set(keyStr, { ...key });
+            }
+        }
+    }
+    // Convert to array
+    const allAccounts = Array.from(accountMap.values());
+    logSyncTx("allAccounts (before sort):", allAccounts.length, "unique accounts from instructions");
+    // Mark the vault PDA as non-signer (it will be signed by Squads via CPI for the inner instruction)
+    const vaultKey = vaultPda.toBase58();
+    const vaultAccount = allAccounts.find((acc) => acc.pubkey.toBase58() === vaultKey);
+    if (vaultAccount) {
+        vaultAccount.isSigner = false;
+    }
+    // Sort: writable signers, readonly signers, writable non-signers, readonly non-signers
+    // (Matches Squads CompiledKeys.getMessageComponents order)
+    allAccounts.sort((a, b) => {
+        const aScore = (a.isSigner ? 0 : 2) + (a.isWritable ? 0 : 1);
+        const bScore = (b.isSigner ? 0 : 2) + (b.isWritable ? 0 : 1);
+        return aScore - bScore;
+    });
+    // For sync policy execution, Squads strips signers, optional leading policy
+    // account(s), and hook account prefixes before evaluating instruction indices.
+    // Therefore compiled instruction indices are relative only to instruction accounts.
+    const accountOffset = 0;
+    logSyncTx("accountOffset (instruction accounts only) =", accountOffset);
+    const accountIndexMap = new Map();
+    allAccounts.forEach((acc, idx) => {
+        const mappedIdx = accountOffset + idx;
+        accountIndexMap.set(acc.pubkey.toBase58(), mappedIdx);
+        logSyncTx("  allAccounts[", idx, "] -> remainder[", mappedIdx, "] =", acc.pubkey.toBase58().slice(0, 16), "isSigner=", acc.isSigner, "isWritable=", acc.isWritable);
+    });
+    // Compile instructions
+    const compiledInstructions = instructions.map((ix, ixIdx) => {
+        const programIdIndex = accountIndexMap.get(ix.programId.toBase58());
+        if (programIdIndex === undefined) {
+            throw new Error(`Program ID ${ix.programId.toBase58()} not found in account map`);
+        }
+        logSyncTx("Instruction", ixIdx, ": programId=", ix.programId.toBase58().slice(0, 12), "-> programIdIndex=", programIdIndex, "(remainder[", programIdIndex, "] should be Exponent program)");
+        const accountIndexes = ix.keys.map((key) => {
+            const idx = accountIndexMap.get(key.pubkey.toBase58());
+            if (idx === undefined) {
+                throw new Error(`Account ${key.pubkey.toBase58()} not found in account map`);
+            }
+            return idx;
+        });
+        return {
+            programIdIndex,
+            accountIndexes,
+            data: ix.data,
+        };
+    });
+    // Serialize compiled instructions
+    const serializedInstructions = serializeCompiledInstructions(compiledInstructions);
+    // Build remaining accounts in the order expected by sync-v2:
+    // [signers, leading policy accounts, pre_hook, post_hook, instruction_accounts].
+    // Squads validates signers from the first numSigners remaining accounts before
+    // any hook parsing, then strips leading policy accounts and hooks before
+    // compiled instruction evaluation/execution.
+    const remainingAccounts = [];
+    // Add signers first (validated before any hook parsing)
+    for (const signer of signers) {
+        remainingAccounts.push({
+            pubkey: signer,
+            isSigner: true,
+            isWritable: false,
+        });
+    }
+    // Add policy prefix / leading accounts (if any, e.g. settings-state expiration)
+    for (const account of leadingAccounts) {
+        remainingAccounts.push("pubkey" in account && account.pubkey != null
+            ? { pubkey: account.pubkey, isSigner: account.isSigner ?? false, isWritable: account.isWritable ?? false }
+            : { pubkey: account, isSigner: false, isWritable: false });
+    }
+    // Add pre-hook accounts (stripped first by parse_hook_accounts)
+    for (const hookAccount of preHookAccounts) {
+        remainingAccounts.push("pubkey" in hookAccount && hookAccount.pubkey != null
+            ? { pubkey: hookAccount.pubkey, isSigner: hookAccount.isSigner ?? false, isWritable: hookAccount.isWritable ?? false }
+            : { pubkey: hookAccount, isSigner: false, isWritable: false });
+    }
+    // Add post-hook accounts (stripped second by parse_hook_accounts)
+    for (const hookAccount of postHookAccounts) {
+        remainingAccounts.push("pubkey" in hookAccount && hookAccount.pubkey != null
+            ? { pubkey: hookAccount.pubkey, isSigner: hookAccount.isSigner ?? false, isWritable: hookAccount.isWritable ?? false }
+            : { pubkey: hookAccount, isSigner: false, isWritable: false });
+    }
+    // Add instruction accounts
+    remainingAccounts.push(...allAccounts);
+    // Log transaction accounts that Squads will use for instruction constraint checks:
+    // strip signers -> strip leading -> strip pre/post hook accounts.
+    const signersLen = signers.length;
+    const leadingLen = leadingAccounts.length;
+    const preLen = preHookAccounts.length;
+    const postLen = postHookAccounts.length;
+    const transactionAccounts = remainingAccounts.slice(signersLen + leadingLen + preLen + postLen);
+    logSyncTx("=== TRANSACTION ACCOUNTS (after stripping signers/leading/hooks) ===");
+    logSyncTx("Stripped: signers", signersLen, "leading", leadingLen, "pre_hook", preLen, "post_hook", postLen, "-> transaction length =", transactionAccounts.length);
+    transactionAccounts.forEach((acc, i) => {
+        logSyncTx("  txAccounts[", i, "] =", acc.pubkey.toBase58().slice(0, 16), "isSigner=", acc.isSigner);
+    });
+    compiledInstructions.forEach((cix, i) => {
+        const accAtProgIdx = transactionAccounts[cix.programIdIndex];
+        logSyncTx("CRITICAL: instruction", i, "programIdIndex=", cix.programIdIndex, "-> txAccounts[", cix.programIdIndex, "] =", accAtProgIdx?.pubkey.toBase58() ?? "OUT_OF_BOUNDS");
+        logSyncTx("  Expected: ExponentnaRg3CQbW6dqQNZKXp7gtZ9DGMp1cwC4HAS7");
+    });
+    logSyncTx("=== compileToSyncTransactionPayload END ===");
+    return {
+        instructions: serializedInstructions,
+        accounts: remainingAccounts,
+    };
+}
+exports.compileToSyncTransactionPayload = compileToSyncTransactionPayload;
+/**
+ * Build the sync_transaction instruction using the Policy payload format.
+ *
+ * When the consensus account is a Policy (not Settings), the SyncPayload
+ * must be SyncPayload::Policy(PolicyPayload::ProgramInteraction(...))
+ */
+function buildSyncTransactionInstruction({ policyPda, accountIndex, numSigners, payload, constraintIndices, squadsProgram = exports.SQUADS_PROGRAM_ID, }) {
+    // Serialize args with Policy payload format
+    const argsData = serializeSyncTransactionArgsForPolicy({
+        accountIndex,
+        numSigners,
+        constraintIndices: constraintIndices ?? null,
+        compiledInstructions: payload.instructions,
+    });
+    // Build instruction data: discriminator + args
+    const data = Buffer.concat([EXECUTE_TRANSACTION_SYNC_V2_DISCRIMINATOR, argsData]);
+    // Build account keys
+    const keys = [
+        {
+            pubkey: policyPda,
+            isWritable: true,
+            isSigner: false,
+        },
+        {
+            pubkey: squadsProgram,
+            isWritable: false,
+            isSigner: false,
+        },
+        ...payload.accounts,
+    ];
+    return new web3_js_1.TransactionInstruction({
+        programId: squadsProgram,
+        keys,
+        data,
+    });
+}
+exports.buildSyncTransactionInstruction = buildSyncTransactionInstruction;
+/**
+ * Convenience function to wrap instructions in a sync_transaction via Policy
+ *
+ * IMPORTANT: Hook accounts must be passed in the correct order:
+ * 1. Leading policy accounts (if any)
+ * 2. Pre-hook accounts (if policy has pre_hook)
+ * 3. Post-hook accounts (if policy has post_hook)
+ * They are appended after signers and before instruction accounts in remaining_accounts.
+ */
+function wrapInstructionsInSyncTransaction({ policyPda, vaultPda, signer, instructions, accountIndex = 0, constraintIndices, leadingAccounts = [], preHookAccounts = [], postHookAccounts = [], squadsProgram = exports.SQUADS_PROGRAM_ID, }) {
+    // For execute_transaction_sync_v2 with ProgramInteraction policies, `numSigners`
+    // applies to the explicit signer prefix in remaining accounts. The smart account
+    // selected by `accountIndex` is resolved from policy/settings state and MUST NOT be
+    // injected into that signer prefix.
+    const signers = [signer];
+    const payload = compileToSyncTransactionPayload({
+        vaultPda,
+        signers,
+        instructions,
+        leadingAccounts,
+        preHookAccounts,
+        postHookAccounts,
+    });
+    return buildSyncTransactionInstruction({
+        policyPda,
+        accountIndex,
+        numSigners: signers.length,
+        payload,
+        constraintIndices,
+        squadsProgram,
+    });
+}
+exports.wrapInstructionsInSyncTransaction = wrapInstructionsInSyncTransaction;
+// ============================================================================
+// Serialization Helpers
+// ============================================================================
+/**
+ * Serialize compiled instructions as SmallVec<u8, CompiledInstruction>
+ */
+function serializeCompiledInstructions(instructions) {
+    let buffer = Buffer.alloc(0);
+    // Length prefix as u8
+    buffer = Buffer.concat([buffer, Buffer.from([instructions.length])]);
+    // Serialize each instruction
+    for (const ix of instructions) {
+        const serializedIx = serializeCompiledInstruction(ix);
+        buffer = Buffer.concat([buffer, serializedIx]);
+    }
+    return Uint8Array.from(buffer);
+}
+/**
+ * Serialize a single CompiledInstruction
+ */
+function serializeCompiledInstruction(ix) {
+    let buffer = Buffer.alloc(0);
+    // program_id_index: u8
+    buffer = Buffer.concat([buffer, Buffer.from([ix.programIdIndex])]);
+    // account_indexes: SmallVec<u8, u8>
+    buffer = Buffer.concat([
+        buffer,
+        Buffer.from([ix.accountIndexes.length]), // length prefix as u8
+        Buffer.from(ix.accountIndexes), // the indexes
+    ]);
+    // data: SmallVec<u16, u8>
+    const dataLenBuffer = Buffer.alloc(2);
+    dataLenBuffer.writeUInt16LE(ix.data.length, 0);
+    buffer = Buffer.concat([
+        buffer,
+        dataLenBuffer, // length prefix as u16 LE
+        ix.data instanceof Buffer ? ix.data : Buffer.from(ix.data), // the data
+    ]);
+    return buffer;
+}
+/**
+ * Serialize SyncTransactionArgs for instruction data using Policy payload format.
+ *
+ * The wire format is:
+ *   accountIndex: u8
+ *   numSigners: u8
+ *   SyncPayload::Policy = variant 1:
+ *     PolicyPayload::ProgramInteraction = variant 1:
+ *       ProgramInteractionPayload:
+ *         instruction_constraint_indices: Option<Vec<u8>>
+ *         transaction_payload: ProgramInteractionTransactionPayload::SyncTransaction = variant 1:
+ *           SyncTransactionPayloadDetails:
+ *             account_index: u8
+ *             instructions: Vec<u8> (4-byte LE length prefix + bytes)
+ */
+function serializeSyncTransactionArgsForPolicy(args) {
+    let buffer = Buffer.alloc(0);
+    // accountIndex: u8
+    buffer = Buffer.concat([buffer, Buffer.from([args.accountIndex])]);
+    // numSigners: u8
+    buffer = Buffer.concat([buffer, Buffer.from([args.numSigners])]);
+    // SyncPayload enum variant: Policy = 1
+    buffer = Buffer.concat([buffer, Buffer.from([1])]);
+    // PolicyPayload enum variant: ProgramInteraction = 1
+    buffer = Buffer.concat([buffer, Buffer.from([1])]);
+    // ProgramInteractionPayload:
+    // 1. instruction_constraint_indices: Option<Vec<u8>>
+    if (args.constraintIndices === null) {
+        // None
+        buffer = Buffer.concat([buffer, Buffer.from([0])]);
+    }
+    else {
+        // Some(Vec<u8>)
+        buffer = Buffer.concat([buffer, Buffer.from([1])]);
+        const vecLenBuf = Buffer.alloc(4);
+        vecLenBuf.writeUInt32LE(args.constraintIndices.length, 0);
+        buffer = Buffer.concat([buffer, vecLenBuf, Buffer.from(args.constraintIndices)]);
+    }
+    // 2. transaction_payload: ProgramInteractionTransactionPayload::SyncTransaction = variant 1
+    buffer = Buffer.concat([buffer, Buffer.from([1])]);
+    // SyncTransactionPayloadDetails:
+    //   account_index: u8
+    buffer = Buffer.concat([buffer, Buffer.from([args.accountIndex])]);
+    //   instructions: Vec<u8> (bytes = 4-byte LE length prefix + data)
+    const instructionsLen = args.compiledInstructions.length;
+    const lenBuffer = Buffer.alloc(4);
+    lenBuffer.writeUInt32LE(instructionsLen, 0);
+    buffer = Buffer.concat([buffer, lenBuffer, Buffer.from(args.compiledInstructions)]);
+    return buffer;
+}
+//# sourceMappingURL=syncTransaction.js.map

package/build/exponentVaults/syncTransaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncTransaction.js","sourceRoot":"","sources":["../../src/exponentVaults/syncTransaction.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEH,6CAAgF;AAEhF,gDAAgD;AACnC,QAAA,iBAAiB,GAAG,IAAI,mBAAS,CAAC,6CAA6C,CAAC,CAAA;AAE7F,4GAA4G;AAC5G,MAAM,KAAK,GAAG,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,aAAa,KAAK,GAAG,CAAA;AAElF,SAAS,SAAS,CAAC,GAAG,IAAe;IACnC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,CAAA;IACnC,CAAC;AACH,CAAC;AAiCD,+EAA+E;AAC/E,4EAA4E;AAC5E,+EAA+E;AAE/E,MAAM,yCAAyC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAA;AAEjG,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,SAAgB,+BAA+B,CAAC,EAC9C,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,eAAe,GAAG,EAAE,EACpB,eAAe,GAAG,EAAE,EACpB,gBAAgB,GAAG,EAAE,GAWtB;IACC,SAAS,CAAC,+CAA+C,CAAC,CAAA;IAC1D,SAAS,CAAC,kBAAkB,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,YAAY,CAAC,MAAM,CAAC,CAAA;IACnI,SAAS,CAAC,oBAAoB,EAAE,eAAe,CAAC,MAAM,EAAE,oBAAoB,EAAE,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,EAAE,eAAe,CAAC,MAAM,CAAC,CAAA;IAEnJ,2CAA2C;IAC3C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAuB,CAAA;IAEjD,4DAA4D;IAC5D,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;QAC9B,iBAAiB;QACjB,MAAM,UAAU,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAA;QAC1C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAChC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE;gBACzB,MAAM,EAAE,EAAE,CAAC,SAAS;gBACpB,QAAQ,EAAE,KAAK;gBACf,UAAU,EAAE,KAAK;aAClB,CAAC,CAAA;QACJ,CAAC;QAED,2BAA2B;QAC3B,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAA;YACpC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YACvC,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,CAAA;gBAC3D,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAA;YACvD,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,CAAA;YACpC,CAAC;QACH,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAA;IACnD,SAAS,CAAC,4BAA4B,EAAE,WAAW,CAAC,MAAM,EAAE,mCAAmC,CAAC,CAAA;IAEhG,mGAAmG;IACnG,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAA;IACpC,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,QAAQ,CAAC,CAAA;IAClF,IAAI,YAAY,EAAE,CAAC;QACjB,YAAY,CAAC,QAAQ,GAAG,KAAK,CAAA;IAC/B,CAAC;IAED,uFAAuF;IACvF,2DAA2D;IAC3D,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC5D,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC5D,OAAO,MAAM,GAAG,MAAM,CAAA;IACxB,CAAC,CAAC,CAAA;IAEF,4EAA4E;IAC5E,+EAA+E;IAC/E,oFAAoF;IACpF,MAAM,aAAa,GAAG,CAAC,CAAA;IACvB,SAAS,CAAC,6CAA6C,EAAE,aAAa,CAAC,CAAA;IAEvE,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAA;IACjD,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC/B,MAAM,SAAS,GAAG,aAAa,GAAG,GAAG,CAAA;QACrC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,CAAC,CAAA;QACrD,SAAS,CAAC,gBAAgB,EAAE,GAAG,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,CAAC,UAAU,CAAC,CAAA;IACrK,CAAC,CAAC,CAAA;IAEF,uBAAuB;IACvB,MAAM,oBAAoB,GAA0B,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE;QACjF,MAAM,cAAc,GAAG,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAA;QACnE,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAA;QACnF,CAAC;QACD,SAAS,CAAC,aAAa,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,oBAAoB,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,+BAA+B,CAAC,CAAA;QAC3L,MAAM,cAAc,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACzC,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;YACtD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAA;YAC9E,CAAC;YACD,OAAO,GAAG,CAAA;QACZ,CAAC,CAAC,CAAA;QAEF,OAAO;YACL,cAAc;YACd,cAAc;YACd,IAAI,EAAE,EAAE,CAAC,IAAI;SACd,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,kCAAkC;IAClC,MAAM,sBAAsB,GAAG,6BAA6B,CAAC,oBAAoB,CAAC,CAAA;IAElF,6DAA6D;IAC7D,iFAAiF;IACjF,+EAA+E;IAC/E,yEAAyE;IACzE,6CAA6C;IAC7C,MAAM,iBAAiB,GAAkB,EAAE,CAAA;IAE3C,wDAAwD;IACxD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,iBAAiB,CAAC,IAAI,CAAC;YACrB,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,KAAK;SAClB,CAAC,CAAA;IACJ,CAAC;IAED,gFAAgF;IAChF,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;QACtC,iBAAiB,CAAC,IAAI,CACpB,QAAQ,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI;YAC3C,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK,EAAE;YAC1G,CAAC,CAAC,EAAE,MAAM,EAAE,OAAoB,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CACzE,CAAA;IACH,CAAC;IAED,gEAAgE;IAChE,KAAK,MAAM,WAAW,IAAI,eAAe,EAAE,CAAC;QAC1C,iBAAiB,CAAC,IAAI,CACpB,QAAQ,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,IAAI,IAAI;YACnD,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,IAAI,KAAK,EAAE,UAAU,EAAE,WAAW,CAAC,UAAU,IAAI,KAAK,EAAE;YACtH,CAAC,CAAC,EAAE,MAAM,EAAE,WAAwB,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAC7E,CAAA;IACH,CAAC;IAED,kEAAkE;IAClE,KAAK,MAAM,WAAW,IAAI,gBAAgB,EAAE,CAAC;QAC3C,iBAAiB,CAAC,IAAI,CACpB,QAAQ,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,IAAI,IAAI;YACnD,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,IAAI,KAAK,EAAE,UAAU,EAAE,WAAW,CAAC,UAAU,IAAI,KAAK,EAAE;YACtH,CAAC,CAAC,EAAE,MAAM,EAAE,WAAwB,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAC7E,CAAA;IACH,CAAC;IAED,2BAA2B;IAC3B,iBAAiB,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAA;IAEtC,mFAAmF;IACnF,kEAAkE;IAClE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAA;IACjC,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAA;IACzC,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAA;IACrC,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAA;IACvC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,KAAK,CAAC,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;IAC/F,SAAS,CAAC,sEAAsE,CAAC,CAAA;IACjF,SAAS,CACP,mBAAmB,EACnB,UAAU,EACV,SAAS,EACT,UAAU,EACV,UAAU,EACV,MAAM,EACN,WAAW,EACX,OAAO,EACP,yBAAyB,EACzB,mBAAmB,CAAC,MAAM,CAC3B,CAAA;IACD,mBAAmB,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACrC,SAAS,CAAC,eAAe,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAA;IACrG,CAAC,CAAC,CAAA;IACF,oBAAoB,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACtC,MAAM,YAAY,GAAG,mBAAmB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;QAC5D,SAAS,CAAC,uBAAuB,EAAE,CAAC,EAAE,iBAAiB,EAAE,GAAG,CAAC,cAAc,EAAE,gBAAgB,EAAE,GAAG,CAAC,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,eAAe,CAAC,CAAA;QAC7K,SAAS,CAAC,0DAA0D,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;IACF,SAAS,CAAC,6CAA6C,CAAC,CAAA;IAExD,OAAO;QACL,YAAY,EAAE,sBAAsB;QACpC,QAAQ,EAAE,iBAAiB;KAC5B,CAAA;AACH,CAAC;AA3LD,0EA2LC;AAED;;;;;GAKG;AACH,SAAgB,+BAA+B,CAAC,EAC9C,SAAS,EACT,YAAY,EACZ,UAAU,EACV,OAAO,EACP,iBAAiB,EACjB,aAAa,GAAG,yBAAiB,GASlC;IACC,4CAA4C;IAC5C,MAAM,QAAQ,GAAG,qCAAqC,CAAC;QACrD,YAAY;QACZ,UAAU;QACV,iBAAiB,EAAE,iBAAiB,IAAI,IAAI;QAC5C,oBAAoB,EAAE,OAAO,CAAC,YAAY;KAC3C,CAAC,CAAA;IAEF,+CAA+C;IAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,yCAAyC,EAAE,QAAQ,CAAC,CAAC,CAAA;IAEjF,qBAAqB;IACrB,MAAM,IAAI,GAAkB;QAC1B;YACE,MAAM,EAAE,SAAS;YACjB,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,MAAM,EAAE,aAAa;YACrB,UAAU,EAAE,KAAK;YACjB,QAAQ,EAAE,KAAK;SAChB;QACD,GAAG,OAAO,CAAC,QAAQ;KACpB,CAAA;IAED,OAAO,IAAI,gCAAsB,CAAC;QAChC,SAAS,EAAE,aAAa;QACxB,IAAI;QACJ,IAAI;KACL,CAAC,CAAA;AACJ,CAAC;AA/CD,0EA+CC;AAED;;;;;;;;GAQG;AACH,SAAgB,iCAAiC,CAAC,EAChD,SAAS,EACT,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,YAAY,GAAG,CAAC,EAChB,iBAAiB,EACjB,eAAe,GAAG,EAAE,EACpB,eAAe,GAAG,EAAE,EACpB,gBAAgB,GAAG,EAAE,EACrB,aAAa,GAAG,yBAAiB,GAclC;IACC,iFAAiF;IACjF,iFAAiF;IACjF,oFAAoF;IACpF,oCAAoC;IACpC,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,CAAA;IAExB,MAAM,OAAO,GAAG,+BAA+B,CAAC;QAC9C,QAAQ;QACR,OAAO;QACP,YAAY;QACZ,eAAe;QACf,eAAe;QACf,gBAAgB;KACjB,CAAC,CAAA;IAEF,OAAO,+BAA+B,CAAC;QACrC,SAAS;QACT,YAAY;QACZ,UAAU,EAAE,OAAO,CAAC,MAAM;QAC1B,OAAO;QACP,iBAAiB;QACjB,aAAa;KACd,CAAC,CAAA;AACJ,CAAC;AAhDD,8EAgDC;AAED,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;GAEG;AACH,SAAS,6BAA6B,CAAC,YAAmC;IACxE,IAAI,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAE5B,sBAAsB;IACtB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAEpE,6BAA6B;IAC7B,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;QAC9B,MAAM,YAAY,GAAG,4BAA4B,CAAC,EAAE,CAAC,CAAA;QACrD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;IAChD,CAAC;IAED,OAAO,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AAChC,CAAC;AAED;;GAEG;AACH,SAAS,4BAA4B,CAAC,EAAuB;IAC3D,IAAI,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAE5B,uBAAuB;IACvB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAA;IAElE,oCAAoC;IACpC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QACrB,MAAM;QACN,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE,sBAAsB;QAC/D,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE,cAAc;KAC/C,CAAC,CAAA;IAEF,0BAA0B;IAC1B,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACrC,aAAa,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAC9C,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QACrB,MAAM;QACN,aAAa,EAAE,0BAA0B;QACzC,EAAE,CAAC,IAAI,YAAY,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,WAAW;KACxE,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAS,qCAAqC,CAAC,IAK9C;IACC,IAAI,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAE5B,mBAAmB;IACnB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;IAElE,iBAAiB;IACjB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;IAEhE,uCAAuC;IACvC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAElD,qDAAqD;IACrD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAElD,6BAA6B;IAC7B,qDAAqD;IACrD,IAAI,IAAI,CAAC,iBAAiB,KAAK,IAAI,EAAE,CAAC;QACpC,OAAO;QACP,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACpD,CAAC;SAAM,CAAC;QACN,gBAAgB;QAChB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAClD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QACjC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;QACzD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAA;IAClF,CAAC;IAED,4FAA4F;IAC5F,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAElD,iCAAiC;IACjC,sBAAsB;IACtB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;IAElE,mEAAmE;IACnE,MAAM,eAAe,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAA;IACxD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACjC,SAAS,CAAC,aAAa,CAAC,eAAe,EAAE,CAAC,CAAC,CAAA;IAC3C,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAA;IAEnF,OAAO,MAAM,CAAA;AACf,CAAC"}

package/build/exponentVaults/titan-quote.d.ts

@@ -0,0 +1,22 @@
+import { Connection, PublicKey, TransactionInstruction } from "@solana/web3.js";
+interface TitanSwapParams {
+    inputMint: PublicKey;
+    outputMint: PublicKey;
+    amount: bigint;
+    slippageBps?: number;
+    userPublicKey: PublicKey;
+}
+export interface TitanQuoteResult {
+    instruction: TransactionInstruction;
+    /** ALT addresses from the Titan route — fetch these on-chain and include in V0 message compilation */
+    addressLookupTableAddresses: PublicKey[];
+}
+/**
+ * Fetch a single Titan swap quote and return the SwapRouteV2 instruction
+ * along with any Address Lookup Table addresses needed for transaction compression.
+ */
+export declare function getTitanQuote(connection: Connection, auth: {
+    wsUrl: string;
+    authToken: string;
+}, params: TitanSwapParams): Promise<TitanQuoteResult>;
+export {};

package/build/exponentVaults/titan-quote.js

@@ -0,0 +1,167 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTitanQuote = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const msgpack_1 = require("@msgpack/msgpack");
+const ws_1 = __importDefault(require("ws"));
+const TITAN_WS_SUBPROTOCOL = "v1.api.titan.ag";
+const SWAP_ROUTE_V2_DISCRIMINATOR = Buffer.from([249, 91, 84, 33, 69, 22, 0, 135]);
+const QUOTE_TIMEOUT_MS = 45_000;
+const JITO_BUNDLE_BLOCKED_ACCOUNT_PREFIXES = ["jitodontfront", "jitonobundle"];
+/**
+ * Fetch a single Titan swap quote and return the SwapRouteV2 instruction
+ * along with any Address Lookup Table addresses needed for transaction compression.
+ */
+async function getTitanQuote(connection, auth, params) {
+    const route = await fetchBestRoute(auth, params);
+    const addressLookupTableAddresses = (route.addressLookupTables ?? []).map((bytes) => new web3_js_1.PublicKey(bytes));
+    // Path 1: Full transaction bytes — deserialize and extract the swap ix
+    if (route.transaction) {
+        const vTx = web3_js_1.VersionedTransaction.deserialize(new Uint8Array(route.transaction));
+        const instruction = await extractSwapInstruction(connection, vTx);
+        return { instruction, addressLookupTableAddresses };
+    }
+    // Path 2: Reconstruct from the route's instructions array
+    if (route.instructions && route.instructions.length > 0) {
+        const swapIx = route.instructions.find((ix) => {
+            return ix.d.length >= 8 && Buffer.from(ix.d.subarray(0, 8)).equals(SWAP_ROUTE_V2_DISCRIMINATOR);
+        });
+        if (swapIx) {
+            const instruction = new web3_js_1.TransactionInstruction({
+                programId: new web3_js_1.PublicKey(swapIx.p),
+                keys: swapIx.a.map((acc) => ({
+                    pubkey: new web3_js_1.PublicKey(acc.p),
+                    isSigner: acc.s,
+                    isWritable: acc.w,
+                })),
+                data: Buffer.from(swapIx.d),
+            });
+            return { instruction: sanitizeTitanInstructionForBundles(instruction), addressLookupTableAddresses };
+        }
+    }
+    throw new Error("Titan route has neither transaction bytes nor a SwapRouteV2 instruction");
+}
+exports.getTitanQuote = getTitanQuote;
+// --- Internals ---
+function fetchBestRoute(auth, params) {
+    return new Promise((resolve, reject) => {
+        const url = `${auth.wsUrl}?auth=${auth.authToken}`;
+        const ws = new ws_1.default(url, [TITAN_WS_SUBPROTOCOL]);
+        ws.binaryType = "arraybuffer";
+        const timeout = setTimeout(() => {
+            ws.close();
+            reject(new Error("Titan quote timed out after " + QUOTE_TIMEOUT_MS + "ms"));
+        }, QUOTE_TIMEOUT_MS);
+        const cleanup = () => {
+            clearTimeout(timeout);
+            ws.close();
+        };
+        ws.on("error", (err) => {
+            cleanup();
+            reject(new Error("Titan WebSocket error: " + err.message));
+        });
+        ws.on("open", () => {
+            const request = {
+                id: 0,
+                data: {
+                    NewSwapQuoteStream: {
+                        swap: {
+                            inputMint: params.inputMint.toBytes(),
+                            outputMint: params.outputMint.toBytes(),
+                            amount: params.amount,
+                            slippageBps: params.slippageBps ?? 50,
+                        },
+                        transaction: {
+                            userPublicKey: params.userPublicKey.toBytes(),
+                        },
+                        update: {
+                            num_quotes: 3,
+                        },
+                    },
+                },
+            };
+            ws.send((0, msgpack_1.encode)(request, { useBigInt64: true }));
+        });
+        ws.on("message", (data) => {
+            const msg = (0, msgpack_1.decode)(new Uint8Array(data), { useBigInt64: true });
+            if (msg.Error) {
+                cleanup();
+                reject(new Error(`Titan API error [${msg.Error.code}]: ${msg.Error.message}`));
+                return;
+            }
+            if (msg.StreamData) {
+                const quotes = msg.StreamData.payload?.SwapQuotes;
+                if (!quotes)
+                    return;
+                const best = selectBestUsableRoute(Object.values(quotes.quotes));
+                if (best) {
+                    cleanup();
+                    resolve(best);
+                    return;
+                }
+            }
+            if (msg.StreamEnd) {
+                cleanup();
+                const err = msg.StreamEnd.errorMessage
+                    ? `Titan stream ended with error [${msg.StreamEnd.errorCode}]: ${msg.StreamEnd.errorMessage}`
+                    : "Titan stream ended unexpectedly";
+                reject(new Error(err));
+            }
+        });
+    });
+}
+function selectBestUsableRoute(routes) {
+    return [...routes]
+        .sort((a, b) => (a.outAmount > b.outAmount ? -1 : a.outAmount < b.outAmount ? 1 : 0))
+        .find(isUsableTitanRoute);
+}
+function isUsableTitanRoute(route) {
+    if (route.transaction) {
+        return true;
+    }
+    return (route.instructions?.some((ix) => {
+        return ix.d.length >= 8 && Buffer.from(ix.d.subarray(0, 8)).equals(SWAP_ROUTE_V2_DISCRIMINATOR);
+    }) ?? false);
+}
+async function extractSwapInstruction(connection, vTx) {
+    const message = vTx.message;
+    let lookupTableAccounts = [];
+    if ("addressTableLookups" in message && message.addressTableLookups.length > 0) {
+        lookupTableAccounts = await Promise.all(message.addressTableLookups.map(async (lookup) => {
+            const result = await connection.getAddressLookupTable(lookup.accountKey);
+            if (!result.value) {
+                throw new Error("Failed to resolve address lookup table: " + lookup.accountKey.toBase58());
+            }
+            return result.value;
+        }));
+    }
+    const decompiled = web3_js_1.TransactionMessage.decompile(message, {
+        addressLookupTableAccounts: lookupTableAccounts,
+    });
+    const swapIx = decompiled.instructions.find((ix) => ix.data.length >= 8 && Buffer.from(ix.data.subarray(0, 8)).equals(SWAP_ROUTE_V2_DISCRIMINATOR));
+    if (!swapIx) {
+        throw new Error("No SwapRouteV2 instruction found in Titan transaction");
+    }
+    return sanitizeTitanInstructionForBundles(swapIx);
+}
+function sanitizeTitanInstructionForBundles(instruction) {
+    const filteredKeys = instruction.keys.filter((key) => {
+        const address = key.pubkey.toBase58().toLowerCase();
+        if (!JITO_BUNDLE_BLOCKED_ACCOUNT_PREFIXES.some((prefix) => address.startsWith(prefix))) {
+            return true;
+        }
+        return key.isSigner || key.isWritable;
+    });
+    if (filteredKeys.length === instruction.keys.length) {
+        return instruction;
+    }
+    return new web3_js_1.TransactionInstruction({
+        programId: instruction.programId,
+        keys: filteredKeys,
+        data: instruction.data,
+    });
+}
+//# sourceMappingURL=titan-quote.js.map

package/build/exponentVaults/titan-quote.js.map

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