Skip to content

Repository files navigation

SolanaForge

SolanaForge License Grant

Open-source testing, simulation, and security sandbox for Solana developers.

🚀 What is SolanaForge?

SolanaForge is a comprehensive testing platform for Solana blockchain developers that provides:

  • One-Click Environment Setup - Instantly start a local validator, manage wallets, import Anchor projects
  • Transaction Simulator - Simulate transactions before execution with fee estimation and state change visualization
  • Debugging Dashboard - Visual transaction flow, program logs viewer, account inspector, and AI-powered error decoder
  • Security Testing - Vulnerability scanning, PDA validation, permission checks, and reentrancy detection
  • Test Scenario Builder - Drag-and-drop UI for building automated test suites

🔧 Tech Stack

Layer Technology
Frontend Dashboard Next.js + TailwindCSS
Website Next.js (Static Export)
Backend API Node.js + Express
Analysis Engine Rust
Solana SDK @solana/web3.js + Anchor
Database PostgreSQL
AI Assistant OpenAI GPT + Claude API
Deployment Docker + Vercel
CI/CD GitHub Actions

📁 Project Structure

SolanaForge/
├── website/                # Landing page (Next.js)
├── frontend/               # Dashboard application (Next.js)
├── packages/
│   ├── api/                # Backend API (Node.js + Express)
│   └── rust-analyzer/      # Rust analysis engine
├── docker/                 # Docker Compose configuration
├── config/                 # Database schema + configuration
├── tests/                  # Integration tests (Jest)
├── grant-app/              # Grant application documents
├── .github/workflows/      # CI/CD pipeline
└── docs/                   # Documentation

🚀 Quick Start

Using Docker (Recommended)

# Clone the repository
git clone https://github.com/Ekpemark/SolanaForge.git
cd SolanaForge

# Create environment file
cp .env.example .env

# Start all services
cd docker
docker-compose up -d

# Access the dashboard
open http://localhost:3001
# Access the website
open http://localhost:3002

Manual Setup

# Install root dependencies
npm install

# Start the API server
cd packages/api
npm install
npm run dev

# Start the frontend dashboard
cd ../frontend
npm install
npm run dev

📡 API Documentation

Environment Management

POST /api/v1/environment/start-validator
GET  /api/v1/environment/status
POST /api/v1/environment/stop-validator
GET  /api/v1/environment/wallets
POST /api/v1/environment/wallets/create
POST /api/v1/environment/import-anchor

Transaction Simulator

POST /api/v1/simulator/simulate
POST /api/v1/simulator/fee-estimate
POST /api/v1/simulator/account-changes
POST /api/v1/simulator/decode-instructions

Debug Dashboard

GET /api/v1/debug/stats
GET /api/v1/debug/transaction/:signature
GET /api/v1/debug/account/:pubkey
GET /api/v1/debug/logs/:signature

Security Testing

POST /api/v1/security/analyze
POST /api/v1/security/validate-pda
POST /api/v1/security/validate-ownership

AI Assistant

POST /api/v1/ai/explain-error
POST /api/v1/ai/explain-logs

🔐 Security Features

SolanaForge implements robust security measures:

  • Helmet.js for security headers
  • Rate limiting to prevent abuse
  • Input validation with express-validator
  • CORS configuration for cross-origin requests
  • CSP headers to prevent XSS
  • SQL injection prevention with parameterized queries
  • Transaction sanitization before simulation
  • Wallet encryption for private keys

🧪 Testing

# Run API tests
cd packages/api
npm test

# Run frontend tests
cd frontend
npm test

# Run all tests
npm test

☁️ Deployment

Deploy to Vercel (Website)

cd website
vercel --prod

Deploy with Docker

cd docker
docker-compose -f docker-compose.prod.yml up -d

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide first.

📜 License

This project is licensed under the MIT License - see LICENSE for details.

🏆 Grant Information

SolanaForge is seeking $11,000 USD in grant funding to deliver a complete MVP within 30 days.

The project aligns with all five of Solana Foundation's funding priorities:

  • ✅ Open-source developer tooling
  • ✅ Testing tools
  • ✅ Program analysis tools
  • ✅ Security frameworks
  • ✅ Developer experience improvements

View Full Grant Application

📞 Contact


Made with ❤️ for the Solana community.

About

Open-source testing, simulation, and security sandbox for solana developers.

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages