A stealth shield against MEV, encrypting trades and settling them fair.
GhostLock: MEV Reaper is a cutting-edge DeFi platform that protects traders from Maximal Extractable Value (MEV) attacks through advanced cryptographic techniques and fair ordering mechanisms. Built on Base Sepolia, it leverages blocklock encryption, VRF-based ordering, and AI-optimized batch auctions.
- 🔒 Blocklock Encryption: Time-locked encryption hides trading intents until execution
- 🎲 VRF Ordering: Verifiable Random Function ensures fair transaction sequencing
- ⚡ Batch Auctions: Uniform pricing eliminates front-running opportunities
- 🤖 AI Optimization: Machine learning optimizes settlement prices and reduces slippage
- 🛡️ MEV Protection: Advanced shield against sandwich attacks and front-running
- ⚖️ Fair Access: Equal opportunity trading for all participants
- Framework: React 18 with TypeScript
- Styling: TailwindCSS with custom design system
- Animations: Framer Motion + Three.js for 3D components
- Web3: Wagmi + RainbowKit for wallet integration
- State: Zustand for client state management
- Runtime: Node.js with Express framework
- Blockchain: Ethers.js for smart contract interaction
- APIs: RESTful API design with comprehensive endpoints
- Real-time: WebSocket support for live updates
- GhostLockIntents: Manages encrypted trading intents
- BatchSettlement: Handles uniform-price batch auctions
- EpochRNG: Provides verifiable randomness for fair ordering
- MockTokens: Test tokens for development and testing
- Node.js 18+ and npm
- Git
- MetaMask or compatible Web3 wallet
- Clone the repository
git clone https://github.com/your-org/ghostlock-mev-reaper.git
cd ghostlock-mev-reaper- Install dependencies
# Install root dependencies
npm install
# Install server dependencies
cd server && npm install && cd ..- Environment Setup
# Copy environment files
cp .env.example .env
cp server/.env.example server/.env
# Update with your configuration
# - Add your WalletConnect Project ID
# - Configure RPC URLs
# - Set contract addresses (after deployment)- Start Development Servers
# Terminal 1: Start frontend
npm run dev
# Terminal 2: Start backend API
npm run server- Access the Application locally
- Frontend:
http://localhost:3000 - Backend API:
http://localhost:4800 - Health Check: Preview
- Peak the server here 👀: Preview
- BaseSepolia Faucets
- GHOSTLOCK_INTENTS_ADDRESS
- BATCH_SETTLEMENT_ADDRESS
- EPOCH_RNG_ADDRESS
- MOCK_ETH_ADDRESS
GET /api/auctions- List all auctionsGET /api/auctions/:id- Get specific auctionGET /api/auctions/stats- Get auction statistics
GET /api/markets- List all marketsGET /api/markets/:id- Get specific marketGET /api/markets/stats- Get market statistics
- On-chain verified randomness Intefrations → Calling the Drand( VRF) verification baked directly into EpochRNG contracts, so ordering proofs are trustless.
- Batch-Auctions Settlemets → via AI enhanced regulations
- Liveness guarantees → Bond + slashing for missed reveals, fallback threshold revealers, and permissionless settlement calls so no one can grief the auction.
- Privacy hardening → Add ciphertext(intent) padding, dummy intents, and batch-only publication so metadata leakage doesn’t kill the whole “encrypted” vibe.
- Tests & security → Foundry fuzz, audits, invariant checks
- UI polish → countdowns, public view mode, better status UX
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Dcipher Network upholding the permissionless threshold signing network
- Blocklock Protocol for time-locked encryption
- Randomness Protocol for VRF implementation
- Base for the underlying blockchain infrastructure
- Drand for distributed randomness beacon
Happy building! 😄😊