Harmonix Protocol Diagrams
Architecture, flows, and operational reference for the Harmonix vault system
01
Deposit Flow
User deposits assets into AssetVault, receives share tokens via FundVault and ShareToken. Covers the full deposit lifecycle and state changes.
02
Allocate & Deallocate
Curator moves assets between FundVault and strategies. Covers allocate, deallocate, strategy whitelisting, and cap enforcement.
03
Withdraw Flow
Three-phase async redeem: requestRedeem, fulfillRedeem, withdraw. Includes PPS tracking and operator pre-steps.
04
NAV Management
NAV formula breakdown, updateNav flow, PPS deviation guard, syncNavValue on FundNavFeed, and fee harvesting mechanics.
05
Roles & Actions
Every privileged role, its actions, timelock status, risk level, and recommended multisig threshold. Includes timelock mechanism diagram.
06
Common Operations
Day-to-day vault management: allocate, deallocate, setStrategyCap, syncNavValue, updateNav, fulfillRedeem. Roles, guards, and operational checklist.
07
Upgrade Mechanism
TimelockController-gated UUPS proxy upgrades with Safe multisig governance. Deploy → schedule → wait → execute. Role architecture and security properties.
08
Fee Management
Management and performance fee configuration, accrual math, harvest flow, and high-water-mark mechanics. Includes recommended sequencing with updateNav.
09
NAV Lifecycle
Action choreography: which calls move NAV between buckets, FundNav report timing, and snapshot refresh. Includes the allocate → report → updateNav timeline and a PPS dip-and-recovery walkthrough.