King's Vault — Protocol Documentation
King's Vault is a permissioned, cross-chain yield aggregator built on the ERC-4626 Tokenized Vault Standard. It accepts USDC deposits on Ethereum Mainnet and deploys capital into curated DeFi strategies across Ethereum and Hyperliquid (HyperEVM / HyperCore).
This documentation serves as the canonical technical reference for smart-contract auditors, integrators, and protocol operators.
Quick Navigation
| Section | Description |
|---|---|
| Introduction | Project summary, staged roadmap, and key terminology. |
| Architecture Overview | System architecture, trust model, roles, and design decisions. |
| Workflows | Step-by-step descriptions of every on-chain operation. |
| Contract Reference | Per-contract function signatures, access control, and events. |
| Deployed Addresses | Mainnet contract addresses, chain selectors, and system contracts. |
| Audit Reports | Static-analysis scope and findings. |
Scope Summary
| Property | Value |
|---|---|
| Primary Asset | USDC (6 decimals) |
| Networks | Ethereum Mainnet, HyperEVM (Hyperliquid L2) |
| Vault Standard | ERC-4626 (deposit), ERC-7540 (async redeem) |
| Cross-Chain Transport | Chainlink CCIP + Circle CCTP |
| Yield Sources | Aave V3, Morpho Steakhouse (ETH); HLP Pool (Hyperliquid) |
| Access Model | Permissioned (whitelist / KYC) |
| Settlement Model | Manual, periodic (daily or epoch-based) |
Standards & Dependencies
| Standard / Library | Usage |
|---|---|
| ERC-4626 | Tokenized vault deposit / mint / preview interface |
| ERC-7540 | Asynchronous redeem request / claim lifecycle |
| EIP-2612 | Gasless permit approvals |
| EIP-165 | Standard interface detection |
| OpenZeppelin Contracts | AccessControl, Pausable, ERC20, SafeERC20, ReentrancyGuard |
| Chainlink CCIP | Cross-chain messaging and token transfers |
| Circle CCTP | Native USDC burn-and-mint bridge |
| Hyperliquid Docs | CoreWriter, L1Read precompiles, HLP vault |