@perena/vault-sdk 1.0.26 → 1.0.28

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;
@@ -4762,66 +4765,6 @@ type Bankineco = {
                         };
                     };
                 },
-                {
-                    "name": "feeCollector";
-                },
-                {
-                    "name": "feeCollectorOutputAta";
-                    "writable": true;
-                    "pda": {
-                        "seeds": [
-                            {
-                                "kind": "account";
-                                "path": "feeCollector";
-                            },
-                            {
-                                "kind": "account";
-                                "path": "assetTokenProgram";
-                            },
-                            {
-                                "kind": "account";
-                                "path": "outputMint";
-                            }
-                        ];
-                        "program": {
-                            "kind": "const";
-                            "value": [
-                                140,
-                                151,
-                                37,
-                                143,
-                                78,
-                                36,
-                                137,
-                                241,
-                                187,
-                                61,
-                                16,
-                                41,
-                                20,
-                                142,
-                                13,
-                                131,
-                                11,
-                                90,
-                                19,
-                                153,
-                                218,
-                                255,
-                                16,
-                                132,
-                                4,
-                                142,
-                                123,
-                                216,
-                                219,
-                                233,
-                                248,
-                                89
-                            ];
-                        };
-                    };
-                },
                 {
                     "name": "queueInputAta";
                     "writable": true;
@@ -4894,7 +4837,24 @@ type Bankineco = {
                     "address": "11111111111111111111111111111111";
                 }
             ];
-            "args": [];
+            "args": [
+                {
+                    "name": "externalWithdrawIxRefs";
+                    "type": {
+                        "option": {
+                            "defined": {
+                                "name": "instructionRefs";
+                            };
+                        };
+                    };
+                },
+                {
+                    "name": "externalLiquiditySource";
+                    "type": {
+                        "option": "u8";
+                    };
+                }
+            ];
         },
         {
             "name": "fulfillJuniorTrancheWithdrawFeeExempt";
@@ -5061,66 +5021,6 @@ type Bankineco = {
                         };
                     };
                 },
