@exponent-labs/exponent-sdk 0.9.0 → 0.9.2

package/build/exponentVaults/loopscale-execution.js

@@ -0,0 +1,341 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeLoopscaleExecutionPlan = exports.createLoopscaleExecutionPlan = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const vault_interaction_1 = require("./vault-interaction");
+const loopscale_client_1 = require("./loopscale-client");
+const LOOPSCALE_WRAPPERS = {
+    createLoan: (instruction) => vault_interaction_1.loopscaleAction.createLoan({ instruction }),
+    depositCollateral: (instruction) => vault_interaction_1.loopscaleAction.depositCollateral({ instruction }),
+    updateWeightMatrix: (instruction) => vault_interaction_1.loopscaleAction.updateWeightMatrix({ instruction }),
+    borrowPrincipal: (instruction) => vault_interaction_1.loopscaleAction.borrowPrincipal({ instruction }),
+    repayPrincipal: (instruction) => vault_interaction_1.loopscaleAction.repayPrincipal({ instruction }),
+    withdrawCollateral: (instruction) => vault_interaction_1.loopscaleAction.withdrawCollateral({ instruction }),
+    closeLoan: (instruction) => vault_interaction_1.loopscaleAction.closeLoan({ instruction }),
+    createStrategy: (instruction) => vault_interaction_1.loopscaleAction.createStrategy({ instruction }),
+    depositStrategy: (instruction) => vault_interaction_1.loopscaleAction.depositStrategy({ instruction }),
+    withdrawStrategy: (instruction) => vault_interaction_1.loopscaleAction.withdrawStrategy({ instruction }),
+    closeStrategy: (instruction) => vault_interaction_1.loopscaleAction.closeStrategy({ instruction }),
+    updateStrategy: (instruction) => vault_interaction_1.loopscaleAction.updateStrategy({ instruction }),
+};
+async function decompileTransaction(connection, transaction) {
+    const addressLookupTableAccounts = await Promise.all(transaction.message.addressTableLookups.map(async (lookup) => {
+        const result = await connection.getAddressLookupTable(lookup.accountKey);
+        if (!result.value) {
+            throw new Error(`Missing lookup table ${lookup.accountKey.toBase58()}`);
+        }
+        return result.value;
+    }));
+    return web3_js_1.TransactionMessage.decompile(transaction.message, { addressLookupTableAccounts }).instructions;
+}
+function isComputeBudgetInstruction(instruction) {
+    return instruction.programId.equals(web3_js_1.ComputeBudgetProgram.programId);
+}
+function wrapLoopscaleInstruction(instruction) {
+    const name = (0, loopscale_client_1.identifyLoopscaleInstruction)(instruction);
+    if (!name) {
+        throw new Error("Encountered a non-Loopscale or unsupported Loopscale instruction in a sync segment");
+    }
+    if (!(name in LOOPSCALE_WRAPPERS)) {
+        throw new Error(`Loopscale instruction ${name} is not supported through Exponent CPI execution`);
+    }
+    return LOOPSCALE_WRAPPERS[name](instruction);
+}
+function dedupeLookupTables(addressLookupTableAccounts) {
+    const seen = new Set();
+    return addressLookupTableAccounts.filter((account) => {
+        const key = account.key.toBase58();
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+async function resolveLookupTableAccounts(connection, addresses) {
+    const results = await Promise.all(addresses.map((address) => connection.getAddressLookupTable(address)));
+    return results
+        .map((result) => result.value)
+        .filter((value) => value !== null);
+}
+async function sendAndConfirm(connection, transaction, sendOptions, confirmation) {
+    const signature = await connection.sendTransaction(transaction, sendOptions);
+    let confirmationError = null;
+    let confirmed = false;
+    if (confirmation.blockhash && confirmation.lastValidBlockHeight !== undefined) {
+        const result = await connection.confirmTransaction({
+            signature,
+            blockhash: confirmation.blockhash,
+            lastValidBlockHeight: confirmation.lastValidBlockHeight,
+        }, confirmation.commitment).catch(() => null);
+        confirmationError = result?.value.err ?? null;
+        confirmed = result !== null;
+    }
+    else {
+        for (let attempt = 0; attempt < 60; attempt += 1) {
+            const statuses = await connection.getSignatureStatuses([signature]);
+            const status = statuses.value[0];
+            if (status?.err || status?.confirmationStatus === "confirmed" || status?.confirmationStatus === "finalized") {
+                confirmationError = status?.err ?? null;
+                confirmed = status?.confirmationStatus === "confirmed" || status?.confirmationStatus === "finalized";
+                break;
+            }
+            await new Promise((resolve) => setTimeout(resolve, 1_000));
+        }
+    }
+    if (confirmationError) {
+        return {
+            signature,
+            logs: null,
+            error: confirmationError,
+        };
+    }
+    const finality = confirmation.commitment === "finalized" ? "finalized" : "confirmed";
+    for (let attempt = 0; attempt < 10; attempt += 1) {
+        const txResult = await connection.getTransaction(signature, {
+            commitment: finality,
+            maxSupportedTransactionVersion: 0,
+        });
+        if (txResult) {
+            return {
+                signature,
+                logs: txResult.meta?.logMessages ?? null,
+                error: txResult.meta?.err ?? null,
+            };
+        }
+        await new Promise((resolve) => setTimeout(resolve, 500));
+    }
+    const statuses = await connection.getSignatureStatuses([signature], { searchTransactionHistory: true });
+    const status = statuses.value[0];
+    if (status?.err) {
+        return {
+            signature,
+            logs: null,
+            error: status.err,
+        };
+    }
+    if (status?.confirmationStatus === "confirmed" || status?.confirmationStatus === "finalized") {
+        return {
+            signature,
+            logs: null,
+            error: null,
+        };
+    }
+    if (confirmed) {
+        return {
+            signature,
+            logs: null,
+            error: null,
+        };
+    }
+    return {
+        signature,
+        logs: null,
+        error: `Transaction ${signature} not found after confirmation timeout`,
+    };
+}
+/**
+ * Convert a raw Loopscale strategy or CPI-compatible loan response into an
+ * Exponent execution plan.
+ *
+ * The adapter preserves transaction boundaries while classifying each returned
+ * transaction into:
+ * 1. standalone top-level batches for contiguous non-Loopscale prefixes/suffixes
+ * 2. wrapped Loopscale sync batches containing only compute-budget prefixes and
+ *    Loopscale program instructions
+ *
+ * This keeps the wrapped sync transaction small and preserves the relative
+ * ordering of any safe top-level setup/finalization work Loopscale includes
+ * around the CPI-compatible instruction segment.
+ *
+ * Loopscale loan maintenance responses such as `repayPrincipal`,
+ * `withdrawCollateral`, `updateWeightMatrix`, and `closeLoan` are supported as
+ * long as they are returned directly by Loopscale in a clean sync segment.
+ * Unsupported instructions such as `lockLoan`, `unlockLoan`, or
+ * `refinanceLedger` still throw instead of being guessed into the sync
+ * segment.
+ */
+async function createLoopscaleExecutionPlan({ connection, response, }) {
+    const rawResponses = (0, loopscale_client_1.getLoopscaleTransactionResponses)(response);
+    const rawTransactions = rawResponses.map((entry) => (0, loopscale_client_1.deserializeLoopscaleTransactionResponse)(entry));
+    const batches = [];
+    for (const transaction of rawTransactions) {
+        const instructions = await decompileTransaction(connection, transaction);
+        const loopscaleIndices = instructions
+            .map((instruction, index) => (0, loopscale_client_1.identifyLoopscaleInstruction)(instruction) !== null ? index : -1)
+            .filter((index) => index !== -1);
+        const firstLoopscaleIndex = loopscaleIndices[0] ?? -1;
+        if (firstLoopscaleIndex === -1) {
+            batches.push({
+                kind: "standalone",
+                instructions,
+                signers: [],
+                addressLookupTableAddresses: transaction.message.addressTableLookups.map((lookup) => lookup.accountKey),
+                rawTransaction: transaction,
+            });
+            continue;
+        }
+        const lastLoopscaleIndex = loopscaleIndices[loopscaleIndices.length - 1];
+        const prefixInstructions = [];
+        const preInstructions = [];
+        const syncInstructions = [];
+        const suffixInstructions = [];
+        for (let index = 0; index < firstLoopscaleIndex; index += 1) {
+            const instruction = instructions[index];
+            if (isComputeBudgetInstruction(instruction)) {
+                preInstructions.push(instruction);
+                continue;
+            }
+            prefixInstructions.push(instruction);
+        }
+        for (let index = firstLoopscaleIndex; index <= lastLoopscaleIndex; index += 1) {
+            const instruction = instructions[index];
+            const name = (0, loopscale_client_1.identifyLoopscaleInstruction)(instruction);
+            if (name !== null) {
+                syncInstructions.push(wrapLoopscaleInstruction(instruction));
+                continue;
+            }
+            throw new Error("Loopscale execution plan cannot split non-Loopscale instructions interleaved within a sync segment");
+        }
+        for (let index = lastLoopscaleIndex + 1; index < instructions.length; index += 1) {
+            suffixInstructions.push(instructions[index]);
+        }
+        if (prefixInstructions.length > 0) {
+            batches.push({
+                kind: "standalone",
+                instructions: prefixInstructions,
+                signers: [],
+                addressLookupTableAddresses: transaction.message.addressTableLookups.map((lookup) => lookup.accountKey),
+                rawTransaction: transaction,
+            });
+        }
+        batches.push({
+            kind: "sync",
+            preInstructions,
+            syncInstructions,
+            postInstructions: [],
+            signers: [],
+            addressLookupTableAddresses: [],
+            rawTransaction: transaction,
+        });
+        if (suffixInstructions.length > 0) {
+            batches.push({
+                kind: "standalone",
+                instructions: suffixInstructions,
+                signers: [],
+                addressLookupTableAddresses: transaction.message.addressTableLookups.map((lookup) => lookup.accountKey),
+                rawTransaction: transaction,
+            });
+        }
+    }
+    return { batches, rawTransactions };
+}
+exports.createLoopscaleExecutionPlan = createLoopscaleExecutionPlan;
+/**
+ * Execute a previously created Loopscale execution plan.
+ *
+ * Sync batches are wrapped into Squads sync transactions and optionally passed
+ * through `context.coSign`. Standalone batches are sent as regular top-level
+ * transactions without wrapping.
+ */
+async function executeLoopscaleExecutionPlan({ plan, context, }) {
+    if (context.signers.length === 0) {
+        throw new Error("Loopscale execution requires at least one signer");
+    }
+    const commitment = context.commitment ?? "confirmed";
+    const results = [];
+    for (const [batchIndex, batch] of plan.batches.entries()) {
+        if (batch.kind === "standalone") {
+            const addressLookupTableAccounts = await resolveLookupTableAccounts(context.connection, batch.addressLookupTableAddresses);
+            const { blockhash, lastValidBlockHeight } = await context.connection.getLatestBlockhash(commitment);
+            const message = new web3_js_1.TransactionMessage({
+                payerKey: context.signers[0].publicKey,
+                recentBlockhash: blockhash,
+                instructions: batch.instructions,
+            }).compileToV0Message(addressLookupTableAccounts);
+            const transaction = new web3_js_1.VersionedTransaction(message);
+            transaction.sign(context.signers);
+            const result = await sendAndConfirm(context.connection, transaction, context.sendOptions, { commitment, blockhash, lastValidBlockHeight });
+            results.push({
+                batchIndex,
+                kind: "standalone",
+                ...result,
+            });
+            if (result.error) {
+                return { error: result.error, results };
+            }
+            continue;
+        }
+        const syncResult = await (0, vault_interaction_1.createVaultSyncTransaction)({
+            instructions: batch.syncInstructions,
+            owner: context.owner,
+            connection: context.connection,
+            policyPda: context.policyPda,
+            vaultPda: context.vaultPda,
+            signer: context.signer,
+            accountIndex: context.accountIndex,
+            constraintIndices: context.constraintIndices,
+            vaultAddress: context.vaultAddress,
+            leadingAccounts: context.leadingAccounts,
+            preHookAccounts: context.preHookAccounts,
+            postHookAccounts: context.postHookAccounts,
+            squadsProgram: context.squadsProgram,
+        });
+        if (syncResult.setupInstructions.length > 0) {
+            const { blockhash, lastValidBlockHeight } = await context.connection.getLatestBlockhash(commitment);
+            const setupMessage = new web3_js_1.TransactionMessage({
+                payerKey: context.signers[0].publicKey,
+                recentBlockhash: blockhash,
+                instructions: [
+                    web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: 400_000 }),
+                    ...syncResult.setupInstructions,
+                ],
+            }).compileToV0Message([]);
+            const setupTransaction = new web3_js_1.VersionedTransaction(setupMessage);
+            setupTransaction.sign(context.signers);
+            const setupResult = await sendAndConfirm(context.connection, setupTransaction, context.sendOptions, { commitment, blockhash, lastValidBlockHeight });
+            results.push({
+                batchIndex,
+                kind: "setup",
+                ...setupResult,
+            });
+            if (setupResult.error) {
+                return { error: setupResult.error, results };
+            }
+        }
+        const rawLookupTableAccounts = await resolveLookupTableAccounts(context.connection, batch.addressLookupTableAddresses);
+        const addressLookupTableAccounts = dedupeLookupTables([
+            ...(context.addressLookupTableAccounts ?? []),
+            ...rawLookupTableAccounts,
+        ]);
+        const { blockhash, lastValidBlockHeight } = await context.connection.getLatestBlockhash(commitment);
+        const message = new web3_js_1.TransactionMessage({
+            payerKey: context.signers[0].publicKey,
+            recentBlockhash: blockhash,
+            instructions: [
+                ...(context.prependInstructions ?? []),
+                ...batch.preInstructions,
+                ...syncResult.preInstructions,
+                syncResult.instruction,
+                ...batch.postInstructions,
+                ...syncResult.postInstructions,
+            ],
+        }).compileToV0Message(addressLookupTableAccounts);
+        let transaction = new web3_js_1.VersionedTransaction(message);
+        transaction.sign([...context.signers, ...syncResult.signers, ...batch.signers]);
+        if (context.coSign) {
+            transaction = await context.coSign(transaction);
+        }
+        const result = await sendAndConfirm(context.connection, transaction, context.sendOptions, { commitment, blockhash, lastValidBlockHeight });
+        results.push({
+            batchIndex,
+            kind: "sync",
+            ...result,
+        });
+        if (result.error) {
+            return { error: result.error, results };
+        }
+    }
+    return { error: null, results };
+}
+exports.executeLoopscaleExecutionPlan = executeLoopscaleExecutionPlan;
+//# sourceMappingURL=loopscale-execution.js.map

package/build/exponentVaults/loopscale-execution.js.map

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

package/build/exponentVaults/loopscale-execution.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/exponentVaults/loopscale-execution.test.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const web3_js_1 = require("@solana/web3.js");
+const policyBuilders_1 = require("./policyBuilders");
+const loopscale_execution_1 = require("./loopscale-execution");
+function buildLoopscaleInstruction(name, payer) {
+    return new web3_js_1.TransactionInstruction({
+        programId: policyBuilders_1.LOOPSCALE_PROGRAM_ID,
+        keys: [
+            { pubkey: payer, isSigner: true, isWritable: true },
+            { pubkey: new web3_js_1.PublicKey("4Nd1mY7V4KJ1mQ9MJ2VYfXh7WvyaManEXZDV4xQSSHqK"), isSigner: false, isWritable: true },
+            { pubkey: new web3_js_1.PublicKey("8W2Y29Jw6dBfS4M7N6KBiD5D4Q2qk4VmF1jM7c3M4bXv"), isSigner: false, isWritable: true },
+            { pubkey: new web3_js_1.PublicKey("9b3BfUqKNAYdP9KJ3cVd7hYjW4M5w2v8s2Q2Mmj74o8D"), isSigner: false, isWritable: true },
+        ],
+        data: Buffer.concat([Buffer.from(policyBuilders_1.LOOPSCALE_DISCRIMINATORS[name]), Buffer.alloc(8)]),
+    });
+}
+function buildNonLoopscaleInstruction(programId, payer) {
+    return new web3_js_1.TransactionInstruction({
+        programId,
+        keys: [{ pubkey: payer, isSigner: true, isWritable: true }],
+        data: Buffer.alloc(0),
+    });
+}
+function encodeTransactionResponse(instructions, payer = new web3_js_1.PublicKey("11111111111111111111111111111111")) {
+    const message = new web3_js_1.TransactionMessage({
+        payerKey: payer,
+        recentBlockhash: "11111111111111111111111111111111",
+        instructions,
+    }).compileToV0Message([]);
+    const transaction = new web3_js_1.VersionedTransaction(message);
+    return {
+        message: Buffer.from(transaction.message.serialize()).toString("base64"),
+        signatures: [{
+                publicKey: payer.toBase58(),
+                signature: Buffer.alloc(64).toString("base64"),
+            }],
+    };
+}
+(0, globals_1.describe)("createLoopscaleExecutionPlan", () => {
+    const connection = new web3_js_1.Connection("http://127.0.0.1:8899");
+    const payer = new web3_js_1.PublicKey("11111111111111111111111111111111");
+    (0, globals_1.it)("splits non-Loopscale suffix instructions into a standalone batch after the sync segment", async () => {
+        const response = encodeTransactionResponse([
+            web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: 1_000_000 }),
+            web3_js_1.ComputeBudgetProgram.requestHeapFrame({ bytes: 64 * 1024 }),
+            buildLoopscaleInstruction("createStrategy", payer),
+            buildLoopscaleInstruction("depositStrategy", payer),
+            buildNonLoopscaleInstruction(web3_js_1.AddressLookupTableProgram.programId, payer),
+        ], payer);
+        const plan = await (0, loopscale_execution_1.createLoopscaleExecutionPlan)({ connection, response: [response] });
+        (0, globals_1.expect)(plan.batches).toHaveLength(2);
+        const batch = plan.batches[0];
+        (0, globals_1.expect)(batch.kind).toBe("sync");
+        (0, globals_1.expect)(batch.preInstructions).toHaveLength(2);
+        (0, globals_1.expect)(batch.syncInstructions.map((instruction) => instruction.action)).toEqual([
+            "LOOPSCALE_CREATE_STRATEGY",
+            "LOOPSCALE_DEPOSIT_STRATEGY",
+        ]);
+        (0, globals_1.expect)(batch.postInstructions).toHaveLength(0);
+        (0, globals_1.expect)(plan.batches[1].kind).toBe("standalone");
+        if (plan.batches[1].kind === "standalone") {
+            (0, globals_1.expect)(plan.batches[1].instructions).toHaveLength(1);
+            (0, globals_1.expect)(plan.batches[1].instructions[0].programId).toEqual(web3_js_1.AddressLookupTableProgram.programId);
+        }
+    });
+    (0, globals_1.it)("preserves a pure loan transaction as one sync batch with a hoisted compute prefix", async () => {
+        const response = encodeTransactionResponse([
+            web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: 1_000_000 }),
+            buildLoopscaleInstruction("createLoan", payer),
+            buildLoopscaleInstruction("depositCollateral", payer),
+            buildLoopscaleInstruction("updateWeightMatrix", payer),
+            buildLoopscaleInstruction("borrowPrincipal", payer),
+        ], payer);
+        const plan = await (0, loopscale_execution_1.createLoopscaleExecutionPlan)({ connection, response });
+        const batch = plan.batches[0];
+        (0, globals_1.expect)(batch.preInstructions).toHaveLength(1);
+        (0, globals_1.expect)(batch.syncInstructions.map((instruction) => instruction.action)).toEqual([
+            "LOOPSCALE_CREATE_LOAN",
+            "LOOPSCALE_DEPOSIT_COLLATERAL",
+            "LOOPSCALE_UPDATE_WEIGHT_MATRIX",
+            "LOOPSCALE_BORROW_PRINCIPAL",
+        ]);
+        (0, globals_1.expect)(batch.postInstructions).toHaveLength(0);
+    });
+    (0, globals_1.it)("accepts the wrapped transactions response shape used by live borrow flows", async () => {
+        const response = {
+            transactions: [encodeTransactionResponse([
+                    web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: 1_000_000 }),
+                    buildLoopscaleInstruction("borrowPrincipal", payer),
+                ], payer)],
+            expectedLoanInfo: {
+                loan: { address: payer.toBase58() },
+            },
+        };
+        const plan = await (0, loopscale_execution_1.createLoopscaleExecutionPlan)({ connection, response });
+        const batch = plan.batches[0];
+        (0, globals_1.expect)(batch.preInstructions).toHaveLength(1);
+        (0, globals_1.expect)(batch.syncInstructions.map((instruction) => instruction.action)).toEqual([
+            "LOOPSCALE_BORROW_PRINCIPAL",
+        ]);
+    });
+    (0, globals_1.it)("returns a standalone batch when Loopscale instructions are absent", async () => {
+        const response = encodeTransactionResponse([
+            web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: 500_000 }),
+            buildNonLoopscaleInstruction(web3_js_1.SystemProgram.programId, payer),
+        ], payer);
+        const plan = await (0, loopscale_execution_1.createLoopscaleExecutionPlan)({ connection, response });
+        (0, globals_1.expect)(plan.batches).toHaveLength(1);
+        (0, globals_1.expect)(plan.batches[0].kind).toBe("standalone");
+        if (plan.batches[0].kind === "standalone") {
+            (0, globals_1.expect)(plan.batches[0].instructions).toHaveLength(2);
+        }
+    });
+    (0, globals_1.it)("rejects interleaved non-Loopscale instructions inside the sync segment", async () => {
+        const response = encodeTransactionResponse([
+            buildLoopscaleInstruction("createLoan", payer),
+            buildNonLoopscaleInstruction(web3_js_1.SystemProgram.programId, payer),
+            buildLoopscaleInstruction("depositCollateral", payer),
+        ], payer);
+        await (0, globals_1.expect)((0, loopscale_execution_1.createLoopscaleExecutionPlan)({ connection, response })).rejects.toThrow("cannot split non-Loopscale instructions interleaved");
+    });
+    (0, globals_1.it)("accepts raw Loopscale repay and close-loan cleanup instructions", async () => {
+        const response = encodeTransactionResponse([
+            web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: 700_000 }),
+            buildLoopscaleInstruction("repayPrincipal", payer),
+            buildLoopscaleInstruction("closeLoan", payer),
+        ], payer);
+        const plan = await (0, loopscale_execution_1.createLoopscaleExecutionPlan)({ connection, response });
+        const batch = plan.batches[0];
+        (0, globals_1.expect)(batch.preInstructions).toHaveLength(1);
+        (0, globals_1.expect)(batch.syncInstructions.map((instruction) => instruction.action)).toEqual([
+            "LOOPSCALE_REPAY_PRINCIPAL",
+            "LOOPSCALE_CLOSE_LOAN",
+        ]);
+    });
+});
+//# sourceMappingURL=loopscale-execution.test.js.map

