JosephKibithe/escrow-kenya

# AHADI (Promise) AHADI (Swahili for "Promise") is a decentralized escrow application designed to bridge the trust gap between buyers and sellers in the "Instagram Vendor" economy. It replaces expensive, slow traditional intermediaries with immutable smart contracts on the Polygon blockchain, wrapped in a premium **Black & Gold Glassmorphism** UI. ## Key Features - **Trustless Escrow**: Funds are held by a smart contract, not a middleman. - **3D Interactive Experience**: Features a real-time 3D gold padlock that reacts to user interaction. - **Glassmorphism UI**: A modern, premium aesthetic with frosted glass cards, noise textures, and smooth animations. - **Payment Links**: Sellers generate unique links that auto-fill deal details for buyers. - **Gas Sponsorship**: Account abstraction via thirdweb allows users to transact without needing MATIC for gas. - **Stablecoin Settlement**: Uses **USDT (Polygon)** to avoid crypto volatility. - **Immutable Timeouts**: Hard-coded expiries ensure funds are never locked indefinitely. --- ## Tech Stack - **Frontend**: Next.js 15 (App Router), React 19, TailwindCSS v4 - **3D & Animation**: React Three Fiber, Drei, Framer Motion (Texture/Model Loading) - **Icons**: Lucide React - **Blockchain SDK**: Reown AppKit (formerly Web3Modal), Wagmi, Viem - **Smart Contracts**: Solidity (0.8.19), OpenZeppelin - **Indexing**: The Graph (Subgraph at `ahadi-escrow-v-1`) - **Network**: Polygon PoS (Mainnet) ## Project Structure ```text app/ ├── components/ │ ├── PadlockScene.tsx # 3D Model logic & Environment │ ├── DashboardPreview.tsx # Glassmorphism card stack component │ └── GlassCard.tsx # Reusable glass UI component ├── dashboard/ │ ├── SellerRequestGenerator.tsx # Logic for generating payment links │ ├── MyDeals.tsx # Buyer/Seller deal management │ ├── AdminStats.tsx # Admin dashboard for disputes/fees │ ├── layout.tsx # Dashboard layout wrapper │ …