@perena/vault-sdk 1.0.28 → 1.0.29

package/dist/index.d.ts

@@ -10929,6 +10929,106 @@ type Bankineco = {
                 ];
             };
         },
+        {
+            "name": "rollingRebalanceLimit";
+            "docs": [
+                "Rolling-window cap on rebalance (Jupiter swap) throughput, expressed as a",
+                "share of current TVL rather than a fixed amount.",
+                "",
+                "Sibling of [`super::withdrawal_limits::RollingWithdrawalLimit`]: same",
+                "window-slide-then-charge mechanics, but the ceiling is recomputed from live",
+                "TVL on every call, so the cap tracks the vault as it grows or shrinks",
+                "instead of going stale at whatever amount the curator last set.",
+                "",
+                "Both swap directions charge the same window — the cap bounds total value",
+                "routed through Jupiter per window, regardless of which asset is sold."
+            ];
+            "serialization": "bytemuck";
+            "repr": {
+                "kind": "c";
+            };
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "windowStartTs";
+                        "docs": [
+                            "Unix timestamp the current window opened."
+                        ];
+                        "type": "i64";
+                    },
+                    {
+                        "name": "windowDurationSeconds";
+                        "docs": [
+                            "Window length, in seconds (e.g. 3_600 for an hourly limit)."
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "valueInWindow";
+                        "docs": [
+                            "Value rebalanced inside the current window, in the vault's accounting",
+                            "unit."
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "windowLimitBps";
+                        "docs": [
+                            "Cap as a share of TVL, in bps. `0` disables the limit."
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "padding1";
+                        "type": {
+                            "array": [
+                                "u8",
+                                6
+                            ];
+                        };
+                    },
+                    {
+                        "name": "padding2";
+                        "type": {
+                            "array": [
+                                "u64",
+                                4
+                            ];
+                        };
+                    }
+                ];
+            };
+        },
+        {
+            "name": "rollingRebalanceLimitConfig";
+            "docs": [
+                "Rolling rebalance-limit config applied via [`SetVaultConfigArgs`].",
+                "",
+                "The cap is a share of TVL rather than a fixed amount, so it stays",
+                "meaningful as the vault grows. Both fields must be zero (disable the cap)",
+                "or both non-zero (enable it)."
+            ];
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "windowLimitBps";
+                        "docs": [
+                            "Max share of TVL rebalanced inside one window, in bps (`0` disables)."
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "windowDurationSeconds";
+                        "docs": [
+                            "Window length in seconds (`0` only valid when `window_limit_bps` is `0`)."
+                        ];
+                        "type": "u64";
+                    }
+                ];
+            };
+        },
         {
             "name": "setAssetPriceOracleArgs";
             "type": {
@@ -11114,6 +11214,20 @@ type Bankineco = {
                                 };
                             };
                         };
+                    },
+                    {
+                        "name": "rebalanceLimit";
+                        "docs": [
+                            "Rolling cap on rebalance (Jupiter swap) throughput. `None` leaves",
+                            "unchanged."
+                        ];
+                        "type": {
+                            "option": {
+                                "defined": {
+                                    "name": "rollingRebalanceLimitConfig";
+                                };
+                            };
+                        };
                     }
                 ];
             };
@@ -12035,6 +12149,14 @@ type Bankineco = {
                         "name": "seniorFixedApyBps";
                         "type": "u16";
                     },
+                    {
+                        "name": "juniorFloorApyBps";
+                        "docs": [
+                            "Floor APY for the junior tranche, in basis points. Zero disables the",
+                            "floor. Shortfalls are funded from the untranched sleeve, never senior."
+                        ];
+                        "type": "u16";
+                    },
                     {
                         "name": "earlyUnstakeFeeBps";
                         "type": "u16";
@@ -12860,12 +12982,38 @@ type Bankineco = {
                         ];
                         "type": "u64";
                     },
+                    {
+                        "name": "juniorFloorApyBps";
+                        "docs": [
+                            "Curator-set floor APY for the junior tranche, in basis points. Zero",
+                            "disables the floor.",
+                            "",
+                            "When junior's realized growth falls short of this floor, the shortfall is",
+                            "topped up from the *untranched* (regular) sleeve's value, never from the",
+                            "senior tranche -- senior's fixed-APY entitlement is settled first and is",
+                            "untouched by the floor. The top-up is best-effort: it is capped by the",
+                            "untranched sleeve's available value, and any unpaid remainder stays",
+                            "outstanding against the durable junior anchor",
+                            "(`VaultTrancheState::junior_apy_anchor_share_price`) so it can be paid on",
+                            "a later settlement."
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "padding1";
+                        "type": {
+                            "array": [
+                                "u8",
+                                6
+                            ];
+                        };
+                    },
                     {
                         "name": "padding2";
                         "type": {
                             "array": [
                                 "u64",
-                                13
+                                12
                             ];
                         };
                     }
@@ -12943,12 +13091,28 @@ type Bankineco = {
                         ];
                         "type": "i64";
                     },
+                    {
+                        "name": "juniorApyAnchorSharePrice";
+                        "docs": [
+                            "Junior share price at the start of the current floor-APY regime. The",
+                            "anchor is durable across settlements so an unpaid floor shortfall stays",
+                            "outstanding and can be caught up later."
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "juniorApyAnchorTs";
+                        "docs": [
+                            "Unix timestamp when the junior floor-APY anchor was set."
+                        ];
+                        "type": "i64";
+                    },
                     {
                         "name": "padding2";
                         "type": {
                             "array": [
                                 "u64",
-                                29
+                                27
                             ];
                         };
                     }
@@ -12966,6 +13130,17 @@ type Bankineco = {
                             "option": "u16";
                         };
                     },
