🌌 Smart Vault Omnichain Protocol

The Smart Vault is a next-generation decentralized application (DApp) that leverages cutting-edge Web3 architecture to provide a secure, non-custodial, and fully omnichain asset management platform. Initially deployed on the Monad Testnet, the protocol is powered by LayerZero V2, completely breaking down blockchain silos by allowing users to seamlessly bridge and teleport native testnet yields across EVM networks instantly.

🚀 Features & Architecture

• Omnichain Native Bridging (LayerZero OApp): The core Solidy contract inherits LayerZero's standard OApp capabilities. This allows the vault to receive a native asset (like Sepolia ETH), lock it, and instantly fire a secure, verified cross-chain protocol payload to directly mirror and credit the user's synthetic vault holdings on the destination Monad Testnet.
• Intelligent Network Switcher: The frontend tracks the connected wallet's state. When users connect to Monad, they get full native operations. When connected to Sepolia or Base, the UI physically morphs to unlock the aggressive LayerZero Cross-Chain Bridging engine!
• Glassmorphism UI/UX: The interface features a vibrant, top-tier aesthetic powered by Tailwind CSS. Built to provide premium real-time responsiveness mirroring top-tier decentralized exchanges.
• Bulletproof Hydration Stability: Deeply integrated within the Next.js App Router, React useState hooks are utilized natively to encapsulate Wagmi QueryClients, completely skipping nasty SSR Hydration loops that plague modern Web3 frontends.

⚙️ Tech Stack

• Frontend Ecosystem: Next.js 14+ (App Router), React, Tailwind CSS (Vanilla utilities).
• Web3 Connectivity: wagmi (v3), viem, @rainbow-me/rainbowkit (v2), @tanstack/react-query.
• Smart Contracts: Solidity ^0.8.20, Hardhat Ignition, @layerzerolabs/lz-evm-oapp-v2, OpenZeppelin.
• Primary EVM Network: Monad Testnet (ChainID: 10143).
• Deployed Smart Vault: 0x86a8EFbe2Ec122A527889Dc2D84625C9DF1b821D (Verify on Monad Explorer)

---

🛠️ Local Development Guide

1. Repository Map

The repository runs a bifurcated monorepo setup:

• /frontend — The Next.js Next-Gen User Interface.
• /contracts — The Hardhat Smart Contract Infrastructure.

2. Booting the Smart Contracts

1. Navigate into the Smart Contracts terminal space:

   cd contracts
   npm install

2. Set up your environment constraints. Ensure your .env requires a standard 32-byte PRIVATE_KEY for deployment credentials.
3. Deploy the Omnichain payload to any EVM chain via Hardhat Ignition:

   npx hardhat ignition deploy ./ignition/modules/SmartVault.js --network monadTestnet

3. Booting the Frontend UI

1. Load up the frontend workspace:

   cd frontend
   npm install

2. (Optional but strictly recommended) Ensure you have your WalletConnect Project ID loaded via .env.local or physically injected into providers.tsx.
3. Launch the development server:

   npm run dev

4. Access the gorgeous local portal at http://localhost:3000.

---

📝 Important Deployment Notes (Vercel)

If you are deploying this application to a Vercel Cloud Server, please remember that the root source contains two distinct folders! You must forcefully tell the Vercel Dashboard to isolate its standard build step inside the frontend directory via the Root Directory setting! Otherwise, the Next.js framework deployment will aggressively crash out on a physical 404 NOT_FOUND sequence!