@exponent-labs/exponent-sdk 0.1.7 → 0.9.0

package/build/exponentVaults/squadsVaultTxnResolver/resolvers/loopscale.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveLoopscaleProtocolInteraction = void 0;
+const policyBuilders_1 = require("../../policyBuilders");
+const types_1 = require("../types");
+const helpers_1 = require("./helpers");
+const LOOPSCALE_INTERACTION_TYPES = new Set([
+    // Loan actions
+    types_1.INTERACTION_TYPES.CREATE_LOAN,
+    types_1.INTERACTION_TYPES.DEPOSIT_COLLATERAL,
+    types_1.INTERACTION_TYPES.BORROW_PRINCIPAL,
+    types_1.INTERACTION_TYPES.REPAY_PRINCIPAL,
+    types_1.INTERACTION_TYPES.WITHDRAW_COLLATERAL,
+    types_1.INTERACTION_TYPES.CLOSE_LOAN,
+    types_1.INTERACTION_TYPES.UPDATE_WEIGHT_MATRIX,
+    types_1.INTERACTION_TYPES.LOCK_LOAN,
+    types_1.INTERACTION_TYPES.UNLOCK_LOAN,
+    types_1.INTERACTION_TYPES.REFINANCE_LEDGER,
+    // Strategy actions
+    types_1.INTERACTION_TYPES.CREATE_STRATEGY,
+    types_1.INTERACTION_TYPES.DEPOSIT_STRATEGY,
+    types_1.INTERACTION_TYPES.WITHDRAW_STRATEGY,
+    types_1.INTERACTION_TYPES.CLOSE_STRATEGY,
+    types_1.INTERACTION_TYPES.UPDATE_STRATEGY,
+]);
+function resolveLoopscaleProtocolInteraction(interaction, params) {
+    if (!LOOPSCALE_INTERACTION_TYPES.has(interaction.type)) {
+        console.warn(`Invalid interaction type. Expected Loopscale interaction, got: ${interaction.type}. Txn: ${interaction.txnSignature}`);
+        return null;
+    }
+    const { accounts, balanceChanges, type } = interaction;
+    const allBalanceChanges = interaction?.balanceChanges || [];
+    const ownerScopedBalanceChanges = params?.squadsVaultAddress
+        ? balanceChanges.filter((bc) => bc.owner === params.squadsVaultAddress)
+        : balanceChanges;
+    if (type === types_1.INTERACTION_TYPES.DEPOSIT_COLLATERAL) {
+        const tokenMint = accounts[policyBuilders_1.LOOPSCALE_ACCOUNT_INDICES.depositCollateralMint] ?? null;
+        const tokenChange = tokenMint
+            ? (ownerScopedBalanceChanges.find((bc) => bc.mint === tokenMint && BigInt(bc.change) < 0n) ?? null)
+            : null;
+        return (0, helpers_1.convertToDefiInteraction)(interaction, tokenMint, tokenChange);
+    }
+    if (type === types_1.INTERACTION_TYPES.BORROW_PRINCIPAL) {
+        const tokenMint = accounts[policyBuilders_1.LOOPSCALE_ACCOUNT_INDICES.borrowPrincipalMint] ?? null;
+        const tokenChange = allBalanceChanges.find((bc) => bc.mint === tokenMint && BigInt(bc.change) < 0n) ?? null;
+        return (0, helpers_1.convertToDefiInteraction)(interaction, tokenMint, tokenChange);
+    }
+    if (type === types_1.INTERACTION_TYPES.REPAY_PRINCIPAL) {
+        const tokenMint = accounts[policyBuilders_1.LOOPSCALE_ACCOUNT_INDICES.repayPrincipalMint];
+        const tokenChange = allBalanceChanges.find((bc) => bc.mint === tokenMint && BigInt(bc.change) > 0n) ?? null;
+        return (0, helpers_1.convertToDefiInteraction)(interaction, tokenMint, tokenChange);
+    }
+    if (type === types_1.INTERACTION_TYPES.WITHDRAW_COLLATERAL) {
+        const tokenMint = accounts[policyBuilders_1.LOOPSCALE_ACCOUNT_INDICES.withdrawCollateralMint];
+        const tokenChange = allBalanceChanges.find((bc) => bc.mint === tokenMint && BigInt(bc.change) > 0n) ?? null;
+        return (0, helpers_1.convertToDefiInteraction)(interaction, tokenMint, tokenChange);
+    }
+    if (type === types_1.INTERACTION_TYPES.DEPOSIT_STRATEGY) {
+        const tokenMint = accounts[policyBuilders_1.LOOPSCALE_ACCOUNT_INDICES.depositStrategyMint];
+        const tokenChange = allBalanceChanges.find((bc) => bc.mint === tokenMint && BigInt(bc.change) > 0n) ?? null;
+        return (0, helpers_1.convertToDefiInteraction)(interaction, tokenMint, tokenChange);
+    }
+    if (type === types_1.INTERACTION_TYPES.WITHDRAW_STRATEGY) {
+        const tokenMint = accounts[policyBuilders_1.LOOPSCALE_ACCOUNT_INDICES.withdrawStrategyMint];
+        const tokenChange = allBalanceChanges.find((bc) => bc.mint === tokenMint && BigInt(bc.change) < 0n) ?? null;
+        return (0, helpers_1.convertToDefiInteraction)(interaction, tokenMint, tokenChange);
+    }
+    // Admin/setup actions: createLoan, closeLoan, createStrategy, closeStrategy,
+    // updateWeightMatrix, lockLoan, unlockLoan, updateStrategy, refinanceLedger
+    return (0, helpers_1.convertToDefiInteraction)(interaction, null, null);
+}
+exports.resolveLoopscaleProtocolInteraction = resolveLoopscaleProtocolInteraction;
+//# sourceMappingURL=loopscale.js.map

