@perena/vault-sdk 1.0.25 → 1.0.27

package/dist/index.d.ts

@@ -2,11 +2,14 @@ import * as _solana_kit from '@solana/kit';
 import { Address, ProgramDerivedAddressBump, Rpc, SolanaRpcApi, Instruction } from '@solana/kit';
 export { address } from '@solana/kit';
 import * as _solana_web3_js from '@solana/web3.js';
-import { PublicKey, Connection, Keypair, Transaction, TransactionInstruction } from '@solana/web3.js';
+import { PublicKey, Connection, Keypair, SimulatedTransactionResponse, Transaction, TransactionInstruction } from '@solana/web3.js';
 import * as _anchor_lang_core from '@anchor-lang/core';
 import { Program, IdlAccounts, BN, AnchorProvider } from '@anchor-lang/core';
 import * as common from 'common';
 import { BaseAccountClient, InstructionRefs, CustomAccountMeta, TransactionPlan, SingleInstructionBuilderService } from 'common';
+import { FetchJupiterUsdPricesOptions, FetchJupiterBalancesOptions } from 'jupiter';
+import { FetchNestVaultSharePriceOptions } from 'nest';
+export { NEST_API_BASE_URL } from 'nest';
 
 /** Bankineco program id (local). Hosts new vault instructions. */
 declare const VAULT_PROGRAM_ID: Address;
