Solana Error Translation Engine
SolBug translates cryptic Solana blockchain errors into clear explanations with actionable solutions. Built for developers who spend too much time debugging failed transactions.
- Pattern Recognition: 25+ common error patterns with high accuracy
- AI Integration: GPT-4o fallback for unknown errors
- Performance: Sub-500ms response times
- Reliability: Multi-RPC failover across providers
- Analytics: Usage tracking and insights
- Multiple Interfaces: CLI, API, and browser extension
npm install -g @solbug/cli
solbug translate <transaction_signature>const response = await fetch('https://api.solbug.dev/translate', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'your-api-key'
},
body: JSON.stringify({
signature: 'your-transaction-signature'
})
})Available on Chrome Web Store - automatically detects errors on Solana explorers.
This repository follows the Open Core model:
Open Source (MIT License)
├── packages/patterns/ # Core error detection engine
├── packages/rpc-client/ # Multi-RPC client with failover
├── packages/cli/ # Command line interface
├── apps/extension/ # Chrome extension (MV3)
└── docs/ # Documentation & examples
Proprietary (SaaS Revenue)
├── apps/dashboard/ # Web analytics dashboard
├── services/api/ # API service with billing
└── services/auth/ # Authentication & rate limiting
- Node.js 18+
- pnpm (recommended) or npm
- Git
git clone https://github.com/qasawa/solbug.git
cd solbug
pnpm install# Start API service
pnpm --filter @solbug/api dev
# Test CLI tool
pnpm --filter @solbug/cli build
pnpm --filter @solbug/cli start translate <signature>
# Build Chrome extension
pnpm --filter @solbug/extension buildSolBug translates these common Solana errors:
| Raw Error | SolBug Translation |
|---|---|
InsufficientFunds (0x1) |
"Account lacks SOL for fees. Add more SOL to wallet." |
Custom Program Error: 0x1771 |
"Slippage tolerance exceeded. Increase slippage or retry later." |
AccountInUse |
"Account locked by another transaction. Retry with exponential backoff." |
Compute budget exceeded |
"Transaction needs more CU. Add compute budget instruction." |
- Response Time: <500ms average
- Pattern Match Rate: >75%
- AI Fallback Rate: 10-20%
- Cache Hit Rate: >60%
- Uptime: 99.9%
We welcome contributions! Here's how to get started:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Add error patterns in
packages/patterns/src/index.ts - Test your changes:
pnpm test - Submit a pull request
- Add tests for new error patterns
- Follow TypeScript best practices
- Update documentation for new features
- Ensure all CI checks pass
While the core engine is open source, we offer a hosted SaaS platform at solbug.dev with:
- Advanced Analytics Dashboard
- Team Collaboration Features
- Enterprise SSO/SAML
- Priority Support
- Custom Integrations
Pricing: Free tier (1,000 requests/month) → Pro ($49/month) → Enterprise ($499/month)
- Trust: Blockchain developers can inspect our error detection
- Growth: Community contributions improve accuracy
- Innovation: Faster iteration through collaboration
- Impact: Help the entire Solana ecosystem debug faster
- API Reference - Complete API documentation
- CLI Guide - Command line interface usage
- Chrome Extension - Browser extension guide
- Self-Hosting - Run your own instance
- Contributing - How to contribute
- Discord: Join our community
- Issues: Report bugs
- Discussions: Feature requests
- Email: support@solbug.dev
- Open Source Components: MIT License
- SaaS Dashboard: Proprietary (source available)
- Brand & Trademarks: All rights reserved
Built for the Solana developer community. Special thanks to:
- Solana Foundation for the amazing blockchain
- Contributors who help improve error patterns
- Community members providing feedback and bug reports
Star us on GitHub if SolBug helps you debug faster
Website • Documentation • Discord • Twitter