package/build/exponentVaults/squadsVaultTxnResolver/resolvers/loopscale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopscale.js","sourceRoot":"","sources":["../../../../src/exponentVaults/squadsVaultTxnResolver/resolvers/loopscale.ts"],"names":[],"mappings":";;;AAAA,yDAAgE;AAChE,oCAMiB;AACjB,uCAAoD;AAEpD,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAkB;IAC3D,eAAe;IACf,yBAAiB,CAAC,WAAW;IAC7B,yBAAiB,CAAC,kBAAkB;IACpC,yBAAiB,CAAC,gBAAgB;IAClC,yBAAiB,CAAC,eAAe;IACjC,yBAAiB,CAAC,mBAAmB;IACrC,yBAAiB,CAAC,UAAU;IAC5B,yBAAiB,CAAC,oBAAoB;IACtC,yBAAiB,CAAC,SAAS;IAC3B,yBAAiB,CAAC,WAAW;IAC7B,yBAAiB,CAAC,gBAAgB;IAClC,mBAAmB;IACnB,yBAAiB,CAAC,eAAe;IACjC,yBAAiB,CAAC,gBAAgB;IAClC,yBAAiB,CAAC,iBAAiB;IACnC,yBAAiB,CAAC,cAAc;IAChC,yBAAiB,CAAC,eAAe;CAClC,CAAC,CAAA;AAEF,SAAgB,mCAAmC,CACjD,WAAgC,EAChC,MAAiC;IAEjC,IAAI,CAAC,2BAA2B,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,OAAO,CAAC,IAAI,CACV,kEAAkE,WAAW,CAAC,IAAI,UAAU,WAAW,CAAC,YAAY,EAAE,CACvH,CAAA;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,WAAW,CAAA;IAEtD,MAAM,iBAAiB,GAAG,WAAW,EAAE,cAAc,IAAI,EAAE,CAAA;IAE3D,MAAM,yBAAyB,GAAG,MAAM,EAAE,kBAAkB;QAC1D,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC,kBAAkB,CAAC;QACvE,CAAC,CAAC,cAAc,CAAA;IAElB,IAAI,IAAI,KAAK,yBAAiB,CAAC,kBAAkB,EAAE,CAAC;QAClD,MAAM,SAAS,GAAG,QAAQ,CAAC,0CAAyB,CAAC,qBAAqB,CAAC,IAAI,IAAI,CAAA;QACnF,MAAM,WAAW,GAAG,SAAS;YAC3B,CAAC,CAAC,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC;YACnG,CAAC,CAAC,IAAI,CAAA;QACR,OAAO,IAAA,kCAAwB,EAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAA;IACtE,CAAC;IAED,IAAI,IAAI,KAAK,yBAAiB,CAAC,gBAAgB,EAAE,CAAC;QAChD,MAAM,SAAS,GAAG,QAAQ,CAAC,0CAAyB,CAAC,mBAAmB,CAAC,IAAI,IAAI,CAAA;QACjF,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAA;QAE3G,OAAO,IAAA,kCAAwB,EAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAA;IACtE,CAAC;IAED,IAAI,IAAI,KAAK,yBAAiB,CAAC,eAAe,EAAE,CAAC;QAC/C,MAAM,SAAS,GAAG,QAAQ,CAAC,0CAAyB,CAAC,kBAAkB,CAAC,CAAA;QACxE,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAA;QAE3G,OAAO,IAAA,kCAAwB,EAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAA;IACtE,CAAC;IAED,IAAI,IAAI,KAAK,yBAAiB,CAAC,mBAAmB,EAAE,CAAC;QACnD,MAAM,SAAS,GAAG,QAAQ,CAAC,0CAAyB,CAAC,sBAAsB,CAAC,CAAA;QAC5E,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAA;QAC3G,OAAO,IAAA,kCAAwB,EAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAA;IACtE,CAAC;IAED,IAAI,IAAI,KAAK,yBAAiB,CAAC,gBAAgB,EAAE,CAAC;QAChD,MAAM,SAAS,GAAG,QAAQ,CAAC,0CAAyB,CAAC,mBAAmB,CAAC,CAAA;QACzE,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAA;QAE3G,OAAO,IAAA,kCAAwB,EAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAA;IACtE,CAAC;IAED,IAAI,IAAI,KAAK,yBAAiB,CAAC,iBAAiB,EAAE,CAAC;QACjD,MAAM,SAAS,GAAG,QAAQ,CAAC,0CAAyB,CAAC,oBAAoB,CAAC,CAAA;QAC1E,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAA;QAC3G,OAAO,IAAA,kCAAwB,EAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAA;IACtE,CAAC;IAED,6EAA6E;IAC7E,4EAA4E;IAC5E,OAAO,IAAA,kCAAwB,EAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AAC1D,CAAC;AA/DD,kFA+DC"}

