@perena/vault-sdk 1.0.24 → 1.0.25

package/dist/index.d.ts

@@ -8957,11 +8957,11 @@ type Bankineco = {
                     "name": "vaultOracle";
                     "docs": [
                         "Required when enabling tranching organically (`for_migration == false`)",
-                        "on a vault that still has main shareholders accruing fixed APY: that APY",
-                        "is only folded into `mint_share_price` while tranching is off, so a fresh",
-                        "NAV must have been settled just before the switch or the accrued APY owed",
-                        "to those shareholders is forfeited. Not needed on the migration path,",
-                        "whose accounting is reconstructed wholesale from the legacy state.",
+                        "on a vault that still has main shareholders accruing fixed APY. A fresh",
+                        "settlement establishes the regular sleeve's booked NAV and physical",
+                        "surplus immediately before the new tranche sleeve is introduced. Not",
+                        "needed on the migration path, whose accounting is reconstructed wholesale",
+                        "from the legacy state.",
                         "",
                         "Kept LAST (a trailing optional account) so legacy clients that predate it",
                         "— e.g. the migration path building against the frozen bankineco IDL —",
@@ -11900,16 +11900,9 @@ type Bankineco = {
                         };
                     },
                     {
-                        "name": "migrationInProgress";
+                        "name": "paddingBool";
                         "docs": [
-                            "True while a legacy migration destination is still receiving backing",
-                            "and receipt-supply accounting. Oracle mutation and NAV settlement stay",
-                            "disabled until every configured receipt mint authority has moved to this vault",
-                            "and migration finalization clears the flag.",
-                            "",
-                            "This occupies the former `apy_settle_skip` padding byte, preserving the",
-                            "on-chain account layout for already-deployed vaults. Existing vaults read",
-                            "it as false."
+                            "Reserved byte retained for on-chain account layout compatibility."
                         ];
                         "type": {
                             "defined": {
@@ -15955,6 +15948,8 @@ interface DecodedHolding {
     mint: unknown;
     decimals: number;
     priceOracleType: unknown;
+    /** Bound Pyth price-update or nested-vault account for live-priced holdings. */
+    priceOracleAccount?: unknown;
     isBase: unknown;
     localAmount?: unknown;
     externalAmount?: unknown;
@@ -16035,6 +16030,12 @@ interface SettlementSimulation {
     grossNav?: bigint;
     settledAccountingNav?: bigint;
     current: SettlementSimulationSnapshot;
+    /**
+     * True when `projected` was calculated by replaying the otherwise-identical
+     * settlement with the max-APY guard disabled. The real crank remains blocked
+     * until the vault config is updated.
+     */
+    projectionRequiresMaxApyDisabled?: boolean;
     projected?: SettlementSimulationSnapshot;
     performanceFees?: {
         curator: bigint;
@@ -16341,6 +16342,12 @@ declare class ConsensusOracleService {
         log?: (msg: string) => void;
     }): Promise<ConsensusOracleTarget[]>;
     private fetchDecodedVault;
+    /**
+     * Keep active permissionless price sources warm so they cannot block the NAV
+     * crank after the consensus report lands. Prices are refreshed at least once
+     * per hour, or at the vault's shorter staleness interval when configured.
+     */
+    private refreshLiveOraclePrices;
     /**
      * Receipt mints issued by this vault are liabilities/shares, not underlying
      * assets for its own NAV. Exclude them even if they were registered as
@@ -16358,12 +16365,13 @@ declare class ConsensusOracleService {
     /** Push the consensus report for all holdings, then settle NAV. */
     private settleVault;
     /**
-     * Fetch the current settled NAV from the oracle account and log the APY
-     * implied by the prospective update, so MaxApyExceeded failures are diagnosable.
+     * Fetch the current settlement timestamp and log the APY implied by the
+     * prospective update, so MaxApyExceeded failures are diagnosable.
      *
      * NAV is expressed in the vault's accounting unit (scaled by assetDecimals).
-     * prospective NAV = Σ ((localAmount_i + externalAmount_i) * price_i)
-     *                   / 10^assetDecimals
+     * Mirrors `gross_nav_from_holdings`: consensus updates overlay their target
+     * slots, while live-priced and otherwise unchanged holdings retain their
+     * current price/external amount.
      */
     private logProspectiveApy;
 }

package/dist/index.js

@@ -1532,7 +1532,8 @@ var PROTOCOL_FEE_RECIPIENT = (0, import_kit.address)(
 var PROGRAM_FEE_EXEMPT_OWNER_WHITELIST = [
   (0, import_kit.address)("Hobbakk1LmW2DhE4nAKnCeU1iK7V7pKHTq3ihaE2i8qG"),
   (0, import_kit.address)("7C39GeKrqLygmgV9D4bicUaiyFhKrX6Eevk6PDACwuj7"),
-  (0, import_kit.address)("LYC8YiiSzQfPpxUW2tpxfuPKGZwywAJhXKUfDP2B66f")
+  (0, import_kit.address)("LYC8YiiSzQfPpxUW2tpxfuPKGZwywAJhXKUfDP2B66f"),
+  (0, import_kit.address)("soBBAHNhFyWF4QBCK9BJLVkX6d6NZt37ozNaPV5aq3H")
 ];
 var VAULT_CREATOR_WHITELIST = [
   (0, import_kit.address)("4jMRBkpWrfhhwFYTwG3o7hmsXQwbJUwdyUX8htB6KwLJ")
@@ -10463,11 +10464,11 @@ var IDL = {
           "name": "vault_oracle",
           "docs": [
             "Required when enabling tranching organically (`for_migration == false`)",
-            "on a vault that still has main shareholders accruing fixed APY: that APY",
-            "is only folded into `mint_share_price` while tranching is off, so a fresh",
-            "NAV must have been settled just before the switch or the accrued APY owed",
-            "to those shareholders is forfeited. Not needed on the migration path,",
-            "whose accounting is reconstructed wholesale from the legacy state.",
+            "on a vault that still has main shareholders accruing fixed APY. A fresh",
+            "settlement establishes the regular sleeve's booked NAV and physical",
+            "surplus immediately before the new tranche sleeve is introduced. Not",
+            "needed on the migration path, whose accounting is reconstructed wholesale",
+            "from the legacy state.",
             "",
             "Kept LAST (a trailing optional account) so legacy clients that predate it",
             "\u2014 e.g. the migration path building against the frozen bankineco IDL \u2014",
@@ -13406,16 +13407,9 @@ var IDL = {
             }
           },
           {
-            "name": "migration_in_progress",
+            "name": "_padding_bool",
             "docs": [
-              "True while a legacy migration destination is still receiving backing",
-              "and receipt-supply accounting. Oracle mutation and NAV settlement stay",
-              "disabled until every configured receipt mint authority has moved to this vault",
-              "and migration finalization clears the flag.",
-              "",
-              "This occupies the former `apy_settle_skip` padding byte, preserving the",
-              "on-chain account layout for already-deployed vaults. Existing vaults read",
-              "it as false."
+              "Reserved byte retained for on-chain account layout compatibility."
             ],
             "type": {
               "defined": {
@@ -19595,6 +19589,7 @@ var MarginfiPositionProvider = class {
 };
 
 // src/services/consensusOracle/liveConsensusOracleDeps.ts
+var YIELD_TRACKER_DECIMALS = 6;
 function createLiveConsensusOracleDeps(connection, opts = {}) {
   const log = opts.log ?? (() => {
   });
@@ -19605,7 +19600,10 @@ function createLiveConsensusOracleDeps(connection, opts = {}) {
       log
     }),
     yieldTracker: {
-      getTotalOutstandingYield,
+      async getTotalOutstandingYield(accountNames, start, end) {
+        const raw = await getTotalOutstandingYield(accountNames, start, end);
+        return raw / 10 ** YIELD_TRACKER_DECIMALS;
+      },
       getYieldPayments
     }
   };
@@ -19744,6 +19742,7 @@ function simulateConsensusOracleSettlement(args) {
       hwmSharePrice: bigint(vaultAccounting.hwmSharePrice),
       fixedApyBps: number(apyConfig.fixedApyBps),
       maxApyBps: number(apyConfig.maxApyBps),
+      accruedApyBalance: bigint(apyConfig.accruedApyBalance),
       apyAnchorSharePrice: bigint(apyConfig.anchorSharePrice),
       apyAnchorTs: bigint(apyConfig.anchorTs),
       tranche: currentTranche
@@ -19763,7 +19762,52 @@ function simulateConsensusOracleSettlement(args) {
       performanceFees: settlement.performanceFees
     };
   } catch (error) {
-    blockers.push(message(error));
+    const blocker = message(error);
+    blockers.push(blocker);
+    if (blocker.includes("MaxApyExceeded")) {
+      try {
+        const settlement = settleVault({
+          grossNav,
+          nowTs: args.nowTs,
+          currentTvl,
+          currentSharePrice: bigint(vaultAccounting.mintSharePrice),
+          totalSupply: reconciledSupply,
+          lossesEnabled: bool(args.vault.lossesEnabled),
+          accountingLastUpdateTs: bigint(vaultAccounting.lastUpdateTs),
+          priorSettledNavTs: oracle.settledNavTs,
+          performanceFeeBps: number(feesConfig.performanceFeeBps),
+          protocolFeeBps: number(feesConfig.protocolFeeBps),
+          hwmSharePrice: bigint(vaultAccounting.hwmSharePrice),
+          fixedApyBps: number(apyConfig.fixedApyBps),
+          maxApyBps: 0,
+          accruedApyBalance: bigint(apyConfig.accruedApyBalance),
+          apyAnchorSharePrice: bigint(apyConfig.anchorSharePrice),
+          apyAnchorTs: bigint(apyConfig.anchorTs),
+          tranche: currentTranche
+        });
+        return {
+          nowTs: args.nowTs,
+          assetDecimals: args.vault.config.assetDecimals,
+          ...consensusSummary,
+          canSettle: false,
+          blockers,
+          warnings,
+          consensus,
+          grossNav,
+          settledAccountingNav: settlement.settledAccountingNav,
+          current,
+          projectionRequiresMaxApyDisabled: true,
+          projected: settlement.projected,
+          performanceFees: settlement.performanceFees
+        };
+      } catch (projectionError) {
+        warnings.push(
+          `could not calculate the uncapped projection: ${message(
+            projectionError
+          )}`
+        );
+      }
+    }
     return {
       nowTs: args.nowTs,
       assetDecimals: args.vault.config.assetDecimals,
@@ -19835,16 +19879,18 @@ function applyConsensus(holdings, entries, nowTs, stalenessThresholdSecs) {
   return results;
 }
 function settleVault(args) {
-  if (args.grossNav < args.currentTvl && !args.lossesEnabled) {
+  const regularSurplusBefore = args.tranche ? max(args.accruedApyBalance, 0n) : 0n;
+  const physicalNavBefore = args.currentTvl + regularSurplusBefore;
+  if (args.grossNav < physicalNavBefore && !args.lossesEnabled) {
     throw new Error(
-      `crank would fail LossesDisabled: gross NAV ${args.grossNav} < current TVL ${args.currentTvl}`
+      `crank would fail LossesDisabled: gross NAV ${args.grossNav} < physical NAV ${physicalNavBefore}`
     );
   }
   const priorTs = args.priorSettledNavTs > 0n ? args.priorSettledNavTs : max(args.accountingLastUpdateTs, args.apyAnchorTs);
   const nextApyValue = args.tranche ? args.grossNav : sharePriceForValue(args.grossNav, args.totalSupply);
   if (nextApyValue !== void 0) {
     validateRealizedApy(
-      args.tranche ? args.currentTvl : args.currentSharePrice,
+      args.tranche ? physicalNavBefore : args.currentSharePrice,
       priorTs,
       nextApyValue,
       args.nowTs,
@@ -19857,13 +19903,22 @@ function settleVault(args) {
   let protocolFee = 0n;
   let settledAccountingNav;
   if (args.tranche) {
-    settledAccountingNav = args.grossNav;
-    regularValue = settleTrancheNav(
+    const regularGrossValue = settleTrancheNav(
       args.tranche,
-      args.currentTvl,
-      settledAccountingNav,
+      physicalNavBefore,
+      args.grossNav,
       args.nowTs
     );
+    regularValue = settleFixedApyNav({
+      currentSharePrice: args.currentSharePrice,
+      reportedNav: regularGrossValue,
+      nowTs: args.nowTs,
+      totalSupply: args.totalSupply,
+      fixedApyBps: args.fixedApyBps,
+      anchorSharePrice: args.apyAnchorSharePrice,
+      anchorTs: args.apyAnchorTs
+    });
+    settledAccountingNav = regularValue + args.tranche.junior.value + args.tranche.senior.value;
     const juniorFees = settleShareClassPerformanceFee(
       args.tranche.junior,
       args.performanceFeeBps,
@@ -20031,7 +20086,8 @@ function settleRegularPerformanceFee(grossValue, supply, hwmSharePrice, performa
   };
 }
 function settleFixedApyNav(args) {
-  if (args.fixedApyBps === 0 || args.currentSharePrice === 0n || args.totalSupply === 0n || args.anchorSharePrice === 0n || args.anchorTs <= 0n) {
+  if (args.totalSupply === 0n) return 0n;
+  if (args.fixedApyBps === 0 || args.currentSharePrice === 0n || args.anchorSharePrice === 0n || args.anchorTs <= 0n) {
     return args.reportedNav;
   }
   if (args.nowTs <= args.anchorTs) {
@@ -20408,6 +20464,9 @@ function formatSettlementSimulation(simulation) {
     );
   }
   if (simulation.projected) {
+    if (simulation.projectionRequiresMaxApyDisabled) {
+      lines.push("    projection with max APY disabled (max_apy_bps=0):");
+    }
     lines.push(
       `    TVL:       ${formatTransition(
         simulation.current.tvl,
@@ -20478,8 +20537,23 @@ function formatUnits(value, decimals) {
 
 // src/services/consensusOracle/consensusOracleService.ts
 var SYSTEM_PROGRAM2 = "11111111111111111111111111111111";
+var PRICE_ORACLE_TYPES_BY_INDEX2 = [
+  "none",
+  "consensusOracle",
+  "pyth",
+  "perenaVault"
+];
 var CONSENSUS_ORACLE_VARIANT = "consensusoracle";
+var LIVE_ORACLE_VARIANTS = /* @__PURE__ */ new Set(["pyth", "perenavault"]);
+var LIVE_PRICE_REFRESH_INTERVAL_SECS = 60n * 60n;
+var DEFAULT_PRICE_STALENESS_THRESHOLD_SECS3 = 24n * 60n * 60n;
 function variantName2(value) {
+  if (typeof value === "number") {
+    return PRICE_ORACLE_TYPES_BY_INDEX2[value] ?? String(value);
+  }
+  if (typeof value === "bigint") {
+    return PRICE_ORACLE_TYPES_BY_INDEX2[Number(value)] ?? String(value);
+  }
   if (value && typeof value === "object") return Object.keys(value)[0] ?? "";
   return String(value ?? "");
 }
@@ -20489,6 +20563,13 @@ function coerceBool3(value) {
   const record2 = value;
   return Boolean(record2?.value ?? record2?.[0]);
 }
+function toBigInt2(value) {
+  if (typeof value === "bigint") return value;
+  if (typeof value === "number") return BigInt(Math.trunc(value));
+  if (typeof value === "string" && value.length > 0) return BigInt(value);
+  if (value !== null && value !== void 0) return BigInt(String(value));
+  return 0n;
+}
 function priceInAccountingUnit(usd, baseUsd, assetDecimals) {
   return BigInt(Math.round(usd / baseUsd * 10 ** assetDecimals));
 }
@@ -20533,7 +20614,17 @@ var ConsensusOracleService = class {
     const log = opts.log ?? (() => {
     });
     const dryRun = opts.dryRun ?? false;
-    const vaultState = await this.fetchDecodedVault(target.vault);
+    let vaultState = await this.fetchDecodedVault(target.vault);
+    const refreshedLivePrices = await this.refreshLiveOraclePrices(
+      signer,
+      target.vault,
+      vaultState,
+      log,
+      dryRun
+    );
+    if (refreshedLivePrices) {
+      vaultState = await this.fetchDecodedVault(target.vault);
+    }
     const receiptMints = await this.fetchReceiptMints(target.vault, vaultState);
     const consensusHoldings = selectConsensusHoldings(
       vaultState.holdings,
@@ -20755,6 +20846,64 @@ var ConsensusOracleService = class {
       fresh: true
     });
   }
+  /**
+   * Keep active permissionless price sources warm so they cannot block the NAV
+   * crank after the consensus report lands. Prices are refreshed at least once
+   * per hour, or at the vault's shorter staleness interval when configured.
+   */
+  async refreshLiveOraclePrices(signer, vault, vaultState, log, dryRun) {
+    const nowSecs = BigInt(Math.floor(this.clock.now() / 1e3));
+    const configuredStaleness = toBigInt2(
+      vaultState.config.priceStalenessThresholdSecs
+    );
+    const stalenessThreshold = configuredStaleness > 0n ? configuredStaleness : DEFAULT_PRICE_STALENESS_THRESHOLD_SECS3;
+    const refreshInterval = stalenessThreshold < LIVE_PRICE_REFRESH_INTERVAL_SECS ? stalenessThreshold : LIVE_PRICE_REFRESH_INTERVAL_SECS;
+    const targets = [];
+    for (const holding of vaultState.holdings) {
+      const oracleType = variantName2(holding.priceOracleType).toLowerCase();
+      if (!LIVE_ORACLE_VARIANTS.has(oracleType)) continue;
+      const mint = (0, import_common41.fromWeb3Pk)(holding.mint);
+      if (mint.toString() === SYSTEM_PROGRAM2) continue;
+      const activeAmount = toBigInt2(holding.localAmount) + toBigInt2(holding.externalAmount);
+      if (activeAmount === 0n) continue;
+      const lastUpdateTs = toBigInt2(holding.lastUpdateTs);
+      const ageSecs = nowSecs - lastUpdateTs;
+      if (lastUpdateTs > 0n && ageSecs >= 0n && ageSecs < refreshInterval) {
+        continue;
+      }
+      if (!holding.priceOracleAccount) {
+        log(
+          `vault ${vault}: cannot refresh ${mint}; ${oracleType} holding has no oracle account`
+        );
+        continue;
+      }
+      const oracleAccount = (0, import_common41.fromWeb3Pk)(holding.priceOracleAccount);
+      if (oracleAccount.toString() === SYSTEM_PROGRAM2) {
+        log(
+          `vault ${vault}: cannot refresh ${mint}; ${oracleType} holding has no oracle account`
+        );
+        continue;
+      }
+      targets.push({ mint, oracleAccount });
+    }
+    if (targets.length === 0) return false;
+    if (dryRun) {
+      log(
+        `vault ${vault}: dry run, would refresh ${targets.length} live asset price(s)`
+      );
+      return false;
+    }
+    log(
+      `vault ${vault}: refreshing ${targets.length} live asset price(s) due for hourly refresh`
+    );
+    const results = await this.oracle.refreshAssetPrices(
+      signer,
+      vault,
+      targets,
+      log
+    );
+    return results.some((result) => Boolean(result.signature));
+  }
   /**
    * Receipt mints issued by this vault are liabilities/shares, not underlying
    * assets for its own NAV. Exclude them even if they were registered as
@@ -20922,12 +21071,13 @@ var ConsensusOracleService = class {
     };
   }
   /**
-   * Fetch the current settled NAV from the oracle account and log the APY
-   * implied by the prospective update, so MaxApyExceeded failures are diagnosable.
+   * Fetch the current settlement timestamp and log the APY implied by the
+   * prospective update, so MaxApyExceeded failures are diagnosable.
    *
    * NAV is expressed in the vault's accounting unit (scaled by assetDecimals).
-   * prospective NAV = Σ ((localAmount_i + externalAmount_i) * price_i)
-   *                   / 10^assetDecimals
+   * Mirrors `gross_nav_from_holdings`: consensus updates overlay their target
+   * slots, while live-priced and otherwise unchanged holdings retain their
+   * current price/external amount.
    */
   async logProspectiveApy(vault, updates, vaultState, log) {
     try {
@@ -20936,22 +21086,38 @@ var ConsensusOracleService = class {
       });
       const data = oracle.data;
       if (!data || data.length < 16) return;
-      const settledNav = readI64LE(data, 0);
       const settledNavTs = readI64LE(data, 8);
-      if (settledNav <= 0n || settledNavTs <= 0n) return;
-      const scale = BigInt(10 ** vaultState.config.assetDecimals);
-      const prospectiveNav = updates.reduce((sum, u) => {
-        const holding = vaultState.holdings[u.holdingIndex];
-        const localAmount = BigInt(holding?.localAmount?.toString() ?? "0");
-        return sum + (localAmount + u.externalAmount) * u.price / scale;
-      }, 0n);
+      if (settledNavTs <= 0n) return;
+      const updatesByIndex = new Map(
+        updates.map((update) => [update.holdingIndex, update])
+      );
+      const prospectiveNav = vaultState.holdings.reduce(
+        (sum, holding, holdingIndex) => {
+          const mint = (0, import_common41.fromWeb3Pk)(holding.mint).toString();
+          if (mint === SYSTEM_PROGRAM2) return sum;
+          const update = updatesByIndex.get(holdingIndex);
+          const localAmount = toBigInt2(holding.localAmount);
+          const externalAmount = update ? update.externalAmount : toBigInt2(holding.externalAmount);
+          const amount = localAmount + externalAmount;
+          if (amount === 0n) return sum;
+          const price = update ? update.price : toBigInt2(holding.price);
+          if (price <= 0n) return sum;
+          const scale = 10n ** BigInt(holding.decimals);
+          return sum + amount * price / scale;
+        },
+        0n
+      );
+      const currentTvl = toBigInt2(vaultState.accounting?.tvl);
+      const accruedApyBalance = coerceBool3(vaultState.tranchingEnabled) ? toBigInt2(vaultState.config.apy?.accruedApyBalance) : 0n;
+      const physicalNavBefore = currentTvl + (accruedApyBalance > 0n ? accruedApyBalance : 0n);
+      if (physicalNavBefore <= 0n) return;
       const nowSecs = BigInt(Math.floor(this.clock.now() / 1e3));
       const elapsedSecs = nowSecs - settledNavTs;
       if (elapsedSecs <= 0n) return;
       const SECONDS_PER_YEAR3 = 365n * 24n * 3600n;
-      const apyBps = (prospectiveNav - settledNav) * SECONDS_PER_YEAR3 * 10000n / (settledNav * elapsedSecs);
+      const apyBps = (prospectiveNav - physicalNavBefore) * SECONDS_PER_YEAR3 * 10000n / (physicalNavBefore * elapsedSecs);
       log(
-        `vault ${vault}: prospective NAV ${prospectiveNav} vs settled ${settledNav} (elapsed ${elapsedSecs}s) \u2192 implied APY ${apyBps}bps`
+        `vault ${vault}: prospective NAV ${prospectiveNav} vs physical baseline ${physicalNavBefore} (elapsed ${elapsedSecs}s) \u2192 implied APY ${apyBps}bps`
       );
     } catch {
     }
@@ -21210,7 +21376,7 @@ function parseActiveSlots(externalLiquidity) {
   }
   return results;
 }
-function toBigInt2(value) {
+function toBigInt3(value) {
   if (typeof value === "bigint") return value;
   if (value !== null && value !== void 0) return BigInt(String(value));
   return 0n;
@@ -21290,7 +21456,7 @@ var ExternalLiquidityIntegrityService = class {
       }
       const holdings = vaultState.holdings.filter((h) => {
         const mint = pubkeyStr(h.mint);
-        return !isZeroPubkey2(mint) && toBigInt2(h.localAmount) > 0n;
+        return !isZeroPubkey2(mint) && toBigInt3(h.localAmount) > 0n;
       });
       if (holdings.length === 0) {
         log(`Vault ${vault} slot ${slot.index}: no local balance to deploy`);
@@ -21299,7 +21465,7 @@ var ExternalLiquidityIntegrityService = class {
       }
       for (const holding of holdings) {
         const mintAddress = (0, import_kit15.address)(pubkeyStr(holding.mint));
-        const localAmount = toBigInt2(holding.localAmount);
+        const localAmount = toBigInt3(holding.localAmount);
         const marginfiAccounts = (0, import_marginfi2.marginfiAccountsForMint)(mintAddress);
         if (!marginfiAccounts) {
           log(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@perena/vault-sdk",
-  "version": "1.0.24",
+  "version": "1.0.25",
   "description": "Vault program helpers for Bankineco integrations.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -38,6 +38,7 @@
     "create-vault": "tsx scripts/createVault.ts",
     "init-vault-atas": "tsx scripts/initVaultAtas.ts",
     "inspect": "tsx scripts/inspect.ts",
+    "vault-data": "tsx scripts/fetchVaultData.ts",
     "simulate-withdraw": "tsx scripts/simulate-withdraw.ts",
     "simulate-message": "tsx scripts/simulate-message.ts",
     "run-external-liquidity-service": "tsx scripts/runExternalLiquidityService.ts"
@@ -56,6 +57,7 @@
   },
   "devDependencies": {
     "common": "file:../common",
+    "jupiter": "file:../jupiter",
     "marginfi": "file:../marginfi",
     "@types/node": "^24.3.1",
     "prettier": "^2.6.2",