The Open-Source Safety Layer for Solana Actions
BlinkGuard is an open-source browser extension and API service designed to "pre-validate" Solana Blinks (Blockchain Links) directly within the Twitter/X user interface. It provides a safety layer that analyzes transactions before users interact with their wallets.
- Pre-Click Safety Validation: Analyzes Solana Blinks before wallet interaction
- Real-Time Transaction Simulation: Uses Solana's fast
simulateTransactionRPC for instant analysis - Community Registry: Open-source database of malicious URLs that anyone can contribute to
- Visual Safety Indicators: Green (Safe), Yellow (Caution), or Red (High Risk) overlays on Blinks
- Heuristic Analysis: Detects drainers, suspicious approvals, and unknown contracts
- Content Script: Detects Blinks in Twitter/X DOM and injects safety overlays
- Background Worker: Handles API communication and registry synchronization
- Transaction Simulator: Performs dry-run transaction analysis via Solana RPC
- Registry Management: Stores and serves malicious URL database
- Safety Analysis: Provides transaction safety scoring
- Community Reporting: Allows users to report suspicious Blinks
- Plasmo Framework: React/TypeScript-based extension framework
- TailwindCSS: Utility-first CSS framework for styling
- Next.js: Serverless Functions for API endpoints
- Rust (Axum): High-throughput transaction simulation handling (alternative implementation)
- PostgreSQL: Registry storage for malicious URLs and safety data
- Redis: Caching layer for performance optimization
- Helius / QuickNode: Solana RPC providers for transaction simulation
- Vercel: Hosting platform for API deployment
All documentation is organized in the docs/ directory:
- Technical Docs: Architecture, API flows, detection processes
- Guides: Usage, quick start, testing
- Development: Debugging, troubleshooting
See docs/README.md for the complete documentation index.
- Node.js 18+ and npm
- Chrome or Brave browser
- Solana RPC endpoint (or use public endpoints)
- Clone the repository:
git clone https://github.com/blinkguard/blinkguard.git
cd blinkguard- Install dependencies:
npm install- Build the extension:
npm run build:extension- Build the API (optional, for local development):
npm run build:api- Open Chrome/Brave and navigate to
chrome://extensions/ - Enable "Developer mode"
- Click "Load unpacked"
- Select the
extension/distdirectory
npm run build:api
node api/dist/server.jsThe API is deployed on Vercel at https://blink-guard-ixk2a1whf-abm32s-projects.vercel.app.
For local development, the API can run on http://localhost:3000.
Once installed, BlinkGuard automatically:
- Detects Blinks: Scans Twitter/X for Solana Blink URLs
- Simulates Transactions: Performs background transaction analysis
- Shows Safety Overlays: Displays colored badges indicating safety level:
- 🟢 Green: Verified Safe
- 🟡 Yellow: Caution (moderate risk)
- 🔴 Red: High Risk (potential drainer)
Users can report suspicious Blinks through the extension popup or directly via the API. Reports are added to the community registry for verification.
Access settings via the extension popup:
- Enable/Disable: Toggle BlinkGuard on/off
- Show Overlays: Toggle safety badge visibility
- RPC Endpoint: Configure custom Solana RPC endpoint
Set environment variables:
PORT: API server port (default: 3000)REGISTRY_FILE: Path to registry JSON file
BlinkGuard analyzes transactions for:
- Balance Transfer Analysis: Detects if >90% of balance is transferred (drainer pattern)
- Approval Risks: Identifies suspicious token approvals
- Unknown Contracts: Flags interactions with unverified programs
- Domain Trust: Checks domain reputation and SSL status
- Registry Matches: Cross-references with community malicious URL database
Transactions receive a safety score (0-100):
- 80-100: Safe (Green)
- 50-79: Caution (Yellow)
- 0-49: High Risk (Red)
BlinkGuard is open-source and welcomes contributions! Areas where we need help:
- Improving safety heuristics
- Adding more trusted program IDs
- Expanding domain trust analysis
- UI/UX improvements
- Documentation
See CONTRIBUTING.md for guidelines.
MIT License - see LICENSE file for details.
- GitHub: https://github.com/blinkguard/blinkguard
- Documentation: https://blinkguard.io/docs
- Chrome Web Store: Coming soon
Built for the Solana ecosystem. Special thanks to:
- Solana Foundation for the Blinks standard
- The Solana developer community
- All contributors and beta testers
BlinkGuard provides safety analysis but cannot guarantee 100% protection. Always:
- Verify transactions in your wallet
- Double-check destination addresses
- Be cautious with large transfers
- Report suspicious activity
Made with ❤️ for the Solana community