package/build/exponentVaults/squadsVaultTxnResolver/resolvers/titan.d.ts

@@ -0,0 +1,2 @@
+import { DefiInteraction, ProtocolInteraction, ResolveInteractionParams } from "../types";
+export declare function resolveTitanProtocolInteraction(interaction: ProtocolInteraction, params?: ResolveInteractionParams): DefiInteraction;

package/build/exponentVaults/squadsVaultTxnResolver/resolvers/titan.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTitanProtocolInteraction = void 0;
+const policyBuilders_1 = require("../../policyBuilders");
+const constants_1 = require("../constants");
+const types_1 = require("../types");
+function resolveTitanProtocolInteraction(interaction, params) {
+    if (interaction.type !== types_1.INTERACTION_TYPES.SWAP_ROUTE_V2)
+        throw new Error(`Invalid interaction type. Expected: ${interaction.type}`);
+    const { /*ixDataBase58,*/ balanceChanges, accounts, protocolName, protocolProgram, txnSignature, timestamp } = interaction;
+    // const dataBytes = bs58.decode(ixDataBase58)
+    // const inputMint = accounts[TITAN_ACCOUNT_INDICES.inputMint] ?? null
+    const outputMint = accounts[policyBuilders_1.TITAN_ACCOUNT_INDICES.outputMint] ?? null;
+    // let inputAmount: string | null = null
+    // if (dataBytes.length >= 16) {
+    //   inputAmount = Buffer.from(dataBytes.subarray(8, 16)).readBigUInt64LE(0).toString()
+    // }
+    const outputChange = outputMint && params?.squadsVaultAddress
+        ? balanceChanges.find((b) => b.owner === params.squadsVaultAddress && b.mint === outputMint)
+        : null;
+    return {
+        protocolName,
+        protocolProgram,
+        typeHuman: constants_1.ACTION_DISPLAY_NAMES[interaction.type],
+        type: interaction.type,
+        token: {
+            mint: outputMint,
+            amount: outputChange?.change?.toString() || null,
+        },
+        txnSignature,
+        timestamp,
+    };
+}
+exports.resolveTitanProtocolInteraction = resolveTitanProtocolInteraction;
+//# sourceMappingURL=titan.js.map

package/build/exponentVaults/squadsVaultTxnResolver/resolvers/titan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"titan.js","sourceRoot":"","sources":["../../../../src/exponentVaults/squadsVaultTxnResolver/resolvers/titan.ts"],"names":[],"mappings":";;;AAAA,yDAA4D;AAC5D,4CAAmD;AACnD,oCAA4G;AAE5G,SAAgB,+BAA+B,CAC7C,WAAgC,EAChC,MAAiC;IAEjC,IAAI,WAAW,CAAC,IAAI,KAAK,yBAAiB,CAAC,aAAa;QACtD,MAAM,IAAI,KAAK,CAAC,uCAAuC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAA;IAE5E,MAAM,EAAE,iBAAiB,CAAC,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,SAAS,EAAE,GAC1G,WAAW,CAAA;IAEb,8CAA8C;IAE9C,sEAAsE;IACtE,MAAM,UAAU,GAAG,QAAQ,CAAC,sCAAqB,CAAC,UAAU,CAAC,IAAI,IAAI,CAAA;IAErE,wCAAwC;IACxC,gCAAgC;IAChC,uFAAuF;IACvF,IAAI;IAEJ,MAAM,YAAY,GAAG,UAAU,IAAI,MAAM,EAAE,kBAAkB;QAC3D,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,kBAAkB,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC;QAC5F,CAAC,CAAC,IAAI,CAAA;IAER,OAAO;QACL,YAAY;QACZ,eAAe;QACf,SAAS,EAAE,gCAAoB,CAAC,WAAW,CAAC,IAAI,CAAC;QACjD,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,KAAK,EAAE;YACL,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,IAAI;SACjD;QACD,YAAY;QACZ,SAAS;KACV,CAAA;AACH,CAAC;AApCD,0EAoCC"}

package/build/exponentVaults/squadsVaultTxnResolver/squadsVaultTxnResolver.d.ts

@@ -0,0 +1,21 @@
+import type { VersionedTransactionResponse } from "@solana/web3.js";
+import type { DecompiledInstructionWithInner, DefiInteraction, ProtocolInteraction, ResolveInteractionParams, TokenBalanceChange } from "./types";
+type DecompiledParams = {
+    instructions: DecompiledInstructionWithInner[];
+    balanceChanges: TokenBalanceChange[];
+    txnSignature: string;
+    timestamp: number;
+};
+export declare class SquadsVaultTxnResolver {
+    getProtocolInteractions(tx: VersionedTransactionResponse): ProtocolInteraction[];
+    getProtocolInteractions(params: DecompiledParams): ProtocolInteraction[];
+    resolveInteraction(interaction: ProtocolInteraction, params?: ResolveInteractionParams): DefiInteraction | null;
+    /**
+     * When a single Squads vault transaction contains multiple protocol interactions
+     * (e.g. Loopscale createStrategy + deposit, or Exponent depositYt + postOffer),
+     * the caller currently gets all of them back. This batch method automatically
+     * keeps only the "top-level" interaction per transaction when one exists.
+     */
+    resolveInteractions(interactions: ProtocolInteraction[], params?: ResolveInteractionParams): DefiInteraction[];
+}
+export {};

