MoonYield Protocol Specification
Technical Documentation
Complete engineering reference for the MoonYield frontend, Wagmi v3 + Viem multi-chain Web3 integration, and Solidity smart contracts.
Frontend & Runtime Stack
- FrameworkNext.js 16 (App Router)
- UI & StylingReact 19 + Tailwind CSS v4
- Web3 LayerWagmi v3 + Viem + TanStack Query
- Package Managerpnpm 10 • Port 8000 (start.sh)
- Smart Contract SuiteFoundry + OpenZeppelin 5.6
Directory Layout
src/
├── app/ # Routes: /, /pools, /portfolio, /calculator, /docs
├── components/
│ ├── wallet/ # WalletOptions (EIP-6963) & Connection (ENS + chains)
│ ├── modals/ # WalletModal, StakeModal, ManagePositionModal
│ ├── pools/ # PoolCard, PoolsDirectoryClient
│ └── charts/ # Interactive SVG YieldChart
├── context/ # Web3Provider & StakingContext
└── lib/
├── wagmi.ts # createConfig (Mainnet, BSC, Arbitrum, Base)
└── contracts.ts # ERC20 & MoonYieldStaking ABIs + addresses
contract/
├── src/ # MoonToken.sol, MoonYieldStaking.sol
├── test/ # MoonYieldStaking.t.sol (Forge unit tests)
└── script/ # DeployMoonYield.s.sol