+                    {
+                        "name": "juniorFloorApyBps";
+                        "docs": [
+                            "Floor APY for the junior tranche, in basis points. Zero disables the",
+                            "floor. Setting this starts a fresh regime: any shortfall accrued under",
+                            "the previous value is forfeited."
+                        ];
+                        "type": {
+                            "option": "u16";
+                        };
+                    },
                     {
                         "name": "earlyUnstakeFeeBps";
                         "type": {
@@ -13248,12 +13423,25 @@ type Bankineco = {
                         ];
                         "type": "u64";
                     },
+                    {
+                        "name": "rebalanceLimit";
+                        "docs": [
+                            "Rolling cap on rebalance (Jupiter swap) throughput per window, as a",
+                            "share of TVL. Carved out of `_padding1`, so the account layout and size",
+                            "are unchanged and existing vaults decode it as disabled."
+                        ];
+                        "type": {
+                            "defined": {
+                                "name": "rollingRebalanceLimit";
+                            };
+                        };
+                    },
                     {
                         "name": "padding1";
                         "type": {
                             "array": [
                                 "u64",
-                                30
+                                22
                             ];
                         };
                     },
@@ -14074,6 +14262,11 @@ interface CreateTrancheStateIxArgs {
      */
     vaultOracle?: Address;
     seniorFixedApyBps: number;
+    /**
+     * Junior floor APY in basis points. Zero disables the floor. Shortfalls are
+     * funded from the untranched sleeve, never from the senior tranche.
+     */
+    juniorFloorApyBps: number;
     earlyUnstakeFeeBps: number;
     standardUnstakeFeeBps: number;
     targetLockupDurationSecs: BN;
@@ -14088,6 +14281,8 @@ interface CreateTrancheStateTxArgs {
     seniorShareMint: Address;
     vaultOracle?: Address;
     seniorFixedApyBps?: number;
+    /** Junior floor APY in basis points. Zero disables the floor. */
+    juniorFloorApyBps?: number;
     earlyUnstakeFeeBps?: number;
     standardUnstakeFeeBps?: number;
     targetLockupDurationSecs?: number;
@@ -14102,6 +14297,12 @@ interface UpdateTrancheConfigIxArgs {
     vaultTrancheState: Address;
     vaultOracle: Address;
     seniorFixedApyBps: number | null;
+    /**
+     * Junior floor APY in basis points, or null to leave it unchanged. Setting it
+     * starts a fresh regime: any shortfall accrued under the previous value is
+     * forfeited.
+     */
+    juniorFloorApyBps: number | null;
     earlyUnstakeFeeBps: number | null;
     standardUnstakeFeeBps: number | null;
     targetLockupDurationSecs: BN | null;
@@ -14113,6 +14314,8 @@ interface UpdateTrancheConfigTxArgs {
     vaultTrancheState?: Address;
     vaultOracle?: Address;
     seniorFixedApyBps?: number;
+    /** Junior floor APY in basis points. Zero disables the floor. */
+    juniorFloorApyBps?: number;
     earlyUnstakeFeeBps?: number;
     standardUnstakeFeeBps?: number;
     targetLockupDurationSecs?: number;
@@ -14138,6 +14341,15 @@ interface RollingLimitConfig {
     windowLimit: bigint;
     windowDurationSeconds: bigint;
 }
+/**
+ * Rolling rebalance cap. Unlike {@link RollingLimitConfig} the ceiling is a
+ * share of TVL, recomputed on every swap, so it does not go stale as the vault
+ * grows.
+ */
+interface RollingRebalanceLimitConfig {
+    windowLimitBps: number;
+    windowDurationSeconds: bigint;
+}
 interface SetVaultConfigIxArgs {
     curator: Address;
     vault: Address;
@@ -14165,6 +14377,10 @@ interface SetVaultConfigIxArgs {
             windowLimit: BN;
             windowDurationSeconds: BN;
         } | null;
+        rebalanceLimit: {
+            windowLimitBps: number;
+            windowDurationSeconds: BN;
+        } | null;
     };
 }
 interface SetVaultConfigTxArgs {
@@ -14190,6 +14406,11 @@ interface SetVaultConfigTxArgs {
     userBurnLimit?: RollingLimitConfig;
     /** Rolling cap on manager liquidity pulls. Omit to leave unchanged. */
     managerPullLimit?: RollingLimitConfig;
+    /**
+     * Rolling cap on rebalance (Jupiter swap) throughput, as a share of TVL.
+     * Omit to leave unchanged.
+     */
+    rebalanceLimit?: RollingRebalanceLimitConfig;
 }
 interface SetProtocolFeeIxArgs {
     /** The hardcoded protocol wallet, the only authority allowed to set this. */
@@ -15576,7 +15797,7 @@ interface FulfillSummary {
     failed: number;
     signatures: string[];
 }
-type LogFn$2 = (msg: string) => void;
+type LogFn$3 = (msg: string) => void;
 declare class WithdrawalQueueService {
     private readonly client;
     constructor(client: VaultClient);
@@ -15604,7 +15825,7 @@ declare class WithdrawalQueueService {
      */
     fulfillAllDue(signer: Keypair, opts?: {
         vault?: Address;
-        log?: LogFn$2;
+        log?: LogFn$3;
     }): Promise<FulfillSummary>;
     private toSnapshot;
 }
@@ -15626,7 +15847,7 @@ declare class WithdrawalQueueService {
  * this service only submits the resulting values on-chain.
  */
 
-type LogFn$1 = (msg: string) => void;
+type LogFn$2 = (msg: string) => void;
 type NavCrankBlockerReason = "unpriced" | "stale";
 interface NavCrankBlocker {
     holdingIndex: number;
@@ -15679,12 +15900,12 @@ declare class OracleService {
         }[];
         assetMint?: Address;
         assetTokenProgram?: Address;
-    }, log?: LogFn$1): Promise<string>;
+    }, log?: LogFn$2): Promise<string>;
     /** Settle the vault NAV from its current holdings (permissionless). */
     crankNav(cranker: Keypair, args: {
         vault: Address;
         vaultTrancheState?: Address;
-    }, log?: LogFn$1): Promise<string>;
+    }, log?: LogFn$2): Promise<string>;
     /**
      * Check the same active-holding price preconditions that `crank_nav` enforces
      * before spending a transaction on the permissionless settlement.
@@ -15694,19 +15915,19 @@ declare class OracleService {
     crankNavIfReady(cranker: Keypair, args: {
         vault: Address;
         vaultTrancheState?: Address;
-    }, log?: LogFn$1): Promise<NavCrankResult>;
+    }, log?: LogFn$2): Promise<NavCrankResult>;
     /** Re-price one live-oracle holding from its bound Pyth/nested-vault account. */
     refreshAssetPrice(updater: Keypair, args: {
         vault: Address;
         mint: Address;
         oracleAccount: Address;
         maxAgeSecs?: bigint;
-    }, log?: LogFn$1): Promise<string>;
+    }, log?: LogFn$2): Promise<string>;
     /**
      * Refresh several holdings in sequence. Non-fatal: one failure is recorded
      * and the rest still run. Returns a per-mint result list.
      */
-    refreshAssetPrices(updater: Keypair, vault: Address, targets: AssetPriceRefreshTarget[], log?: LogFn$1): Promise<AssetRefreshResult[]>;
+    refreshAssetPrices(updater: Keypair, vault: Address, targets: AssetPriceRefreshTarget[], log?: LogFn$2): Promise<AssetRefreshResult[]>;
 }
 
 /**
@@ -15929,12 +16150,15 @@ interface DecodedVaultTrancheState {
         juniorMint: unknown;
         seniorMint: unknown;
         seniorFixedApyBps?: unknown;
+        juniorFloorApyBps?: unknown;
     };
     junior?: Record<string, unknown>;
     senior?: Record<string, unknown>;
     lastSettledTs?: unknown;
     seniorApyAnchorSharePrice?: unknown;
     seniorApyAnchorTs?: unknown;
+    juniorApyAnchorSharePrice?: unknown;
+    juniorApyAnchorTs?: unknown;
 }
 interface ConsensusHoldingSimulation {
     holdingIndex: number;
@@ -16526,61 +16750,235 @@ declare class ConsensusOracleService {
 /**
  * External Liquidity Integrity Service
  *
- * Scans all vaults for active external liquidity positions. For each vault
- * holding with a non-zero local_amount and an active (non-None) external
- * liquidity slot, deposits the local funds into the external position via
- * `protocol_interaction` (e.g. a Marginfi deposit CPI).
+ * Keeps each vault holding's split between local (vault-owned token account)
+ * and external (Marginfi) balances at its target ratio. A small share of every
+ * holding is deliberately left local — see {@link DEFAULT_TARGET_LOCAL_BPS} —
+ * so routine payouts can be served without a Marginfi round trip; everything
+ * above that target is deposited into the configured external position via
+ * `protocol_interaction` (a Marginfi deposit CPI).
+ *
+ * The rebalance is two-sided: when the local balance has drifted *below* the
+ * target (deposits swept too aggressively, payouts drained the buffer) the
+ * service withdraws the shortfall back out of Marginfi. Either leg only fires
+ * once the drift leaves the hysteresis band around the target — see
+ * {@link DEFAULT_REBALANCE_BAND_BPS} — so ordinary flow does not generate a
+ * transaction per run.
  *
- * Intended to run on a recurring schedule (every ~10 minutes) so that idle
- * local balances are always deployed into the configured yield source.
+ * Intended to run on a recurring schedule (every ~10 minutes) so that the idle
+ * buffer stays close to target and the rest keeps earning yield.
  */
 
 interface ExternalLiquidityIntegrityResult {
     vault: Address;
     deposited: number;
+    withdrawn: number;
     skipped: number;
     failed: number;
-    /** Signatures of sent deposits (empty in dry-run mode). */
+    /** Signatures of sent rebalances (empty in dry-run mode). */
     signatures: string[];
 }
 interface ExternalLiquidityIntegritySummary {
     vaultsProcessed: number;
     totalDeposited: number;
+    totalWithdrawn: number;
     totalSkipped: number;
     totalFailed: number;
-    /** True when deposits were simulated rather than sent. */
+    /** True when rebalances were simulated rather than sent. */
     dryRun: boolean;
 }
-type LogFn = (msg: string) => void;
+type LogFn$1 = (msg: string) => void;
 interface ExternalLiquidityIntegrityOptions {
-    log?: LogFn;
-    /** Simulate each deposit instead of sending it. Nothing is submitted. */
+    log?: LogFn$1;
+    /** Simulate each rebalance instead of sending it. Nothing is submitted. */
     dryRun?: boolean;
     /**
-     * Skip holdings worth less than this many UI tokens. Every mint with a
+     * Skip rebalances smaller than this many UI tokens. Every mint with a
      * Marginfi bank is a USD stablecoin, so the default of 1 means "ignore
-     * dust below ~$1" and keeps the tx fee from exceeding the deposit.
+     * dust below ~$1" and keeps the tx fee from exceeding the movement.
      */
     minAmountUi?: number;
+    /**
+     * Share of each holding (local + external) to keep in the vault's own token
+     * account, in basis points. Defaults to {@link DEFAULT_TARGET_LOCAL_BPS}.
+     */
+    targetLocalBps?: number;
+    /**
+     * Hysteresis band, in basis points *of the target local amount*: the local
+     * balance must drift at least this far from target before a rebalance is
+     * worth a transaction. Defaults to {@link DEFAULT_REBALANCE_BAND_BPS}.
+     */
+    rebalanceBandBps?: number;
 }
 declare const DEFAULT_MIN_AMOUNT_UI = 1;