-                {
-                    "name": "feeCollector";
-                },
-                {
-                    "name": "feeCollectorOutputAta";
-                    "writable": true;
-                    "pda": {
-                        "seeds": [
-                            {
-                                "kind": "account";
-                                "path": "feeCollector";
-                            },
-                            {
-                                "kind": "account";
-                                "path": "assetTokenProgram";
-                            },
-                            {
-                                "kind": "account";
-                                "path": "outputMint";
-                            }
-                        ];
-                        "program": {
-                            "kind": "const";
-                            "value": [
-                                140,
-                                151,
-                                37,
-                                143,
-                                78,
-                                36,
-                                137,
-                                241,
-                                187,
-                                61,
-                                16,
-                                41,
-                                20,
-                                142,
-                                13,
-                                131,
-                                11,
-                                90,
-                                19,
-                                153,
-                                218,
-                                255,
-                                16,
-                                132,
-                                4,
-                                142,
-                                123,
-                                216,
-                                219,
-                                233,
-                                248,
-                                89
-                            ];
-                        };
-                    };
-                },
                 {
                     "name": "queueInputAta";
                     "writable": true;
@@ -5194,6 +5094,22 @@ type Bankineco = {
                 }
             ];
             "args": [
+                {
+                    "name": "externalWithdrawIxRefs";
+                    "type": {
+                        "option": {
+                            "defined": {
+                                "name": "instructionRefs";
+                            };
+                        };
+                    };
+                },
+                {
+                    "name": "externalLiquiditySource";
+                    "type": {
+                        "option": "u8";
+                    };
+                },
                 {
                     "name": "signerSeeds";
                     "type": {
@@ -9533,239 +9449,229 @@ type Bankineco = {
     ];
     "errors": [
         {
-            "code": 14001;
-            "name": "unauthorized";
-            "msg": "You are not authorized to perform this action.";
-        },
-        {
-            "code": 14002;
-            "name": "invalidBankMint";
-            "msg": "Invalid mint";
+            "code": 6000;
+            "name": "mintSupplyNonZero";
+            "msg": "Supplied share mint already has non-zero supply";
         },
         {
-            "code": 14003;
-            "name": "accountingIssue";
-            "msg": "Accounting issue";
+            "code": 6001;
+            "name": "invalidAssetMint";
+            "msg": "Supplied mint is not accepted by this vault";
         },
         {
-            "code": 14004;
-            "name": "vaultAccountingIssue";
-            "msg": "Vault accounting issue";
+            "code": 6002;
+            "name": "zeroDepositAmount";
+            "msg": "Deposit amount must be greater than zero";
         },
         {
-            "code": 14005;
-            "name": "bankAccountingIssue";
-            "msg": "Bank accounting issue";
+            "code": 6003;
+            "name": "exceedsTvlLimit";
+            "msg": "Deposit would exceed the vault's TVL limit";
         },
         {
-            "code": 14006;
-            "name": "onchainAccountingIssue";
-            "msg": "Onchain accounting issue";
+            "code": 6004;
+            "name": "zeroBurnAmount";
+            "msg": "Burn amount must be greater than zero";
         },
         {
-            "code": 14007;
-            "name": "externalAccountingIssue";
-            "msg": "External accounting issue";
+            "code": 6005;
+            "name": "zeroAssetAmount";
+            "msg": "Asset amount must be greater than zero";
         },
         {
-            "code": 14008;
-            "name": "mintSlippage";
-            "msg": "Minting failed due to slippage.";
+            "code": 6006;
+            "name": "insufficientVaultLiquidity";
+            "msg": "Insufficient vault liquidity to satisfy withdrawal";
         },
         {
-            "code": 14009;
-            "name": "burningSlippage";
-            "msg": "Burning failed due to slippage.";
+            "code": 6007;
+            "name": "mintAuthorityNotCurator";
+            "msg": "Mint authority is not the curator";
         },
         {
-            "code": 14010;
-            "name": "teamAccountAlreadyExists";
-            "msg": "Team account already exists";
+            "code": 6008;
+            "name": "zeroTotalSupply";
+            "msg": "Vault total supply is zero";
         },
         {
-            "code": 14011;
-            "name": "oracleAccountAlreadyExists";
-            "msg": "Oracle account already exists";
-        },
-        {
-            "code": 14012;
+            "code": 6009;
             "name": "staleOracle";
-            "msg": "Stale oracle";
+            "msg": "Vault oracle is stale";
         },
         {
-            "code": 14013;
-            "name": "localSignificantPriceChange";
-            "msg": "Price change is too large locally";
+            "code": 6010;
+            "name": "invalidOracleUpdate";
+            "msg": "Invalid oracle update";
         },
         {
-            "code": 14014;
-            "name": "significantPriceChange";
-            "msg": "Price change is too large";
+            "code": 6011;
+            "name": "invalidInitialMintSharePrice";
+            "msg": "Initial mint share price must be greater than zero";
         },
         {
-            "code": 14015;
-            "name": "roundingImpact";
-            "msg": "Rounding impacts the protocol";
+            "code": 6012;
+            "name": "maxApyExceeded";
+            "msg": "Oracle NAV update exceeds the vault's maximum acceptable APY";
         },
         {
-            "code": 14016;
-            "name": "bankIsHalted";
-            "msg": "Bank is halted";
+            "code": 6013;
+            "name": "invalidApyConfig";
+            "msg": "Invalid APY configuration";
         },
         {
-            "code": 14017;
-            "name": "vaultIsHalted";
-            "msg": "Vault is halted";
+            "code": 6014;
+            "name": "invalidFeeConfig";
+            "msg": "Invalid fee configuration";
         },
         {
-            "code": 14018;
-            "name": "conversionOverflow";
-            "msg": "Conversion Overflow";
+            "code": 6015;
+            "name": "vaultHasLiveAssets";
+            "msg": "Vault has live supply, TVL, or holdings";
         },
         {
-            "code": 14019;
-            "name": "reserved8019";
-            "msg": "reserved";
+            "code": 6016;
+            "name": "depositMintsZeroShares";
+            "msg": "Deposit would mint zero shares";
         },
         {
-            "code": 14020;
-            "name": "invalidArgument";
-            "msg": "Invalid argument";
+            "code": 6017;
+            "name": "insufficientAccruedApyBalance";
+            "msg": "Insufficient accrued APY balance";
         },
         {
-            "code": 14021;
-            "name": "userSanityCheck";
-            "msg": "User Sanity Check";
+            "code": 6018;
+            "name": "invalidRole";
+            "msg": "Invalid role configuration";
         },
         {
-            "code": 14022;
-            "name": "mathOverflow";
-            "msg": "Math overflow";
+            "code": 6019;
+            "name": "invalidProtocolInteraction";
+            "msg": "Invalid protocol interaction CPI";
         },
         {
-            "code": 14023;
-            "name": "invalidMarginFiAccount";
-            "msg": "Invalid MarginFi account - must be correct PDA for this vault";
+            "code": 6020;
+            "name": "reserved7020";
+            "msg": "reserved";
         },
         {
-            "code": 14024;
-            "name": "invalidStartMarker";
-            "msg": "Invalid start marker";
+            "code": 6021;
+            "name": "invalidExternalLiquidity";
+            "msg": "Invalid external liquidity configuration";
         },
         {
-            "code": 14025;
-            "name": "oracleUpdateOnEmptyReserve";
-            "msg": "Unable to push oracle update on an empty vault reserve";
+            "code": 6022;
+            "name": "swapBalanceUnchanged";
+            "msg": "Swap did not change both source and destination balances";
         },
         {
-            "code": 14026;
-            "name": "invalidRemainingAccountsLength";
-            "msg": "Invalid remaining accounts length";
+            "code": 6023;
+            "name": "protocolBalanceUnchanged";
+            "msg": "Protocol interaction did not change the affected token balance";
         },
         {
-            "code": 14027;
-            "name": "withdrawalExceedsBalance";
-            "msg": "Specified withdrawal exceeds available balance";
+            "code": 6024;
+            "name": "excessiveSwapSlippage";
+            "msg": "Swap TVL loss exceeds the allowed slippage";
         },
         {
-            "code": 14028;
-            "name": "insufficientPendingYield";
-            "msg": "Insufficient pending yield";
+            "code": 6025;
+            "name": "tranchingNotEnabled";
+            "msg": "Vault tranching is not enabled";
         },
         {
-            "code": 14029;
-            "name": "notSupported";
-            "msg": "Not supported";
+            "code": 6026;
+            "name": "tranchingAlreadyEnabled";
+            "msg": "Vault tranching is already enabled";
         },
         {
-            "code": 14030;
-            "name": "exceedsMaxYieldingTvl";
-            "msg": "Exceeds maximum yielding TVL";
+            "code": 6027;
+            "name": "trancheStateRequired";
+            "msg": "Tranche state account is required";
         },
         {
-            "code": 14031;
-            "name": "tranchingNotEnabled";
-            "msg": "Tranching is not enabled for this bank";
+            "code": 6028;
+            "name": "invalidTrancheConfig";
+            "msg": "Invalid tranche configuration";
         },
         {
-            "code": 14032;
-            "name": "invalidLeverageFactor";
-            "msg": "Invalid leverage factor - must be at least 10000 (1x)";
+            "code": 6029;
+            "name": "invalidTrancheMint";
+            "msg": "Invalid tranche mint";
         },
         {
-            "code": 14033;
-            "name": "insufficientStakedAmount";
-            "msg": "Insufficient staked amount";
+            "code": 6030;
+            "name": "lossesDisabled";
+            "msg": "Vault losses are not enabled";
         },
         {
-            "code": 14034;
-            "name": "juniorTrancheEmpty";
-            "msg": "Junior tranche has no value";
+            "code": 6031;
+            "name": "withdrawalQueueNotExpired";
+            "msg": "Withdrawal queue is not yet expired";
         },
         {
-            "code": 14035;
-            "name": "invalidTrancheConfig";
-            "msg": "Invalid tranche config parameter";
+            "code": 6032;
+            "name": "invalidWithdrawalQueue";
+            "msg": "Invalid withdrawal queue";
         },
         {
-            "code": 14036;
-            "name": "withdrawalQueueNotExpired";
-            "msg": "Withdrawal queue lockup period has not expired";
+            "code": 6033;
+            "name": "assetPriceNotSet";
+            "msg": "Destination asset has no price set; a consensus oracle price is required before swapping";
         },
         {
-            "code": 14037;
-            "name": "invalidWithdrawalQueue";
-            "msg": "Withdrawal queue entry is not in a valid state";
+            "code": 6034;
+            "name": "assetHoldingNotEmpty";
+            "msg": "Asset holding still has a balance and cannot be removed";
         },
         {
-            "code": 14038;
-            "name": "invalidAccount";
-            "msg": "Account does not belong to the expected parent";
+            "code": 6035;
+            "name": "cannotRemoveBaseHolding";
+            "msg": "The base asset holding cannot be removed";
         },
         {
-            "code": 14039;
-            "name": "missingAccount";
-            "msg": "Required optional account is missing";
+            "code": 6036;
+            "name": "unauthorizedPriceUpdater";
+            "msg": "Caller is not authorized to trigger an asset price update";
         },
         {
-            "code": 14040;
-            "name": "trancheWipedOut";
-            "msg": "Junior tranche is wiped out and cannot accept new stakes";
+            "code": 6037;
+            "name": "invalidStalenessConfig";
+            "msg": "Invalid asset-price staleness threshold";
         },
         {
-            "code": 14041;
-            "name": "vaultLossNotAccepted";
-            "msg": "Vault does not accept losses — enable losses_accepted before retrying";
+            "code": 6038;
+            "name": "assetRebalanceRateLimitExceeded";
+            "msg": "Asset was rebalanced too recently";
         },
         {
-            "code": 14042;
-            "name": "capitalLossExceedsReserve";
-            "msg": "Capital loss exceeds available yielding reserve";
+            "code": 6039;
+            "name": "invalidShareTokenProgram";
+            "msg": "Share token program does not match the vault/tranche mint configuration";
         },
         {
-            "code": 14043;
-            "name": "rollingWithdrawalLimitExceeded";
-            "msg": "Rolling withdrawal limit exceeded";
+            "code": 6040;
+            "name": "unauthorizedVaultCreator";
+            "msg": "Caller is not on the vault-creator whitelist";
         },
         {
-            "code": 14044;
-            "name": "vaultAlreadyMigrated";
-            "msg": "Legacy vault has already been migrated";
+            "code": 6041;
+            "name": "invalidShareMintDecimals";
+            "msg": "Share mint decimals must match the vault accounting decimals";
         },
         {
-            "code": 14045;
-            "name": "invalidMigrationState";
-            "msg": "Legacy vault migration is incomplete or invalid";
+            "code": 6042;
+            "name": "invalidFeeExemption";
+            "msg": "Invalid fee-exemption PDA signer or seeds";
         },
         {
-            "code": 14046;
-            "name": "invalidMigrationMintAuthority";
-            "msg": "Mint authority does not match the expected migration source";
+            "code": 6043;
+            "name": "exceedsJuniorDepositCap";
+            "msg": "Deposit would exceed the junior tranche deposit cap";
         },
         {
-            "code": 14047;
-            "name": "bankMigrationIncomplete";
-            "msg": "Legacy bank or tranche migration is incomplete — source accounting and escrow must be fully drained before mint authority transfer";
+            "code": 6044;
+            "name": "invalidShareSupply";
+            "msg": "Physical share-mint supply does not match effective supply accounting";
         }
     ];
     "types": [
@@ -10146,9 +10052,7 @@ 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`.",
-                "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."
+                "and `holding_index` is ignored. For existing holdings leave `mint` as `None`."
             ];
             "type": {
                 "kind": "struct";
@@ -11893,7 +11797,8 @@ type Bankineco = {
                     {
                         "name": "lossesEnabled";
                         "docs": [
-                            "Allows consensus-oracle NAV losses beyond the protocol's small-loss tolerance. Losses inside that tolerance settle without this flag."
+                            "Allows consensus-oracle NAV losses beyond the protocol's small-loss",
+                            "tolerance. Losses inside that tolerance settle without this flag."
                         ];
                         "type": {
                             "defined": {
@@ -14558,11 +14463,12 @@ interface FulfillJuniorTrancheWithdrawIxArgs {
     ownerInputAta: Address;
     ownerOutputAta: Address;
     vaultOutputAta: Address;
-    feeCollector: Address;
-    feeCollectorOutputAta: Address;
     queueInputAta: Address;
     assetTokenProgram: Address;
     shareTokenProgram: Address;
+    externalWithdrawIxRefs: InstructionRefs | null;
+    externalLiquiditySource: number | null;
+    externalWithdrawAccounts: CustomAccountMeta[];
     /** PDA derivation seeds, including the bump, for the fee-exempt route. */
     addressSeeds?: readonly Uint8Array[];
 }
@@ -14578,9 +14484,17 @@ interface FulfillJuniorTrancheWithdrawTxArgs {
     juniorShareMint: Address;
     ownerInputAta?: Address;
     queueId: number;
-    feeCollector?: Address;
     assetTokenProgram?: Address;
     shareTokenProgram?: Address;
+    externalWithdrawIxRefs?: InstructionRefs;
+    externalLiquiditySource?: number;
+    externalWithdrawAccounts?: CustomAccountMeta[];
+    /**
+     * When true, skips the automatic detection of on-chain Marginfi external
+     * liquidity and always fulfills from local vault liquidity only.
+     */
+    skipExternalLiquidity?: boolean;
+    lookupTables?: Address[];
     /** PDA derivation seeds, including the bump, for the fee-exempt route. */
     addressSeeds?: readonly Uint8Array[];
 }
@@ -15131,19 +15045,19 @@ declare class ExecuteTrancheWithdrawBuilder extends VaultBuilderBase<ExecuteTran
 
 declare class ExecuteWithdrawBuilder extends VaultBuilderBase<ExecuteWithdrawIxArgs, ExecuteWithdrawTxArgs> {
     getIxAccounts(args: ExecuteWithdrawIxArgs): {
-        user: PublicKey;
-        vault: PublicKey;
-        vaultOracle: PublicKey;
-        vaultTrancheState: PublicKey | null;
-        assetMint: PublicKey;
-        shareMint: PublicKey;
-        userAssetAta: PublicKey;
-        vaultAssetAta: PublicKey;
-        feeVault: PublicKey;
-        feeVaultAta: PublicKey;
-        userShareAta: PublicKey;
-        assetTokenProgram: PublicKey;
-        shareTokenProgram: PublicKey;
+        user: _solana_web3_js.PublicKey;
+        vault: _solana_web3_js.PublicKey;
+        vaultOracle: _solana_web3_js.PublicKey;
+        vaultTrancheState: _solana_web3_js.PublicKey | null;
+        assetMint: _solana_web3_js.PublicKey;
+        shareMint: _solana_web3_js.PublicKey;
+        userAssetAta: _solana_web3_js.PublicKey;
+        vaultAssetAta: _solana_web3_js.PublicKey;
+        feeVault: _solana_web3_js.PublicKey;
+        feeVaultAta: _solana_web3_js.PublicKey;
+        userShareAta: _solana_web3_js.PublicKey;
+        assetTokenProgram: _solana_web3_js.PublicKey;
+        shareTokenProgram: _solana_web3_js.PublicKey;
     };
     getIxData(args: ExecuteWithdrawIxArgs): {
         shareAmount: BN;
@@ -15165,12 +15079,13 @@ declare class ExecuteWithdrawBuilder extends VaultBuilderBase<ExecuteWithdrawIxA
 declare class FulfillJuniorTrancheWithdrawBuilder extends VaultBuilderBase<FulfillJuniorTrancheWithdrawIxArgs, FulfillJuniorTrancheWithdrawTxArgs> {
     getIx(args: FulfillJuniorTrancheWithdrawIxArgs): Promise<_solana_kit.Instruction<string, readonly (_solana_kit.AccountLookupMeta<string, string> | _solana_kit.AccountMeta<string>)[]>>;
     protected deriveIxArgs(txArgs: FulfillJuniorTrancheWithdrawTxArgs): Promise<FulfillJuniorTrancheWithdrawIxArgs>;
+    protected buildLookupTables(_args: FulfillJuniorTrancheWithdrawIxArgs, txArgs: FulfillJuniorTrancheWithdrawTxArgs): Promise<readonly Address[] | undefined>;
     protected buildPreambleInstructions(args: FulfillJuniorTrancheWithdrawIxArgs): Promise<_solana_kit.Instruction<string, readonly (_solana_kit.AccountLookupMeta<string, string> | _solana_kit.AccountMeta<string>)[]>[]>;
     protected buildPlanExtras(args: FulfillJuniorTrancheWithdrawIxArgs): Promise<{
         postSuccessCacheInvalidations: {
-            vaultPda: _solana_kit.Address;
-            vaultTrancheStatePda: _solana_kit.Address;
-            withdrawalQueuePda: _solana_kit.Address;
+            vaultPda: Address;
+            vaultTrancheStatePda: Address;
+            withdrawalQueuePda: Address;
         }[];
     }>;
 }
@@ -15318,6 +15233,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;
 }
@@ -15355,7 +15276,9 @@ declare function resolveKeypairPath(keypairPath: string): string;
 declare function loadKeypair(keypairPath: string): Keypair;
 /**
  * Default keypair location for a given role/env, e.g.
- * `~/.config/solana/vault-fulfiller-prod.json`. Override per-invocation with
+ * `~/.config/solana/vault-fulfiller-prod.json`. Roles in
+ * {@link ENV_AGNOSTIC_ROLES} share one key across envs, e.g.
+ * `~/.config/solana/fulfiller.json`. Override per-invocation with
  * the `--keypair` CLI flag or the `keypairPath` option.
  */
 declare function defaultKeypairPath(env: VaultEnv, role?: string): string;
@@ -15908,6 +15831,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 {
@@ -16014,6 +15946,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;
@@ -16041,6 +15992,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;
@@ -16073,44 +16026,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>;
 /**
- * {@link PriceSource} backed by the Jupiter price API.
+ * 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
  *
- * 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.
+ * 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;
 
-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;
+/**
+ * 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;
+}>;
+
+/**
+ * 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).
+ *
+ * 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.
+ */
+
+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;
@@ -16139,35 +16306,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;
 }
 
 /**
@@ -16203,6 +16360,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;
@@ -16210,31 +16377,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.
  *
@@ -16330,6 +16472,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;
@@ -16338,20 +16505,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;
-    /**
-     * 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.
-     */
-    private withDiscoveredYieldAccounts;
     /**
      * Drive several vaults in sequence. Non-fatal: a failure on one vault is
      * recorded and the rest still run (mirrors the oracle-updater daemon).
@@ -16361,46 +16514,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;
-    /** Tracked external principal + outstanding yield attributed to a holding. */
-    private resolveTrackedAmounts;
-    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;
 }
 
 /**
@@ -16420,6 +16540,7 @@ interface ExternalLiquidityIntegrityResult {
     deposited: number;
     skipped: number;
     failed: number;
+    /** Signatures of sent deposits (empty in dry-run mode). */
     signatures: string[];
 }
 interface ExternalLiquidityIntegritySummary {
@@ -16427,8 +16548,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);
@@ -16436,15 +16571,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 };