How sridhar636146591/mev-shield works
MEV Shield is a Web3 platform for detecting pending-transaction attacks and helping users assess or mitigate their risk. The principal workflow is mempool monitoring, attack detection and risk scoring, then presenting findings through the dashboard and live notifications; users can also simulate trades or submit transactions privately through Flashbots. The README documents market analysis, premium payments, and analytics as additional capabilities. Several service and route implementations were not sampled, so their internal call relationships are not asserted.
Main entry points: App.js React app · api.ts API routes · server.ts HTTP and WS server · mempoolMonitor.ts Mempool monitor
Components 29
User experience
- React app
mev-detector/src/App.js - Dashboard
mev-detector/src/components/Dashboard.tsx - Attack detector UI
mev-detector/src/components/AttackDetector.tsx - Mempool monitor UI
mev-detector/src/components/MempoolMonitor.tsx - Charts and heatmap
mev-detector/src/components/Charts.tsx - AI chat
mev-detector/src/components/AIChat.js - Email alerts UI
mev-detector/src/components/EmailAlerts.js - Education
mev-detector/src/components/Education.js - Rewards
mev-detector/src/components/Rewards.js - Market analysis UI
mev-detector/src/components/CryptoMarketTrends.js - Wallet connection
mev-detector/src/components/MetaMaskButton.js - Trade simulator
mev-detector/src/components/Simulator.js - Private protection UI
mev-detector/src/components/FlashbotsProtection.js
Detection pipeline
- Mempool monitor
server/src/services/mempoolMonitor.ts - Alchemy listener
server/src/services/alchemyMempoolListener.ts - MEV detector
server/src/utils/mevDetector.ts
Protection services
- Flashbots relay
server/src/services/flashbotsService.ts
Insights and accounts
- Historical analytics
server/src/services/analytics/analyticsService.ts - Market data service
server/src/services/cryptoMarketService.ts - Alert delivery
server/src/services/emailAlertService.ts - Institutional API
server/src/services/institutional/institutionalService.ts
Backend platform
- HTTP and WS server
server/src/server.ts - API routes
server/src/routes/api.ts - Persistence
server/src/database.ts
Other components
- Web3 user
- Alchemy
- Flashbots relay
- Market data providers
- MetaMask
Connections 27
- Web3 user → React app: uses
README.md - React app → Dashboard: renders
mev-detector/src/App.js - React app → Attack detector UI: renders
mev-detector/src/App.js - React app → Mempool monitor UI: renders
mev-detector/src/App.js - React app → Charts and heatmap: renders
mev-detector/src/App.js - React app → AI chat: renders
mev-detector/src/App.js - React app → Email alerts UI: renders
mev-detector/src/App.js - React app → Education: renders
mev-detector/src/App.js - React app → Rewards: renders
mev-detector/src/App.js - React app → Market analysis UI: renders
mev-detector/src/App.js - React app → Wallet connection: renders
mev-detector/src/App.js - React app → Trade simulator: offers
README.md - React app → Private protection UI: offers
README.md - React app → API routes: requests attacks
mev-detector/src/App.js - HTTP and WS server → API routes: mounts routes
server/src/server.ts - HTTP and WS server → Persistence: connects
server/src/server.ts - HTTP and WS server → Mempool monitor: broadcasts alerts
server/src/server.ts - Alchemy listener → Alchemy: monitors pool
README.md - Mempool monitor → MEV detector: analyzes transactions
- HTTP and WS server → Mempool monitor: starts monitoring
server/src/server.ts - Flashbots relay → Flashbots relay: submits privately
server/src/services/flashbotsService.ts - Market data service → Market data providers: fetches data
README.md - Wallet connection → MetaMask: connects wallet
README.md - API routes → Historical analytics: serves analytics
- API routes → Market data service: serves market data
- API routes → Alert delivery: configures alerts
- API routes → Flashbots relay: routes protection