@@ -10146,7 +10149,9 @@ type Bankineco = {
                 "Holdings are addressed by their slot index (1 byte) to keep instruction data",
                 "small. To register a brand-new consensus holding, set `mint` to its mint",
                 "(and pass the matching `asset_mint` account); the created slot's index is used",
-                "and `holding_index` is ignored. For existing holdings leave `mint` as `None`."
+                "and `holding_index` is ignored. For existing holdings leave `mint` as `None`.",
+                "The price is authoritative only for ConsensusOracle holdings. Pyth and nested-vault",
+                "holdings use the report only for external_amount and retain their live-oracle price."
             ];
             "type": {
                 "kind": "struct";
@@ -11891,7 +11896,7 @@ type Bankineco = {
                     {
                         "name": "lossesEnabled";
                         "docs": [
-                            "Allows consensus-oracle NAV updates below the vault's current TVL."
+                            "Allows consensus-oracle NAV losses beyond the protocol's small-loss tolerance. Losses inside that tolerance settle without this flag."
                         ];
                         "type": {
                             "defined": {
@@ -15316,6 +15321,12 @@ declare class VaultClient {
      * Pass `extraSigners` for accounts created in the same tx (e.g. a new share mint).
      */
     sendTransaction(payer: Keypair, plan: VaultTransactionPlan, extraSigners?: Keypair[]): Promise<string>;
+    /**
+     * Build the same transaction {@link sendTransaction} would send, but run it
+     * through `simulateTransaction` instead. Nothing is signed or submitted, so
+     * this is safe to call with a keypair that is not the real signer.
+     */
+    simulateTransaction(payer: Keypair, plan: VaultTransactionPlan): Promise<SimulatedTransactionResponse>;
     applyCacheInvalidations(plan: VaultTransactionPlan): void;
     clearAllCache(): void;
 }
@@ -15864,10 +15875,20 @@ interface YieldPaymentSnapshot {
  * helpers for tests and local operation.
  */
 interface YieldTracker {
+    /** Account names tagged to a vault. Live prod discovery uses this automatically. */
+    getAccountNamesForVault?(vault: Address): Promise<string[]>;
     /** All payments for an account, including payments not yet confirmed. */
     getYieldPayments(accountName: string): Promise<YieldPaymentSnapshot[]>;
     /** Sum of oracle-safe outstanding yield across the named accounts. */
     getTotalOutstandingYield(accountNames: string[], start?: Date, end?: Date): Promise<number>;
+    /**
+     * Sum the external principal and confirmed-payment-adjusted outstanding yield
+     * across the named accounts. Both values are UI token amounts.
+     */
+    getTotalTrackedAmounts(accountNames: string[], start?: Date, end?: Date): Promise<{
+        principal: number;
+        outstandingYield: number;
+    }>;
 }
 /** Injectable wall clock (ms since epoch). Lets tests pin time deterministically. */
 interface Clock {
@@ -15896,6 +15917,15 @@ interface ConsensusOracleDeps {
     /** Optional; omitted ⇒ no yield accrual is folded in. */
     yieldTracker?: YieldTracker;
     clock?: Clock;
+    /**
+     * How many times external position NAV is read before reporting, and how
+     * many of those reads must succeed. Defaults to
+     * `EXTERNAL_POSITION_SAMPLES` / `MIN_EXTERNAL_POSITION_SAMPLES`.
+     */
+    externalPositionSampling?: {
+        samples?: number;
+        minSamples?: number;
+    };
 }
 /** Per-holding breakdown of what the service computed (and would/did push). */
 interface HoldingUpdatePreview {
@@ -15911,7 +15941,9 @@ interface HoldingUpdatePreview {
     lpAmount: bigint;
     /** Accrued yield attributed to this holding (base units). */
     yieldAmount: bigint;
-    /** Total external balance pushed = wallet + lp + yield. */
+    /** Yield-tracker principal attributed to this holding (base units). */
+    trackedPrincipalAmount: bigint;
+    /** Total external balance pushed = wallet + LP + tracked principal + yield. */
     externalAmount: bigint;
 }
 interface VaultOracleResult {
@@ -16000,6 +16032,25 @@ interface ConsensusHoldingSimulation {
     wouldUpdateHolding: boolean;
     reason?: string;
 }
+/**
+ * Per-holding NAV attribution: what each holding contributed to gross NAV
+ * before and after consensus landed. `delta` sums to the gross-NAV change.
+ */
+interface HoldingNavContribution {
+    holdingIndex: number;
+    mint: Address;
+    decimals: number;
+    /** Vault-owned token-account balance (base units); unchanged by consensus. */
+    localAmount: bigint;
+    externalAmountBefore: bigint;
+    externalAmountAfter: bigint;
+    priceBefore: bigint;
+    priceAfter: bigint;
+    /** localAmount + external, priced at `price`, in the vault's accounting unit. */
+    valueBefore: bigint;
+    valueAfter: bigint;
+    delta: bigint;
+}
 interface SimulatedShareClass {
     value: bigint;
     totalSupply: bigint;
@@ -16027,6 +16078,8 @@ interface SettlementSimulation {
     blockers: string[];
     warnings: string[];
     consensus: ConsensusHoldingSimulation[];
+    /** Per-holding attribution of the gross-NAV change consensus would cause. */
+    navContributions: HoldingNavContribution[];
     grossNav?: bigint;
     settledAccountingNav?: bigint;
     current: SettlementSimulationSnapshot;
@@ -16059,44 +16112,258 @@ interface VaultPricingInputs {
     configByMint: Map<string, ConsensusOracleHoldingConfig>;
 }
 
+declare const SYSTEM_PROGRAM = "11111111111111111111111111111111";
+/** `PriceOracleType` discriminants, in on-chain declaration order. */
+declare const PRICE_ORACLE_TYPES_BY_INDEX: string[];
+declare const CONSENSUS_ORACLE_VARIANT = "consensusoracle";
+/** Oracle types priced by a permissionless on-chain source, not by this service. */
+declare const LIVE_ORACLE_VARIANTS: Set<string>;
+/** Every oracle type whose external amount this service reports. */
+declare const REPORTABLE_ORACLE_VARIANTS: Set<string>;
+/** Live (Pyth / nested-vault) prices are refreshed at least this often. */
+declare const LIVE_PRICE_REFRESH_INTERVAL_SECS: bigint;
+/**
+ * Fallback when the vault does not configure `priceStalenessThresholdSecs`,
+ * as a bigint for comparison against decoded on-chain values.
+ */
+declare const DEFAULT_PRICE_STALENESS_SECS: bigint;
+/**
+ * External position NAV is read this many times back to back, and the most
+ * frequent value per mint is reported. Matches the 5-of-which-4-must-succeed
+ * shape used by the Kamino/Marginfi yield oracles in `bankineco-services`.
+ */
+declare const EXTERNAL_POSITION_SAMPLES = 5;
+declare const MIN_EXTERNAL_POSITION_SAMPLES = 4;
+declare const ORACLE_ENTRY_SIZE = 272;
+declare const ORACLE_ENTRIES_OFFSET = 40;
+declare const ORACLE_SETTLED_NAV_TS_OFFSET = 8;
+declare const MAX_CONSENSUS_SIGNERS = 4;
+
+/** Read a little-endian i64 from a number[] byte array at the given offset. */
+declare function readI64LE(data: number[], offset: number): bigint;
+/** SPL Token and Token-2022 share the base Mint layout; supply is bytes 36..44. */
+declare function readSplMintSupply(data: Buffer | Uint8Array): bigint;
+/** True when `signerBytes` occupies one of the oracle's signer entry slots. */
+declare function signerInOracleData(data: number[], signerBytes: Uint8Array): boolean;
+
+/** Name of an Anchor enum variant, e.g. `{ consensusOracle: {} }` → "consensusOracle". */
+declare function variantName(value: unknown): string;
+/** Decode a PodBool (which arrives in a few shapes depending on the codec). */
+declare function coerceBool(value: unknown): boolean;
+declare function toBigInt(value: unknown): bigint;
+
+/** Oracle-priced holdings whose external amount can be consensus-reported. */
+declare function selectReportableHoldings(holdings: readonly DecodedHolding[], excludedMints?: ReadonlySet<string>): ConsensusHoldingEntry[];
+/** Drop per-holding sourcing config for receipt mints as well as their updates. */
+declare function filterTargetHoldings(target: ConsensusOracleTarget, excludedMints: ReadonlySet<string>): ConsensusOracleTarget;
+/** Index per-holding config by mint (base58). */
+declare function indexConfigByMint(holdings?: ConsensusOracleHoldingConfig[]): Map<string, ConsensusOracleHoldingConfig>;
+/** Sum external positions by mint (base58 → base units). */
+declare function sumPositionsByMint(positions: ExternalPosition[]): Map<string, bigint>;
+/**
+ * Parse the vault's on-chain ExternalLiquiditySlot array into ExternalPositionRefs.
+ * Layout (C repr / bytemuck):
+ *   byte 0      : discriminant (0 = None, 1 = Marginfi)
+ *   bytes 8–40  : userAccount pubkey
+ *
+ * No mint is specified here — the MarginfiPositionProvider will iterate all
+ * active balances on the account and return positions keyed by bank mint.
+ */
+declare function parseExternalLiquidityRefs(vaultState: DecodedVault): ExternalPositionRef[];
+
+/** Price conversions between USD spot and the vault's accounting unit. */
+/** Re-denominate a USD price into the vault's accounting unit, fixed-point. */
+declare function priceInAccountingUnit(usd: number, baseUsd: number, assetDecimals: number): bigint;
+/** Inverse of {@link priceInAccountingUnit}, for logging live-oracle holdings. */
+declare function accountingUnitPriceToUsd(price: bigint, baseUsd: number, assetDecimals: number): number;
+
+/**
+ * Repeated-read sampling.
+ *
+ * Live protocol reads (Kamino/Marginfi position NAV) can come back mid-update
+ * or against a lagging RPC node, so a single read is not trustworthy enough to
+ * report on-chain. The fix used elsewhere in this repo — see
+ * `bankineco-services/src/oracle/updateKaminoVaultPendingYield.ts` — is to read
+ * the value several times back to back and keep the most frequent answer,
+ * failing closed when no value is observed more than once.
+ */
+/**
+ * The most frequently occurring value. Throws when `values` is empty or when
+ * every value is distinct — a single unrepeated reading is not consensus.
+ */
+declare function mostFrequent<T>(values: readonly T[], keyOf?: (value: T) => string): T;
+interface CollectSamplesOptions {
+    /** How many reads to attempt, back to back. */
+    samples: number;
+    /** Minimum successful reads required, else the whole read fails. */
+    minSamples: number;
+    /** Called with each failed attempt; failures are otherwise skipped. */
+    onError?: (err: unknown, attempt: number) => void;
+}
+/**
+ * Run `read` `samples` times in sequence, discarding failures. Throws when
+ * fewer than `minSamples` reads succeed.
+ */
+declare function collectSamples<T>(read: () => Promise<T>, { samples, minSamples, onError }: CollectSamplesOptions): Promise<T[]>;
+
+/**
+ * Dry-run counterpart to `settlement.ts`: read the canonical share supplies and
+ * replay the exact on-chain settlement path locally, without sending anything.
+ */
+
+interface SimulateDryRunSettlementParams {
+    client: VaultClient;
+    signer: Keypair;
+    vault: Address;
+    vaultState: DecodedVault;
+    updates: HoldingUpdatePreview[];
+    nowSecs: bigint;
+}
+declare function simulateDryRunSettlement({ client, signer, vault, vaultState, updates, nowSecs, }: SimulateDryRunSettlementParams): Promise<SettlementSimulation>;
+
+declare function buildUpdates(yieldTracker: YieldTracker | undefined, reportableHoldings: ConsensusHoldingEntry[], inputs: VaultPricingInputs): Promise<HoldingUpdatePreview[]>;
+declare function buildHoldingUpdate(yieldTracker: YieldTracker | undefined, entry: ConsensusHoldingEntry, inputs: VaultPricingInputs): Promise<HoldingUpdatePreview>;
+/** Tracked external principal + outstanding yield attributed to a holding. */
+declare function resolveTrackedAmounts(yieldTracker: YieldTracker | undefined, cfg: ConsensusOracleHoldingConfig | undefined, decimals: number): Promise<{
+    principalAmount: bigint;
+    yieldAmount: bigint;
+}>;
+
 /**
- * {@link PriceSource} backed by the Jupiter price API.
+ * Step 1 of a pass: keep active permissionless price sources warm so they
+ * cannot block the NAV crank after the consensus report lands. Prices are
+ * refreshed at least once per hour, or at the vault's shorter staleness
+ * interval when configured.
+ */
+
+interface RefreshLiveOraclePricesParams {
+    oracle: OracleService;
+    signer: Keypair;
+    vault: Address;
+    vaultState: DecodedVault;
+    nowSecs: bigint;
+    log: (msg: string) => void;
+    dryRun: boolean;
+}
+/** 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).
  *
- * Mirrors the existing feed in `oracle-service/src/feeds/jupiter.ts`
- * (`GET /price/v3`, batched at 50 ids, small retry, reads `usdPrice`) but is
- * self-contained so `vault_sdk` keeps its lean dependency set.
+ * The provider is read {@link EXTERNAL_POSITION_SAMPLES} times back to back and
+ * the most frequent amount per mint is kept — a single read can land mid-update
+ * 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>>;
+
+/**
+ * Receipt mints issued by a vault are liabilities/shares, not underlying assets
+ * for its own NAV. They are excluded from reporting even when registered as
+ * consensus-priced holdings.
  */
 
-interface JupiterPriceSourceOptions {
-    /** Override the price endpoint (e.g. the keyed `api.jup.ag` host). */
-    baseUrl?: string;
-    /** Retry attempts per batch request. */
-    retries?: number;
-    /** Injectable fetch (for tests); defaults to global `fetch`. */
-    fetchFn?: typeof fetch;
+declare function fetchReceiptMints(client: VaultClient, vault: Address, vaultState: DecodedVault): Promise<Set<string>>;
+
+/**
+ * Settlement step: push the consensus report for all holdings, then crank NAV.
+ */
+
+interface SettleVaultResult {
+    updateSignature: string;
+    crankSignature?: string;
+    crankSkippedReason?: string;
+}
+interface SettleVaultParams {
+    client: VaultClient;
+    oracle: OracleService;
+    yieldTracker: YieldTracker | undefined;
+    signer: Keypair;
+    target: ConsensusOracleTarget;
+    updates: HoldingUpdatePreview[];
+    vaultState: DecodedVault;
+    nowSecs: bigint;
+    log: (msg: string) => void;
 }
+/** Push the consensus report for all holdings, then settle NAV. */
+declare function settleVault({ client, oracle, yieldTracker, signer, target, updates, vaultState, nowSecs, log, }: SettleVaultParams): Promise<SettleVaultResult>;
+interface LogProspectiveApyParams {
+    client: VaultClient;
+    vault: Address;
+    updates: HoldingUpdatePreview[];
+    vaultState: DecodedVault;
+    nowSecs: bigint;
+    log: (msg: string) => void;
+}
+/**
+ * Fetch the current settlement timestamp and log the APY implied by the
+ * prospective update, so MaxApyExceeded failures are diagnosable.
+ *
+ * NAV is expressed in the vault's accounting unit (scaled by assetDecimals).
+ * Mirrors `gross_nav_from_holdings`: consensus updates overlay their target
+ * slots, while live-priced and otherwise unchanged holdings retain their
+ * current price/external amount.
+ */
+declare function logProspectiveApy({ client, vault, updates, vaultState, nowSecs, log, }: LogProspectiveApyParams): Promise<void>;
+
+/**
+ * Discover which on-chain vaults a given keypair is a registered consensus
+ * oracle signer for.
+ */
+
+/**
+ * Fetches every vault and its oracle account, then filters by signer
+ * membership. Returns minimal `ConsensusOracleTarget` entries (no per-holding
+ * config); callers can overlay config from `targets.ts` if needed.
+ */
+declare function discoverVaultsForSigner(client: VaultClient, signer: Keypair, opts?: {
+    log?: (msg: string) => void;
+}): Promise<ConsensusOracleTarget[]>;
+
+/**
+ * Fail closed while any configured yield account has an unsettled payment.
+ * The payout must be confirmed only after it is visible in the same wallet
+ * balance source used by this service. Until then, no oracle update is safe.
+ */
+declare function assertNoUnconfirmedYieldPayments(yieldTracker: YieldTracker | undefined, target: ConsensusOracleTarget): Promise<void>;
+/**
+ * In production, yield accounts are tagged with their vault address. Attach
+ * newly discovered accounts to the base holding, while preserving explicit
+ * per-mint mappings supplied by config or CLI flags.
+ */
+declare function withDiscoveredYieldAccounts(yieldTracker: YieldTracker | undefined, target: ConsensusOracleTarget, vaultState: DecodedVault, excludedMints: ReadonlySet<string>, log: (msg: string) => void): Promise<ConsensusOracleTarget>;
+
+/**
+ * {@link PriceSource} adapter over the `jupiter` package's price API.
+ *
+ * The HTTP client (batching, retries, response shape) lives in
+ * `jupiter/src/priceApi.ts`; this file only binds it to the consensus-oracle
+ * interface.
+ */
+
+type JupiterPriceSourceOptions = FetchJupiterUsdPricesOptions;
 declare class JupiterPriceSource implements PriceSource {
-    private readonly baseUrl;
-    private readonly retries;
-    private readonly fetchFn;
+    private readonly opts;
     constructor(opts?: JupiterPriceSourceOptions);
     fetchUsdPrices(mints: Address[]): Promise<Record<string, number>>;
 }
 
-/** Nest's Perena vault-share price feed. */
+/**
+ * {@link PriceSource} adapter over the `nest` package's price API, bound to the
+ * Perena vault's Nest slug and share mint.
+ */
 
-declare const NEST_API_BASE_URL = "https://api.nest.credit/v1";
 declare const NEST_VAULT_SLUG = "nest-perena-vault";
 declare const NEST_RWA_SHARE_MINT: Address;
-interface FetchNestTokenPriceOptions {
-    baseUrl?: string;
-    fetchFn?: typeof fetch;
-}
-/**
- * Fetch the USD price of one Nest vault share. This is the price reader that
- * historically lived in bankineco-sdk's `nestUtils`; the vault SDK owns it now
- * because nested Nest shares are a consensus-oracle price source.
- */
+type FetchNestTokenPriceOptions = FetchNestVaultSharePriceOptions;
+/** Fetch the USD price of one share of the Perena vault on Nest. */
 declare function fetchNestTokenPrice(nestVaultSlug?: string, opts?: FetchNestTokenPriceOptions): Promise<number>;
 interface NestPriceSourceOptions extends FetchNestTokenPriceOptions {
     nestVaultSlug?: string;
@@ -16125,35 +16392,25 @@ declare class LivePriceSource implements PriceSource {
 }
 
 /**
- * {@link WalletBalanceSource} backed by the Jupiter "portfolio" / Ultra balances
- * API, with an on-chain RPC fallback.
- *
- *   Primary:  GET https://lite-api.jup.ag/ultra/v1/balances/{owner}
- *             → { "<mint>": { amount, uiAmount, slot, isFrozen }, "SOL": {…} }
- *   Fallback: `getParsedTokenAccountsByOwner` over the SPL Token and Token-2022
- *             programs, summed per mint.
+ * {@link WalletBalanceSource} adapter over the `jupiter` package's balances API.
  *
- * `amount` from Jupiter is already in raw base units, matching the on-chain
- * `external_amount` unit, so no decimal conversion is applied here.
+ * 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 {
-    baseUrl?: string;
-    fetchFn?: typeof fetch;
+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 baseUrl;
-    private readonly fetchFn;
     private readonly rpcOnly;
     private readonly log;
+    private readonly apiOptions;
     constructor(connection: Connection, opts?: JupiterBalanceSourceOptions);
     fetchBalances(owner: Address): Promise<Record<string, bigint>>;
-    private fetchFromJupiter;
-    private fetchFromRpc;
 }
 
 /**
@@ -16189,6 +16446,16 @@ declare class KaminoPositionProvider implements ExternalPositionProvider {
     positionsFor(ctx: ExternalPositionContext): Promise<ExternalPosition[]>;
 }
 
+/**
+ * {@link ExternalPositionProvider} adapter over the `marginfi` package's
+ * position readers.
+ *
+ * The Marginfi SDK usage and account layout parsing live in
+ * `marginfi/src/positions.ts`; this file maps `ExternalPositionRef`s onto them:
+ * a ref with an explicit `marginfiBank` reads that one bank, while a ref with
+ * only a `marginfiAccount` reports every non-zero balance on the account.
+ */
+
 declare class MarginfiPositionProvider implements ExternalPositionProvider {
     private readonly connection;
     private readonly log;
@@ -16196,31 +16463,6 @@ declare class MarginfiPositionProvider implements ExternalPositionProvider {
     positionsFor(ctx: ExternalPositionContext): Promise<ExternalPosition[]>;
 }
 
-interface LiveConsensusOracleDepsOptions {
-    log?: (msg: string) => void;
-    rpcOnly?: boolean;
-    includeExternalPositions?: boolean;
-}
-declare function createLiveConsensusOracleDeps(connection: Connection, opts?: LiveConsensusOracleDepsOptions): ConsensusOracleDeps;
-
-interface RunLiveConsensusOracleOptions extends RunOptions {
-    /** Override the RPC endpoint used for vault discovery, price updates, and NAV cranks. */
-    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;
-}
-/**
- * Full live consensus-oracle pass for one signer.
- *
- * Builds the vault client for `env`, discovers every vault where `oracleSigner`
- * is registered, updates consensus prices/external allocations, and cranks NAV.
- */
-declare function runLiveConsensusOracle(env: VaultEnv, oracleSigner: Keypair, opts?: RunLiveConsensusOracleOptions): Promise<RunSummary>;
-
 /**
  * In-memory mock of the bankineco yield tracker.
  *
@@ -16236,6 +16478,8 @@ declare function runLiveConsensusOracle(env: VaultEnv, oracleSigner: Keypair, op
  */
 
 interface MockYieldAccountConfig {
+    /** Optional vault address used by production-style account discovery. */
+    tag?: string;
     aprBps: number;
     /** Initial principal (UI amount). Defaults to 0. */
     principal?: number;
@@ -16253,10 +16497,15 @@ declare class MockYieldTracker implements YieldTracker {
     /** Register (or replace) a tracked account. */
     setAccount(name: string, cfg: MockYieldAccountConfig): void;
     private require;
+    getAccountNamesForVault(vault: string): Promise<string[]>;
     getYieldPayments(accountName: string): Promise<YieldPaymentSnapshot[]>;
     getYield(accountName: string, start?: Date, end?: Date): Promise<YieldAccountSnapshot>;
     getTotalYield(accountNames: string[], start?: Date, end?: Date): Promise<number>;
     getTotalOutstandingYield(accountNames: string[], start?: Date, end?: Date): Promise<number>;
+    getTotalTrackedAmounts(accountNames: string[], start?: Date, end?: Date): Promise<{
+        principal: number;
+        outstandingYield: number;
+    }>;
     getBalance(accountName: string, atTime?: Date): Promise<number>;
     addCashflow(params: {
         accountName: string;
@@ -16309,6 +16558,31 @@ declare function applyEffectiveApy(anchor: bigint, apyBps: number, elapsedSecs:
 /** Human-readable CLI lines for a raw settlement projection. */
 declare function formatSettlementSimulation(simulation: SettlementSimulation): string[];
 
+interface LiveConsensusOracleDepsOptions {
+    log?: (msg: string) => void;
+    rpcOnly?: boolean;
+    includeExternalPositions?: boolean;
+}
+declare function createLiveConsensusOracleDeps(connection: Connection, opts?: LiveConsensusOracleDepsOptions): ConsensusOracleDeps;
+
+interface RunLiveConsensusOracleOptions extends RunOptions {
+    /** Override the RPC endpoint used for vault discovery, price updates, and NAV cranks. */
+    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;
+}
+/**
+ * Full live consensus-oracle pass for one signer.
+ *
+ * Builds the vault client for `env`, discovers every vault where `oracleSigner`
+ * is registered, updates consensus prices/external allocations, and cranks NAV.
+ */
+declare function runLiveConsensusOracle(env: VaultEnv, oracleSigner: Keypair, opts?: RunLiveConsensusOracleOptions): Promise<RunSummary>;
+
 declare class ConsensusOracleService {
     private readonly client;
     private readonly deps;
@@ -16317,14 +16591,6 @@ declare class ConsensusOracleService {
     constructor(client: VaultClient, deps: ConsensusOracleDeps);
     /** Drive one vault: source prices/balances, push consensus update, crank NAV. */
     runOnce(signer: Keypair, target: ConsensusOracleTarget, opts?: RunOptions): Promise<VaultOracleResult>;
-    /** Read canonical supplies and replay the exact on-chain settlement path. */
-    private simulateDryRunSettlement;
-    /**
-     * Fail closed while any configured yield account has an unsettled payment.
-     * The payout must be confirmed only after it is visible in the same wallet
-     * balance source used by this service. Until then, no oracle update is safe.
-     */
-    private assertNoUnconfirmedYieldPayments;
     /**
      * Drive several vaults in sequence. Non-fatal: a failure on one vault is
      * recorded and the rest still run (mirrors the oracle-updater daemon).
@@ -16334,46 +16600,13 @@ declare class ConsensusOracleService {
     runDiscoveredForSigner(signer: Keypair, opts?: RunOptions): Promise<RunSummary>;
     /**
      * Discover all on-chain vaults for which `signer` is a registered consensus
-     * oracle signer. Fetches every vault and its oracle account, then filters by
-     * signer membership. Returns minimal `ConsensusOracleTarget` entries (no
-     * per-holding config); callers can overlay config from `targets.ts` if needed.
+     * oracle signer.
      */
     discoverVaultsForSigner(signer: Keypair, opts?: {
         log?: (msg: string) => void;
     }): Promise<ConsensusOracleTarget[]>;
+    private nowSecs;
     private fetchDecodedVault;
-    /**
-     * Keep active permissionless price sources warm so they cannot block the NAV
-     * crank after the consensus report lands. Prices are refreshed at least once
-     * per hour, or at the vault's shorter staleness interval when configured.
-     */
-    private refreshLiveOraclePrices;
-    /**
-     * Receipt mints issued by this vault are liabilities/shares, not underlying
-     * assets for its own NAV. Exclude them even if they were registered as
-     * consensus-priced holdings.
-     */
-    private fetchReceiptMints;
-    /** Fetch every external input the per-holding updates draw on, in parallel-ish. */
-    private gatherPricingInputs;
-    /** Live-LP balances for the target, summed by mint (empty if no provider). */
-    private fetchExternalPositions;
-    /** Accrued yield (base units) attributed to a holding via its configured accounts. */
-    private resolveYieldAmount;
-    private buildUpdates;
-    private buildHoldingUpdate;
-    /** Push the consensus report for all holdings, then settle NAV. */
-    private settleVault;
-    /**
-     * Fetch the current settlement timestamp and log the APY implied by the
-     * prospective update, so MaxApyExceeded failures are diagnosable.
-     *
-     * NAV is expressed in the vault's accounting unit (scaled by assetDecimals).
-     * Mirrors `gross_nav_from_holdings`: consensus updates overlay their target
-     * slots, while live-priced and otherwise unchanged holdings retain their
-     * current price/external amount.
-     */
-    private logProspectiveApy;
 }
 
 /**
@@ -16393,6 +16626,7 @@ interface ExternalLiquidityIntegrityResult {
     deposited: number;
     skipped: number;
     failed: number;
+    /** Signatures of sent deposits (empty in dry-run mode). */
     signatures: string[];
 }
 interface ExternalLiquidityIntegritySummary {
@@ -16400,8 +16634,22 @@ interface ExternalLiquidityIntegritySummary {
     totalDeposited: number;
     totalSkipped: number;
     totalFailed: number;
+    /** True when deposits were simulated rather than sent. */
+    dryRun: boolean;
 }
 type LogFn = (msg: string) => void;
+interface ExternalLiquidityIntegrityOptions {
+    log?: LogFn;
+    /** Simulate each deposit instead of sending it. Nothing is submitted. */
+    dryRun?: boolean;
+    /**
+     * Skip holdings worth less 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.
+     */
+    minAmountUi?: number;
+}
+declare const DEFAULT_MIN_AMOUNT_UI = 1;
 declare class ExternalLiquidityIntegrityService {
     private readonly client;
     constructor(client: VaultClient);
@@ -16409,15 +16657,16 @@ declare class ExternalLiquidityIntegrityService {
      * Scan all vaults and deposit any idle local balance into configured external
      * liquidity positions. Non-fatal per vault — errors are logged and counted.
      */
-    runAll(hwManager: Keypair, opts?: {
-        log?: LogFn;
-    }): Promise<ExternalLiquidityIntegritySummary>;
+    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.
      */
-    processVault(vault: Address, vaultState: VaultAccountData, hwManager: Keypair, log: LogFn): Promise<ExternalLiquidityIntegrityResult>;
+    processVault(vault: Address, vaultState: VaultAccountData, hwManager: Keypair, log: LogFn, opts?: {
+        dryRun?: boolean;
+        minAmountUi?: number;
+    }): Promise<ExternalLiquidityIntegrityResult>;
     private depositIntoMarginfi;
 }
 
-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, CancelJuniorTrancheWithdrawBuilder, type CancelJuniorTrancheWithdrawIxArgs, type CancelJuniorTrancheWithdrawTxArgs, type Clock, 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_ORACLE_STALENESS_THRESHOLD_SECS, DEFAULT_PRICE_ORACLE_ACCOUNT, DEFAULT_PRICE_STALENESS_THRESHOLD_SECS, DEFAULT_VAULT_ID, type DecodedHolding, type DecodedVault, type DecodedVaultTrancheState, type DeleteAccountParams, DisableCircuitBreakerBuilder, type DisableCircuitBreakerIxArgs, type DisableCircuitBreakerTxArgs, 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 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 HoldingUpdatePreview, IDL, InitializeVaultRolesBuilder, type InitializeVaultRolesIxArgs, type InitializeVaultRolesTxArgs, type JuniorWithdrawalMode, JupiterBalanceSource, type JupiterBalanceSourceOptions, JupiterPriceSource, type JupiterPriceSourceOptions, JupiterSwapBuilder, type JupiterSwapIxArgs, type JupiterSwapTxArgs, KaminoPositionProvider, LOCAL_PROTOCOL_ADMIN, type LiveConsensusOracleDepsOptions, LivePriceSource, type LivePriceSourceOptions, MAX_PRICE_STALENESS_THRESHOLD_SECS, ManagerRedepositAssetBuilder, type ManagerRedepositAssetIxArgs, type ManagerRedepositAssetTxArgs, ManagerWithdrawAssetBuilder, type ManagerWithdrawAssetIxArgs, type ManagerWithdrawAssetTxArgs, MarginfiPositionProvider, type MockYieldAccountConfig, MockYieldTracker, type MockYieldTrackerOptions, NEST_API_BASE_URL, NEST_RWA_SHARE_MINT, NEST_VAULT_SLUG, type NavCrankBlocker, type NavCrankBlockerReason, type NavCrankReadiness, type NavCrankResult, NestPriceSource, type NestPriceSourceOptions, OracleService, 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, RemoveAssetHoldingBuilder, type RemoveAssetHoldingIxArgs, type RemoveAssetHoldingTxArgs, RequestJuniorTrancheWithdrawBuilder, type RequestJuniorTrancheWithdrawIxArgs, type RequestJuniorTrancheWithdrawTxArgs, type ResolvedSquadsWalletRoute, type RollingLimitConfig, type RunLiveConsensusOracleOptions, type RunOptions, type RunSummary, SHARE_DECIMALS, SetAssetPriceOracleBuilder, type SetAssetPriceOracleIxArgs, type SetAssetPriceOracleTxArgs, SetExternalLiquidityBuilder, type SetExternalLiquidityIxArgs, type SetExternalLiquidityTxArgs, SetProtocolFeeBuilder, type SetProtocolFeeIxArgs, type SetProtocolFeeTxArgs, SetVaultConfigBuilder, type SetVaultConfigIxArgs, type SetVaultConfigTxArgs, type SettlementSimulation, type SettlementSimulationSnapshot, 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, addCashflowUpdate, applyEffectiveApy, confirmYieldPayment, createAccount, createLiveConsensusOracleDeps, createRpcFromConnection, createTokenMint, createTokenMintIxs, createVaultClient, createYieldPayment, dateToStr, defaultKeypairPath, deleteAccount, fetchNestTokenPrice, findSquadsWalletRoute, formatSettlementSimulation, fromUiAmount, getAccounts, getBalance, getCashflows, getRpcUrl, getTotalOutstandingYield, getTotalYield, getVaultProgramId, getYield, getYieldPayments, isVaultEnv, keypairAddress, loadKeypair, makeProvider, mintTokensTo, prepareVaultTransaction, resolveKeypairPath, resolveSquadsWalletRoute, roundToNextUtcMidnight, runLiveConsensusOracle, simulateConsensusOracleSettlement, systemClock, toUiAmount, updateAccount, updateDynamicApr, validateSquadsWalletRoutes, vaultAuthorityForWallet };
+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 };