package/build/exponentVaults/loopscale-execution.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopscale-execution.test.js","sourceRoot":"","sources":["../../src/exponentVaults/loopscale-execution.test.ts"],"names":[],"mappings":";;AAAA,2CAAoD;AACpD,6CASwB;AAExB,qDAAiF;AACjF,+DAA6F;AAM7F,SAAS,yBAAyB,CAChC,IAA8B,EAC9B,KAAgB;IAEhB,OAAO,IAAI,gCAAsB,CAAC;QAChC,SAAS,EAAE,qCAAoB;QAC/B,IAAI,EAAE;YACJ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;YACnD,EAAE,MAAM,EAAE,IAAI,mBAAS,CAAC,8CAA8C,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;YAC5G,EAAE,MAAM,EAAE,IAAI,mBAAS,CAAC,8CAA8C,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;YAC5G,EAAE,MAAM,EAAE,IAAI,mBAAS,CAAC,8CAA8C,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;SAC7G;QACD,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,yCAAwB,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;KACpF,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,4BAA4B,CAAC,SAAoB,EAAE,KAAgB;IAC1E,OAAO,IAAI,gCAAsB,CAAC;QAChC,SAAS;QACT,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QAC3D,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;KACtB,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,yBAAyB,CAChC,YAAsC,EACtC,KAAK,GAAG,IAAI,mBAAS,CAAC,kCAAkC,CAAC;IAEzD,MAAM,OAAO,GAAG,IAAI,4BAAkB,CAAC;QACrC,QAAQ,EAAE,KAAK;QACf,eAAe,EAAE,kCAAkC;QACnD,YAAY;KACb,CAAC,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAA;IACzB,MAAM,WAAW,GAAG,IAAI,8BAAoB,CAAC,OAAO,CAAC,CAAA;IAErD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACxE,UAAU,EAAE,CAAC;gBACX,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE;gBAC3B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;aAC/C,CAAC;KACH,CAAA;AACH,CAAC;AAED,IAAA,kBAAQ,EAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,MAAM,UAAU,GAAG,IAAI,oBAAU,CAAC,uBAAuB,CAAC,CAAA;IAC1D,MAAM,KAAK,GAAG,IAAI,mBAAS,CAAC,kCAAkC,CAAC,CAAA;IAE/D,IAAA,YAAE,EAAC,yFAAyF,EAAE,KAAK,IAAI,EAAE;QACvG,MAAM,QAAQ,GAAG,yBAAyB,CAAC;YACzC,8BAAoB,CAAC,mBAAmB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YAC9D,8BAAoB,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC;YAC3D,yBAAyB,CAAC,gBAAgB,EAAE,KAAK,CAAC;YAClD,yBAAyB,CAAC,iBAAiB,EAAE,KAAK,CAAC;YACnD,4BAA4B,CAAC,mCAAyB,CAAC,SAAS,EAAE,KAAK,CAAC;SACzE,EAAE,KAAK,CAAC,CAAA;QAET,MAAM,IAAI,GAAG,MAAM,IAAA,kDAA4B,EAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;QACrF,IAAA,gBAAM,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAEpC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAuB,CAAA;QACnD,IAAA,gBAAM,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC/B,IAAA,gBAAM,EAAC,KAAK,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC7C,IAAA,gBAAM,EAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YAC9E,2BAA2B;YAC3B,4BAA4B;SAC7B,CAAC,CAAA;QACF,IAAA,gBAAM,EAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC9C,IAAA,gBAAM,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAChD,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC3C,IAAA,gBAAM,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;YACrD,IAAA,gBAAM,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,YAAY,CAAC,CAAC,CAAE,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,mCAAyB,CAAC,SAAS,CAAC,CAAA;QAClG,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,IAAA,YAAE,EAAC,mFAAmF,EAAE,KAAK,IAAI,EAAE;QACjG,MAAM,QAAQ,GAAG,yBAAyB,CAAC;YACzC,8BAAoB,CAAC,mBAAmB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YAC9D,yBAAyB,CAAC,YAAY,EAAE,KAAK,CAAC;YAC9C,yBAAyB,CAAC,mBAAmB,EAAE,KAAK,CAAC;YACrD,yBAAyB,CAAC,oBAAoB,EAAE,KAAK,CAAC;YACtD,yBAAyB,CAAC,iBAAiB,EAAE,KAAK,CAAC;SACpD,EAAE,KAAK,CAAC,CAAA;QAET,MAAM,IAAI,GAAG,MAAM,IAAA,kDAA4B,EAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAA;QACzE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAuB,CAAA;QAEnD,IAAA,gBAAM,EAAC,KAAK,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC7C,IAAA,gBAAM,EAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YAC9E,uBAAuB;YACvB,8BAA8B;YAC9B,gCAAgC;YAChC,4BAA4B;SAC7B,CAAC,CAAA;QACF,IAAA,gBAAM,EAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;IAEF,IAAA,YAAE,EAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;QACzF,MAAM,QAAQ,GAAG;YACf,YAAY,EAAE,CAAC,yBAAyB,CAAC;oBACvC,8BAAoB,CAAC,mBAAmB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;oBAC9D,yBAAyB,CAAC,iBAAiB,EAAE,KAAK,CAAC;iBACpD,EAAE,KAAK,CAAC,CAAC;YACV,gBAAgB,EAAE;gBAChB,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE;aACpC;SACF,CAAA;QAED,MAAM,IAAI,GAAG,MAAM,IAAA,kDAA4B,EAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAA;QACzE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAuB,CAAA;QAEnD,IAAA,gBAAM,EAAC,KAAK,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC7C,IAAA,gBAAM,EAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YAC9E,4BAA4B;SAC7B,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,IAAA,YAAE,EAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,QAAQ,GAAG,yBAAyB,CAAC;YACzC,8BAAoB,CAAC,mBAAmB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;YAC5D,4BAA4B,CAAC,uBAAa,CAAC,SAAS,EAAE,KAAK,CAAC;SAC7D,EAAE,KAAK,CAAC,CAAA;QAET,MAAM,IAAI,GAAG,MAAM,IAAA,kDAA4B,EAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAA;QAEzE,IAAA,gBAAM,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACpC,IAAA,gBAAM,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAChD,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC3C,IAAA,gBAAM,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACvD,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,IAAA,YAAE,EAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,QAAQ,GAAG,yBAAyB,CAAC;YACzC,yBAAyB,CAAC,YAAY,EAAE,KAAK,CAAC;YAC9C,4BAA4B,CAAC,uBAAa,CAAC,SAAS,EAAE,KAAK,CAAC;YAC5D,yBAAyB,CAAC,mBAAmB,EAAE,KAAK,CAAC;SACtD,EAAE,KAAK,CAAC,CAAA;QAET,MAAM,IAAA,gBAAM,EACV,IAAA,kDAA4B,EAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CACvD,CAAC,OAAO,CAAC,OAAO,CAAC,qDAAqD,CAAC,CAAA;IAC1E,CAAC,CAAC,CAAA;IAEF,IAAA,YAAE,EAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,QAAQ,GAAG,yBAAyB,CAAC;YACzC,8BAAoB,CAAC,mBAAmB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;YAC5D,yBAAyB,CAAC,gBAAgB,EAAE,KAAK,CAAC;YAClD,yBAAyB,CAAC,WAAW,EAAE,KAAK,CAAC;SAC9C,EAAE,KAAK,CAAC,CAAA;QAET,MAAM,IAAI,GAAG,MAAM,IAAA,kDAA4B,EAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAA;QACzE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAuB,CAAA;QAEnD,IAAA,gBAAM,EAAC,KAAK,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC7C,IAAA,gBAAM,EAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YAC9E,2BAA2B;YAC3B,sBAAsB;SACvB,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/build/exponentVaults/loopscale-vault.d.ts

