Smart Contract Interface

Every vault contract function that touches curator workflows, grouped by job, with the role that calls it.

Every function on the vault contract that touches curator workflows, grouped by job, with the role that calls it.

Admin functions are gated to the owner multisig or operator; attempting them from a curator-managed address reverts.

Capital Movement (Vault ↔ Subaccount)

Function	Caller	Purpose and notes
`depositToSubaccount(uint256 amount, address subAccountAddr)`	Operator	Transfers vault assets to a whitelisted subaccount. This is the only road capital takes toward the curator's strategy.
`withdrawFromSubaccount(uint256 amount, address subAccountAddr)`	Operator	Pulls assets from the subaccount back into the vault — used to refill the buffer and fund epoch settlements.

Function	Caller	Purpose and notes
`updateTotalAssets(uint256 externalAssetsAmount)`	Operator	Syncs the vault's internal accounting with the externally calculated value of deployed positions. This is what moves the share price. Bounded by the max-percentage-change guardrail (see Risk Framework & Emergency).
`updateMaxChangePercent(uint256 newValue)`	Owner	Sets the ceiling/floor on share-price movement per update cycle (NAV volatility protection).
`totalAssets()`, `totalSupply()`	Anyone (view)	Current accounting state; share price = `totalAssets / totalSupply`.

Function	Caller	Purpose and notes
`processAllClaimsByDate(uint256 year, uint256 month, uint256 day, uint256 maxLimit)`	Anyone	Batch-settles all scheduled redemptions for a given epoch date.
`updateTimelockDuration(uint256 newDuration)`	Owner	Changes the lag between `requestRedeem` and `claim`. Subject to the 24h timelock on withdrawal-period changes.
`getWithdrawalEpoch()`	Anyone (view)	Current epoch boundaries — poll this to plan unwinds.

Function	Caller	Purpose and notes
`chargeManagementFee()`	Operator	Triggers fee accrual against TVL. Emits `ManagementFeeCharged(uint256)`.
`collectFees()`	Operator	Sweeps accrued fees to the fee collector address.
`updateManagementFee(uint256 newManagementFeePercent)`	Owner	Changes the management fee. Fee changes sit behind a 24h timelock.
`updateWithdrawalFee(uint256 newWithdrawalFee)`	Owner	Standard withdrawal fee percentage.
`updateInstantRedemptionFee(uint256 newFee)`	Owner	Fee charged on the `instantRedeem` path.
`updateFeeCollector(address newFeeCollectorAddr)`	Owner	Where collected fees land.

Function	Caller	Purpose and notes
`updateIssuanceLimits(uint256 maxDeposit, uint256 maxWithdrawal, uint256 maxSupply)`	Owner	Caps on deposits, withdrawals, and total share supply — the lever for capacity management.
`pauseDepositsAndWithdrawals(bool bPauseDeposits, bool bPauseWithdrawals)`	Owner	Pause/resume either side independently. Emits `DepositWithdrawalStatusChanged`.
`emergencyWithdraw(IERC20 token, address destinationAddr)`	Owner	Emergency sweep of tokens to a safe destination.

Curators rarely call these, but depositor behavior drives liquidity planning, so the flows must be understood:

Function	Caller	Purpose and notes
`deposit(uint256 assets, address receiver)`	User/custodian	Deposit underlying assets; returns shares minted.
`requestRedeem(uint256 shares, address receiverAddr, address holderAddr)`	User/custodian	Starts the epoch redemption flow; returns assets owed and the claimable epoch.
`claim(uint256 year, uint256 month, uint256 day, address receiverAddr)`	Anyone (for the registered receiver)	Completes a matured redemption; returns `assetsClaimed` and `sharesBurned`.
`instantRedeem(uint256 shares, address receiverAddr, address holderAddr)`	User/custodian	Immediate exit, fee applies, served from the buffer.
`previewDeposit`, `previewRedeem`, `previewInstantRedemption`	Anyone (view)	Simulation surfaces for frontends and reconciliation.