+/** Keep 1% of each holding local; the remaining 99% earns yield in Marginfi. */
+declare const DEFAULT_TARGET_LOCAL_BPS = 100;
+/**
+ * Rebalance only once the local balance has drifted more than 20% away from its
+ * target — i.e. outside 0.8%–1.2% of the holding at the default 1% target.
+ * Without this band every arriving deposit or payout would trigger its own
+ * transaction; with it, each rebalance restores the exact target, so the next
+ * one is a full band away rather than one dust movement later.
+ */
+declare const DEFAULT_REBALANCE_BAND_BPS = 2000;
+type RebalanceDirection = "deposit" | "withdraw";
+/**
+ * Decide how to move a holding back toward its target local share.
+ *
+ * A rebalance fires only once the drift from target exceeds both the hysteresis
+ * band (`rebalanceBandBps` of the target) and the `minRaw` dust floor — the band
+ * keeps the vault from paying a transaction fee for every small deposit or
+ * payout, the floor keeps small vaults, where the band itself is dust, quiet.
+ * When it does fire the move restores the exact target rather than the band
+ * edge. Withdrawals are additionally capped at the external balance.
+ */
+declare function planRebalance(params: {
+    localAmount: bigint;
+    externalAmount: bigint;
+    targetLocalBps: number;
+    rebalanceBandBps: number;
+    minRaw: bigint;
+}): {
+    direction: RebalanceDirection;
+    amount: bigint;
+    targetLocal: bigint;
+} | null;
 declare class ExternalLiquidityIntegrityService {
     private readonly client;
     constructor(client: VaultClient);
     /**
-     * Scan all vaults and deposit any idle local balance into configured external
-     * liquidity positions. Non-fatal per vault — errors are logged and counted.
+     * Scan all vaults and rebalance each holding toward its target local share.
+     * Non-fatal per vault — errors are logged and counted.
      */
     runAll(hwManager: Keypair, opts?: ExternalLiquidityIntegrityOptions): Promise<ExternalLiquidityIntegritySummary>;
     /**
-     * Process a single vault: for each active external liquidity slot, deposit
-     * any holdings that have a non-zero local_amount.
+     * Process a single vault: for each active external liquidity slot, move each
+     * holding's balance toward the target local/external split.
      */
-    processVault(vault: Address, vaultState: VaultAccountData, hwManager: Keypair, log: LogFn, opts?: {
+    processVault(vault: Address, vaultState: VaultAccountData, hwManager: Keypair, log: LogFn$1, opts?: {
         dryRun?: boolean;
         minAmountUi?: number;
+        targetLocalBps?: number;
+        rebalanceBandBps?: number;
     }): Promise<ExternalLiquidityIntegrityResult>;
-    private depositIntoMarginfi;
+    /**
+     * Move `amount` of `mintAddress` between the vault's own token account and
+     * its Marginfi position, in `direction`, through `protocol_interaction`.
+     */
+    private rebalanceMarginfi;
+}
+
+/**
+ * Idle Liquidity Service
+ *
+ * Keeps a floor of idle USDC in the vault so junior withdrawals and other
+ * payouts can be served without unwinding yield positions on demand.
+ *
+ * Idle USDC is measured as the USDC holding's `local_amount + external_amount`
+ * valued at the holding price — external (Marginfi-deployed) USDC counts,
+ * because the external-liquidity service sweeps local balances into Marginfi on
+ * its own schedule and that liquidity is withdrawable.
+ *
+ * When idle USDC drops below {@link IDLE_RESERVE_FLOOR_BPS} of vault TVL, the
+ * service swaps PST into USDC through the permissioned `jupiter_swap`
+ * instruction, sizing the swap to land at {@link IDLE_RESERVE_TARGET_BPS} of
+ * TVL. PST is never deployed externally, so the vault's local PST balance is
+ * the whole swappable inventory; if it cannot cover the full top-up the run is
+ * skipped rather than partially filled.
+ *
+ * Every swap is simulated before the signed transaction is submitted — the same
+ * mandatory-simulation discipline as the `swap-pst-to-usdc` script this service
+ * generalizes.
+ */
+
+/** Idle USDC below this share of TVL triggers a top-up. */
+declare const IDLE_RESERVE_FLOOR_BPS = 400;
+/** Top-ups are sized to land idle USDC at this share of TVL. */
+declare const IDLE_RESERVE_TARGET_BPS = 500;
+declare const DEFAULT_SLIPPAGE_BPS = 30;
+declare const DEFAULT_CU_PRICE_MICRO_LAMPORTS = 10000;
+declare const DEFAULT_MAX_ACCOUNTS = 20;
+/**
+ * Mirrors `ASSET_REBALANCE_COOLDOWN_SECS` on-chain. Swapping inside the cooldown
+ * reverts with `AssetRebalanceRateLimitExceeded`, so the run is skipped instead.
+ */
+declare const ASSET_REBALANCE_COOLDOWN_SECS = 60;
+type LogFn = (msg: string) => void;
+/** Why a run did not swap, or that it did. */
+type IdleLiquidityStatus = "swapped" | "simulated" | "above-floor" | "insufficient-pst" | "rebalance-cooldown" | "rebalance-limit" | "missing-holding" | "stale-price" | "no-tvl" | "failed";
+interface IdleLiquidityResult {
+    vault: Address;
+    status: IdleLiquidityStatus;
+    /** Human-readable detail for the status, always populated. */
+    reason: string;
+    /** Vault TVL in accounting units. */
+    tvl: bigint;
+    /** Idle USDC (local + external) valued in accounting units. */
+    idleValue: bigint;
+    /** Idle USDC as a share of TVL, in bps. */
+    idleBps: number;
+    /** USDC the swap needs to produce to reach the target, in raw USDC units. */
+    shortfallUsdc: bigint;
+    /** PST spent (0 unless a swap was executed or simulated). */
+    pstSpent: bigint;
+    /** USDC received (0 unless a swap was executed or simulated). */
+    usdcReceived: bigint;
+    signature?: string;
+}
+interface IdleLiquidityOptions {
+    log?: LogFn;
+    /** Simulate the swap and stop; nothing is submitted. */
+    dryRun?: boolean;
+    /** Jupiter slippage tolerance for the top-up quote. */
+    slippageBps?: number;
+    /** Priority fee. Set to 0 to omit the compute-unit-price instruction. */
+    cuPriceMicroLamports?: number;
+    /**
+     * Cap on a single swap's PST input, in raw units. Useful to bound price
+     * impact when the shortfall is large; the deficit closes over several runs.
+     */
+    maxPstInput?: bigint;
+}
+declare class IdleLiquidityService {
+    private readonly client;
+    constructor(client: VaultClient);
+    /** Current unix time in seconds (override in tests). */
+    protected now(): number;
+    /**
+     * Top up the vault's idle USDC reserve if it has fallen below the floor.
+     * Never throws for an expected no-op — inspect `status` on the result.
+     */
+    run(vault: Address, hwManager: Keypair, opts?: IdleLiquidityOptions): Promise<IdleLiquidityResult>;
+    /**
+     * Decide whether a top-up is warranted. Returns either a terminal `result`
+     * (nothing to do) or the holdings and sizing needed to build the swap.
+     */
+    private assess;
+    /**
+     * Value still chargeable against the vault's rolling rebalance window, in
+     * accounting units. `undefined` when the cap is disabled (unlimited).
+     */
+    private remainingRebalanceAllowance;
+    /**
+     * PST input that buys `shortfallUsdc` at the holdings' recorded prices.
+     * Both prices share the vault's accounting unit, so this is a straight
+     * value conversion; slippage is absorbed by landing slightly under target.
+     */
+    private sizePstInput;
+    private stalenessThresholdSecs;
+    /**
+     * Token program owning a mint. Read from the chain rather than from the
+     * holding's enum so a Token-2022 mint can never be passed to the classic
+     * program (and vice versa).
+     */
+    private mintTokenProgram;
+    /**
+     * Build, simulate, and (unless `dryRun`) submit the `jupiter_swap`.
+     *
+     * Built as a versioned transaction here rather than through
+     * `client.sendTransaction`, because a Jupiter route needs address lookup
+     * tables and a raised compute-unit limit to fit.
+     */
+    private executeSwap;
 }
 
-export { ASSET_DECIMALS, type AccountBalanceResponse, AccountClient, type AccountYieldResponse, ActivateCircuitBreakerBuilder, type ActivateCircuitBreakerIxArgs, type ActivateCircuitBreakerTxArgs, type AssetPriceOracleConfigIxArgs, type AssetPriceOracleConfigTxArgs, type AssetPriceRefreshTarget, type AssetRefreshResult, type Bankineco, type BasicAuthCredentials, type Bigintish, CONSENSUS_ORACLE_VARIANT, CancelJuniorTrancheWithdrawBuilder, type CancelJuniorTrancheWithdrawIxArgs, type CancelJuniorTrancheWithdrawTxArgs, type Clock, type CollectSamplesOptions, type ConsensusAssetUpdate, type ConsensusHoldingEntry, type ConsensusHoldingSimulation, type ConsensusOracleDeps, type ConsensusOracleHoldingConfig, ConsensusOracleService, type ConsensusOracleTarget, CrankNavBuilder, type CrankNavIxArgs, type CrankNavTxArgs, CrankPerformanceFeesBuilder, type CrankPerformanceFeesIxArgs, type CrankPerformanceFeesTxArgs, type CreateAccountParams, CreateAssetHoldingBuilder, type CreateAssetHoldingIxArgs, type CreateAssetHoldingTxArgs, type CreateTokenMintIxs, CreateTrancheStateBuilder, type CreateTrancheStateIxArgs, type CreateTrancheStateTxArgs, CreateVaultBuilder, type CreateVaultClientOptions, type CreateVaultIxArgs, type CreateVaultParams, type CreateVaultTxArgs, type CreateYieldPaymentParams, DEFAULT_JUNIOR_EARLY_UNSTAKE_FEE_BPS, DEFAULT_JUNIOR_STANDARD_UNSTAKE_FEE_BPS, DEFAULT_JUNIOR_WITHDRAWAL_LOCKUP_SECS, DEFAULT_MAX_ACCEPTABLE_APY_BPS, DEFAULT_MIN_AMOUNT_UI, DEFAULT_ORACLE_STALENESS_THRESHOLD_SECS, DEFAULT_PRICE_ORACLE_ACCOUNT, DEFAULT_PRICE_STALENESS_SECS, DEFAULT_PRICE_STALENESS_THRESHOLD_SECS, DEFAULT_VAULT_ID, type DecodedHolding, type DecodedVault, type DecodedVaultTrancheState, type DeleteAccountParams, DisableCircuitBreakerBuilder, type DisableCircuitBreakerIxArgs, type DisableCircuitBreakerTxArgs, EXTERNAL_POSITION_SAMPLES, ExecuteDepositBuilder, type ExecuteDepositIxArgs, type ExecuteDepositTxArgs, ExecuteShareSwapBuilder, type ExecuteShareSwapIxArgs, type ExecuteShareSwapTxArgs, ExecuteTrancheDepositBuilder, type ExecuteTrancheDepositIxArgs, type ExecuteTrancheDepositTxArgs, ExecuteTrancheWithdrawBuilder, type ExecuteTrancheWithdrawIxArgs, type ExecuteTrancheWithdrawTxArgs, ExecuteWithdrawBuilder, type ExecuteWithdrawIxArgs, type ExecuteWithdrawTxArgs, type ExternalLiquidityIntegrityOptions, type ExternalLiquidityIntegrityResult, ExternalLiquidityIntegrityService, type ExternalLiquidityIntegritySummary, type ExternalLiquiditySlot, type ExternalLiquiditySourceArgs, type ExternalPosition, type ExternalPositionContext, type ExternalPositionProvider, type ExternalPositionRef, ExternalPositionRegistry, FEE_VAULT_CACHE_CATEGORY, type FeeVaultAccountData, type FetchNestTokenPriceOptions, FulfillJuniorTrancheWithdrawBuilder, type FulfillJuniorTrancheWithdrawIxArgs, type FulfillJuniorTrancheWithdrawTxArgs, type FulfillSummary, type HoldingNavContribution, type HoldingUpdatePreview, IDL, InitializeVaultRolesBuilder, type InitializeVaultRolesIxArgs, type InitializeVaultRolesTxArgs, type JuniorWithdrawalMode, JupiterBalanceSource, type JupiterBalanceSourceOptions, JupiterPriceSource, type JupiterPriceSourceOptions, JupiterSwapBuilder, type JupiterSwapIxArgs, type JupiterSwapTxArgs, KaminoPositionProvider, LIVE_ORACLE_VARIANTS, LIVE_PRICE_REFRESH_INTERVAL_SECS, LOCAL_PROTOCOL_ADMIN, type LiveConsensusOracleDepsOptions, LivePriceSource, type LivePriceSourceOptions, MAX_CONSENSUS_SIGNERS, MAX_PRICE_STALENESS_THRESHOLD_SECS, MIN_EXTERNAL_POSITION_SAMPLES, ManagerRedepositAssetBuilder, type ManagerRedepositAssetIxArgs, type ManagerRedepositAssetTxArgs, ManagerWithdrawAssetBuilder, type ManagerWithdrawAssetIxArgs, type ManagerWithdrawAssetTxArgs, MarginfiPositionProvider, type MockYieldAccountConfig, MockYieldTracker, type MockYieldTrackerOptions, NEST_RWA_SHARE_MINT, NEST_VAULT_SLUG, type NavCrankBlocker, type NavCrankBlockerReason, type NavCrankReadiness, type NavCrankResult, NestPriceSource, type NestPriceSourceOptions, ORACLE_ENTRIES_OFFSET, ORACLE_ENTRY_SIZE, ORACLE_SETTLED_NAV_TS_OFFSET, OracleService, PRICE_ORACLE_TYPES_BY_INDEX, PROGRAM_FEE_EXEMPT_OWNER_WHITELIST, PROTOCOL_ADMIN, PROTOCOL_FEE_RECIPIENT, PdaClient, type PreparedDirectTransaction, type PreparedSquadsTransaction, type PreparedVaultTransaction, type PriceOracleTypeArgs, type PriceSource, ProtocolInteractionBuilder, type ProtocolInteractionIxArgs, type ProtocolInteractionTxArgs, type QuoteFeeUnit, REPORTABLE_ORACLE_VARIANTS, type RefreshLiveOraclePricesParams, RemoveAssetHoldingBuilder, type RemoveAssetHoldingIxArgs, type RemoveAssetHoldingTxArgs, RequestJuniorTrancheWithdrawBuilder, type RequestJuniorTrancheWithdrawIxArgs, type RequestJuniorTrancheWithdrawTxArgs, type ResolvedSquadsWalletRoute, type RollingLimitConfig, type RunLiveConsensusOracleOptions, type RunOptions, type RunSummary, SHARE_DECIMALS, SYSTEM_PROGRAM, SetAssetPriceOracleBuilder, type SetAssetPriceOracleIxArgs, type SetAssetPriceOracleTxArgs, SetExternalLiquidityBuilder, type SetExternalLiquidityIxArgs, type SetExternalLiquidityTxArgs, SetProtocolFeeBuilder, type SetProtocolFeeIxArgs, type SetProtocolFeeTxArgs, SetVaultConfigBuilder, type SetVaultConfigIxArgs, type SetVaultConfigTxArgs, type SettleVaultParams, type SettleVaultResult, type SettlementSimulation, type SettlementSimulationSnapshot, type SimulateDryRunSettlementParams, type SimulateSettlementArgs, type SimulatedShareClass, type SquadsWalletRouteConfig, StaticPositionProvider, TOKEN_PROGRAM, TOKEN_PROGRAM_ID, type TrancheKindArgs, type TransactionBuilder, TransactionClient, USDC_MINT, USD_STAR_JUNIOR_MINT, USD_STAR_MINT, USD_STAR_PRINCIPAL_MINT, type UpdateAccountParams, UpdateAssetPriceBuilder, type UpdateAssetPriceIxArgs, type UpdateAssetPriceTxArgs, UpdateConsensusOracleBuilder, type UpdateConsensusOracleIxArgs, type UpdateConsensusOracleTxArgs, UpdateConsensusSignersBuilder, type UpdateConsensusSignersIxArgs, type UpdateConsensusSignersTxArgs, type UpdateDynamicAprParams, UpdateTrancheConfigBuilder, type UpdateTrancheConfigIxArgs, type UpdateTrancheConfigTxArgs, VAULT_CACHE_CATEGORY, VAULT_CREATOR_WHITELIST, VAULT_ENVIRONMENTS, VAULT_ORACLE_CACHE_CATEGORY, VAULT_PROGRAM_ID, VAULT_PROGRAM_IDS, VAULT_PROGRAM_PUBLIC_KEY, VAULT_ROLE_UPDATE_TIMELOCK_SECS, VAULT_TRANCHE_STATE_CACHE_CATEGORY, VAULT_TRANCHE_WITHDRAWAL_QUEUE_CACHE_CATEGORY, type Vault, type VaultAccountData, VaultBuilderBase, type VaultBuilderContext, type VaultCacheInvalidation, VaultClient, type VaultClientBundle, type VaultEnv, type VaultOracleAccountData, type VaultOracleResult, type VaultPricingInputs, type VaultQuote, type VaultQuoteArgs, VaultQuoteClient, type VaultQuoteDirection, type VaultQuoteShareClass, VaultReallocationBuilder, type VaultReallocationIxArgs, type VaultReallocationTxArgs, type VaultTrancheStateAccountData, type VaultTrancheWithdrawalQueueAccountData, type VaultTransactionPlan, type WalletBalanceSource, type WithdrawProtocolFeesIxArgs, type WithdrawProtocolFeesTxArgs, type WithdrawTrancheFeesIxArgs, type WithdrawTrancheFeesTxArgs, WithdrawalQueueService, type WithdrawalQueueSnapshot, type YieldAccount, type YieldAccountSnapshot, type YieldCalculationLog, type YieldPaymentResponse, type YieldPaymentSnapshot, type YieldTracker, accountingUnitPriceToUsd, addCashflowUpdate, applyEffectiveApy, assertNoUnconfirmedYieldPayments, buildHoldingUpdate, buildUpdates, coerceBool, collectSamples, confirmYieldPayment, createAccount, createLiveConsensusOracleDeps, createRpcFromConnection, createTokenMint, createTokenMintIxs, createVaultClient, createYieldPayment, dateToStr, defaultKeypairPath, deleteAccount, discoverVaultsForSigner, fetchExternalPositions, fetchNestTokenPrice, fetchReceiptMints, filterTargetHoldings, findSquadsWalletRoute, formatSettlementSimulation, fromUiAmount, gatherPricingInputs, getAccounts, getBalance, getCashflows, getRpcUrl, getTotalOutstandingYield, getTotalYield, getVaultProgramId, getYield, getYieldPayments, indexConfigByMint, isVaultEnv, keypairAddress, loadKeypair, logProspectiveApy, makeProvider, mintTokensTo, mostFrequent, parseExternalLiquidityRefs, prepareVaultTransaction, priceInAccountingUnit, readI64LE, readSplMintSupply, refreshLiveOraclePrices, resolveKeypairPath, resolveSquadsWalletRoute, resolveTrackedAmounts, roundToNextUtcMidnight, runLiveConsensusOracle, selectReportableHoldings, settleVault, signerInOracleData, simulateConsensusOracleSettlement, simulateDryRunSettlement, sumPositionsByMint, systemClock, toBigInt, toUiAmount, updateAccount, updateDynamicApr, validateSquadsWalletRoutes, variantName, vaultAuthorityForWallet, withDiscoveredYieldAccounts };
+export { ASSET_DECIMALS, ASSET_REBALANCE_COOLDOWN_SECS, type AccountBalanceResponse, AccountClient, type AccountYieldResponse, ActivateCircuitBreakerBuilder, type ActivateCircuitBreakerIxArgs, type ActivateCircuitBreakerTxArgs, type AssetPriceOracleConfigIxArgs, type AssetPriceOracleConfigTxArgs, type AssetPriceRefreshTarget, type AssetRefreshResult, type Bankineco, type BasicAuthCredentials, type Bigintish, CONSENSUS_ORACLE_VARIANT, CancelJuniorTrancheWithdrawBuilder, type CancelJuniorTrancheWithdrawIxArgs, type CancelJuniorTrancheWithdrawTxArgs, type Clock, type CollectSamplesOptions, type ConsensusAssetUpdate, type ConsensusHoldingEntry, type ConsensusHoldingSimulation, type ConsensusOracleDeps, type ConsensusOracleHoldingConfig, ConsensusOracleService, type ConsensusOracleTarget, CrankNavBuilder, type CrankNavIxArgs, type CrankNavTxArgs, CrankPerformanceFeesBuilder, type CrankPerformanceFeesIxArgs, type CrankPerformanceFeesTxArgs, type CreateAccountParams, CreateAssetHoldingBuilder, type CreateAssetHoldingIxArgs, type CreateAssetHoldingTxArgs, type CreateTokenMintIxs, CreateTrancheStateBuilder, type CreateTrancheStateIxArgs, type CreateTrancheStateTxArgs, CreateVaultBuilder, type CreateVaultClientOptions, type CreateVaultIxArgs, type CreateVaultParams, type CreateVaultTxArgs, type CreateYieldPaymentParams, DEFAULT_CU_PRICE_MICRO_LAMPORTS, DEFAULT_JUNIOR_EARLY_UNSTAKE_FEE_BPS, DEFAULT_JUNIOR_STANDARD_UNSTAKE_FEE_BPS, DEFAULT_JUNIOR_WITHDRAWAL_LOCKUP_SECS, DEFAULT_MAX_ACCEPTABLE_APY_BPS, DEFAULT_MAX_ACCOUNTS, DEFAULT_MIN_AMOUNT_UI, DEFAULT_ORACLE_STALENESS_THRESHOLD_SECS, DEFAULT_PRICE_ORACLE_ACCOUNT, DEFAULT_PRICE_STALENESS_SECS, DEFAULT_PRICE_STALENESS_THRESHOLD_SECS, DEFAULT_REBALANCE_BAND_BPS, DEFAULT_SLIPPAGE_BPS, DEFAULT_TARGET_LOCAL_BPS, DEFAULT_VAULT_ID, type DecodedHolding, type DecodedVault, type DecodedVaultTrancheState, type DeleteAccountParams, DisableCircuitBreakerBuilder, type DisableCircuitBreakerIxArgs, type DisableCircuitBreakerTxArgs, EXTERNAL_POSITION_SAMPLES, ExecuteDepositBuilder, type ExecuteDepositIxArgs, type ExecuteDepositTxArgs, ExecuteShareSwapBuilder, type ExecuteShareSwapIxArgs, type ExecuteShareSwapTxArgs, ExecuteTrancheDepositBuilder, type ExecuteTrancheDepositIxArgs, type ExecuteTrancheDepositTxArgs, ExecuteTrancheWithdrawBuilder, type ExecuteTrancheWithdrawIxArgs, type ExecuteTrancheWithdrawTxArgs, ExecuteWithdrawBuilder, type ExecuteWithdrawIxArgs, type ExecuteWithdrawTxArgs, type ExternalLiquidityIntegrityOptions, type ExternalLiquidityIntegrityResult, ExternalLiquidityIntegrityService, type ExternalLiquidityIntegritySummary, type ExternalLiquiditySlot, type ExternalLiquiditySourceArgs, type ExternalPosition, type ExternalPositionContext, type ExternalPositionProvider, type ExternalPositionRef, ExternalPositionRegistry, FEE_VAULT_CACHE_CATEGORY, type FeeVaultAccountData, type FetchNestTokenPriceOptions, FulfillJuniorTrancheWithdrawBuilder, type FulfillJuniorTrancheWithdrawIxArgs, type FulfillJuniorTrancheWithdrawTxArgs, type FulfillSummary, type HoldingNavContribution, type HoldingUpdatePreview, IDL, IDLE_RESERVE_FLOOR_BPS, IDLE_RESERVE_TARGET_BPS, type IdleLiquidityOptions, type IdleLiquidityResult, IdleLiquidityService, type IdleLiquidityStatus, InitializeVaultRolesBuilder, type InitializeVaultRolesIxArgs, type InitializeVaultRolesTxArgs, type JuniorWithdrawalMode, JupiterBalanceSource, type JupiterBalanceSourceOptions, JupiterPriceSource, type JupiterPriceSourceOptions, JupiterSwapBuilder, type JupiterSwapIxArgs, type JupiterSwapTxArgs, KaminoPositionProvider, LIVE_ORACLE_VARIANTS, LIVE_PRICE_REFRESH_INTERVAL_SECS, LOCAL_PROTOCOL_ADMIN, type LiveConsensusOracleDepsOptions, LivePriceSource, type LivePriceSourceOptions, MAX_CONSENSUS_SIGNERS, MAX_PRICE_STALENESS_THRESHOLD_SECS, MIN_EXTERNAL_POSITION_SAMPLES, ManagerRedepositAssetBuilder, type ManagerRedepositAssetIxArgs, type ManagerRedepositAssetTxArgs, ManagerWithdrawAssetBuilder, type ManagerWithdrawAssetIxArgs, type ManagerWithdrawAssetTxArgs, MarginfiPositionProvider, type MockYieldAccountConfig, MockYieldTracker, type MockYieldTrackerOptions, NEST_RWA_SHARE_MINT, NEST_VAULT_SLUG, type NavCrankBlocker, type NavCrankBlockerReason, type NavCrankReadiness, type NavCrankResult, NestPriceSource, type NestPriceSourceOptions, ORACLE_ENTRIES_OFFSET, ORACLE_ENTRY_SIZE, ORACLE_SETTLED_NAV_TS_OFFSET, OracleService, PRICE_ORACLE_TYPES_BY_INDEX, PROGRAM_FEE_EXEMPT_OWNER_WHITELIST, PROTOCOL_ADMIN, PROTOCOL_FEE_RECIPIENT, PdaClient, type PreparedDirectTransaction, type PreparedSquadsTransaction, type PreparedVaultTransaction, type PriceOracleTypeArgs, type PriceSource, ProtocolInteractionBuilder, type ProtocolInteractionIxArgs, type ProtocolInteractionTxArgs, type QuoteFeeUnit, REPORTABLE_ORACLE_VARIANTS, type RefreshLiveOraclePricesParams, RemoveAssetHoldingBuilder, type RemoveAssetHoldingIxArgs, type RemoveAssetHoldingTxArgs, RequestJuniorTrancheWithdrawBuilder, type RequestJuniorTrancheWithdrawIxArgs, type RequestJuniorTrancheWithdrawTxArgs, type ResolvedSquadsWalletRoute, type RollingLimitConfig, type RollingRebalanceLimitConfig, type RunLiveConsensusOracleOptions, type RunOptions, type RunSummary, SHARE_DECIMALS, SYSTEM_PROGRAM, SetAssetPriceOracleBuilder, type SetAssetPriceOracleIxArgs, type SetAssetPriceOracleTxArgs, SetExternalLiquidityBuilder, type SetExternalLiquidityIxArgs, type SetExternalLiquidityTxArgs, SetProtocolFeeBuilder, type SetProtocolFeeIxArgs, type SetProtocolFeeTxArgs, SetVaultConfigBuilder, type SetVaultConfigIxArgs, type SetVaultConfigTxArgs, type SettleVaultParams, type SettleVaultResult, type SettlementSimulation, type SettlementSimulationSnapshot, type SimulateDryRunSettlementParams, type SimulateSettlementArgs, type SimulatedShareClass, type SquadsWalletRouteConfig, StaticPositionProvider, TOKEN_PROGRAM, TOKEN_PROGRAM_ID, type TrancheKindArgs, type TransactionBuilder, TransactionClient, USDC_MINT, USD_STAR_JUNIOR_MINT, USD_STAR_MINT, USD_STAR_PRINCIPAL_MINT, type UpdateAccountParams, UpdateAssetPriceBuilder, type UpdateAssetPriceIxArgs, type UpdateAssetPriceTxArgs, UpdateConsensusOracleBuilder, type UpdateConsensusOracleIxArgs, type UpdateConsensusOracleTxArgs, UpdateConsensusSignersBuilder, type UpdateConsensusSignersIxArgs, type UpdateConsensusSignersTxArgs, type UpdateDynamicAprParams, UpdateTrancheConfigBuilder, type UpdateTrancheConfigIxArgs, type UpdateTrancheConfigTxArgs, VAULT_CACHE_CATEGORY, VAULT_CREATOR_WHITELIST, VAULT_ENVIRONMENTS, VAULT_ORACLE_CACHE_CATEGORY, VAULT_PROGRAM_ID, VAULT_PROGRAM_IDS, VAULT_PROGRAM_PUBLIC_KEY, VAULT_ROLE_UPDATE_TIMELOCK_SECS, VAULT_TRANCHE_STATE_CACHE_CATEGORY, VAULT_TRANCHE_WITHDRAWAL_QUEUE_CACHE_CATEGORY, type Vault, type VaultAccountData, VaultBuilderBase, type VaultBuilderContext, type VaultCacheInvalidation, VaultClient, type VaultClientBundle, type VaultEnv, type VaultOracleAccountData, type VaultOracleResult, type VaultPricingInputs, type VaultQuote, type VaultQuoteArgs, VaultQuoteClient, type VaultQuoteDirection, type VaultQuoteShareClass, VaultReallocationBuilder, type VaultReallocationIxArgs, type VaultReallocationTxArgs, type VaultTrancheStateAccountData, type VaultTrancheWithdrawalQueueAccountData, type VaultTransactionPlan, type WalletBalanceSource, type WithdrawProtocolFeesIxArgs, type WithdrawProtocolFeesTxArgs, type WithdrawTrancheFeesIxArgs, type WithdrawTrancheFeesTxArgs, WithdrawalQueueService, type WithdrawalQueueSnapshot, type YieldAccount, type YieldAccountSnapshot, type YieldCalculationLog, type YieldPaymentResponse, type YieldPaymentSnapshot, type YieldTracker, accountingUnitPriceToUsd, addCashflowUpdate, applyEffectiveApy, assertNoUnconfirmedYieldPayments, buildHoldingUpdate, buildUpdates, coerceBool, collectSamples, confirmYieldPayment, createAccount, createLiveConsensusOracleDeps, createRpcFromConnection, createTokenMint, createTokenMintIxs, createVaultClient, createYieldPayment, dateToStr, defaultKeypairPath, deleteAccount, discoverVaultsForSigner, fetchExternalPositions, fetchNestTokenPrice, fetchReceiptMints, filterTargetHoldings, findSquadsWalletRoute, formatSettlementSimulation, fromUiAmount, gatherPricingInputs, getAccounts, getBalance, getCashflows, getRpcUrl, getTotalOutstandingYield, getTotalYield, getVaultProgramId, getYield, getYieldPayments, indexConfigByMint, isVaultEnv, keypairAddress, loadKeypair, logProspectiveApy, makeProvider, mintTokensTo, mostFrequent, parseExternalLiquidityRefs, planRebalance, prepareVaultTransaction, priceInAccountingUnit, readI64LE, readSplMintSupply, refreshLiveOraclePrices, resolveKeypairPath, resolveSquadsWalletRoute, resolveTrackedAmounts, roundToNextUtcMidnight, runLiveConsensusOracle, selectReportableHoldings, settleVault, signerInOracleData, simulateConsensusOracleSettlement, simulateDryRunSettlement, sumPositionsByMint, systemClock, toBigInt, toUiAmount, updateAccount, updateDynamicApr, validateSquadsWalletRoutes, variantName, vaultAuthorityForWallet, withDiscoveredYieldAccounts };