package/build/exponentVaults/squadsVaultTxnResolver/squadsVaultTxnResolver.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SquadsVaultTxnResolver = void 0;
+const helpers_1 = require("./helpers");
+const resolvers_1 = require("./resolvers");
+class SquadsVaultTxnResolver {
+    getProtocolInteractions(txOrParams) {
+        let topLevelInstructions;
+        let balanceChanges;
+        let txnSignature;
+        let timestamp;
+        if ("instructions" in txOrParams) {
+            topLevelInstructions = txOrParams.instructions;
+            balanceChanges = txOrParams.balanceChanges;
+            txnSignature = txOrParams.txnSignature;
+            timestamp = txOrParams.timestamp;
+        }
+        else {
+            topLevelInstructions = (0, helpers_1.ejectDecompiledIxnsFromVersionedTx)(txOrParams);
+            const accountKeys = (0, helpers_1.getMessageAccountKeysFromVersionedTxn)(txOrParams);
+            balanceChanges = (0, helpers_1.getTxnTokensBalancesChanges)(txOrParams, accountKeys);
+            txnSignature = txOrParams.transaction.signatures[0] ?? "";
+            timestamp = txOrParams.blockTime ?? 0;
+        }
+        const allInstructions = topLevelInstructions.flatMap((ix) => [ix, ...(ix.innerInstructions ?? [])]);
+        const interactions = [];
+        for (const instruction of allInstructions) {
+            const resolved = (0, helpers_1.resolveInteractionType)(instruction.programId, instruction.data);
+            if (!resolved)
+                continue;
+            interactions.push({
+                type: resolved.type,
+                protocolName: resolved.protocolName,
+                protocolProgram: instruction.programId,
+                ixDataBase58: instruction.data,
+                accounts: instruction.accounts,
+                balanceChanges,
+                txnSignature,
+                timestamp,
+            });
+        }
+        return interactions;
+    }
+    resolveInteraction(interaction, params) {
+        const resolver = resolvers_1.RESOLVER_BY_PROGRAM_ID.get(interaction.protocolProgram);
+        if (!resolver)
+            return null;
+        return resolver(interaction, params);
+    }
+    /**
+     * When a single Squads vault transaction contains multiple protocol interactions
+     * (e.g. Loopscale createStrategy + deposit, or Exponent depositYt + postOffer),
+     * the caller currently gets all of them back. This batch method automatically
+     * keeps only the "top-level" interaction per transaction when one exists.
+     */
+    resolveInteractions(interactions, params) {
+        const resolved = interactions
+            .map((i) => this.resolveInteraction(i, params))
+            .filter((r) => r !== null);
+        return (0, helpers_1.filterInteractionsWithTopLevel)(resolved);
+    }
+}
+exports.SquadsVaultTxnResolver = SquadsVaultTxnResolver;
+//# sourceMappingURL=squadsVaultTxnResolver.js.map

package/build/exponentVaults/squadsVaultTxnResolver/squadsVaultTxnResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"squadsVaultTxnResolver.js","sourceRoot":"","sources":["../../../src/exponentVaults/squadsVaultTxnResolver/squadsVaultTxnResolver.ts"],"names":[],"mappings":";;;AAEA,uCAMkB;AAClB,2CAAoD;AAgBpD,MAAa,sBAAsB;IAGjC,uBAAuB,CAAC,UAA2D;QACjF,IAAI,oBAAsD,CAAA;QAC1D,IAAI,cAAoC,CAAA;QACxC,IAAI,YAAoB,CAAA;QACxB,IAAI,SAAiB,CAAA;QAErB,IAAI,cAAc,IAAI,UAAU,EAAE,CAAC;YACjC,oBAAoB,GAAG,UAAU,CAAC,YAAY,CAAA;YAC9C,cAAc,GAAG,UAAU,CAAC,cAAc,CAAA;YAC1C,YAAY,GAAG,UAAU,CAAC,YAAY,CAAA;YACtC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAA;QAClC,CAAC;aAAM,CAAC;YACN,oBAAoB,GAAG,IAAA,4CAAkC,EAAC,UAAU,CAAC,CAAA;YACrE,MAAM,WAAW,GAAG,IAAA,+CAAqC,EAAC,UAAU,CAAC,CAAA;YACrE,cAAc,GAAG,IAAA,qCAA2B,EAAC,UAAU,EAAE,WAAW,CAAC,CAAA;YACrE,YAAY,GAAG,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;YACzD,SAAS,GAAG,UAAU,CAAC,SAAS,IAAI,CAAC,CAAA;QACvC,CAAC;QAED,MAAM,eAAe,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QAEnG,MAAM,YAAY,GAA0B,EAAE,CAAA;QAE9C,KAAK,MAAM,WAAW,IAAI,eAAe,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,IAAA,gCAAsB,EAAC,WAAW,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAA;YAChF,IAAI,CAAC,QAAQ;gBAAE,SAAQ;YAEvB,YAAY,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,YAAY,EAAE,QAAQ,CAAC,YAAY;gBACnC,eAAe,EAAE,WAAW,CAAC,SAAS;gBACtC,YAAY,EAAE,WAAW,CAAC,IAAI;gBAC9B,QAAQ,EAAE,WAAW,CAAC,QAAQ;gBAC9B,cAAc;gBACd,YAAY;gBACZ,SAAS;aACV,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,YAAY,CAAA;IACrB,CAAC;IAED,kBAAkB,CAAC,WAAgC,EAAE,MAAiC;QACpF,MAAM,QAAQ,GAAG,kCAAsB,CAAC,GAAG,CAAC,WAAW,CAAC,eAAe,CAAC,CAAA;QACxE,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAA;QAE1B,OAAO,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;IACtC,CAAC;IAED;;;;;OAKG;IACH,mBAAmB,CAAC,YAAmC,EAAE,MAAiC;QACxF,MAAM,QAAQ,GAAG,YAAY;aAC1B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;aAC9C,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAA;QAElD,OAAO,IAAA,wCAA8B,EAAC,QAAQ,CAAC,CAAA;IACjD,CAAC;CACF;AAjED,wDAiEC"}

