King's Vault — Protocol Documentation

King’s Vault is a permissioned DeFi gateway that simplifies access to on-chain protocols through purpose-built smart contracts. It accepts Stablecoin deposits on Ethereum Mainnet and deploys capital into DeFi protocols 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
Cross-Chain Transport	Circle CCTP V2 (USDC burn-and-mint + state messages)
Yield Sources	Aave V3, Morpho Steakhouse (ETH); HLP Pool (Hyperliquid)
Access Model	Permissioned address allowlist
Settlement Model	Manual, periodic (daily or epoch-based)

---

Standards & Dependencies

Standard / Library	Usage
ERC-4626	Tokenized vault deposit / withdraw / preview interface
OpenZeppelin Contracts	AccessControl, Pausable, ERC20, SafeERC20, ReentrancyGuard
Circle CCTP V2	Native USDC burn-and-mint bridge; state message relay between Ethereum and HyperEVM
Hyperliquid Docs	CoreWriter, L1Read precompiles, HLP vault