@perena/vault-sdk 1.0.34 → 1.0.36

package/README.md

@@ -72,6 +72,59 @@ const client = new VaultClient(makeProvider(connection, payer));
 const [vault] = await client.pda.deriveVaultPda(0); // vault id
 ```
 
+## NAV-priced yield-tracker accounts
+
+The SDK supports both legacy APR accounts and NAV accounts whose share price is
+read by the yield tracker from a configured JSON API. Cashflow amounts are USDC
+base units; for NAV accounts the tracker records the exact shares purchased or
+redeemed at the fetched price.
+
+```typescript
+import {
+  addCashflowUpdate,
+  createAccount,
+  getNavValue,
+  getTrackedValue,
+} from "@perena/vault-sdk";
+
+await createAccount({
+  name: "piku-basis-trade",
+  type: "stockmarkettrbasistrade",
+  valuationModel: "nav",
+  navConfig: {
+    url: "https://public-api.piku.co/v1/tokens/stockmarkettrbasistrade",
+    price_path: "price",
+  },
+  tag: vault.toString(),
+  password: accountPassword,
+  adminSecret,
+});
+
+const deposit = await addCashflowUpdate({
+  accountName: "piku-basis-trade",
+  amount: 1_000_000, // 1 USDC at six decimals
+  cashflowType: "deposit",
+  valuationModel: "nav",
+  password: accountPassword,
+});
+console.log(deposit.share_amount, deposit.nav_price);
+
+const nav = await getNavValue("piku-basis-trade");
+console.log(nav.shares, nav.nav_price, nav.total_nav);
+
+// Works for either APR or NAV accounts.
+const tracked = await getTrackedValue("piku-basis-trade");
+console.log(tracked.totalValue, tracked.valuationModel);
+```
+
+Use `getAprYield(...)` when an APR-only response is required. The general
+`getYield(...)` and `getBalance(...)` methods return discriminated APR/NAV
+unions, with `isNavAccountValue(...)` and `isNavAccountBalance(...)` available
+as type guards. Historical `start`, `end`, or `as_of` valuation is unavailable
+for NAV accounts backed only by a current-price API. NAV cashflows have no
+`date` or `fundingNextDay` parameter: they execute immediately at the price the
+tracker fetches during submission.
+
 ## Creating transactions
 
 ### The builder pattern

package/dist/index.d.ts

@@ -15161,29 +15161,73 @@ interface BasicAuthCredentials {
 }
 declare function dateToStr(date: Date): string;
 declare function roundToNextUtcMidnight(date: Date): Date;
+type YieldValuationModel = "apr" | "nav";
+interface NavPriceConfig {
+    url: string;
+    price_path: string;
+}
+interface YieldCashflow {
+    id: string;
+    account_name: string;
+    /** Signed USDC amount in tracker base units. */
+    amount: number;
+    /** Present for NAV accounts: exact signed shares derived at submission. */
+    share_amount?: string;
+    nav_price?: string;
+    nav_fetched_at?: Date;
+    timestamp: Date;
+    description?: string | null;
+    created_at: Date;
+}
 interface YieldAccount {
     name: string;
     tag: string | null;
     type: string;
-    apy: number | null;
+    /** `apr` is returned by single-account/create/update endpoints. */
+    apr?: number | null;
+    /** `apy` is the legacy list-endpoint name for the same APR value. */
+    apy?: number | null;
+    valuation_model?: YieldValuationModel;
+    nav_config?: NavPriceConfig | null;
     description?: string | null;
+    created_at?: Date;
+    updated_at?: Date;
+    cashflows?: YieldCashflow[];
+}
+interface NavYieldAccount extends YieldAccount {
+    valuation_model: "nav";
+    nav_config: NavPriceConfig;
+    apr?: null;
+    apy?: null;
 }
+declare function isNavYieldAccount(account: YieldAccount): account is NavYieldAccount;
 interface CreateAccountBaseParams {
     name: string;
     password: string;
     adminSecret?: string;
-    tag?: string;
+    /** Vault address used by consensus-oracle account discovery. */
+    tag: string;
     description?: string;
 }
-type CreateAccountParams<TType extends string = string> = CreateAccountBaseParams & {
+type AprCreateAccountParams<TType extends string> = CreateAccountBaseParams & {
     type: TType;
+    valuationModel?: "apr";
+    navConfig?: never;
 } & (TType extends "dynamic" ? {
     apr: number;
 } : {
     apr?: number;
 });
-declare function createAccount<TType extends string>(params: CreateAccountParams<TType>): Promise<any>;
+type NavCreateAccountParams<TType extends string> = CreateAccountBaseParams & {
+    type: TType;
+    valuationModel: "nav";
+    navConfig: NavPriceConfig;
+    apr?: never;
+};
+type CreateAccountParams<TType extends string = string> = AprCreateAccountParams<TType> | NavCreateAccountParams<TType>;
+declare function createAccount<TType extends string>(params: CreateAccountParams<TType>): Promise<YieldAccount>;
 declare function getAccounts(): Promise<YieldAccount[]>;
+declare function getAccount(accountName: string): Promise<YieldAccount>;
 interface UpdateAccountParams {
     accountName: string;
     password: string;
@@ -15192,6 +15236,8 @@ interface UpdateAccountParams {
     apr?: number;
     tag?: string | null;
     description?: string | null;
+    valuationModel?: YieldValuationModel;
+    navConfig?: NavPriceConfig;
 }
 declare function updateAccount(params: UpdateAccountParams): Promise<YieldAccount>;
 interface DeleteAccountParams {
@@ -15207,24 +15253,45 @@ interface UpdateDynamicAprParams {
     password: string;
 }
 declare function updateDynamicApr(params: UpdateDynamicAprParams): Promise<any>;
-interface AddCashflowUpdateParams {
+interface AddCashflowUpdateBaseParams {
     accountName: string;
     amount: number;
-    date: Date;
     description?: string;
     password: string;
     cashflowType: "deposit" | "withdraw";
+}
+interface AddNavCashflowUpdateParams extends AddCashflowUpdateBaseParams {
+    /** NAV cashflows always execute immediately at the fetched price. */
+    valuationModel: "nav";
+}
+interface AddAprCashflowUpdateParams extends AddCashflowUpdateBaseParams {
+    valuationModel?: "apr";
+    date?: Date;
     fundingNextDay?: boolean;
 }
-declare function addCashflowUpdate(params: AddCashflowUpdateParams): Promise<any>;
-declare function getCashflows(accountName: string): Promise<any>;
-interface AccountBalanceResponse {
+type AddCashflowUpdateParams = AddNavCashflowUpdateParams | AddAprCashflowUpdateParams;
+declare function addCashflowUpdate(params: AddCashflowUpdateParams): Promise<YieldCashflow>;
+declare function getCashflows(accountName: string): Promise<YieldCashflow[]>;
+interface AprAccountBalanceResponse {
     account_name: string;
     account_type: string;
+    valuation_model?: "apr";
     apr: number;
     balance: number;
     as_of: Date;
 }
+interface NavAccountBalanceResponse {
+    account_name: string;
+    account_type: string;
+    valuation_model: "nav";
+    total_nav: string;
+    shares: string;
+    nav_price: string;
+    nav_fetched_at: Date;
+    as_of: Date;
+}
+type AccountBalanceResponse = AprAccountBalanceResponse | NavAccountBalanceResponse;
+declare function isNavAccountBalance(response: AccountBalanceResponse): response is NavAccountBalanceResponse;
 declare function getBalance(accountName: string, atTime?: Date): Promise<AccountBalanceResponse>;
 interface YieldCalculationLog {
     segment_number: number;
@@ -15237,7 +15304,8 @@ interface YieldCalculationLog {
     cumulative_yield: number;
     calculation_formula: string;
 }
-interface AccountYieldResponse {
+interface AprAccountYieldResponse {
+    valuation_model?: "apr";
     account: {
         name: string;
         type: string;
@@ -15256,6 +15324,16 @@ interface AccountYieldResponse {
     apr_used: number;
     calculation_log: YieldCalculationLog[];
 }
+interface NavAccountValueResponse {
+    account: AprAccountYieldResponse["account"];
+    valuation_model: "nav";
+    total_nav: string;
+    shares: string;
+    nav_price: string;
+    nav_fetched_at: Date;
+}
+type AccountYieldResponse = AprAccountYieldResponse | NavAccountValueResponse;
+declare function isNavAccountValue(response: AccountYieldResponse): response is NavAccountValueResponse;
 interface CreateYieldPaymentParams {
     accountName: string;
     amount: number;
@@ -15283,9 +15361,26 @@ declare function confirmYieldPayment(params: {
 }): Promise<YieldPaymentResponse>;
 declare function getYieldPayments(accountName: string): Promise<YieldPaymentResponse[]>;
 declare function getYield(accountName: string, start?: Date, end?: Date): Promise<AccountYieldResponse>;
+declare function getAprYield(accountName: string, start?: Date, end?: Date): Promise<AprAccountYieldResponse>;
+declare function getNavValue(accountName: string): Promise<NavAccountValueResponse>;
+interface TrackedAccountValue {
+    totalValue: number;
+    principal: number;
+    outstandingYield: number;
+    valuationModel: YieldValuationModel;
+}
+/** Normalize either yield-tracker response model into one current base-unit value. */
+declare function trackedValueFromResponse(response: AccountYieldResponse): TrackedAccountValue;
+declare function getTrackedValue(accountName: string): Promise<TrackedAccountValue>;
 declare function getTotalYield(accountNames: string[], start?: Date, end?: Date): Promise<BN>;
 /** Sum only confirmed-payment-adjusted yield that remains receivable. */
 declare function getTotalOutstandingYield(accountNames: string[], start?: Date, end?: Date): Promise<number>;
+/** Sum the complete current value of APR and NAV accounts in tracker base units. */
+declare function getTotalTrackedValue(accountNames: string[], start?: Date, end?: Date): Promise<{
+    totalValue: number;
+    principal: number;
+    outstandingYield: number;
+}>;
 
 /**
  * Junior-tranche withdrawal-queue fulfillment.
@@ -15544,13 +15639,21 @@ interface YieldTracker {
     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. */
+    /** Sum of oracle-safe outstanding yield across APR 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.
+     * Sum complete current account value across APR and NAV accounts. APR
+     * diagnostics remain separate; NAV accounts contribute only to totalValue.
+     * All values are UI token amounts.
      */
-    getTotalTrackedAmounts(accountNames: string[], start?: Date, end?: Date): Promise<{
+    getTotalTrackedValue?(accountNames: string[], start?: Date, end?: Date): Promise<{
+        totalValue: number;
+        /** APR-account diagnostics; NAV accounts contribute zero here. */
+        principal: number;
+        outstandingYield: number;
+    }>;
+    /** @deprecated APR-only compatibility surface; use getTotalTrackedValue. */
+    getTotalTrackedAmounts?(accountNames: string[], start?: Date, end?: Date): Promise<{
         principal: number;
         outstandingYield: number;
     }>;
@@ -15608,7 +15711,9 @@ interface HoldingUpdatePreview {
     yieldAmount: bigint;
     /** Yield-tracker principal attributed to this holding (base units). */
     trackedPrincipalAmount: bigint;
-    /** Total external balance pushed = wallet + LP + tracked principal + yield. */
+    /** Complete tracked value, including NAV accounts (base units). */
+    trackedValueAmount: bigint;
+    /** Total external balance pushed = wallet + LP + complete tracked value. */
     externalAmount: bigint;
 }
 interface VaultOracleResult {
@@ -15905,6 +16010,7 @@ interface LargeBalanceChangeViolation {
     walletAmount: bigint;
     lpAmount: bigint;
     trackedPrincipalAmount: bigint;
+    trackedValueAmount: bigint;
     yieldAmount: bigint;
 }
 interface StaleBalanceChangeBypass extends LargeBalanceChangeViolation {
@@ -15939,8 +16045,9 @@ declare function simulateDryRunSettlement({ client, signer, vault, vaultState, u
 
 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. */
+/** Complete tracked account value attributed to a holding. */
 declare function resolveTrackedAmounts(yieldTracker: YieldTracker | undefined, cfg: ConsensusOracleHoldingConfig | undefined, decimals: number): Promise<{
+    trackedValueAmount: bigint;
     principalAmount: bigint;
     yieldAmount: bigint;
 }>;
@@ -16268,6 +16375,12 @@ declare class MockYieldTracker implements YieldTracker {
     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>;
+    getTotalTrackedValue(accountNames: string[], start?: Date, end?: Date): Promise<{
+        totalValue: number;
+        principal: number;
+        outstandingYield: number;
+    }>;
+    /** Backward-compatible APR-only breakdown. */
     getTotalTrackedAmounts(accountNames: string[], start?: Date, end?: Date): Promise<{
         principal: number;
         outstandingYield: number;
@@ -16613,4 +16726,4 @@ declare class IdleLiquidityService {
     private executeSwap;
 }
 
-export { ASSET_DECIMALS, ASSET_REBALANCE_COOLDOWN_SECS, type AccountBalanceResponse, AccountClient, type AccountYieldResponse, ActivateCircuitBreakerBuilder, type ActivateCircuitBreakerIxArgs, type ActivateCircuitBreakerTxArgs, type AssetPriceOracleConfigIxArgs, type AssetPriceOracleConfigTxArgs, type AssetPriceRefreshTarget, type AssetRefreshResult, type AssetType, BALANCE_CHANGE_BASELINE_MAX_AGE_SECS, type Bankineco, type BasicAuthCredentials, type Bigintish, CONSENSUS_ORACLE_VARIANT, CancelJuniorTrancheWithdrawBuilder, type CancelJuniorTrancheWithdrawIxArgs, type CancelJuniorTrancheWithdrawTxArgs, type Clock, type CollectSamplesOptions, type ConsensusAssetUpdate, type ConsensusHoldingEntry, type ConsensusHoldingSimulation, type ConsensusOracleDeps, type ConsensusOracleHoldingConfig, ConsensusOracleService, type ConsensusOracleTarget, CrankNavBuilder, type CrankNavIxArgs, type CrankNavTxArgs, CrankPerformanceFeesBuilder, type CrankPerformanceFeesIxArgs, type CrankPerformanceFeesTxArgs, type CreateAccountParams, CreateAssetHoldingBuilder, type CreateAssetHoldingIxArgs, type CreateAssetHoldingTxArgs, type CreateTokenMintIxs, CreateTrancheStateBuilder, type CreateTrancheStateIxArgs, type CreateTrancheStateTxArgs, CreateVaultBuilder, type CreateVaultClientOptions, type CreateVaultIxArgs, type CreateVaultParams, type CreateVaultTxArgs, type CreateYieldPaymentParams, DEFAULT_CU_PRICE_MICRO_LAMPORTS, DEFAULT_JUNIOR_EARLY_UNSTAKE_FEE_BPS, DEFAULT_JUNIOR_STANDARD_UNSTAKE_FEE_BPS, DEFAULT_JUNIOR_WITHDRAWAL_LOCKUP_SECS, DEFAULT_MAX_ACCEPTABLE_APY_BPS, DEFAULT_MAX_ACCOUNTS, DEFAULT_MINTS, DEFAULT_MIN_AMOUNT_UI, DEFAULT_ORACLE_STALENESS_THRESHOLD_SECS, DEFAULT_PRICE_ORACLE_ACCOUNT, DEFAULT_PRICE_STALENESS_SECS, DEFAULT_PRICE_STALENESS_THRESHOLD_SECS, DEFAULT_REBALANCE_BAND_BPS, DEFAULT_SLIPPAGE_BPS, DEFAULT_TARGET_LOCAL_BPS, DEFAULT_VAULT_ID, type DecodedHolding, type DecodedVault, type DecodedVaultTrancheState, type DeleteAccountParams, DisableCircuitBreakerBuilder, type DisableCircuitBreakerIxArgs, type DisableCircuitBreakerTxArgs, EXTERNAL_POSITION_SAMPLES, ExecuteDepositBuilder, type ExecuteDepositIxArgs, type ExecuteDepositTxArgs, ExecuteShareSwapBuilder, type ExecuteShareSwapIxArgs, type ExecuteShareSwapTxArgs, ExecuteTrancheDepositBuilder, type ExecuteTrancheDepositIxArgs, type ExecuteTrancheDepositTxArgs, ExecuteTrancheWithdrawBuilder, type ExecuteTrancheWithdrawIxArgs, type ExecuteTrancheWithdrawTxArgs, ExecuteWithdrawBuilder, type ExecuteWithdrawIxArgs, type ExecuteWithdrawTxArgs, type ExternalLiquidityIntegrityOptions, type ExternalLiquidityIntegrityResult, ExternalLiquidityIntegrityService, type ExternalLiquidityIntegritySummary, type ExternalLiquiditySlot, type ExternalLiquiditySourceArgs, type ExternalPosition, type ExternalPositionContext, type ExternalPositionProvider, type ExternalPositionRef, ExternalPositionRegistry, FEE_VAULT_CACHE_CATEGORY, type FeeVaultAccountData, type FetchNestTokenPriceOptions, FulfillJuniorTrancheWithdrawBuilder, type FulfillJuniorTrancheWithdrawIxArgs, type FulfillJuniorTrancheWithdrawTxArgs, type FulfillSummary, type HoldingNavContribution, type HoldingUpdatePreview, IDL, IDLE_RESERVE_FLOOR_BPS, IDLE_RESERVE_TARGET_BPS, type IdleLiquidityOptions, type IdleLiquidityResult, IdleLiquidityService, type IdleLiquidityStatus, InitializeVaultRolesBuilder, type InitializeVaultRolesIxArgs, type InitializeVaultRolesTxArgs, type JuniorWithdrawalMode, JupiterBalanceSource, type JupiterBalanceSourceOptions, JupiterPriceSource, type JupiterPriceSourceOptions, JupiterSwapBuilder, type JupiterSwapIxArgs, type JupiterSwapTxArgs, KaminoPositionProvider, LIVE_ORACLE_VARIANTS, LIVE_PRICE_REFRESH_INTERVAL_SECS, LOCAL_PROTOCOL_ADMIN, LargeBalanceChangeError, type LargeBalanceChangeViolation, type LiveConsensusOracleDepsOptions, LivePriceSource, type LivePriceSourceOptions, MAX_BALANCE_CHANGE_BPS, MAX_CONSENSUS_SIGNERS, MAX_MANAGER_WITHDRAW_DESTINATIONS, MAX_PRICE_STALENESS_THRESHOLD_SECS, MIN_EXTERNAL_POSITION_SAMPLES, ManagerRedepositAssetBuilder, type ManagerRedepositAssetIxArgs, type ManagerRedepositAssetTxArgs, ManagerWithdrawAssetBuilder, type ManagerWithdrawAssetIxArgs, type ManagerWithdrawAssetTxArgs, MarginfiPositionProvider, type MintConfig, type MintIdentifier, type MintInfo, MintRegistry, type MintRegistryOptions, type MockYieldAccountConfig, MockYieldTracker, type MockYieldTrackerOptions, NEST_API_BASE_URL, NEST_RWA_SHARE_MINT, NEST_VAULT_SLUG, type NavCrankBlocker, type NavCrankBlockerReason, type NavCrankReadiness, type NavCrankResult, NestPriceSource, type NestPriceSourceOptions, ORACLE_ENTRIES_OFFSET, ORACLE_ENTRY_SIZE, ORACLE_SETTLED_NAV_TS_OFFSET, OracleService, PRICE_ORACLE_TYPES_BY_INDEX, PROGRAM_FEE_EXEMPT_OWNER_WHITELIST, PROTOCOL_ADMIN, PROTOCOL_FEE_RECIPIENT, PdaClient, type PreparedDirectTransaction, type PreparedSquadsTransaction, type PreparedVaultTransaction, type PriceOracleTypeArgs, type PriceSource, ProtocolInteractionBuilder, type ProtocolInteractionIxArgs, type ProtocolInteractionTxArgs, type QuoteFeeUnit, REPORTABLE_ORACLE_VARIANTS, type RefreshLiveOraclePricesParams, RemoveAssetHoldingBuilder, type RemoveAssetHoldingIxArgs, type RemoveAssetHoldingTxArgs, RequestJuniorTrancheWithdrawBuilder, type RequestJuniorTrancheWithdrawIxArgs, type RequestJuniorTrancheWithdrawTxArgs, type ResolvedSquadsWalletRoute, type RollingLimitConfig, type RollingRebalanceLimitConfig, type RunLiveConsensusOracleOptions, type RunOptions, type RunSummary, SHARE_DECIMALS, SYSTEM_PROGRAM, SetAssetPriceOracleBuilder, type SetAssetPriceOracleIxArgs, type SetAssetPriceOracleTxArgs, SetExternalLiquidityBuilder, type SetExternalLiquidityIxArgs, type SetExternalLiquidityTxArgs, SetManagerWithdrawDestinationBuilder, type SetManagerWithdrawDestinationIxArgs, type SetManagerWithdrawDestinationTxArgs, SetProtocolFeeBuilder, type SetProtocolFeeIxArgs, type SetProtocolFeeTxArgs, SetVaultConfigBuilder, type SetVaultConfigIxArgs, type SetVaultConfigTxArgs, type SettleVaultParams, type SettleVaultResult, type SettlementSimulation, type SettlementSimulationSnapshot, type SimulateDryRunSettlementParams, type SimulateSettlementArgs, type SimulatedShareClass, type SquadsWalletRouteConfig, type StaleBalanceChangeBypass, 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, assertNoLargeBalanceChanges, assertNoUnconfirmedYieldPayments, buildHoldingUpdate, buildUpdates, coerceBool, collectSamples, confirmYieldPayment, createAccount, createLiveConsensusOracleDeps, createRpcFromConnection, createTokenMint, createTokenMintIxs, createVaultClient, createYieldPayment, dateToStr, defaultKeypairPath, deleteAccount, discoverVaultsForSigner, fetchExternalPositions, fetchNestTokenPrice, fetchReceiptMints, filterTargetHoldings, findLargeBalanceChanges, findSquadsWalletRoute, formatSettlementSimulation, fromUiAmount, gatherPricingInputs, getAccounts, getBalance, getCashflows, getRpcUrl, getTotalOutstandingYield, getTotalYield, getVaultProgramId, getYield, getYieldPayments, indexConfigByMint, isVaultEnv, keypairAddress, loadKeypair, logProspectiveApy, makeProvider, mintTokensTo, mints, mostFrequent, parseExternalLiquidityRefs, planRebalance, prepareVaultTransaction, priceInAccountingUnit, readI64LE, readSplMintSupply, refreshLiveOraclePrices, resolveKeypairPath, resolveSquadsWalletRoute, resolveTrackedAmounts, roundToNextUtcMidnight, runLiveConsensusOracle, selectReportableHoldings, settleVault, signerInOracleData, simulateConsensusOracleSettlement, simulateDryRunSettlement, sumPositionsByMint, systemClock, toBigInt, toUiAmount, updateAccount, updateDynamicApr, validateSquadsWalletRoutes, variantName, vaultAuthorityForWallet, withDiscoveredYieldAccounts };
+export { ASSET_DECIMALS, ASSET_REBALANCE_COOLDOWN_SECS, type AccountBalanceResponse, AccountClient, type AccountYieldResponse, ActivateCircuitBreakerBuilder, type ActivateCircuitBreakerIxArgs, type ActivateCircuitBreakerTxArgs, type AddAprCashflowUpdateParams, type AddCashflowUpdateParams, type AddNavCashflowUpdateParams, type AprAccountBalanceResponse, type AprAccountYieldResponse, type AssetPriceOracleConfigIxArgs, type AssetPriceOracleConfigTxArgs, type AssetPriceRefreshTarget, type AssetRefreshResult, type AssetType, BALANCE_CHANGE_BASELINE_MAX_AGE_SECS, type Bankineco, type BasicAuthCredentials, type Bigintish, CONSENSUS_ORACLE_VARIANT, CancelJuniorTrancheWithdrawBuilder, type CancelJuniorTrancheWithdrawIxArgs, type CancelJuniorTrancheWithdrawTxArgs, type Clock, type CollectSamplesOptions, type ConsensusAssetUpdate, type ConsensusHoldingEntry, type ConsensusHoldingSimulation, type ConsensusOracleDeps, type ConsensusOracleHoldingConfig, ConsensusOracleService, type ConsensusOracleTarget, CrankNavBuilder, type CrankNavIxArgs, type CrankNavTxArgs, CrankPerformanceFeesBuilder, type CrankPerformanceFeesIxArgs, type CrankPerformanceFeesTxArgs, type CreateAccountParams, CreateAssetHoldingBuilder, type CreateAssetHoldingIxArgs, type CreateAssetHoldingTxArgs, type CreateTokenMintIxs, CreateTrancheStateBuilder, type CreateTrancheStateIxArgs, type CreateTrancheStateTxArgs, CreateVaultBuilder, type CreateVaultClientOptions, type CreateVaultIxArgs, type CreateVaultParams, type CreateVaultTxArgs, type CreateYieldPaymentParams, DEFAULT_CU_PRICE_MICRO_LAMPORTS, DEFAULT_JUNIOR_EARLY_UNSTAKE_FEE_BPS, DEFAULT_JUNIOR_STANDARD_UNSTAKE_FEE_BPS, DEFAULT_JUNIOR_WITHDRAWAL_LOCKUP_SECS, DEFAULT_MAX_ACCEPTABLE_APY_BPS, DEFAULT_MAX_ACCOUNTS, DEFAULT_MINTS, DEFAULT_MIN_AMOUNT_UI, DEFAULT_ORACLE_STALENESS_THRESHOLD_SECS, DEFAULT_PRICE_ORACLE_ACCOUNT, DEFAULT_PRICE_STALENESS_SECS, DEFAULT_PRICE_STALENESS_THRESHOLD_SECS, DEFAULT_REBALANCE_BAND_BPS, DEFAULT_SLIPPAGE_BPS, DEFAULT_TARGET_LOCAL_BPS, DEFAULT_VAULT_ID, type DecodedHolding, type DecodedVault, type DecodedVaultTrancheState, type DeleteAccountParams, DisableCircuitBreakerBuilder, type DisableCircuitBreakerIxArgs, type DisableCircuitBreakerTxArgs, EXTERNAL_POSITION_SAMPLES, ExecuteDepositBuilder, type ExecuteDepositIxArgs, type ExecuteDepositTxArgs, ExecuteShareSwapBuilder, type ExecuteShareSwapIxArgs, type ExecuteShareSwapTxArgs, ExecuteTrancheDepositBuilder, type ExecuteTrancheDepositIxArgs, type ExecuteTrancheDepositTxArgs, ExecuteTrancheWithdrawBuilder, type ExecuteTrancheWithdrawIxArgs, type ExecuteTrancheWithdrawTxArgs, ExecuteWithdrawBuilder, type ExecuteWithdrawIxArgs, type ExecuteWithdrawTxArgs, type ExternalLiquidityIntegrityOptions, type ExternalLiquidityIntegrityResult, ExternalLiquidityIntegrityService, type ExternalLiquidityIntegritySummary, type ExternalLiquiditySlot, type ExternalLiquiditySourceArgs, type ExternalPosition, type ExternalPositionContext, type ExternalPositionProvider, type ExternalPositionRef, ExternalPositionRegistry, FEE_VAULT_CACHE_CATEGORY, type FeeVaultAccountData, type FetchNestTokenPriceOptions, FulfillJuniorTrancheWithdrawBuilder, type FulfillJuniorTrancheWithdrawIxArgs, type FulfillJuniorTrancheWithdrawTxArgs, type FulfillSummary, type HoldingNavContribution, type HoldingUpdatePreview, IDL, IDLE_RESERVE_FLOOR_BPS, IDLE_RESERVE_TARGET_BPS, type IdleLiquidityOptions, type IdleLiquidityResult, IdleLiquidityService, type IdleLiquidityStatus, InitializeVaultRolesBuilder, type InitializeVaultRolesIxArgs, type InitializeVaultRolesTxArgs, type JuniorWithdrawalMode, JupiterBalanceSource, type JupiterBalanceSourceOptions, JupiterPriceSource, type JupiterPriceSourceOptions, JupiterSwapBuilder, type JupiterSwapIxArgs, type JupiterSwapTxArgs, KaminoPositionProvider, LIVE_ORACLE_VARIANTS, LIVE_PRICE_REFRESH_INTERVAL_SECS, LOCAL_PROTOCOL_ADMIN, LargeBalanceChangeError, type LargeBalanceChangeViolation, type LiveConsensusOracleDepsOptions, LivePriceSource, type LivePriceSourceOptions, MAX_BALANCE_CHANGE_BPS, MAX_CONSENSUS_SIGNERS, MAX_MANAGER_WITHDRAW_DESTINATIONS, MAX_PRICE_STALENESS_THRESHOLD_SECS, MIN_EXTERNAL_POSITION_SAMPLES, ManagerRedepositAssetBuilder, type ManagerRedepositAssetIxArgs, type ManagerRedepositAssetTxArgs, ManagerWithdrawAssetBuilder, type ManagerWithdrawAssetIxArgs, type ManagerWithdrawAssetTxArgs, MarginfiPositionProvider, type MintConfig, type MintIdentifier, type MintInfo, MintRegistry, type MintRegistryOptions, type MockYieldAccountConfig, MockYieldTracker, type MockYieldTrackerOptions, NEST_API_BASE_URL, NEST_RWA_SHARE_MINT, NEST_VAULT_SLUG, type NavAccountBalanceResponse, type NavAccountValueResponse, type NavCrankBlocker, type NavCrankBlockerReason, type NavCrankReadiness, type NavCrankResult, type NavPriceConfig, type NavYieldAccount, NestPriceSource, type NestPriceSourceOptions, ORACLE_ENTRIES_OFFSET, ORACLE_ENTRY_SIZE, ORACLE_SETTLED_NAV_TS_OFFSET, OracleService, PRICE_ORACLE_TYPES_BY_INDEX, PROGRAM_FEE_EXEMPT_OWNER_WHITELIST, PROTOCOL_ADMIN, PROTOCOL_FEE_RECIPIENT, PdaClient, type PreparedDirectTransaction, type PreparedSquadsTransaction, type PreparedVaultTransaction, type PriceOracleTypeArgs, type PriceSource, ProtocolInteractionBuilder, type ProtocolInteractionIxArgs, type ProtocolInteractionTxArgs, type QuoteFeeUnit, REPORTABLE_ORACLE_VARIANTS, type RefreshLiveOraclePricesParams, RemoveAssetHoldingBuilder, type RemoveAssetHoldingIxArgs, type RemoveAssetHoldingTxArgs, RequestJuniorTrancheWithdrawBuilder, type RequestJuniorTrancheWithdrawIxArgs, type RequestJuniorTrancheWithdrawTxArgs, type ResolvedSquadsWalletRoute, type RollingLimitConfig, type RollingRebalanceLimitConfig, type RunLiveConsensusOracleOptions, type RunOptions, type RunSummary, SHARE_DECIMALS, SYSTEM_PROGRAM, SetAssetPriceOracleBuilder, type SetAssetPriceOracleIxArgs, type SetAssetPriceOracleTxArgs, SetExternalLiquidityBuilder, type SetExternalLiquidityIxArgs, type SetExternalLiquidityTxArgs, SetManagerWithdrawDestinationBuilder, type SetManagerWithdrawDestinationIxArgs, type SetManagerWithdrawDestinationTxArgs, SetProtocolFeeBuilder, type SetProtocolFeeIxArgs, type SetProtocolFeeTxArgs, SetVaultConfigBuilder, type SetVaultConfigIxArgs, type SetVaultConfigTxArgs, type SettleVaultParams, type SettleVaultResult, type SettlementSimulation, type SettlementSimulationSnapshot, type SimulateDryRunSettlementParams, type SimulateSettlementArgs, type SimulatedShareClass, type SquadsWalletRouteConfig, type StaleBalanceChangeBypass, StaticPositionProvider, TOKEN_PROGRAM, TOKEN_PROGRAM_ID, type TrackedAccountValue, type TrancheKindArgs, type TransactionBuilder, TransactionClient, USDC_MINT, USD_STAR_JUNIOR_MINT, USD_STAR_MINT, USD_STAR_PRINCIPAL_MINT, type UpdateAccountParams, UpdateAssetPriceBuilder, type UpdateAssetPriceIxArgs, type UpdateAssetPriceTxArgs, UpdateConsensusOracleBuilder, type UpdateConsensusOracleIxArgs, type UpdateConsensusOracleTxArgs, UpdateConsensusSignersBuilder, type UpdateConsensusSignersIxArgs, type UpdateConsensusSignersTxArgs, type UpdateDynamicAprParams, UpdateTrancheConfigBuilder, type UpdateTrancheConfigIxArgs, type UpdateTrancheConfigTxArgs, VAULT_CACHE_CATEGORY, VAULT_CREATOR_WHITELIST, VAULT_ENVIRONMENTS, VAULT_ORACLE_CACHE_CATEGORY, VAULT_PROGRAM_ID, VAULT_PROGRAM_IDS, VAULT_PROGRAM_PUBLIC_KEY, VAULT_ROLE_UPDATE_TIMELOCK_SECS, VAULT_TRANCHE_STATE_CACHE_CATEGORY, VAULT_TRANCHE_WITHDRAWAL_QUEUE_CACHE_CATEGORY, type Vault, type VaultAccountData, VaultBuilderBase, type VaultBuilderContext, type VaultCacheInvalidation, VaultClient, type VaultClientBundle, type VaultEnv, type 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 YieldCashflow, type YieldPaymentResponse, type YieldPaymentSnapshot, type YieldTracker, type YieldValuationModel, accountingUnitPriceToUsd, addCashflowUpdate, applyEffectiveApy, assertNoLargeBalanceChanges, assertNoUnconfirmedYieldPayments, buildHoldingUpdate, buildUpdates, coerceBool, collectSamples, confirmYieldPayment, createAccount, createLiveConsensusOracleDeps, createRpcFromConnection, createTokenMint, createTokenMintIxs, createVaultClient, createYieldPayment, dateToStr, defaultKeypairPath, deleteAccount, discoverVaultsForSigner, fetchExternalPositions, fetchNestTokenPrice, fetchReceiptMints, filterTargetHoldings, findLargeBalanceChanges, findSquadsWalletRoute, formatSettlementSimulation, fromUiAmount, gatherPricingInputs, getAccount, getAccounts, getAprYield, getBalance, getCashflows, getNavValue, getRpcUrl, getTotalOutstandingYield, getTotalTrackedValue, getTotalYield, getTrackedValue, getVaultProgramId, getYield, getYieldPayments, indexConfigByMint, isNavAccountBalance, isNavAccountValue, isNavYieldAccount, isVaultEnv, keypairAddress, loadKeypair, logProspectiveApy, makeProvider, mintTokensTo, mints, mostFrequent, parseExternalLiquidityRefs, planRebalance, prepareVaultTransaction, priceInAccountingUnit, readI64LE, readSplMintSupply, refreshLiveOraclePrices, resolveKeypairPath, resolveSquadsWalletRoute, resolveTrackedAmounts, roundToNextUtcMidnight, runLiveConsensusOracle, selectReportableHoldings, settleVault, signerInOracleData, simulateConsensusOracleSettlement, simulateDryRunSettlement, sumPositionsByMint, systemClock, toBigInt, toUiAmount, trackedValueFromResponse, updateAccount, updateDynamicApr, validateSquadsWalletRoutes, variantName, vaultAuthorityForWallet, withDiscoveredYieldAccounts };

package/dist/index.js

@@ -3393,16 +3393,24 @@ __export(index_exports, {
   formatSettlementSimulation: () => formatSettlementSimulation,
   fromUiAmount: () => fromUiAmount,
   gatherPricingInputs: () => gatherPricingInputs,
+  getAccount: () => getAccount,
   getAccounts: () => getAccounts,
+  getAprYield: () => getAprYield,
   getBalance: () => getBalance,
   getCashflows: () => getCashflows,
+  getNavValue: () => getNavValue,
   getRpcUrl: () => getRpcUrl,
   getTotalOutstandingYield: () => getTotalOutstandingYield,
+  getTotalTrackedValue: () => getTotalTrackedValue,
   getTotalYield: () => getTotalYield,
+  getTrackedValue: () => getTrackedValue,
   getVaultProgramId: () => getVaultProgramId,
   getYield: () => getYield,
   getYieldPayments: () => getYieldPayments,
   indexConfigByMint: () => indexConfigByMint,
+  isNavAccountBalance: () => isNavAccountBalance,
+  isNavAccountValue: () => isNavAccountValue,
+  isNavYieldAccount: () => isNavYieldAccount,
   isVaultEnv: () => isVaultEnv,
   keypairAddress: () => keypairAddress,
   loadKeypair: () => loadKeypair,
@@ -3432,6 +3440,7 @@ __export(index_exports, {
   systemClock: () => systemClock,
   toBigInt: () => toBigInt2,
   toUiAmount: () => toUiAmount,
+  trackedValueFromResponse: () => trackedValueFromResponse,
   updateAccount: () => updateAccount,
   updateDynamicApr: () => updateDynamicApr,
   validateSquadsWalletRoutes: () => validateSquadsWalletRoutes,
@@ -20259,33 +20268,60 @@ function getAdminSecret(adminSecret) {
   }
   return secret;
 }
+function isNavYieldAccount(account) {
+  return account.valuation_model === "nav";
+}
 async function createAccount(params) {
-  if (params.type === "dynamic" && params.apr === void 0) {
+  const valuationModel = params.valuationModel ?? "apr";
+  if (valuationModel === "nav" && !params.navConfig) {
+    throw new Error("navConfig is required when creating a NAV account");
+  }
+  if (valuationModel === "nav" && params.apr !== void 0) {
+    throw new Error("NAV accounts cannot define apr");
+  }
+  if (valuationModel === "apr" && params.type === "dynamic" && params.apr === void 0) {
     throw new Error("apr is required when creating a dynamic yield account");
   }
   if (params.apr !== void 0) {
     assertValidApr(params.apr);
   }
-  return await yieldApiReq(
-    "accounts/new",
-    "POST",
-    {
-      name: params.name,
-      type: params.type,
-      apr: params.apr,
-      tag: params.tag,
-      password: params.password,
-      description: params.description
-    },
-    {
-      adminSecret: getAdminSecret(params.adminSecret)
-    }
+  return unwrapData(
+    await yieldApiReq(
+      "accounts/new",
+      "POST",
+      {
+        name: params.name,
+        type: params.type,
+        apr: params.apr,
+        valuation_model: valuationModel,
+        nav_config: params.navConfig,
+        tag: params.tag,
+        password: params.password,
+        description: params.description
+      },
+      {
+        adminSecret: getAdminSecret(params.adminSecret)
+      }
+    )
   );
 }
 async function getAccounts() {
   return unwrapData(await yieldApiReq("accounts", "GET"));
 }
+async function getAccount(accountName) {
+  return unwrapData(
+    await yieldApiReq(accountEndpoint(accountName), "GET")
+  );
+}
 async function updateAccount(params) {
+  if (params.valuationModel === "nav") {
+    if (!params.navConfig) {
+      throw new Error("navConfig is required when switching to a NAV account");
+    }
+    if (params.apr !== void 0) {
+      throw new Error("NAV accounts cannot define apr");
+    }
+  }
   if (params.apr !== void 0) {
     assertValidApr(params.apr);
   }
@@ -20306,7 +20342,9 @@ async function updateAccount(params) {
         type: params.type,
         apr: params.apr,
         tag: params.tag,
-        description: params.description
+        description: params.description,
+        valuation_model: params.valuationModel,
+        nav_config: params.navConfig
       },
       auth.options
     )
@@ -20346,28 +20384,51 @@ async function updateDynamicApr(params) {
   );
 }
 async function addCashflowUpdate(params) {
-  if (params.fundingNextDay) {
-    params.date = roundToNextUtcMidnight(params.date);
-  }
-  return await yieldApiReq(
-    accountEndpoint(params.accountName, "cashflows"),
-    "POST",
-    {
-      amount: params.cashflowType === "deposit" ? params.amount : params.amount * -1,
-      timestamp: params.date ? dateToStr(params.date) : void 0,
-      description: params.description,
-      password: params.password
+  const runtimeParams = params;
+  if (params.valuationModel === "nav") {
+    if (runtimeParams.date !== void 0 || runtimeParams.fundingNextDay !== void 0) {
+      throw new Error(
+        "NAV cashflows execute immediately and cannot specify date or fundingNextDay"
+      );
+    }
+    if (!Number.isSafeInteger(params.amount)) {
+      throw new Error(
+        "NAV cashflow amount must be an integer number of base units"
+      );
     }
+  }
+  const effectiveDate = params.valuationModel === "nav" ? void 0 : params.fundingNextDay ? roundToNextUtcMidnight(params.date ?? /* @__PURE__ */ new Date()) : params.date;
+  return unwrapData(
+    await yieldApiReq(
+      accountEndpoint(params.accountName, "cashflows"),
+      "POST",
+      {
+        amount: params.cashflowType === "deposit" ? Math.abs(params.amount) : -Math.abs(params.amount),
+        timestamp: params.valuationModel === "nav" || !effectiveDate ? void 0 : dateToStr(effectiveDate),
+        description: params.description,
+        password: params.password
+      }
+    )
   );
 }
 async function getCashflows(accountName) {
-  return (await yieldApiReq(accountEndpoint(accountName, "cashflows"), "GET")).data;
+  return unwrapData(
+    await yieldApiReq(accountEndpoint(accountName, "cashflows"), "GET")
+  );
+}
+function isNavAccountBalance(response) {
+  return response.valuation_model === "nav";
 }
 async function getBalance(accountName, atTime) {
-  return (await yieldApiReq(
-    accountEndpoint(accountName, "balance") + (atTime ? `?as_of=${dateToStr(atTime)}` : ""),
-    "GET"
-  )).data;
+  return unwrapData(
+    await yieldApiReq(
+      accountEndpoint(accountName, "balance") + (atTime ? `?as_of=${dateToStr(atTime)}` : ""),
+      "GET"
+    )
+  );
+}
+function isNavAccountValue(response) {
+  return response.valuation_model === "nav";
 }
 async function createYieldPayment(params) {
   return unwrapData(
@@ -20404,15 +20465,63 @@ async function getYieldPayments(accountName) {
   );
 }
 async function getYield(accountName, start, end) {
-  return (await yieldApiReq(
-    accountEndpoint(accountName, "yield") + (start ? `?start=${dateToStr(start)}` : "") + (start && end ? `&end=${dateToStr(end)}` : end ? `?end=${dateToStr(end)}` : ""),
-    "GET"
-  )).data;
+  return unwrapData(
+    await yieldApiReq(
+      accountEndpoint(accountName, "yield") + (start ? `?start=${dateToStr(start)}` : "") + (start && end ? `&end=${dateToStr(end)}` : end ? `?end=${dateToStr(end)}` : ""),
+      "GET"
+    )
+  );
+}
+async function getAprYield(accountName, start, end) {
+  const response = await getYield(accountName, start, end);
+  if (isNavAccountValue(response)) {
+    throw new Error(`Account "${accountName}" uses NAV valuation, not APR`);
+  }
+  return response;
+}
+async function getNavValue(accountName) {
+  const response = await getYield(accountName);
+  if (!isNavAccountValue(response)) {
+    throw new Error(`Account "${accountName}" uses APR valuation, not NAV`);
+  }
+  return response;
+}
+function trackedValueFromResponse(response) {
+  if (isNavAccountValue(response)) {
+    const totalValue2 = Number(response.total_nav);
+    if (!Number.isFinite(totalValue2) || totalValue2 < 0) {
+      throw new Error("NAV account returned an invalid total_nav");
+    }
+    return {
+      totalValue: totalValue2,
+      principal: 0,
+      outstandingYield: 0,
+      valuationModel: "nav"
+    };
+  }
+  const totalValue = response.principal_at_end + response.outstanding_yield;
+  if (!Number.isFinite(totalValue)) {
+    throw new Error("APR account returned an invalid tracked value");
+  }
+  return {
+    totalValue,
+    principal: response.principal_at_end,
+    outstandingYield: response.outstanding_yield,
+    valuationModel: "apr"
+  };
+}
+async function getTrackedValue(accountName) {
+  return trackedValueFromResponse(await getYield(accountName));
 }
 async function getTotalYield(accountNames, start, end) {
   let totalYield = new import_core20.BN(0);
   for (const accountName of accountNames) {
     const res = await getYield(accountName, start, end);
+    if (isNavAccountValue(res)) {
+      throw new Error(
+        `NAV account "${accountName}" does not report accrued yield`
+      );
+    }
     console.log(res);
     totalYield = totalYield.add(new import_core20.BN(res.total_yield));
   }
@@ -20422,10 +20531,28 @@ async function getTotalOutstandingYield(accountNames, start, end) {
   let total = 0;
   for (const accountName of accountNames) {
     const response = await getYield(accountName, start, end);
+    if (isNavAccountValue(response)) {
+      throw new Error(
+        `NAV account "${accountName}" does not report outstanding yield`
+      );
+    }
     total += response.outstanding_yield;
   }
   return total;
 }
+async function getTotalTrackedValue(accountNames, start, end) {
+  let totalValue = 0;
+  let principal = 0;
+  let outstandingYield = 0;
+  for (const accountName of accountNames) {
+    const response = await getYield(accountName, start, end);
+    const tracked = trackedValueFromResponse(response);
+    totalValue += tracked.totalValue;
+    principal += tracked.principal;
+    outstandingYield += tracked.outstandingYield;
+  }
+  return { totalValue, principal, outstandingYield };
+}
 
 // src/services/withdrawalQueueService.ts
 var import_common40 = __toESM(require_dist());
@@ -20987,6 +21114,7 @@ function evaluateBalanceChanges(vaultState, updates, thresholdBps, nowSecs) {
       walletAmount: update.walletAmount,
       lpAmount: update.lpAmount,
       trackedPrincipalAmount: update.trackedPrincipalAmount,
+      trackedValueAmount: update.trackedValueAmount,
       yieldAmount: update.yieldAmount
     };
     const lastUpdateTs = toBigInt2(holding.lastUpdateTs);
@@ -21051,6 +21179,9 @@ function assertNoLargeBalanceChanges(vault, vaultState, updates, nowSecs, log =
       )} lp=${formatTokenAmount(
         violation.lpAmount,
         violation.decimals
+      )} tracked=${formatTokenAmount(
+        violation.trackedValueAmount,
+        violation.decimals
       )} principal=${formatTokenAmount(
         violation.trackedPrincipalAmount,
         violation.decimals
@@ -22202,7 +22333,7 @@ async function buildHoldingUpdate(yieldTracker, entry, inputs) {
   }
   const walletAmount = inputs.walletBalances[mintKey] ?? 0n;
   const lpAmount = inputs.lpByMint.get(mintKey) ?? 0n;
-  const { principalAmount, yieldAmount } = await resolveTrackedAmounts(
+  const { trackedValueAmount, principalAmount, yieldAmount } = await resolveTrackedAmounts(
     yieldTracker,
     inputs.configByMint.get(mintKey),
     holding.decimals
@@ -22217,17 +22348,36 @@ async function buildHoldingUpdate(yieldTracker, entry, inputs) {
     lpAmount,
     yieldAmount,
     trackedPrincipalAmount: principalAmount,
-    externalAmount: walletAmount + lpAmount + principalAmount + yieldAmount
+    trackedValueAmount,
+    externalAmount: walletAmount + lpAmount + trackedValueAmount
   };
 }
 async function resolveTrackedAmounts(yieldTracker, cfg, decimals) {
   if (!yieldTracker || !cfg?.yieldAccountNames?.length) {
-    return { principalAmount: 0n, yieldAmount: 0n };
+    return {
+      trackedValueAmount: 0n,
+      principalAmount: 0n,
+      yieldAmount: 0n
+    };
+  }
+  let tracked;
+  if (yieldTracker.getTotalTrackedValue) {
+    tracked = await yieldTracker.getTotalTrackedValue(cfg.yieldAccountNames);
+  } else if (yieldTracker.getTotalTrackedAmounts) {
+    const legacy = await yieldTracker.getTotalTrackedAmounts(
+      cfg.yieldAccountNames
+    );
+    tracked = {
+      totalValue: legacy.principal + legacy.outstandingYield,
+      ...legacy
+    };
+  } else {
+    throw new Error(
+      "yield tracker does not implement getTotalTrackedValue or its legacy fallback"
+    );
   }
-  const tracked = await yieldTracker.getTotalTrackedAmounts(
-    cfg.yieldAccountNames
-  );
   return {
+    trackedValueAmount: tracked.totalValue > 0 ? (0, import_common44.fromUiAmount)(tracked.totalValue, decimals) : 0n,
     principalAmount: tracked.principal > 0 ? (0, import_common44.fromUiAmount)(tracked.principal, decimals) : 0n,
     yieldAmount: tracked.outstandingYield > 0 ? (0, import_common44.fromUiAmount)(tracked.outstandingYield, decimals) : 0n
   };
@@ -22506,7 +22656,7 @@ async function settleVault2({
   log(`vault ${vault}: submitting ${updates.length} consensus asset update(s)`);
   for (const update of updates) {
     log(
-      `  holding #${update.holdingIndex} ${update.mint}: price=${update.price} external_amount=${update.externalAmount} [wallet=${update.walletAmount} lp=${update.lpAmount} principal=${update.trackedPrincipalAmount} yield=${update.yieldAmount}]`
+      `  holding #${update.holdingIndex} ${update.mint}: price=${update.price} external_amount=${update.externalAmount} [wallet=${update.walletAmount} lp=${update.lpAmount} tracked=${update.trackedValueAmount} principal=${update.trackedPrincipalAmount} yield=${update.yieldAmount}]`
     );
   }
   await logProspectiveApy({
@@ -22943,7 +23093,7 @@ var MockYieldTracker = class {
     }
     return total;
   }
-  async getTotalTrackedAmounts(accountNames, start, end) {
+  async getTotalTrackedValue(accountNames, start, end) {
     let principal = 0;
     let outstandingYield = 0;
     for (const name of accountNames) {
@@ -22951,7 +23101,19 @@ var MockYieldTracker = class {
       principal += snapshot2.principalAtEnd;
       outstandingYield += snapshot2.outstandingYield;
     }
-    return { principal, outstandingYield };
+    return {
+      totalValue: principal + outstandingYield,
+      principal,
+      outstandingYield
+    };
+  }
+  /** Backward-compatible APR-only breakdown. */
+  async getTotalTrackedAmounts(accountNames, start, end) {
+    const tracked = await this.getTotalTrackedValue(accountNames, start, end);
+    return {
+      principal: tracked.principal,
+      outstandingYield: tracked.outstandingYield
+    };
   }
   async getBalance(accountName, atTime) {
     const snapshot2 = await this.getYield(accountName, void 0, atTime);
@@ -23041,17 +23203,12 @@ function createLiveConsensusOracleDeps(connection, opts = {}) {
         const raw = await getTotalOutstandingYield(accountNames, start, end);
         return raw / 10 ** YIELD_TRACKER_DECIMALS;
       },
-      async getTotalTrackedAmounts(accountNames, start, end) {
-        let principal = 0;
-        let outstandingYield = 0;
-        for (const accountName of accountNames) {
-          const snapshot2 = await getYield(accountName, start, end);
-          principal += snapshot2.principal_at_end;
-          outstandingYield += snapshot2.outstanding_yield;
-        }
+      async getTotalTrackedValue(accountNames, start, end) {
+        const tracked = await getTotalTrackedValue(accountNames, start, end);
         return {
-          principal: principal / 10 ** YIELD_TRACKER_DECIMALS,
-          outstandingYield: outstandingYield / 10 ** YIELD_TRACKER_DECIMALS
+          totalValue: tracked.totalValue / 10 ** YIELD_TRACKER_DECIMALS,
+          principal: tracked.principal / 10 ** YIELD_TRACKER_DECIMALS,
+          outstandingYield: tracked.outstandingYield / 10 ** YIELD_TRACKER_DECIMALS
         };
       },
       getYieldPayments
@@ -24140,16 +24297,24 @@ var import_common53 = __toESM(require_dist());
   formatSettlementSimulation,
   fromUiAmount,
   gatherPricingInputs,
+  getAccount,
   getAccounts,
+  getAprYield,
   getBalance,
   getCashflows,
+  getNavValue,
   getRpcUrl,
   getTotalOutstandingYield,
+  getTotalTrackedValue,
   getTotalYield,
+  getTrackedValue,
   getVaultProgramId,
   getYield,
   getYieldPayments,
   indexConfigByMint,
+  isNavAccountBalance,
+  isNavAccountValue,
+  isNavYieldAccount,
   isVaultEnv,
   keypairAddress,
   loadKeypair,
@@ -24179,6 +24344,7 @@ var import_common53 = __toESM(require_dist());
   systemClock,
   toBigInt,
   toUiAmount,
+  trackedValueFromResponse,
   updateAccount,
   updateDynamicApr,
   validateSquadsWalletRoutes,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@perena/vault-sdk",
-  "version": "1.0.34",
+  "version": "1.0.36",
   "description": "Vault program helpers for Bankineco integrations.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",