package/build/exponentVaults/squadsVaultTxnResolver/types.d.ts

@@ -0,0 +1,111 @@
+export type TokenBalanceChange = {
+    account: string;
+    owner: string;
+    mint: string;
+    change: string;
+};
+export type DecompiledInstruction = {
+    programId: string;
+    accounts: string[];
+    data: string;
+};
+export type DecompiledInstructionWithInner = DecompiledInstruction & {
+    innerInstructions?: DecompiledInstruction[];
+};
+export declare const INTERACTION_TYPES: {
+    readonly SWAP_EXACT_SY_FOR_PT: "swap_exact_sy_for_pt";
+    readonly SWAP_EXACT_PT_FOR_SY: "swap_exact_pt_for_sy";
+    readonly SWAP_EXACT_SY_FOR_YT: "swap_exact_sy_for_yt";
+    readonly SWAP_EXACT_YT_FOR_SY: "swap_exact_yt_for_sy";
+    readonly WRAPPER_POST_OFFER: "wrapper_post_offer";
+    readonly RAW_POST_OFFER: "raw_post_offer";
+    readonly RAW_MARKET_OFFER: "raw_market_offer";
+    readonly WRAPPER_REMOVE_OFFER: "wrapper_remove_offer";
+    readonly WRAPPER_WITHDRAW_FUNDS: "wrapper_withdraw_funds";
+    readonly INITIALIZE_YIELD_POSITION: "initialize_yield_position";
+    readonly WRAPPER_STRIP: "wrapper_strip";
+    readonly WRAPPER_MERGE: "wrapper_merge";
+    readonly COLLECT_INTEREST: "collect_interest";
+    readonly WRAPPER_COLLECT_INTEREST: "wrapper_collect_interest";
+    readonly DEPOSIT_YT: "deposit_yt";
+    readonly WITHDRAW_YT: "withdraw_yt";
+    readonly MINT_SY: "mint_sy";
+    readonly REDEEM_SY: "redeem_sy";
+    readonly DEPOSIT_LIQUIDITY: "deposit_liquidity";
+    readonly ADD_LIQUIDITY: "add_liquidity";
+    readonly WITHDRAW_LIQUIDITY: "withdraw_liquidity";
+    readonly TRADE_PT: "trade_pt";
+    readonly TRADE_PT_EXACT_OUT: "trade_pt_exact_out";
+    readonly BUY_YT: "buy_yt";
+    readonly SELL_YT: "sell_yt";
+    readonly CLAIM_FARM_EMISSION: "claim_farm_emission";
+    readonly LENDING_ACCOUNT_DEPOSIT: "lending_account_deposit";
+    readonly LENDING_ACCOUNT_WITHDRAW: "lending_account_withdraw";
+    readonly LENDING_ACCOUNT_BORROW: "lending_account_borrow";
+    readonly LENDING_ACCOUNT_REPAY: "lending_account_repay";
+    readonly INIT_USER_METADATA: "init_user_metadata";
+    readonly DEPOSIT_RESERVE_LIQUIDITY: "deposit_reserve_liquidity";
+    readonly INIT_OBLIGATION: "init_obligation";
+    readonly INIT_OBLIGATION_FARMS_FOR_RESERVE: "init_obligation_farms_for_reserve";
+    readonly REFRESH_RESERVE: "refresh_reserve";
+    readonly REFRESH_OBLIGATION: "refresh_obligation";
+    readonly SWAP_ROUTE_V2: "swap_route_v2";
+    readonly CREATE_LOAN: "create_loan";
+    readonly DEPOSIT_COLLATERAL: "deposit_collateral";
+    readonly BORROW_PRINCIPAL: "borrow_principal";
+    readonly REPAY_PRINCIPAL: "repay_principal";
+    readonly WITHDRAW_COLLATERAL: "withdraw_collateral";
+    readonly CLOSE_LOAN: "close_loan";
+    readonly CREATE_STRATEGY: "create_strategy";
+    readonly DEPOSIT_STRATEGY: "deposit_strategy";
+    readonly WITHDRAW_STRATEGY: "withdraw_strategy";
+    readonly CLOSE_STRATEGY: "close_strategy";
+    readonly UPDATE_WEIGHT_MATRIX: "update_weight_matrix";
+    readonly LOCK_LOAN: "lock_loan";
+    readonly UNLOCK_LOAN: "unlock_loan";
+    readonly UPDATE_STRATEGY: "update_strategy";
+    readonly REFINANCE_LEDGER: "refinance_ledger";
+};
+export type InteractionType = (typeof INTERACTION_TYPES)[keyof typeof INTERACTION_TYPES];
+export declare const TOP_LEVEL_INTERACTIONS: InteractionType[];
+export declare const PROTOCOLS: {
+    readonly EXPONENT: "Exponent";
+    readonly KAMINO: "Kamino";
+    readonly TITAN: "Titan";
+    readonly LOOPSCALE: "Loopscale";
+};
+export type ProtocolInteraction = {
+    type: InteractionType;
+    protocolName: string;
+    protocolProgram: string;
+    ixDataBase58: string;
+    accounts: string[];
+    balanceChanges: TokenBalanceChange[];
+    txnSignature: string;
+    timestamp: number;
+};
+export type DefiInteractionToken = {
+    mint: string;
+    amount: string;
+};
+export type ExponentVaultTokens = {
+    ptMint: string;
+    ytMint: string;
+    syMint: string;
+    underlyingMint: string;
+};
+export type ExponentTokensMap = Map<string, ExponentVaultTokens>;
+export type ResolveInteractionParams = {
+    squadsVaultAddress?: string;
+    exponentTokensMap?: ExponentTokensMap;
+};
+export type DefiInteraction = {
+    typeHuman: string;
+    type: InteractionType;
+    protocolName: string;
+    protocolProgram: string;
+    token: DefiInteractionToken | null;
+    txnSignature: string;
+    timestamp: number;
+};
+export type ProtocolResolver = (interaction: ProtocolInteraction, params?: ResolveInteractionParams) => DefiInteraction | null;

