Skip to content

GoalVault is a decentralized collaborative savings and accountability platform built on Scroll that helps teams achieve their financial goals through smart contract-powered vaults. We combine group savings** with **task accountability to ensure teams don't just collect money they actually achieve their goals. Deployed on SCROLL SEPOLIA

Notifications You must be signed in to change notification settings

Elite-tch/goalvault

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

# 🎯 Scroll GoalVault - Deployed & Ready! ## ✅ What's Been Built Your **Scroll GoalVault** project is now fully functional with: ### 📜 Smart Contract (Deployed) - **Contract Address:** `0xf7ef04b4d03fa5c64e61110f052b9ddee715e8a6` - **Network:** Scroll Sepolia Testnet - **Status:** ✅ Verified on Sourcify - **Explorer:** https://sepolia.scrollscan.com/address/0xf7ef04b4d03fa5c64e61110f052b9ddee715e8a6 ### 🎨 Frontend Application - **Landing Page** - Beautiful hero with project overview - **Create Vault** - Full form integrated with smart contract - **Dashboard** - View all vaults from blockchain - **Vault Details** - Join vaults, complete tasks, verify tasks, release funds - **Wallet Integration** - RainbowKit with Scroll Sepolia support ## 🚀 Getting Started ### 1. The app is already running! Your dev server should be live at: **http://localhost:3000** ### 2. Connect Your Wallet - Click "Connect Wallet" in the navbar - Make sure you're on **Scroll Sepolia** network - You need testnet ETH (you already have some!) ### 3. Try These Features #### Create a Vault 1. Click "Start a Vault" or go to Dashboard → Create New Vault 2. Fill in: - Vault name (e.g., "Hackathon Team Fund") - Financial goal (e.g., 0.1 ETH) - Duration (e.g., 7 days) - Tasks (e.g., "Complete project", "Deploy contract") 3. Click "Create Vault on Scroll" 4. Approve transaction in your wallet 5. Wait for confirmation #### Join a Vault 1. Go to Dashboard 2. Click on any vault 3. Enter deposit amount 4. Click "Join Vault" #### Complete Tasks 1. Go to your vault details page 2. Find "Your Tasks" section 3. Click "Mark Complete" for each task #### Verify Tasks (Vault Creator Only) 1. Go to vault details 2. Click "View Tasks" on any member 3. Click "Verify" on completed tasks #### Release Funds 1. When all tasks are verified and goal is met 2. Vault creator sees "Release Funds" button 3. Click to return funds to all members ## 🎮 Project Features ### Core Functionality ✅ Create group savings vaults ✅ Set financial goals and deadlines ✅ Assign tasks to members ✅ Join vaults with ETH deposits ✅ Track progress in real-time ✅ Complete and verify tasks ✅ Release funds when conditions met ✅ Cancel vaults and refund members ### Smart Contract Features - Trustless escrow on Scroll zkEVM - Dual verification (financial + tasks) - Time-locked with deadlines - Member management - Task tracking per member - Automated fund distribution - Emergency cancellation ### Frontend Features - Real-time blockchain data - Beautiful, responsive UI - Wallet connection (RainbowKit) - Transaction status tracking - Loading states & error handling - Block explorer links - Progress visualization ## 🏗️ Technical Stack - **Smart Contracts:** Solidity 0.8.28 - **Frontend:** Next.js 16, React, TypeScript - **Styling:** Tailwind CSS - **Animations:** Framer Motion - **Web3:** Wagmi, V iem, RainbowKit - **Network:** Scroll Sepolia Testnet - **Deployment:** Hardhat ## 📁 Project Structure ``` syncvault/ ├── contracts/ │ └── GoalVault.sol # Main smart contract ├── app/ │ ├── page.tsx # Landing page │ ├── dashboard/ │ │ ├── page.tsx # Dashboard (view all vaults) │ │ └── create/ │ │ └── page.tsx # Create vault form │ └── vault/[id]/ │ └── page.tsx # Vault details page ├── components/ │ ├── Navbar.tsx # Navigation with wallet connect │ └── LandingHero.tsx # Hero section ├── lib/ │ ├── contracts.ts # Contract ABI & config │ └── hooks/ │ └── useGoalVault.ts # Contract interaction hooks └── scripts/ └── deployGoalVault.ts # Deployment script ``` ## 🎯 Next Steps ### For Hackathon Demo 1. **Create a demo flow:** - Create a vault - Join with multiple wallets (if you have test wallets) - Complete some tasks - Show the release funds flow 2. **Record a video demo:** - Show the UI - Create a vault - Explain the dual accountability model - Highlight Scroll zkEVM benefits 3. **Add more features** (optional): - Gamification (badges, leaderboards) - Social sharing - Vault templates - Multi-sig for large vaults ### For Production 1. Get WalletConnect Project ID: - Go to https://cloud.walletconnect.com/ - Create a project - Update `app/providers.tsx` line 26 2. Deploy to mainnet (when ready): - Update to Scroll mainnet in hardhat.config.ts - Deploy contract - Update contract address in `lib/contracts.ts` 3. Add ENS/domain support 4. Implement notification system 5. Add vault discovery/explore page ## 🐛 Troubleshooting ### "Wallet not connected" - Click "Connect Wallet" in navbar - Select Scroll Sepolia network ### "Insufficient funds" - Make sure you have Scroll Sepolia ETH - You need ETH for both gas fees and vault deposits ### "Transaction failed" - Check you're on Scroll Sepolia - Ensure you have enough ETH - Try increasing gas limit ### Page not loading - Check dev server is running (`npm run dev`) - Clear browser cache - Check console for errors ## 📚 Resources - **Scroll Docs:** https://docs.scroll.io/ - **Scaffold Scroll:** https://github.com/scaffold-eth/scaffold-eth-2 - **Scroll Explorer:** https://sepolia.scrollscan.com/ - **Scroll Faucet:** https://sepolia.scroll.io/bridge ## 🎉 Congratulations! You now have a fully functional group savings and task accountability platform running on Scroll zkEVM! **Contract:** `0xf7ef04b4d03fa5c64e61110f052b9ddee715e8a6` **Local App:** http://localhost:3000 Happy building! 🚀 # goalvault

About

GoalVault is a decentralized collaborative savings and accountability platform built on Scroll that helps teams achieve their financial goals through smart contract-powered vaults. We combine group savings** with **task accountability to ensure teams don't just collect money they actually achieve their goals. Deployed on SCROLL SEPOLIA

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published