@perena/vault-sdk 1.0.41 → 1.0.42

package/dist/index.d.ts

@@ -11345,7 +11345,10 @@ declare class VaultClient {
     readonly account: AccountClient;
     readonly tx: TransactionClient;
     readonly quote: VaultQuoteClient;
-    constructor(provider: AnchorProvider, programId?: Address);
+    readonly skipSimulation: boolean;
+    constructor(provider: AnchorProvider, programId?: Address, options?: {
+        skipSimulation?: boolean;
+    });
     /**
      * Sign, send, and confirm a transaction plan built from {@link TransactionClient}.
      * Pass `extraSigners` for accounts created in the same tx (e.g. a new share mint).
@@ -11401,6 +11404,8 @@ declare function loadKeypair(keypairPath: string): Keypair;
  */
 declare function defaultKeypairPath(env: VaultEnv, role?: string): string;
 interface CreateVaultClientOptions {
+    /** Skip optional transaction simulations and RPC send preflight. */
+    skipSimulation?: boolean;
     /** Explicit RPC endpoint; otherwise resolved from env vars. */
     rpcUrl?: string;
     /** Keypair file path; defaults to {@link defaultKeypairPath}. Ignored if `keypair` is set. */
@@ -11982,7 +11987,7 @@ declare class OracleService {
  * The orchestrator ({@link ConsensusOracleService}) depends only on these
  * interfaces, so it carries no network/RPC/protocol dependencies of its own and
  * can be unit-tested with in-memory fakes. Concrete implementations
- * (Jupiter price/balance feeds, the mock yield tracker, live-LP providers) are
+ * (price feeds, the mock yield tracker, live-LP providers) are
  * injected by the caller.
  */
 
@@ -11994,10 +11999,6 @@ interface PriceSource {
      */
     fetchUsdPrices(mints: Address[]): Promise<Record<string, number>>;
 }
-/** Supplies an owner's SPL token balances (raw base units), keyed by mint. */
-interface WalletBalanceSource {
-    fetchBalances(owner: Address): Promise<Record<string, bigint>>;
-}
 /** A balance deployed outside vault-owned token accounts, in the mint's base units. */
 interface ExternalPosition {
     mint: Address;
@@ -12015,8 +12016,6 @@ interface ExternalPositionRef {
 }
 interface ExternalPositionContext {
     vault: Address;
-    /** The vault's manager wallet (positions are usually held against it). */
-    manager: Address;
     /** Position descriptors gathered from the target config for this vault. */
     refs: ExternalPositionRef[];
 }
@@ -12099,7 +12098,6 @@ interface ConsensusOracleTarget {
 /** Injected collaborators for {@link ConsensusOracleService}. */
 interface ConsensusOracleDeps {
     priceSource: PriceSource;
-    balanceSource: WalletBalanceSource;
     /** Optional; omitted ⇒ no live-LP balances are folded in. */
     externalPositions?: ExternalPositionProvider;
     /** Optional; omitted ⇒ no yield accrual is folded in. */
@@ -12123,8 +12121,6 @@ interface HoldingUpdatePreview {
     usdPrice: number;
     /** Price in the vault's accounting unit, fixed-point (scaled by assetDecimals). */
     price: bigint;
-    /** Manager-wallet balance of this mint (base units). */
-    walletAmount: bigint;
     /** Summed live-LP positions for this mint (base units). */
     lpAmount: bigint;
     /** Accrued yield attributed to this holding (base units). */
@@ -12133,7 +12129,7 @@ interface HoldingUpdatePreview {
     trackedPrincipalAmount: bigint;
     /** Complete tracked value, including NAV accounts (base units). */
     trackedValueAmount: bigint;
-    /** Total external balance pushed = wallet + LP + complete tracked value. */
+    /** Total external balance pushed = LP + complete tracked value. */
     externalAmount: bigint;
 }
 interface VaultOracleResult {
@@ -12283,6 +12279,8 @@ interface SettlementSimulation {
      * until the vault config is updated.
      */
     projectionRequiresMaxApyDisabled?: boolean;
+    /** Hypothetical projection with losses enabled; the real crank remains blocked. */
+    projectionRequiresLossesEnabled?: boolean;
     projected?: SettlementSimulationSnapshot;
     performanceFees?: {
         curator: bigint;
@@ -12301,7 +12299,6 @@ interface VaultPricingInputs {
     assetDecimals: number;
     baseUsd: number;
     usdPrices: Record<string, number>;
-    walletBalances: Record<string, bigint>;
     lpByMint: Map<string, bigint>;
     configByMint: Map<string, ConsensusOracleHoldingConfig>;
 }
@@ -12425,7 +12422,6 @@ interface LargeBalanceChangeViolation {
     valueChange: bigint;
     tvl: bigint;
     thresholdBps: bigint;
-    walletAmount: bigint;
     lpAmount: bigint;
     trackedPrincipalAmount: bigint;
     trackedValueAmount: bigint;
@@ -12489,11 +12485,6 @@ interface RefreshLiveOraclePricesParams {
 /** Returns true when at least one price was actually refreshed on-chain. */
 declare function refreshLiveOraclePrices({ oracle, signer, vault, vaultState, nowSecs, log, dryRun, }: RefreshLiveOraclePricesParams): Promise<boolean>;
 
-/**
- * Sourcing step: fetch every external input the per-holding updates draw on —
- * USD spot prices, manager wallet balances, and live external LP positions.
- */
-
 declare function gatherPricingInputs(deps: ConsensusOracleDeps, target: ConsensusOracleTarget, vaultState: DecodedVault, reportableHoldings: ConsensusHoldingEntry[], log?: (msg: string) => void): Promise<VaultPricingInputs>;
 /**
  * Live-LP balances for the target, summed by mint (empty if no provider).
@@ -12503,7 +12494,7 @@ declare function gatherPricingInputs(deps: ConsensusOracleDeps, target: Consensu
  * or hit a lagging RPC node, and this value is reported on-chain as
  * `external_amount`.
  */
-declare function fetchExternalPositions(deps: ConsensusOracleDeps, target: ConsensusOracleTarget, manager: Address, vaultState: DecodedVault, log?: (msg: string) => void): Promise<Map<string, bigint>>;
+declare function fetchExternalPositions(deps: ConsensusOracleDeps, target: ConsensusOracleTarget, vaultState: DecodedVault, log?: (msg: string) => void): Promise<Map<string, bigint>>;
 
 /**
  * Receipt mints issued by a vault are liabilities/shares, not underlying assets
@@ -12581,24 +12572,6 @@ declare function assertNoUnconfirmedYieldPayments(yieldTracker: YieldTracker | u
  */
 declare function withDiscoveredYieldAccounts(yieldTracker: YieldTracker | undefined, target: ConsensusOracleTarget, vaultState: DecodedVault, excludedMints: ReadonlySet<string>, log: (msg: string) => void): Promise<ConsensusOracleTarget>;
 
-/**
- * Wallet token balances, from the Jupiter Ultra balances API with an on-chain
- * RPC fallback.
- *
- *   Jupiter: GET https://lite-api.jup.ag/ultra/v1/balances/{owner}
- *            → { "<mint>": { amount, uiAmount, slot, isFrozen }, "SOL": {…} }
- *   RPC:     `getParsedTokenAccountsByOwner` over the SPL Token and Token-2022
- *            programs, summed per mint.
- *
- * Amounts are raw base units in both paths — no decimal conversion is applied.
- * Native SOL is skipped; these are SPL holdings only.
- */
-
-interface FetchJupiterBalancesOptions {
-    baseUrl?: string;
-    fetchFn?: typeof fetch;
-}
-
 /**
  * Jupiter price API (`GET /price/v3`).
  *
@@ -12682,28 +12655,6 @@ declare class LivePriceSource implements PriceSource {
     fetchUsdPrices(mints: Address[]): Promise<Record<string, number>>;
 }
 
-/**
- * {@link WalletBalanceSource} adapter over the `jupiter` package's balances API.
- *
- * The Jupiter call and the RPC fallback both live in
- * `jupiter/src/balancesApi.ts`; this file owns the policy — try Jupiter first,
- * fall back to RPC on failure or an empty result — plus logging.
- */
-
-interface JupiterBalanceSourceOptions extends FetchJupiterBalancesOptions {
-    /** Skip the Jupiter call and read straight from RPC. */
-    rpcOnly?: boolean;
-    log?: (msg: string) => void;
-}
-declare class JupiterBalanceSource implements WalletBalanceSource {
-    private readonly connection;
-    private readonly rpcOnly;
-    private readonly log;
-    private readonly apiOptions;
-    constructor(connection: Connection, opts?: JupiterBalanceSourceOptions);
-    fetchBalances(owner: Address): Promise<Record<string, bigint>>;
-}
-
 /**
  * Aggregation of {@link ExternalPositionProvider}s plus a trivial static
  * provider. Concrete live-LP providers (Kamino, Marginfi) wrap protocol SDKs,
@@ -12855,7 +12806,6 @@ declare function formatSettlementSimulation(simulation: SettlementSimulation): s
 
 interface LiveConsensusOracleDepsOptions {
     log?: (msg: string) => void;
-    rpcOnly?: boolean;
     includeExternalPositions?: boolean;
 }
 declare function createLiveConsensusOracleDeps(connection: Connection, opts?: LiveConsensusOracleDepsOptions): ConsensusOracleDeps;
@@ -12865,8 +12815,6 @@ interface RunLiveConsensusOracleOptions extends RunOptions {
     rpcUrl?: string;
     /** Override the vault program id. Defaults to the environment's configured program. */
     programId?: Address;
-    /** Skip Jupiter balances and use RPC token-account balances only. */
-    rpcOnly?: boolean;
     /** Include live Kamino/Marginfi positions in external amount updates. Defaults to true. */
     includeExternalPositions?: boolean;
 }
@@ -13201,4 +13149,4 @@ declare class TimelockSettlementService {
     private execute;
 }
 
-export { ASSET_DECIMALS, ASSET_REBALANCE_COOLDOWN_SECS, type AccountBalanceResponse, AccountClient, type AccountYieldResponse, ActivateCircuitBreakerBuilder, type ActivateCircuitBreakerIxArgs, type ActivateCircuitBreakerTxArgs, type AddAprCashflowUpdateParams, type AddCashflowUpdateParams, type AddIncentiveRecipientArgs, AddIncentiveRecipientBuilder, type AddIncentiveRecipientIxArgs, type AddNavCashflowUpdateParams, type AprAccountBalanceResponse, type AprAccountYieldResponse, type AssetPriceOracleConfigIxArgs, type AssetPriceOracleConfigTxArgs, type AssetPriceRefreshTarget, type AssetRefreshResult, type AssetType, BALANCE_CHANGE_BASELINE_MAX_AGE_SECS, type Bankineco, type BasicAuthCredentials, type Bigintish, type BuildMarginfiWithdrawInteractionArgs, CONSENSUS_ORACLE_VARIANT, type CancelIncentiveProposalArgs, CancelIncentiveProposalBuilder, CancelJuniorTrancheWithdrawBuilder, type CancelJuniorTrancheWithdrawIxArgs, type CancelJuniorTrancheWithdrawTxArgs, ClaimIncentiveBuilder, type ClaimIncentiveIxArgs, type ClaimIncentiveTxArgs, 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, CreateIncentiveBuilder, type CreateIncentiveIxArgs, type CreateIncentiveTxArgs, 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_MINTS, 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, DistributeIncentiveBuilder, type DistributeIncentiveIxArgs, type DistributeIncentiveTxArgs, 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, type IncentiveRecipient, type IncentiveTotals, 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, LargeBalanceChangeError, type LargeBalanceChangeViolation, type LiveConsensusOracleDepsOptions, LivePriceSource, type LivePriceSourceOptions, MAX_BALANCE_CHANGE_BPS, MAX_CONSENSUS_SIGNERS, MAX_INCENTIVE_RECIPIENTS, MAX_MANAGER_WITHDRAW_DESTINATIONS, MAX_PRICE_STALENESS_THRESHOLD_SECS, MIN_EXTERNAL_POSITION_SAMPLES, ManagerRedepositAssetBuilder, type ManagerRedepositAssetIxArgs, type ManagerRedepositAssetTxArgs, ManagerWithdrawAssetBuilder, type ManagerWithdrawAssetIxArgs, type ManagerWithdrawAssetTxArgs, MarginfiPositionProvider, type MintConfig, type MintIdentifier, type MintInfo, MintRegistry, type MintRegistryOptions, type MockYieldAccountConfig, MockYieldTracker, type MockYieldTrackerOptions, NEST_API_BASE_URL, NEST_RWA_SHARE_MINT, NEST_VAULT_SLUG, type NavAccountBalanceResponse, type NavAccountValueResponse, type NavCrankBlocker, type NavCrankBlockerReason, type NavCrankReadiness, type NavCrankResult, type NavPriceConfig, type NavYieldAccount, 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 PendingConsensusSignerSet, 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 ResolveExternalWithdrawArgs, type ResolvedExternalWithdraw, 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, type SetIncentiveLimitsArgs, SetIncentiveLimitsBuilder, SetManagerWithdrawDestinationBuilder, type SetManagerWithdrawDestinationIxArgs, type SetManagerWithdrawDestinationTxArgs, SetProtocolFeeBuilder, type SetProtocolFeeIxArgs, type SetProtocolFeeTxArgs, SetVaultConfigBuilder, type SetVaultConfigIxArgs, type SetVaultConfigTxArgs, type SettleVaultParams, type SettleVaultResult, type SettlementSimulation, type SettlementSimulationSnapshot, type SimulateDryRunSettlementParams, type SimulateSettlementArgs, type SimulatedShareClass, SquadsProposalExecutionSimulationError, type SquadsWalletRouteConfig, type StaleBalanceChangeBypass, StaticPositionProvider, SubmitIncentiveBuilder, type SubmitIncentiveIxArgs, type SubmitIncentiveTxArgs, TOKEN_PROGRAM, TOKEN_PROGRAM_ID, type TimelockSettlementKind, type TimelockSettlementOptions, type TimelockSettlementRecord, TimelockSettlementService, type TimelockSettlementSummary, type TrackedAccountValue, 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 VaultIncentiveAccount, type VaultIncentiveAccountData, 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, WithdrawalQueueService, type WithdrawalQueueSnapshot, type YieldAccount, type YieldAccountSnapshot, type YieldCalculationLog, type YieldCashflow, type YieldPaymentResponse, type YieldPaymentSnapshot, type YieldTracker, type YieldValuationModel, accountingUnitPriceToUsd, addCashflowUpdate, applyEffectiveApy, assertNoLargeBalanceChanges, assertNoUnconfirmedYieldPayments, buildHoldingUpdate, buildMarginfiWithdrawInteraction, buildUpdates, coerceBool, collectSamples, confirmYieldPayment, createAccount, createLiveConsensusOracleDeps, createRpcFromConnection, createTokenMint, createTokenMintIxs, createVaultClient, createYieldPayment, dateToStr, decodePendingConsensusSigners, defaultKeypairPath, deleteAccount, discoverVaultsForSigner, fetchExternalPositions, fetchNestTokenPrice, fetchReceiptMints, filterTargetHoldings, findLargeBalanceChanges, findSquadsWalletRoute, formatSettlementSimulation, fromUiAmount, gatherPricingInputs, getAccount, getAccounts, getAprYield, getBalance, getCashflows, getIncentiveRecipientShareAtas, getIncentiveRecipients, getIncentiveReportRecipients, getIncentiveTotals, getNavValue, getRpcUrl, getTotalOutstandingYield, getTotalTrackedValue, getTotalYield, getTrackedValue, getVaultProgramId, getYield, getYieldPayments, indexConfigByMint, isNavAccountBalance, isNavAccountValue, isNavYieldAccount, isVaultEnv, keypairAddress, loadKeypair, logProspectiveApy, makeProvider, mintTokensTo, mints, mostFrequent, parseExternalLiquidityRefs, planRebalance, prepareVaultTransaction, priceInAccountingUnit, readI64LE, readSplMintSupply, refreshLiveOraclePrices, resolveExternalWithdraw, resolveKeypairPath, resolveSquadsWalletRoute, resolveTrackedAmounts, roundToNextUtcMidnight, runLiveConsensusOracle, selectReportableHoldings, settleVault, signerInOracleData, simulateConsensusOracleSettlement, simulateDryRunSettlement, simulateSquadsProposalExecution, sumPositionsByMint, systemClock, toBigInt, toUiAmount, toWeb3AccountMeta, trackedValueFromResponse, updateAccount, updateDynamicApr, validateSquadsWalletRoutes, variantName, vaultAuthorityForWallet, withDiscoveredYieldAccounts };
+export { ASSET_DECIMALS, ASSET_REBALANCE_COOLDOWN_SECS, type AccountBalanceResponse, AccountClient, type AccountYieldResponse, ActivateCircuitBreakerBuilder, type ActivateCircuitBreakerIxArgs, type ActivateCircuitBreakerTxArgs, type AddAprCashflowUpdateParams, type AddCashflowUpdateParams, type AddIncentiveRecipientArgs, AddIncentiveRecipientBuilder, type AddIncentiveRecipientIxArgs, type AddNavCashflowUpdateParams, type AprAccountBalanceResponse, type AprAccountYieldResponse, type AssetPriceOracleConfigIxArgs, type AssetPriceOracleConfigTxArgs, type AssetPriceRefreshTarget, type AssetRefreshResult, type AssetType, BALANCE_CHANGE_BASELINE_MAX_AGE_SECS, type Bankineco, type BasicAuthCredentials, type Bigintish, type BuildMarginfiWithdrawInteractionArgs, CONSENSUS_ORACLE_VARIANT, type CancelIncentiveProposalArgs, CancelIncentiveProposalBuilder, CancelJuniorTrancheWithdrawBuilder, type CancelJuniorTrancheWithdrawIxArgs, type CancelJuniorTrancheWithdrawTxArgs, ClaimIncentiveBuilder, type ClaimIncentiveIxArgs, type ClaimIncentiveTxArgs, 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, CreateIncentiveBuilder, type CreateIncentiveIxArgs, type CreateIncentiveTxArgs, 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_MINTS, 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, DistributeIncentiveBuilder, type DistributeIncentiveIxArgs, type DistributeIncentiveTxArgs, 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, type IncentiveRecipient, type IncentiveTotals, InitializeVaultRolesBuilder, type InitializeVaultRolesIxArgs, type InitializeVaultRolesTxArgs, type JuniorWithdrawalMode, JupiterPriceSource, type JupiterPriceSourceOptions, JupiterSwapBuilder, type JupiterSwapIxArgs, type JupiterSwapTxArgs, KaminoPositionProvider, LIVE_ORACLE_VARIANTS, LIVE_PRICE_REFRESH_INTERVAL_SECS, LOCAL_PROTOCOL_ADMIN, LargeBalanceChangeError, type LargeBalanceChangeViolation, type LiveConsensusOracleDepsOptions, LivePriceSource, type LivePriceSourceOptions, MAX_BALANCE_CHANGE_BPS, MAX_CONSENSUS_SIGNERS, MAX_INCENTIVE_RECIPIENTS, MAX_MANAGER_WITHDRAW_DESTINATIONS, MAX_PRICE_STALENESS_THRESHOLD_SECS, MIN_EXTERNAL_POSITION_SAMPLES, ManagerRedepositAssetBuilder, type ManagerRedepositAssetIxArgs, type ManagerRedepositAssetTxArgs, ManagerWithdrawAssetBuilder, type ManagerWithdrawAssetIxArgs, type ManagerWithdrawAssetTxArgs, MarginfiPositionProvider, type MintConfig, type MintIdentifier, type MintInfo, MintRegistry, type MintRegistryOptions, type MockYieldAccountConfig, MockYieldTracker, type MockYieldTrackerOptions, NEST_API_BASE_URL, NEST_RWA_SHARE_MINT, NEST_VAULT_SLUG, type NavAccountBalanceResponse, type NavAccountValueResponse, type NavCrankBlocker, type NavCrankBlockerReason, type NavCrankReadiness, type NavCrankResult, type NavPriceConfig, type NavYieldAccount, 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 PendingConsensusSignerSet, 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 ResolveExternalWithdrawArgs, type ResolvedExternalWithdraw, 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, type SetIncentiveLimitsArgs, SetIncentiveLimitsBuilder, SetManagerWithdrawDestinationBuilder, type SetManagerWithdrawDestinationIxArgs, type SetManagerWithdrawDestinationTxArgs, SetProtocolFeeBuilder, type SetProtocolFeeIxArgs, type SetProtocolFeeTxArgs, SetVaultConfigBuilder, type SetVaultConfigIxArgs, type SetVaultConfigTxArgs, type SettleVaultParams, type SettleVaultResult, type SettlementSimulation, type SettlementSimulationSnapshot, type SimulateDryRunSettlementParams, type SimulateSettlementArgs, type SimulatedShareClass, SquadsProposalExecutionSimulationError, type SquadsWalletRouteConfig, type StaleBalanceChangeBypass, StaticPositionProvider, SubmitIncentiveBuilder, type SubmitIncentiveIxArgs, type SubmitIncentiveTxArgs, TOKEN_PROGRAM, TOKEN_PROGRAM_ID, type TimelockSettlementKind, type TimelockSettlementOptions, type TimelockSettlementRecord, TimelockSettlementService, type TimelockSettlementSummary, type TrackedAccountValue, 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 VaultIncentiveAccount, type VaultIncentiveAccountData, 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 WithdrawProtocolFeesIxArgs, type WithdrawProtocolFeesTxArgs, WithdrawalQueueService, type WithdrawalQueueSnapshot, type YieldAccount, type YieldAccountSnapshot, type YieldCalculationLog, type YieldCashflow, type YieldPaymentResponse, type YieldPaymentSnapshot, type YieldTracker, type YieldValuationModel, accountingUnitPriceToUsd, addCashflowUpdate, applyEffectiveApy, assertNoLargeBalanceChanges, assertNoUnconfirmedYieldPayments, buildHoldingUpdate, buildMarginfiWithdrawInteraction, buildUpdates, coerceBool, collectSamples, confirmYieldPayment, createAccount, createLiveConsensusOracleDeps, createRpcFromConnection, createTokenMint, createTokenMintIxs, createVaultClient, createYieldPayment, dateToStr, decodePendingConsensusSigners, defaultKeypairPath, deleteAccount, discoverVaultsForSigner, fetchExternalPositions, fetchNestTokenPrice, fetchReceiptMints, filterTargetHoldings, findLargeBalanceChanges, findSquadsWalletRoute, formatSettlementSimulation, fromUiAmount, gatherPricingInputs, getAccount, getAccounts, getAprYield, getBalance, getCashflows, getIncentiveRecipientShareAtas, getIncentiveRecipients, getIncentiveReportRecipients, getIncentiveTotals, getNavValue, getRpcUrl, getTotalOutstandingYield, getTotalTrackedValue, getTotalYield, getTrackedValue, getVaultProgramId, getYield, getYieldPayments, indexConfigByMint, isNavAccountBalance, isNavAccountValue, isNavYieldAccount, isVaultEnv, keypairAddress, loadKeypair, logProspectiveApy, makeProvider, mintTokensTo, mints, mostFrequent, parseExternalLiquidityRefs, planRebalance, prepareVaultTransaction, priceInAccountingUnit, readI64LE, readSplMintSupply, refreshLiveOraclePrices, resolveExternalWithdraw, resolveKeypairPath, resolveSquadsWalletRoute, resolveTrackedAmounts, roundToNextUtcMidnight, runLiveConsensusOracle, selectReportableHoldings, settleVault, signerInOracleData, simulateConsensusOracleSettlement, simulateDryRunSettlement, simulateSquadsProposalExecution, sumPositionsByMint, systemClock, toBigInt, toUiAmount, toWeb3AccountMeta, trackedValueFromResponse, updateAccount, updateDynamicApr, validateSquadsWalletRoutes, variantName, vaultAuthorityForWallet, withDiscoveredYieldAccounts };

package/dist/index.js

@@ -611,7 +611,7 @@ var require_transaction = __commonJS({
         searchTransactionHistory: true
       })).value[0];
     }
-    async function sendVersionedTransaction({ connection, payer, instructions: instructions2, lookupTables }) {
+    async function sendVersionedTransaction({ connection, payer, instructions: instructions2, lookupTables, skipPreflight = true }) {
       const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash("confirmed");
       const lookupTableAccounts = await fetchLookupTables3(connection, lookupTables);
       const message2 = new web3_js_1.TransactionMessage({
@@ -622,9 +622,12 @@ var require_transaction = __commonJS({
       const tx = new web3_js_1.VersionedTransaction(message2);
       tx.sign([payer]);
       const signature = await connection.sendRawTransaction(tx.serialize(), {
-        skipPreflight: true
+        skipPreflight
       });
-      await connection.confirmTransaction({ signature, blockhash, lastValidBlockHeight }, "confirmed");
+      const confirmation = await connection.confirmTransaction({ signature, blockhash, lastValidBlockHeight }, "confirmed");
+      if (confirmation.value.err) {
+        throw new Error(`Transaction ${signature} failed: ${JSON.stringify(confirmation.value.err)}`);
+      }
       return signature;
     }
   }
@@ -1412,7 +1415,12 @@ var require_positions = __commonJS({
       return out;
     }
     async function createMarginfiReadClient2(connection, preloadedBankAddresses = []) {
-      return marginfi_client_v2_1.MarginfiClient.fetch((0, marginfi_client_v2_1.getConfig)("production"), void 0, connection, { preloadedBankAddresses });
+      return marginfi_client_v2_1.MarginfiClient.fetch((0, marginfi_client_v2_1.getConfig)("production"), void 0, connection, {
+        preloadedBankAddresses,
+        // Balance readers use on-chain shares and bank addresses, not metadata.
+        // An explicit map skips the SDK's optional bank/staked-bank cache downloads.
+        bankMetadataMap: {}
+      });
     }
     async function readMarginfiBankBalance2(client, marginfiAccount, marginfiBank) {
       const account = await marginfi_client_v2_1.MarginfiAccountWrapper.fetch(marginfiAccount, client);
@@ -2681,12 +2689,11 @@ var require_constants4 = __commonJS({
   "../jupiter/dist/constants.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.DEFAULT_EXCLUDED_DEXES = exports2.DEFAULT_MAX_ACCOUNTS = exports2.DEFAULT_SLIPPAGE_BPS = exports2.JUPITER_BALANCES_API_URL = exports2.JUPITER_PRICE_API_URL = exports2.JUPITER_API_URL = exports2.JUPITER_V6_PROGRAM_ID = void 0;
+    exports2.DEFAULT_EXCLUDED_DEXES = exports2.DEFAULT_MAX_ACCOUNTS = exports2.DEFAULT_SLIPPAGE_BPS = exports2.JUPITER_PRICE_API_URL = exports2.JUPITER_API_URL = exports2.JUPITER_V6_PROGRAM_ID = void 0;
     var kit_1 = require("@solana/kit");
     exports2.JUPITER_V6_PROGRAM_ID = (0, kit_1.address)("JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4");
     exports2.JUPITER_API_URL = "https://lite-api.jup.ag";
     exports2.JUPITER_PRICE_API_URL = `${exports2.JUPITER_API_URL}/price/v3`;
-    exports2.JUPITER_BALANCES_API_URL = `${exports2.JUPITER_API_URL}/ultra/v1/balances`;
     exports2.DEFAULT_SLIPPAGE_BPS = 500;
     exports2.DEFAULT_MAX_ACCOUNTS = 20;
     exports2.DEFAULT_EXCLUDED_DEXES = [
@@ -2772,68 +2779,6 @@ var require_api = __commonJS({
   }
 });
 
-// ../jupiter/dist/balancesApi.js
-var require_balancesApi = __commonJS({
-  "../jupiter/dist/balancesApi.js"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.fetchJupiterWalletBalances = fetchJupiterWalletBalances2;
-    exports2.fetchWalletBalancesFromRpc = fetchWalletBalancesFromRpc2;
-    var web3_js_1 = require("@solana/web3.js");
-    var spl_token_1 = require("@solana/spl-token");
-    var constants_1 = require_constants4();
-    async function fetchJupiterWalletBalances2(owner, opts = {}) {
-      const baseUrl = opts.baseUrl ?? constants_1.JUPITER_BALANCES_API_URL;
-      const fetchFn = opts.fetchFn ?? fetch;
-      const res = await fetchFn(`${baseUrl}/${owner.toString()}`);
-      if (!res.ok) {
-        throw new Error(`Jupiter balances API ${res.status}`);
-      }
-      const body = await res.json();
-      if (!body || typeof body !== "object") {
-        throw new Error("Jupiter balances API returned a non-object body");
-      }
-      const out = {};
-      for (const [key, value] of Object.entries(body)) {
-        if (key === "SOL")
-          continue;
-        if (!value || typeof value !== "object")
-          continue;
-        const amount = value.amount;
-        if (amount === void 0 || amount === null)
-          continue;
-        try {
-          const raw = BigInt(String(amount));
-          if (raw > 0n)
-            out[key] = raw;
-        } catch {
-        }
-      }
-      return out;
-    }
-    async function fetchWalletBalancesFromRpc2(connection, owner) {
-      const ownerPk = owner instanceof web3_js_1.PublicKey ? owner : new web3_js_1.PublicKey(owner.toString());
-      const out = {};
-      for (const programId of [spl_token_1.TOKEN_PROGRAM_ID, spl_token_1.TOKEN_2022_PROGRAM_ID]) {
-        const { value } = await connection.getParsedTokenAccountsByOwner(ownerPk, {
-          programId: new web3_js_1.PublicKey(programId)
-        });
-        for (const { account } of value) {
-          const info = account.data.parsed?.info;
-          const mint = info?.mint;
-          const amount = info?.tokenAmount?.amount;
-          if (!mint || amount === void 0)
-            continue;
-          const raw = BigInt(amount);
-          if (raw > 0n)
-            out[mint] = (out[mint] ?? 0n) + raw;
-        }
-      }
-      return out;
-    }
-  }
-});
-
 // ../jupiter/dist/extract.js
 var require_extract = __commonJS({
   "../jupiter/dist/extract.js"(exports2) {
@@ -3185,7 +3130,6 @@ var require_dist3 = __commonJS({
     };
     Object.defineProperty(exports2, "__esModule", { value: true });
     __exportStar(require_api(), exports2);
-    __exportStar(require_balancesApi(), exports2);
     __exportStar(require_client(), exports2);
     __exportStar(require_constants4(), exports2);
     __exportStar(require_priceApi(), exports2);
@@ -3297,7 +3241,6 @@ __export(index_exports, {
   IDLE_RESERVE_TARGET_BPS: () => IDLE_RESERVE_TARGET_BPS,
   IdleLiquidityService: () => IdleLiquidityService,
   InitializeVaultRolesBuilder: () => InitializeVaultRolesBuilder,
-  JupiterBalanceSource: () => JupiterBalanceSource,
   JupiterPriceSource: () => JupiterPriceSource,
   JupiterSwapBuilder: () => JupiterSwapBuilder,
   KaminoPositionProvider: () => KaminoPositionProvider,
@@ -16376,8 +16319,9 @@ var TransactionClient = class {
 
 // src/client/client.ts
 var VaultClient = class {
-  constructor(provider, programId = VAULT_PROGRAM_ID) {
+  constructor(provider, programId = VAULT_PROGRAM_ID, options = {}) {
     this.provider = provider;
+    this.skipSimulation = options.skipSimulation ?? false;
     const idl = { ...IDL, address: programId };
     this.program = new import_core18.Program(idl, provider);
     this.pda = new PdaClient((0, import_kit9.address)(this.program.programId.toBase58()));
@@ -16410,13 +16354,20 @@ var VaultClient = class {
     const signature = await this.provider.connection.sendRawTransaction(
       tx.serialize(),
       {
-        skipPreflight: false
+        skipPreflight: this.skipSimulation
       }
     );
-    await this.provider.connection.confirmTransaction(
+    const confirmation = await this.provider.connection.confirmTransaction(
       { signature, blockhash, lastValidBlockHeight },
       "confirmed"
     );
+    if (confirmation.value.err) {
+      throw new Error(
+        `Transaction ${signature} failed: ${JSON.stringify(
+          confirmation.value.err
+        )}`
+      );
+    }
     this.applyCacheInvalidations(plan);
     return signature;
   }
@@ -16526,7 +16477,8 @@ function createVaultClient(env, opts = {}) {
   });
   const client = new VaultClient(
     provider,
-    opts.programId ?? getVaultProgramId(env)
+    opts.programId ?? getVaultProgramId(env),
+    { skipSimulation: opts.skipSimulation }
   );
   return {
     env,
@@ -17720,7 +17672,6 @@ function evaluateBalanceChanges(vaultState, updates, thresholdBps, nowSecs) {
       valueChange: valueNumerator / amountScale,
       tvl,
       thresholdBps,
-      walletAmount: update.walletAmount,
       lpAmount: update.lpAmount,
       trackedPrincipalAmount: update.trackedPrincipalAmount,
       trackedValueAmount: update.trackedValueAmount,
@@ -17782,10 +17733,7 @@ function assertNoLargeBalanceChanges(vault, vaultState, updates, nowSecs, log =
         violation.decimals
       )}, value_change=${violation.valueChange} accounting_base_units (${percentOfTvl} of TVL ${violation.tvl} accounting_base_units; threshold=${formatBpsAsPercent(
         violation.thresholdBps
-      )}), sources=[wallet=${formatTokenAmount(
-        violation.walletAmount,
-        violation.decimals
-      )} lp=${formatTokenAmount(
+      )}), sources=[lp=${formatTokenAmount(
         violation.lpAmount,
         violation.decimals
       )} tracked=${formatTokenAmount(
@@ -17988,50 +17936,30 @@ function simulateConsensusOracleSettlement(args) {
   } catch (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,
-          navContributions,
-          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
-          )}`
-        );
-      }
+    const requiresLossesEnabled = blocker.includes("LossesDisabled");
+    const requiresMaxApyDisabled = blocker.includes("MaxApyExceeded");
+    if (requiresLossesEnabled || requiresMaxApyDisabled) {
+      const projection = simulateConsensusOracleSettlement({
+        ...args,
+        vault: {
+          ...args.vault,
+          lossesEnabled: requiresLossesEnabled ? true : args.vault.lossesEnabled,
+          config: {
+            ...args.vault.config,
+            apy: {
+              ...apyConfig,
+              maxApyBps: requiresMaxApyDisabled ? 0 : apyConfig.maxApyBps
+            }
+          }
+        }
+      });
+      return {
+        ...projection,
+        canSettle: false,
+        blockers: [...blockers, ...projection.blockers],
+        projectionRequiresLossesEnabled: projection.projected ? requiresLossesEnabled || projection.projectionRequiresLossesEnabled : void 0,
+        projectionRequiresMaxApyDisabled: projection.projected ? requiresMaxApyDisabled || projection.projectionRequiresMaxApyDisabled : void 0
+      };
     }
     return {
       nowTs: args.nowTs,
@@ -18832,6 +18760,11 @@ function formatSettlementSimulation(simulation) {
     );
   }
   if (simulation.projected) {
+    if (simulation.projectionRequiresLossesEnabled) {
+      lines.push(
+        "    hypothetical projection with losses enabled (losses_enabled=true):"
+      );
+    }
     if (simulation.projectionRequiresMaxApyDisabled) {
       lines.push("    projection with max APY disabled (max_apy_bps=0):");
     }
@@ -18977,7 +18910,6 @@ async function buildHoldingUpdate(yieldTracker, entry, inputs) {
     }
     usd = accountingUnitPriceToUsd(price, inputs.baseUsd, inputs.assetDecimals);
   }
-  const walletAmount = inputs.walletBalances[mintKey] ?? 0n;
   const lpAmount = inputs.lpByMint.get(mintKey) ?? 0n;
   const { trackedValueAmount, principalAmount, yieldAmount } = await resolveTrackedAmounts(
     yieldTracker,
@@ -18990,12 +18922,11 @@ async function buildHoldingUpdate(yieldTracker, entry, inputs) {
     decimals: holding.decimals,
     usdPrice: usd,
     price,
-    walletAmount,
     lpAmount,
     yieldAmount,
     trackedPrincipalAmount: principalAmount,
     trackedValueAmount,
-    externalAmount: walletAmount + lpAmount + trackedValueAmount
+    externalAmount: lpAmount + trackedValueAmount
   };
 }
 async function resolveTrackedAmounts(yieldTracker, cfg, decimals) {
@@ -19091,7 +19022,6 @@ async function refreshLiveOraclePrices({
 var import_common48 = __toESM(require_dist());
 async function gatherPricingInputs(deps, target, vaultState, reportableHoldings, log = () => {
 }) {
-  const manager = (0, import_common48.fromWeb3Pk)(vaultState.roles.manager);
   const consensusMints = reportableHoldings.filter(
     ({ holding }) => variantName2(holding.priceOracleType).toLowerCase() === CONSENSUS_ORACLE_VARIANT
   ).map(({ holding }) => (0, import_common48.fromWeb3Pk)(holding.mint));
@@ -19112,11 +19042,9 @@ async function gatherPricingInputs(deps, target, vaultState, reportableHoldings,
       `no USD price for base asset ${baseMint} (cannot denominate prices)`
     );
   }
-  const walletBalances = await deps.balanceSource.fetchBalances(manager);
   const lpByMint = await fetchExternalPositions(
     deps,
     target,
-    manager,
     vaultState,
     log
   );
@@ -19124,12 +19052,11 @@ async function gatherPricingInputs(deps, target, vaultState, reportableHoldings,
     assetDecimals: vaultState.config.assetDecimals,
     baseUsd,
     usdPrices,
-    walletBalances,
     lpByMint,
     configByMint: indexConfigByMint(target.holdings)
   };
 }
-async function fetchExternalPositions(deps, target, manager, vaultState, log = () => {
+async function fetchExternalPositions(deps, target, vaultState, log = () => {
 }) {
   if (!deps.externalPositions) return /* @__PURE__ */ new Map();
   const configRefs = (target.holdings ?? []).flatMap(
@@ -19150,7 +19077,6 @@ async function fetchExternalPositions(deps, target, manager, vaultState, log = (
     async () => sumPositionsByMint(
       await provider.positionsFor({
         vault: target.vault,
-        manager,
         refs: mergedRefs
       })
     ),
@@ -19302,7 +19228,7 @@ async function settleVault2({
   log(`vault ${vault}: submitting ${updates.length} consensus asset update(s)`);
   for (const update of updates) {
     log(
-      `  holding #${update.holdingIndex} ${update.mint}: price=${update.price} external_amount=${update.externalAmount} [wallet=${update.walletAmount} lp=${update.lpAmount} tracked=${update.trackedValueAmount} principal=${update.trackedPrincipalAmount} yield=${update.yieldAmount}]`
+      `  holding #${update.holdingIndex} ${update.mint}: price=${update.price} external_amount=${update.externalAmount} [lp=${update.lpAmount} tracked=${update.trackedValueAmount} principal=${update.trackedPrincipalAmount} yield=${update.yieldAmount}]`
     );
   }
   await logProspectiveApy({
@@ -19313,6 +19239,24 @@ async function settleVault2({
     nowSecs,
     log
   });
+  try {
+    const simulation = await simulateDryRunSettlement({
+      client,
+      signer,
+      vault,
+      vaultState,
+      updates,
+      nowSecs
+    });
+    log(
+      `vault ${vault}: expected settlement using this report and current consensus`
+    );
+    for (const line of formatSettlementSimulation(simulation)) log(line);
+  } catch (error) {
+    log(
+      `vault ${vault}: expected share prices unavailable (${error instanceof Error ? error.message : String(error)})`
+    );
+  }
   await assertNoUnconfirmedYieldPayments(yieldTracker, target);
   const updateSignature = await oracle.updateAssetConsensusPrice(
     signer,
@@ -19471,34 +19415,6 @@ var LivePriceSource = class {
   }
 };
 
-// src/services/consensusOracle/sources/jupiterBalanceSource.ts
-var import_jupiter2 = __toESM(require_dist3());
-var JupiterBalanceSource = class {
-  constructor(connection, opts = {}) {
-    this.connection = connection;
-    this.rpcOnly = opts.rpcOnly ?? false;
-    this.log = opts.log ?? (() => {
-    });
-    this.apiOptions = { baseUrl: opts.baseUrl, fetchFn: opts.fetchFn };
-  }
-  async fetchBalances(owner) {
-    if (!this.rpcOnly) {
-      try {
-        const fromJup = await (0, import_jupiter2.fetchJupiterWalletBalances)(
-          owner,
-          this.apiOptions
-        );
-        if (Object.keys(fromJup).length > 0) return fromJup;
-      } catch (err) {
-        this.log(
-          `Jupiter balances failed for ${owner}, falling back to RPC: ${err instanceof Error ? err.message : String(err)}`
-        );
-      }
-    }
-    return (0, import_jupiter2.fetchWalletBalancesFromRpc)(this.connection, owner);
-  }
-};
-
 // src/services/consensusOracle/positions/externalPositions.ts
 var ExternalPositionRegistry = class {
   constructor(providers = [], log = () => {
@@ -19836,10 +19752,6 @@ function createLiveConsensusOracleDeps(connection, opts = {}) {
   });
   const deps = {
     priceSource: new LivePriceSource(),
-    balanceSource: new JupiterBalanceSource(connection, {
-      rpcOnly: opts.rpcOnly ?? false,
-      log
-    }),
     yieldTracker: {
       async getAccountNamesForVault(vault) {
         const accounts2 = await getAccounts();
@@ -20079,7 +19991,6 @@ async function runLiveConsensusOracle(env, oracleSigner, opts = {}) {
     client,
     createLiveConsensusOracleDeps(client.provider.connection, {
       log: opts.log,
-      rpcOnly: opts.rpcOnly,
       includeExternalPositions: opts.includeExternalPositions
     })
   );
@@ -20172,7 +20083,11 @@ var ExternalLiquidityIntegrityService = class {
     const minAmountUi = opts.minAmountUi ?? DEFAULT_MIN_AMOUNT_UI;
     const targetLocalBps = opts.targetLocalBps ?? DEFAULT_TARGET_LOCAL_BPS;
     const rebalanceBandBps = opts.rebalanceBandBps ?? DEFAULT_REBALANCE_BAND_BPS;
-    if (dryRun) log("DRY RUN \u2014 rebalances will be simulated, not sent");
+    if (dryRun) {
+      log(
+        this.client.skipSimulation ? "DRY RUN \u2014 rebalances will be built; simulations skipped; nothing sent" : "DRY RUN \u2014 rebalances will be simulated, not sent"
+      );
+    }
     log(`Minimum rebalance: ${minAmountUi} token(s) (~$${minAmountUi})`);
     log(`Target local share: ${targetLocalBps / 100}% of each holding`);
     log(
@@ -20286,7 +20201,10 @@ var ExternalLiquidityIntegrityService = class {
           continue;
         }
         log(
-          `Vault ${vault} slot ${slot.index}: ${dryRun ? "simulating " : ""}${plan.direction} of ${formatUi(plan.amount, decimals)} ${mintAddress} (local ${formatUi(localAmount, decimals)} \u2192 target ${formatUi(
+          `Vault ${vault} slot ${slot.index}: ${dryRun ? this.client.skipSimulation ? "building " : "simulating " : ""}${plan.direction} of ${formatUi(
+            plan.amount,
+            decimals
+          )} ${mintAddress} (local ${formatUi(localAmount, decimals)} \u2192 target ${formatUi(
             plan.targetLocal,
             decimals
           )})`
@@ -20379,6 +20297,12 @@ var ExternalLiquidityIntegrityService = class {
       ...cpiRefs.lookupTables?.length ? { lookupTables: cpiRefs.lookupTables } : {}
     };
     if (dryRun) {
+      if (this.client.skipSimulation) {
+        log(
+          `Vault ${vault} slot ${slot.index}: built; simulation skipped; no transaction sent`
+        );
+        return {};
+      }
       const sim = await this.client.simulateTransaction(hwManager, plan);
       for (const line of sim.logs ?? []) {
         log(`  | ${line}`);
@@ -20400,7 +20324,7 @@ var import_kit16 = require("@solana/kit");
 var import_spl_token20 = require("@solana/spl-token");
 var import_web330 = require("@solana/web3.js");
 var import_common54 = __toESM(require_dist());
-var import_jupiter3 = __toESM(require_dist3());
+var import_jupiter2 = __toESM(require_dist3());
 var IDLE_RESERVE_FLOOR_BPS = 400;
 var IDLE_RESERVE_TARGET_BPS = 500;
 var DEFAULT_SLIPPAGE_BPS = 30;
@@ -20492,7 +20416,7 @@ var IdleLiquidityService = class {
       log(`Vault ${vault}: ${reason} \u2014 skipping`);
       return { ...base, status: "insufficient-pst", reason };
     }
-    const jupiter = new import_jupiter3.JupiterSwapClient(
+    const jupiter = new import_jupiter2.JupiterSwapClient(
       (0, import_kit16.createSolanaRpc)(this.client.provider.connection.rpcEndpoint)
     );
     let quote;
@@ -20755,26 +20679,30 @@ var IdleLiquidityService = class {
     }).compileToV0Message(lookupTableAccounts);
     const transaction = new import_web330.VersionedTransaction(message2);
     transaction.sign([hwManager]);
-    const simulation = await connection.simulateTransaction(transaction, {
-      sigVerify: true,
-      commitment: "confirmed"
-    });
-    if (simulation.value.err) {
-      for (const line of simulation.value.logs ?? []) log(`  | ${line}`);
-      throw new Error(
-        `simulation failed: ${JSON.stringify(simulation.value.err)}`
+    if (!this.client.skipSimulation) {
+      const simulation = await connection.simulateTransaction(transaction, {
+        sigVerify: true,
+        commitment: "confirmed"
+      });
+      if (simulation.value.err) {
+        for (const line of simulation.value.logs ?? []) log(`  | ${line}`);
+        throw new Error(
+          `simulation failed: ${JSON.stringify(simulation.value.err)}`
+        );
+      }
+      log(
+        `Vault ${vault}: simulation OK (${simulation.value.unitsConsumed ?? "?"} CU)`
       );
+    } else {
+      log(`Vault ${vault}: simulation skipped`);
     }
-    log(
-      `Vault ${vault}: simulation OK (${simulation.value.unitsConsumed ?? "?"} CU)`
-    );
     if (dryRun) {
       log(`Vault ${vault}: dry run \u2014 transaction NOT submitted`);
       return {};
     }
     const signature = await connection.sendRawTransaction(
       transaction.serialize(),
-      { skipPreflight: false, maxRetries: 5 }
+      { skipPreflight: this.client.skipSimulation, maxRetries: 5 }
     );
     const confirmation = await connection.confirmTransaction(
       { signature, blockhash, lastValidBlockHeight },
@@ -20998,7 +20926,7 @@ var TimelockSettlementService = class {
         }
         try {
           log(
-            `Vault ${vault}: ${dryRun ? "simulating" : "settling"} expired ${action.kind}`
+            `Vault ${vault}: ${dryRun ? this.client.skipSimulation ? "building" : "simulating" : "settling"} expired ${action.kind}`
           );
           const signature = await action.execute();
           summary.settled += 1;
@@ -21010,7 +20938,7 @@ var TimelockSettlementService = class {
             dryRun
           });
           log(
-            `Vault ${vault}: ${action.kind} ${dryRun ? "simulation passed" : `settled: ${signature}`}`
+            `Vault ${vault}: ${action.kind} ${dryRun ? this.client.skipSimulation ? "built; simulation skipped; no transaction sent" : "simulation passed" : `settled: ${signature}`}`
           );
         } catch (error) {
           summary.failed += 1;
@@ -21024,6 +20952,7 @@ var TimelockSettlementService = class {
   }
   async execute(fulfiller, plan, dryRun, log) {
     if (!dryRun) return this.client.sendTransaction(fulfiller, plan);
+    if (this.client.skipSimulation) return void 0;
     const simulation = await this.client.simulateTransaction(fulfiller, plan);
     for (const line of simulation.logs ?? []) log(`  | ${line}`);
     if (simulation.err) {
@@ -21087,7 +21016,6 @@ var import_common56 = __toESM(require_dist());
   IDLE_RESERVE_TARGET_BPS,
   IdleLiquidityService,
   InitializeVaultRolesBuilder,
-  JupiterBalanceSource,
   JupiterPriceSource,
   JupiterSwapBuilder,
   KaminoPositionProvider,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@perena/vault-sdk",
-  "version": "1.0.41",
+  "version": "1.0.42",
   "description": "Vault program helpers for Bankineco integrations.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -42,6 +42,7 @@
     "init-vault-atas": "tsx scripts/initVaultAtas.ts",
     "inspect": "tsx scripts/inspect.ts",
     "vault-data": "tsx scripts/fetchVaultData.ts",
+    "preview-oracle-update": "tsx scripts/previewOracleUpdate.ts",
     "simulate-withdraw": "tsx scripts/simulate-withdraw.ts",
     "simulate-message": "tsx scripts/simulate-message.ts",
     "run-external-liquidity-service": "tsx scripts/runExternalLiquidityService.ts",