package/build/exponentVaults/squadsVaultTxnResolver/types.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROTOCOLS = exports.TOP_LEVEL_INTERACTIONS = exports.INTERACTION_TYPES = void 0;
+// ---------------------------------------------------------------------------
+// Constants for type-safe equality checks at upper level
+// ---------------------------------------------------------------------------
+exports.INTERACTION_TYPES = {
+    // Exponent Orderbook
+    SWAP_EXACT_SY_FOR_PT: "swap_exact_sy_for_pt",
+    SWAP_EXACT_PT_FOR_SY: "swap_exact_pt_for_sy",
+    SWAP_EXACT_SY_FOR_YT: "swap_exact_sy_for_yt",
+    SWAP_EXACT_YT_FOR_SY: "swap_exact_yt_for_sy",
+    WRAPPER_POST_OFFER: "wrapper_post_offer",
+    RAW_POST_OFFER: "raw_post_offer",
+    RAW_MARKET_OFFER: "raw_market_offer",
+    WRAPPER_REMOVE_OFFER: "wrapper_remove_offer",
+    WRAPPER_WITHDRAW_FUNDS: "wrapper_withdraw_funds",
+    // Exponent Core
+    INITIALIZE_YIELD_POSITION: "initialize_yield_position",
+    WRAPPER_STRIP: "wrapper_strip",
+    WRAPPER_MERGE: "wrapper_merge",
+    COLLECT_INTEREST: "collect_interest",
+    WRAPPER_COLLECT_INTEREST: "wrapper_collect_interest",
+    DEPOSIT_YT: "deposit_yt",
+    WITHDRAW_YT: "withdraw_yt",
+    // Exponent Standard
+    MINT_SY: "mint_sy",
+    REDEEM_SY: "redeem_sy",
+    // CLMM
+    DEPOSIT_LIQUIDITY: "deposit_liquidity",
+    ADD_LIQUIDITY: "add_liquidity",
+    WITHDRAW_LIQUIDITY: "withdraw_liquidity",
+    TRADE_PT: "trade_pt",
+    TRADE_PT_EXACT_OUT: "trade_pt_exact_out",
+    BUY_YT: "buy_yt",
+    SELL_YT: "sell_yt",
+    CLAIM_FARM_EMISSION: "claim_farm_emission",
+    // Kamino
+    LENDING_ACCOUNT_DEPOSIT: "lending_account_deposit",
+    LENDING_ACCOUNT_WITHDRAW: "lending_account_withdraw",
+    LENDING_ACCOUNT_BORROW: "lending_account_borrow",
+    LENDING_ACCOUNT_REPAY: "lending_account_repay",
+    INIT_USER_METADATA: "init_user_metadata",
+    DEPOSIT_RESERVE_LIQUIDITY: "deposit_reserve_liquidity",
+    INIT_OBLIGATION: "init_obligation",
+    INIT_OBLIGATION_FARMS_FOR_RESERVE: "init_obligation_farms_for_reserve",
+    REFRESH_RESERVE: "refresh_reserve",
+    REFRESH_OBLIGATION: "refresh_obligation",
+    // Titan
+    SWAP_ROUTE_V2: "swap_route_v2",
+    // Loopscale
+    CREATE_LOAN: "create_loan",
+    DEPOSIT_COLLATERAL: "deposit_collateral",
+    BORROW_PRINCIPAL: "borrow_principal",
+    REPAY_PRINCIPAL: "repay_principal",
+    WITHDRAW_COLLATERAL: "withdraw_collateral",
+    CLOSE_LOAN: "close_loan",
+    CREATE_STRATEGY: "create_strategy",
+    DEPOSIT_STRATEGY: "deposit_strategy",
+    WITHDRAW_STRATEGY: "withdraw_strategy",
+    CLOSE_STRATEGY: "close_strategy",
+    UPDATE_WEIGHT_MATRIX: "update_weight_matrix",
+    LOCK_LOAN: "lock_loan",
+    UNLOCK_LOAN: "unlock_loan",
+    UPDATE_STRATEGY: "update_strategy",
+    REFINANCE_LEDGER: "refinance_ledger",
+};
+exports.TOP_LEVEL_INTERACTIONS = [
+    // Exponent Orderbook
+    exports.INTERACTION_TYPES.WRAPPER_POST_OFFER,
+    exports.INTERACTION_TYPES.WRAPPER_REMOVE_OFFER,
+    exports.INTERACTION_TYPES.RAW_POST_OFFER,
+    exports.INTERACTION_TYPES.RAW_MARKET_OFFER,
+    exports.INTERACTION_TYPES.WRAPPER_WITHDRAW_FUNDS,
+    // CLMM
+    exports.INTERACTION_TYPES.TRADE_PT,
+    exports.INTERACTION_TYPES.TRADE_PT_EXACT_OUT,
+    // Kamino
+    exports.INTERACTION_TYPES.LENDING_ACCOUNT_BORROW,
+    exports.INTERACTION_TYPES.LENDING_ACCOUNT_DEPOSIT,
+    // Loopscale
+    exports.INTERACTION_TYPES.CREATE_STRATEGY,
+    exports.INTERACTION_TYPES.DEPOSIT_COLLATERAL,
+    exports.INTERACTION_TYPES.WITHDRAW_COLLATERAL,
+];
+exports.PROTOCOLS = {
+    EXPONENT: "Exponent",
+    KAMINO: "Kamino",
+    TITAN: "Titan",
+    LOOPSCALE: "Loopscale",
+};
+//# sourceMappingURL=types.js.map