@@ -0,0 +1,115 @@
+import { type AccountMeta, type AddressLookupTableAccount, type Commitment, type SendOptions, type Signer, Connection, PublicKey, TransactionInstruction, VersionedTransaction } from "@solana/web3.js";
+import { type LoopscaleInstruction } from "./vault-interaction";
+import { type LoopscaleTransactionResponse } from "./loopscale-client";
+/**
+ * A wrapped Loopscale batch that can be executed through the Exponent vault.
+ *
+ * `preInstructions` and `postInstructions` are top-level instructions hoisted
+ * from the raw Loopscale transaction. `syncInstructions` are the original
+ * Loopscale program instructions, wrapped minimally for `createVaultSyncTransaction`.
+ */
+export interface LoopscaleVaultSyncBatch {
+    kind: "sync";
+    preInstructions: TransactionInstruction[];
+    syncInstructions: LoopscaleInstruction[];
+    postInstructions: TransactionInstruction[];
+    signers: Signer[];
+    addressLookupTableAddresses: PublicKey[];
+    rawTransaction: VersionedTransaction;
+}
+/**
+ * A raw top-level transaction batch that does not contain any Loopscale
+ * program instructions and therefore must not be wrapped in a Squads sync
+ * transaction.
+ */
+export interface LoopscaleVaultStandaloneBatch {
+    kind: "standalone";
+    instructions: TransactionInstruction[];
+    signers: Signer[];
+    addressLookupTableAddresses: PublicKey[];
+    rawTransaction: VersionedTransaction;
+}
+/**
+ * A single executable batch derived from a raw Loopscale response.
+ */
+export type LoopscaleVaultExecutionBatch = LoopscaleVaultSyncBatch | LoopscaleVaultStandaloneBatch;
+/**
+ * Minimal execution plan derived from a raw Loopscale response.
+ */
+export interface LoopscaleVaultExecutionPlan {
+    /** Executable batches in the same order Loopscale returned them. */
+    batches: LoopscaleVaultExecutionBatch[];
+    /** Deserialized raw transactions returned by Loopscale. */
+    rawTransactions: VersionedTransaction[];
+}
+/**
+ * Execution context for sending a Loopscale vault execution plan.
+ */
+export interface LoopscaleVaultExecutionContext {
+    connection: Connection;
+    owner: PublicKey;
+    vaultPda: PublicKey;
+    signer: PublicKey;
+    signers: Signer[];
+    vaultAddress?: PublicKey;
+    accountIndex?: number;
+    policyPda?: PublicKey;
+    constraintIndices?: number[];
+    leadingAccounts?: PublicKey[] | AccountMeta[];
+    preHookAccounts?: PublicKey[] | AccountMeta[];
+    postHookAccounts?: PublicKey[] | AccountMeta[];
+    squadsProgram?: PublicKey;
+    addressLookupTableAccounts?: AddressLookupTableAccount[];
+    prependInstructions?: TransactionInstruction[];
+    sendOptions?: SendOptions;
+    commitment?: Commitment;
+    /**
+     * Optional co-signing hook used for sync batches.
+     *
+     * When omitted, sync batches are sent without additional Loopscale co-signing.
+     */
+    coSign?: (transaction: VersionedTransaction) => Promise<VersionedTransaction>;
+}
+/**
+ * Result for a single sent transaction while executing a vault plan.
+ */
+export interface BatchExecutionResult {
+    batchIndex: number;
+    kind: "setup" | "sync" | "standalone";
+    signature: string;
+    logs: string[] | null;
+    error: unknown;
+}
+/**
+ * Aggregate result for {@link executeLoopscaleVaultPlan}.
+ */
+export interface ExecutionResult {
+    error: unknown;
+    results: BatchExecutionResult[];
+}
+/**
+ * Convert a raw Loopscale transaction response into a vault-compatible execution plan.
+ *
+ * The adapter preserves transaction boundaries and original instruction order.
+ * It only performs two structural changes:
+ * 1. Compute budget instructions are hoisted out of the sync segment.
+ * 2. A contiguous non-Loopscale prefix/suffix is hoisted to top-level.
+ *
+ * If a non-Loopscale instruction appears between two Loopscale instructions, the
+ * adapter throws instead of guessing how to rewrite the transaction.
+ */
+export declare function createLoopscaleVaultExecutionPlan({ connection, response, }: {
+    connection: Connection;
+    response: LoopscaleTransactionResponse;
+}): Promise<LoopscaleVaultExecutionPlan>;
+/**
+ * Execute a previously created Loopscale vault execution plan.
+ *
+ * Sync batches are wrapped into Squads sync transactions and optionally passed
+ * through `context.coSign`. Standalone batches are sent as regular top-level
+ * transactions without wrapping.
+ */
+export declare function executeLoopscaleVaultPlan({ plan, context, }: {
+    plan: LoopscaleVaultExecutionPlan;
+    context: LoopscaleVaultExecutionContext;
+}): Promise<ExecutionResult>;