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