package/build/exponentVaults/squadsVaultTxnResolver/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/exponentVaults/squadsVaultTxnResolver/types.ts"],"names":[],"mappings":";;;AAiBA,8EAA8E;AAC9E,yDAAyD;AACzD,8EAA8E;AAEjE,QAAA,iBAAiB,GAAG;IAC/B,qBAAqB;IACrB,oBAAoB,EAAE,sBAAsB;IAC5C,oBAAoB,EAAE,sBAAsB;IAC5C,oBAAoB,EAAE,sBAAsB;IAC5C,oBAAoB,EAAE,sBAAsB;IAC5C,kBAAkB,EAAE,oBAAoB;IACxC,cAAc,EAAE,gBAAgB;IAChC,gBAAgB,EAAE,kBAAkB;IACpC,oBAAoB,EAAE,sBAAsB;IAC5C,sBAAsB,EAAE,wBAAwB;IAChD,gBAAgB;IAChB,yBAAyB,EAAE,2BAA2B;IACtD,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,gBAAgB,EAAE,kBAAkB;IACpC,wBAAwB,EAAE,0BAA0B;IACpD,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,oBAAoB;IACpB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,OAAO;IACP,iBAAiB,EAAE,mBAAmB;IACtC,aAAa,EAAE,eAAe;IAC9B,kBAAkB,EAAE,oBAAoB;IACxC,QAAQ,EAAE,UAAU;IACpB,kBAAkB,EAAE,oBAAoB;IACxC,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,mBAAmB,EAAE,qBAAqB;IAC1C,SAAS;IACT,uBAAuB,EAAE,yBAAyB;IAClD,wBAAwB,EAAE,0BAA0B;IACpD,sBAAsB,EAAE,wBAAwB;IAChD,qBAAqB,EAAE,uBAAuB;IAC9C,kBAAkB,EAAE,oBAAoB;IACxC,yBAAyB,EAAE,2BAA2B;IACtD,eAAe,EAAE,iBAAiB;IAClC,iCAAiC,EAAE,mCAAmC;IACtE,eAAe,EAAE,iBAAiB;IAClC,kBAAkB,EAAE,oBAAoB;IACxC,QAAQ;IACR,aAAa,EAAE,eAAe;IAC9B,YAAY;IACZ,WAAW,EAAE,aAAa;IAC1B,kBAAkB,EAAE,oBAAoB;IACxC,gBAAgB,EAAE,kBAAkB;IACpC,eAAe,EAAE,iBAAiB;IAClC,mBAAmB,EAAE,qBAAqB;IAC1C,UAAU,EAAE,YAAY;IACxB,eAAe,EAAE,iBAAiB;IAClC,gBAAgB,EAAE,kBAAkB;IACpC,iBAAiB,EAAE,mBAAmB;IACtC,cAAc,EAAE,gBAAgB;IAChC,oBAAoB,EAAE,sBAAsB;IAC5C,SAAS,EAAE,WAAW;IACtB,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,iBAAiB;IAClC,gBAAgB,EAAE,kBAAkB;CAC5B,CAAA;AAIG,QAAA,sBAAsB,GAAsB;IACvD,qBAAqB;IACrB,yBAAiB,CAAC,kBAAkB;IACpC,yBAAiB,CAAC,oBAAoB;IACtC,yBAAiB,CAAC,cAAc;IAChC,yBAAiB,CAAC,gBAAgB;IAClC,yBAAiB,CAAC,sBAAsB;IACxC,OAAO;IACP,yBAAiB,CAAC,QAAQ;IAC1B,yBAAiB,CAAC,kBAAkB;IACpC,SAAS;IACT,yBAAiB,CAAC,sBAAsB;IACxC,yBAAiB,CAAC,uBAAuB;IACzC,YAAY;IACZ,yBAAiB,CAAC,eAAe;IACjC,yBAAiB,CAAC,kBAAkB;IACpC,yBAAiB,CAAC,mBAAmB;CACtC,CAAA;AAEY,QAAA,SAAS,GAAG;IACvB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,WAAW;CACd,CAAA"}

