@perena/vault-sdk 1.0.19 → 1.0.20

package/dist/index.d.ts

@@ -9756,6 +9756,11 @@ type Bankineco = {
             "code": 6042;
             "name": "invalidFeeExemption";
             "msg": "Invalid fee-exemption PDA signer or seeds";
+        },
+        {
+            "code": 6043;
+            "name": "exceedsJuniorDepositCap";
+            "msg": "Deposit would exceed the junior tranche deposit cap";
         }
     ];
     "types": [
@@ -12140,6 +12145,13 @@ type Bankineco = {
                         "name": "targetLockupDurationSecs";
                         "type": "i64";
                     },
+                    {
+                        "name": "juniorDepositCap";
+                        "docs": [
+                            "Maximum junior tranche value in accounting units. Zero means uncapped."
+                        ];
+                        "type": "u64";
+                    },
                     {
                         "name": "forMigration";
                         "docs": [
@@ -12937,12 +12949,21 @@ type Bankineco = {
                         "name": "targetLockupDurationSecs";
                         "type": "i64";
                     },
+                    {
+                        "name": "juniorDepositCap";
+                        "docs": [
+                            "Maximum junior tranche value in vault accounting units. Zero disables",
+                            "the cap. Yield may carry the tranche above this value, but further",
+                            "junior deposits remain blocked until its value falls below the cap."
+                        ];
+                        "type": "u64";
+                    },
                     {
                         "name": "padding2";
                         "type": {
                             "array": [
                                 "u64",
-                                14
+                                13
                             ];
                         };
                     }
@@ -13060,6 +13081,15 @@ type Bankineco = {
                         "type": {
                             "option": "i64";
                         };
+                    },
+                    {
+                        "name": "juniorDepositCap";
+                        "docs": [
+                            "Maximum junior tranche value in accounting units. Zero means uncapped."
+                        ];
+                        "type": {
+                            "option": "u64";
+                        };
                     }
                 ];
             };
@@ -14133,6 +14163,7 @@ interface CreateTrancheStateIxArgs {
     earlyUnstakeFeeBps: number;
     standardUnstakeFeeBps: number;
     targetLockupDurationSecs: BN;
+    juniorDepositCap: BN;
     forMigration: boolean;
     tokenProgram: Address;
 }
@@ -14146,6 +14177,8 @@ interface CreateTrancheStateTxArgs {
     earlyUnstakeFeeBps?: number;
     standardUnstakeFeeBps?: number;
     targetLockupDurationSecs?: number;
+    /** Maximum junior tranche value in accounting units. Zero means uncapped. */
+    juniorDepositCap?: bigint;
     forMigration?: boolean;
     tokenProgram?: Address;
 }
@@ -14158,6 +14191,7 @@ interface UpdateTrancheConfigIxArgs {
     earlyUnstakeFeeBps: number | null;
     standardUnstakeFeeBps: number | null;
     targetLockupDurationSecs: BN | null;
+    juniorDepositCap: BN | null;
 }
 interface UpdateTrancheConfigTxArgs {
     curator: Address;
@@ -14168,6 +14202,8 @@ interface UpdateTrancheConfigTxArgs {
     earlyUnstakeFeeBps?: number;
     standardUnstakeFeeBps?: number;
     targetLockupDurationSecs?: number;
+    /** Maximum junior tranche value in accounting units. Zero means uncapped. */
+    juniorDepositCap?: bigint;
 }
 interface InitializeVaultRolesIxArgs {
     curator: Address;
@@ -15466,6 +15502,9 @@ interface AccountYieldResponse {
         updated_at: Date;
     };
     total_yield: number;
+    gross_yield: number;
+    paid_yield: number;
+    outstanding_yield: number;
     principal_at_end: number;
     accrual_start: Date;
     accrual_end: Date;
@@ -15473,8 +15512,36 @@ interface AccountYieldResponse {
     apr_used: number;
     calculation_log: YieldCalculationLog[];
 }
+interface CreateYieldPaymentParams {
+    accountName: string;
+    amount: number;
+    effectiveAt: Date;
+    idempotencyKey: string;
+    password: string;
+}
+interface YieldPaymentResponse {
+    id: string;
+    account_name: string;
+    idempotency_key: string;
+    amount: number;
+    effective_at: Date;
+    status: "pending" | "confirmed";
+    transaction_signature?: string;
+    confirmed_at?: Date;
+    created_at: Date;
+}
+declare function createYieldPayment(params: CreateYieldPaymentParams): Promise<YieldPaymentResponse>;
+declare function confirmYieldPayment(params: {
+    accountName: string;
+    paymentId: string;
+    transactionSignature: string;
+    password: string;
+}): Promise<YieldPaymentResponse>;
+declare function getYieldPayments(accountName: string): Promise<YieldPaymentResponse[]>;
 declare function getYield(accountName: string, start?: Date, end?: Date): Promise<AccountYieldResponse>;
 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>;
 
 /**
  * Junior-tranche withdrawal-queue fulfillment.
@@ -15705,7 +15772,13 @@ interface ExternalPositionProvider {
  */
 interface YieldAccountSnapshot {
     account: string;
+    /** Gross accrued yield before payment settlements. */
     totalYield: number;
+    grossYield: number;
+    /** Confirmed payments inside the requested accrual window. */
+    paidYield: number;
+    /** Gross yield less confirmed payments; this is the oracle-safe receivable. */
+    outstandingYield: number;
     principalAtEnd: number;
     aprUsed: number;
     accrualStart: Date;
@@ -15720,7 +15793,9 @@ interface YieldTracker {
     getYield(accountName: string, start?: Date, end?: Date): Promise<YieldAccountSnapshot>;
     /** Sum of `totalYield` (UI amount) across the named accounts. */
     getTotalYield(accountNames: string[], start?: Date, end?: Date): Promise<number>;
-    /** Current balance (principal + accrued yield), UI amount. */
+    /** Sum of oracle-safe outstanding yield across the named accounts. */
+    getTotalOutstandingYield(accountNames: string[], start?: Date, end?: Date): Promise<number>;
+    /** Current balance (principal + outstanding yield), UI amount. */
     getBalance(accountName: string, atTime?: Date): Promise<number>;
     addCashflow(params: {
         accountName: string;
@@ -15728,6 +15803,19 @@ interface YieldTracker {
         date?: Date;
         cashflowType: "deposit" | "withdraw";
     }): Promise<void>;
+    /** Register an expected payment. Pending payments remain outstanding. */
+    createYieldPayment(params: {
+        accountName: string;
+        paymentId: string;
+        amount: number;
+        effectiveAt: Date;
+    }): Promise<void>;
+    /** Confirm only after the payment is observable in the destination wallet. */
+    confirmYieldPayment(params: {
+        accountName: string;
+        paymentId: string;
+        transactionSignature: string;
+    }): Promise<void>;
 }
 /** Injectable wall clock (ms since epoch). Lets tests pin time deterministically. */
 interface Clock {
@@ -15988,6 +16076,7 @@ declare class MockYieldTracker implements YieldTracker {
     private require;
     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>;
     getBalance(accountName: string, atTime?: Date): Promise<number>;
     addCashflow(params: {
         accountName: string;
@@ -15995,6 +16084,17 @@ declare class MockYieldTracker implements YieldTracker {
         date?: Date;
         cashflowType: "deposit" | "withdraw";
     }): Promise<void>;
+    createYieldPayment(params: {
+        accountName: string;
+        paymentId: string;
+        amount: number;
+        effectiveAt: Date;
+    }): Promise<void>;
+    confirmYieldPayment(params: {
+        accountName: string;
+        paymentId: string;
+        transactionSignature: string;
+    }): Promise<void>;
 }
 
 declare class ConsensusOracleService {
@@ -16087,4 +16187,4 @@ declare class ExternalLiquidityIntegrityService {
     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 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, 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 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, 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, type LiveConsensusOracleDepsOptions, MAX_PRICE_STALENESS_THRESHOLD_SECS, ManagerRedepositAssetBuilder, type ManagerRedepositAssetIxArgs, type ManagerRedepositAssetTxArgs, ManagerWithdrawAssetBuilder, type ManagerWithdrawAssetIxArgs, type ManagerWithdrawAssetTxArgs, MarginfiPositionProvider, type MockYieldAccountConfig, MockYieldTracker, type MockYieldTrackerOptions, type NavCrankBlocker, type NavCrankBlockerReason, type NavCrankReadiness, type NavCrankResult, OracleService, PROGRAM_FEE_EXEMPT_OWNER_WHITELIST, PROTOCOL_ADMIN, PROTOCOL_FEE_RECIPIENT, PdaClient, type PriceOracleTypeArgs, type PriceSource, ProtocolInteractionBuilder, type ProtocolInteractionIxArgs, type ProtocolInteractionTxArgs, type QuoteFeeUnit, RemoveAssetHoldingBuilder, type RemoveAssetHoldingIxArgs, type RemoveAssetHoldingTxArgs, RequestJuniorTrancheWithdrawBuilder, type RequestJuniorTrancheWithdrawIxArgs, type RequestJuniorTrancheWithdrawTxArgs, 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, 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 YieldTracker, addCashflowUpdate, createAccount, createLiveConsensusOracleDeps, createRpcFromConnection, createTokenMint, createTokenMintIxs, createVaultClient, dateToStr, defaultKeypairPath, deleteAccount, fromUiAmount, getAccounts, getBalance, getCashflows, getRpcUrl, getTotalYield, getVaultProgramId, getYield, isVaultEnv, keypairAddress, loadKeypair, makeProvider, mintTokensTo, resolveKeypairPath, roundToNextUtcMidnight, runLiveConsensusOracle, systemClock, toUiAmount, updateAccount, updateDynamicApr };
+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 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 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, 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, type LiveConsensusOracleDepsOptions, MAX_PRICE_STALENESS_THRESHOLD_SECS, ManagerRedepositAssetBuilder, type ManagerRedepositAssetIxArgs, type ManagerRedepositAssetTxArgs, ManagerWithdrawAssetBuilder, type ManagerWithdrawAssetIxArgs, type ManagerWithdrawAssetTxArgs, MarginfiPositionProvider, type MockYieldAccountConfig, MockYieldTracker, type MockYieldTrackerOptions, type NavCrankBlocker, type NavCrankBlockerReason, type NavCrankReadiness, type NavCrankResult, OracleService, PROGRAM_FEE_EXEMPT_OWNER_WHITELIST, PROTOCOL_ADMIN, PROTOCOL_FEE_RECIPIENT, PdaClient, type PriceOracleTypeArgs, type PriceSource, ProtocolInteractionBuilder, type ProtocolInteractionIxArgs, type ProtocolInteractionTxArgs, type QuoteFeeUnit, RemoveAssetHoldingBuilder, type RemoveAssetHoldingIxArgs, type RemoveAssetHoldingTxArgs, RequestJuniorTrancheWithdrawBuilder, type RequestJuniorTrancheWithdrawIxArgs, type RequestJuniorTrancheWithdrawTxArgs, 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, 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 YieldTracker, addCashflowUpdate, confirmYieldPayment, createAccount, createLiveConsensusOracleDeps, createRpcFromConnection, createTokenMint, createTokenMintIxs, createVaultClient, createYieldPayment, dateToStr, defaultKeypairPath, deleteAccount, fromUiAmount, getAccounts, getBalance, getCashflows, getRpcUrl, getTotalOutstandingYield, getTotalYield, getVaultProgramId, getYield, getYieldPayments, isVaultEnv, keypairAddress, loadKeypair, makeProvider, mintTokensTo, resolveKeypairPath, roundToNextUtcMidnight, runLiveConsensusOracle, systemClock, toUiAmount, updateAccount, updateDynamicApr };

package/dist/index.js

@@ -1461,12 +1461,14 @@ __export(index_exports, {
   WithdrawalQueueService: () => WithdrawalQueueService,
   addCashflowUpdate: () => addCashflowUpdate,
   address: () => import_kit10.address,
+  confirmYieldPayment: () => confirmYieldPayment,
   createAccount: () => createAccount,
   createLiveConsensusOracleDeps: () => createLiveConsensusOracleDeps,
   createRpcFromConnection: () => createRpcFromConnection,
   createTokenMint: () => createTokenMint,
   createTokenMintIxs: () => createTokenMintIxs,
   createVaultClient: () => createVaultClient,
+  createYieldPayment: () => createYieldPayment,
   dateToStr: () => dateToStr,
   defaultKeypairPath: () => defaultKeypairPath,
   deleteAccount: () => deleteAccount,
@@ -1475,9 +1477,11 @@ __export(index_exports, {
   getBalance: () => getBalance,
   getCashflows: () => getCashflows,
   getRpcUrl: () => getRpcUrl,
+  getTotalOutstandingYield: () => getTotalOutstandingYield,
   getTotalYield: () => getTotalYield,
   getVaultProgramId: () => getVaultProgramId,
   getYield: () => getYield,
+  getYieldPayments: () => getYieldPayments,
   isVaultEnv: () => isVaultEnv,
   keypairAddress: () => keypairAddress,
   loadKeypair: () => loadKeypair,
@@ -11238,6 +11242,11 @@ var IDL = {
       "code": 6042,
       "name": "InvalidFeeExemption",
       "msg": "Invalid fee-exemption PDA signer or seeds"
+    },
+    {
+      "code": 6043,
+      "name": "ExceedsJuniorDepositCap",
+      "msg": "Deposit would exceed the junior tranche deposit cap"
     }
   ],
   "types": [
@@ -13622,6 +13631,13 @@ var IDL = {
             "name": "target_lockup_duration_secs",
             "type": "i64"
           },
+          {
+            "name": "junior_deposit_cap",
+            "docs": [
+              "Maximum junior tranche value in accounting units. Zero means uncapped."
+            ],
+            "type": "u64"
+          },
           {
             "name": "for_migration",
             "docs": [
@@ -14419,12 +14435,21 @@ var IDL = {
             "name": "target_lockup_duration_secs",
             "type": "i64"
           },
+          {
+            "name": "junior_deposit_cap",
+            "docs": [
+              "Maximum junior tranche value in vault accounting units. Zero disables",
+              "the cap. Yield may carry the tranche above this value, but further",
+              "junior deposits remain blocked until its value falls below the cap."
+            ],
+            "type": "u64"
+          },
           {
             "name": "_padding2",
             "type": {
               "array": [
                 "u64",
-                14
+                13
               ]
             }
           }
@@ -14542,6 +14567,15 @@ var IDL = {
             "type": {
               "option": "i64"
             }
+          },
+          {
+            "name": "junior_deposit_cap",
+            "docs": [
+              "Maximum junior tranche value in accounting units. Zero means uncapped."
+            ],
+            "type": {
+              "option": "u64"
+            }
           }
         ]
       }
@@ -15931,6 +15965,7 @@ var CreateTrancheStateBuilder = class extends VaultBuilderBase {
       earlyUnstakeFeeBps: args.earlyUnstakeFeeBps,
       standardUnstakeFeeBps: args.standardUnstakeFeeBps,
       targetLockupDurationSecs: args.targetLockupDurationSecs,
+      juniorDepositCap: args.juniorDepositCap,
       forMigration: args.forMigration
     }).accountsPartial({
       curator: (0, import_common8.toWeb3Pk)(args.curator),
@@ -15975,6 +16010,7 @@ var CreateTrancheStateBuilder = class extends VaultBuilderBase {
       targetLockupDurationSecs: new import_core.BN(
         (txArgs.targetLockupDurationSecs ?? DEFAULT_JUNIOR_WITHDRAWAL_LOCKUP_SECS).toString()
       ),
+      juniorDepositCap: new import_core.BN((txArgs.juniorDepositCap ?? 0n).toString()),
       forMigration,
       tokenProgram: txArgs.tokenProgram ?? TOKEN_PROGRAM_ID
     };
@@ -17608,7 +17644,8 @@ var UpdateTrancheConfigBuilder = class extends VaultBuilderBase {
       seniorFixedApyBps: args.seniorFixedApyBps,
       earlyUnstakeFeeBps: args.earlyUnstakeFeeBps,
       standardUnstakeFeeBps: args.standardUnstakeFeeBps,
-      targetLockupDurationSecs: args.targetLockupDurationSecs
+      targetLockupDurationSecs: args.targetLockupDurationSecs,
+      juniorDepositCap: args.juniorDepositCap
     }).accountsPartial({
       curator: (0, import_common29.toWeb3Pk)(args.curator),
       vault: (0, import_common29.toWeb3Pk)(args.vault),
@@ -17629,7 +17666,8 @@ var UpdateTrancheConfigBuilder = class extends VaultBuilderBase {
       seniorFixedApyBps: txArgs.seniorFixedApyBps ?? null,
       earlyUnstakeFeeBps: txArgs.earlyUnstakeFeeBps ?? null,
       standardUnstakeFeeBps: txArgs.standardUnstakeFeeBps ?? null,
-      targetLockupDurationSecs: txArgs.targetLockupDurationSecs === void 0 ? null : new import_core11.BN(txArgs.targetLockupDurationSecs.toString())
+      targetLockupDurationSecs: txArgs.targetLockupDurationSecs === void 0 ? null : new import_core11.BN(txArgs.targetLockupDurationSecs.toString()),
+      juniorDepositCap: txArgs.juniorDepositCap === void 0 ? null : new import_core11.BN(txArgs.juniorDepositCap.toString())
     };
   }
   async buildPlanExtras(args) {
@@ -18677,6 +18715,40 @@ async function getBalance(accountName, atTime) {
     "GET"
   )).data;
 }
+async function createYieldPayment(params) {
+  return unwrapData(
+    await yieldApiReq(
+      accountEndpoint(params.accountName, "yield-payments"),
+      "POST",
+      {
+        amount: params.amount,
+        effective_at: dateToStr(params.effectiveAt),
+        idempotency_key: params.idempotencyKey,
+        password: params.password
+      }
+    )
+  );
+}
+async function confirmYieldPayment(params) {
+  return unwrapData(
+    await yieldApiReq(
+      accountEndpoint(
+        params.accountName,
+        `yield-payments/${encodeURIComponent(params.paymentId)}/confirm`
+      ),
+      "POST",
+      {
+        transaction_signature: params.transactionSignature,
+        password: params.password
+      }
+    )
+  );
+}
+async function getYieldPayments(accountName) {
+  return unwrapData(
+    await yieldApiReq(accountEndpoint(accountName, "yield-payments"), "GET")
+  );
+}
 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)}` : ""),
@@ -18692,6 +18764,14 @@ async function getTotalYield(accountNames, start, end) {
   }
   return totalYield;
 }
+async function getTotalOutstandingYield(accountNames, start, end) {
+  let total = 0;
+  for (const accountName of accountNames) {
+    const response = await getYield(accountName, start, end);
+    total += response.outstanding_yield;
+  }
+  return total;
+}
 
 // src/services/withdrawalQueueService.ts
 var import_common38 = __toESM(require_dist());
@@ -19588,7 +19668,7 @@ var ConsensusOracleService = class {
   /** Accrued yield (base units) attributed to a holding via its configured accounts. */
   async resolveYieldAmount(cfg, decimals) {
     if (!this.deps.yieldTracker || !cfg?.yieldAccountNames?.length) return 0n;
-    const totalYieldUi = await this.deps.yieldTracker.getTotalYield(
+    const totalYieldUi = await this.deps.yieldTracker.getTotalOutstandingYield(
       cfg.yieldAccountNames
     );
     return totalYieldUi > 0 ? (0, import_common41.fromUiAmount)(totalYieldUi, decimals) : 0n;
@@ -19766,7 +19846,8 @@ var MockYieldTracker = class {
         aprBps: cfg.aprBps,
         initialPrincipal: cfg.principal ?? 0,
         startTs: cfg.startTs ?? this.clock.now(),
-        cashflows: []
+        cashflows: [],
+        yieldPayments: []
       });
     }
   }
@@ -19776,7 +19857,8 @@ var MockYieldTracker = class {
       aprBps: cfg.aprBps,
       initialPrincipal: cfg.principal ?? 0,
       startTs: cfg.startTs ?? this.clock.now(),
-      cashflows: []
+      cashflows: [],
+      yieldPayments: []
     });
   }
   require(name) {
@@ -19809,9 +19891,16 @@ var MockYieldTracker = class {
     }
     const tailSecs = Math.max(0, (windowEndMs - segStart) / 1e3);
     totalYield += principal * apr * (tailSecs / SECONDS_PER_YEAR);
+    const paidYield = state.yieldPayments.reduce((sum, payment) => {
+      return payment.status === "confirmed" && payment.effectiveAt > windowStartMs && payment.effectiveAt <= windowEndMs ? sum + payment.amount : sum;
+    }, 0);
+    const outstandingYield = Math.max(0, totalYield - paidYield);
     return {
       account: accountName,
       totalYield,
+      grossYield: totalYield,
+      paidYield,
+      outstandingYield,
       principalAtEnd: principal,
       aprUsed: apr,
       accrualStart: new Date(windowStartMs),
@@ -19826,9 +19915,17 @@ var MockYieldTracker = class {
     }
     return total;
   }
+  async getTotalOutstandingYield(accountNames, start, end) {
+    let total = 0;
+    for (const name of accountNames) {
+      const snapshot = await this.getYield(name, start, end);
+      total += snapshot.outstandingYield;
+    }
+    return total;
+  }
   async getBalance(accountName, atTime) {
     const snapshot = await this.getYield(accountName, void 0, atTime);
-    return snapshot.principalAtEnd + snapshot.totalYield;
+    return snapshot.principalAtEnd + snapshot.outstandingYield;
   }
   async addCashflow(params) {
     const state = this.require(params.accountName);
@@ -19838,6 +19935,60 @@ var MockYieldTracker = class {
       amount: signed
     });
   }
+  async createYieldPayment(params) {
+    const state = this.require(params.accountName);
+    if (!(params.amount > 0)) throw new Error("Yield payment must be positive");
+    const existing = state.yieldPayments.find(
+      (payment) => payment.paymentId === params.paymentId
+    );
+    if (existing) {
+      if (existing.amount !== params.amount || existing.effectiveAt !== params.effectiveAt.getTime()) {
+        throw new Error(
+          `Yield payment "${params.paymentId}" already exists with different details`
+        );
+      }
+      return;
+    }
+    state.yieldPayments.push({
+      paymentId: params.paymentId,
+      amount: params.amount,
+      effectiveAt: params.effectiveAt.getTime(),
+      status: "pending"
+    });
+  }
+  async confirmYieldPayment(params) {
+    const state = this.require(params.accountName);
+    const payment = state.yieldPayments.find(
+      (candidate) => candidate.paymentId === params.paymentId
+    );
+    if (!payment)
+      throw new Error(`Unknown yield payment "${params.paymentId}"`);
+    if (payment.status === "confirmed") {
+      if (payment.transactionSignature !== params.transactionSignature) {
+        throw new Error(
+          "Yield payment already confirmed with another signature"
+        );
+      }
+      return;
+    }
+    const chronologicalPayments = state.yieldPayments.filter(
+      (candidate) => candidate.status === "confirmed" || candidate === payment
+    ).sort((a, b) => a.effectiveAt - b.effectiveAt);
+    let cumulativePaid = 0;
+    for (const candidate of chronologicalPayments) {
+      cumulativePaid += candidate.amount;
+      const snapshot = await this.getYield(
+        params.accountName,
+        void 0,
+        new Date(candidate.effectiveAt)
+      );
+      if (cumulativePaid > snapshot.totalYield + 1e-9) {
+        throw new Error("Confirmed payment exceeds accrued unpaid yield");
+      }
+    }
+    payment.status = "confirmed";
+    payment.transactionSignature = params.transactionSignature;
+  }
 };
 
 // src/services/externalLiquidityIntegrityService.ts
@@ -20111,12 +20262,14 @@ var ExternalLiquidityIntegrityService = class {
   WithdrawalQueueService,
   addCashflowUpdate,
   address,
+  confirmYieldPayment,
   createAccount,
   createLiveConsensusOracleDeps,
   createRpcFromConnection,
   createTokenMint,
   createTokenMintIxs,
   createVaultClient,
+  createYieldPayment,
   dateToStr,
   defaultKeypairPath,
   deleteAccount,
@@ -20125,9 +20278,11 @@ var ExternalLiquidityIntegrityService = class {
   getBalance,
   getCashflows,
   getRpcUrl,
+  getTotalOutstandingYield,
   getTotalYield,
   getVaultProgramId,
   getYield,
+  getYieldPayments,
   isVaultEnv,
   keypairAddress,
   loadKeypair,

package/package.json

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