package/build/exponentVaults/squadsVaultTxnResolver/utils.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="node" />
+/// <reference types="node" />
+export declare function toHex(data: Uint8Array | Buffer): string;

package/build/exponentVaults/squadsVaultTxnResolver/utils.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toHex = void 0;
+function toHex(data) {
+    return Buffer.from(data).toString("hex");
+}
+exports.toHex = toHex;
+//# sourceMappingURL=utils.js.map

package/build/exponentVaults/squadsVaultTxnResolver/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/exponentVaults/squadsVaultTxnResolver/utils.ts"],"names":[],"mappings":";;;AAAA,SAAgB,KAAK,CAAC,IAAyB;IAC7C,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC1C,CAAC;AAFD,sBAEC"}

package/build/exponentVaults/syncTransaction.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 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
+ */
+import { AccountMeta, PublicKey, TransactionInstruction } from "@solana/web3.js";
+/** Squads Smart Account Program ID (mainnet) */
+export declare const SQUADS_PROGRAM_ID: PublicKey;
+/**
+ * Result of compiling instructions for sync_transaction
+ */
+export interface SyncTransactionPayload {
+    /** Serialized instructions (SmallVec<u8, CompiledInstruction>) */
+    instructions: Uint8Array;
+    /** Account metas for remaining_accounts (signers, optional leading/hook accounts, then instruction accounts) */
+    accounts: AccountMeta[];
+}
+/**
+ * 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)
+ */
+export declare function compileToSyncTransactionPayload({ vaultPda, signers, instructions, leadingAccounts, preHookAccounts, postHookAccounts, }: {
+    vaultPda: PublicKey;
+    signers: PublicKey[];
+    instructions: TransactionInstruction[];
+    /** Accounts required before hook parsing (e.g. policy expiration settings account). */
+    leadingAccounts?: PublicKey[] | AccountMeta[];
+    /** Accounts required by the policy's pre_hook (in order: program_id, then extra accounts) */
+    preHookAccounts?: PublicKey[] | AccountMeta[];
+    /** Accounts required by the policy's post_hook (in order: program_id, then extra accounts). Use AccountMeta[] to set isWritable (e.g. vault for validate_interaction_hook). */
+    postHookAccounts?: PublicKey[] | AccountMeta[];
+}): SyncTransactionPayload;
+/**
+ * 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(...))
+ */
+export declare function buildSyncTransactionInstruction({ policyPda, accountIndex, numSigners, payload, constraintIndices, squadsProgram, }: {
+    policyPda: PublicKey;
+    accountIndex: number;
+    numSigners: number;
+    payload: SyncTransactionPayload;
+    /** Optional constraint indices mapping each instruction to a constraint in the policy */
+    constraintIndices?: number[];
+    squadsProgram?: PublicKey;
+}): TransactionInstruction;
+/**
+ * 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.
+ */
+export declare function wrapInstructionsInSyncTransaction({ policyPda, vaultPda, signer, instructions, accountIndex, constraintIndices, leadingAccounts, preHookAccounts, postHookAccounts, squadsProgram, }: {
+    policyPda: PublicKey;
+    vaultPda: PublicKey;
+    signer: PublicKey;
+    instructions: TransactionInstruction[];
+    accountIndex?: number;
+    constraintIndices?: number[];
+    leadingAccounts?: PublicKey[] | AccountMeta[];
+    /** Accounts required by the policy's pre_hook (in order: program_id, then extra accounts) */
+    preHookAccounts?: PublicKey[] | AccountMeta[];
+    /** Accounts required by the policy's post_hook (in order: program_id, then extra accounts). Use AccountMeta[] to set isWritable. */
+    postHookAccounts?: PublicKey[] | AccountMeta[];
+    squadsProgram?: PublicKey;
+}): TransactionInstruction;