AgentForge: No-Code x402-Powered Agent Builder for Solana

What is AgentForge?

AgentForge is the first no-code workflow automation platform designed specifically for the Solana ecosystem, combining:

• 🎯 Drag-and-drop workflow builder (inspired by n8n)
• ⚡ x402 hybrid payment model (prepayment + instant credits)
• 🚀 One-click Telegram deployment
• 🔒 Zero private key exposure (uses Solana session keys)

Problem We Solve

1. Existing automation tools (n8n, Zapier) aren't Solana-native
2. x402 alone is slow for high-frequency trading (~1000ms+ latency per request)
3. Telegram bots expose private keys to security risks

Our Solution

• Hybrid x402 model: One-time prepayment = instant credits for thousands of API calls
• n8n-style canvas: Create bots without any coding knowledge
• Direct Telegram integration: Deploy and execute in minutes
• Solana session keys: Users never expose their private keys

Features

• ✅ 27+ pre-built blocks (Jupiter, Pump.fun, Helius, Telegram, AI Agent, etc.)
• ✅ Drag-and-drop workflow builder with n8n-style canvas
• ✅ AI Agent Block - Autonomous agent that can use ANY block as a tool
• ✅ AI Assistant - Generate workflows from natural language prompts
• ✅ Workflow Activation System - One-click Telegram/Webhook deployment
• ✅ Environment Variables - Secure configuration with lock/unlock
• ✅ x402 prepayment system (Coinbase facilitator)
• ✅ CDP Embedded Wallets - Email login without seed phrases
• ✅ Phantom CASH token support - New stablecoin payments
• ✅ Session Keys - Execute trades without exposing private keys
• ✅ Real-time execution tracking with visual feedback
• ✅ Credits-based API charging
• ✅ 100% open source (MIT)

Tech Stack

Backend

• Node.js 20+ / Express.js
• TypeScript (strict mode)
• PostgreSQL + Prisma ORM
• Socket.io (real-time updates)
• @solana/web3.js

Frontend

• React 18.2+ with TypeScript
• React Flow (drag-and-drop canvas)
• TailwindCSS (styling)
• Zustand (state management)
• TanStack Query (server state)
• Vite (build tool)

Quick Start

Prerequisites

• Node.js 20+
• PostgreSQL 15+
• Docker & Docker Compose (optional, for local DB)

Installation

1. Clone the repository

git clone https://github.com/MixasV/agentforge.git
cd agentforge

2. Start PostgreSQL (using Docker)

docker-compose up -d

3. Setup Backend

cd backend
npm install
cp .env.example .env
# Edit .env with your configuration
npm run db:push
npm run dev

4. Setup Frontend

cd frontend
npm install
npm run dev

5. Access the application

• Frontend: http://localhost:3000
• Backend: http://localhost:3001

Project Structure

agentforge/
├── backend/
│   ├── src/
│   │   ├── routes/          # API endpoints
│   │   ├── services/        # Business logic
│   │   ├── middleware/      # Auth, credits charging
│   │   ├── utils/           # Helpers, logger, errors
│   │   └── types/           # TypeScript types
│   ├── prisma/
│   │   └── schema.prisma    # Database schema
│   └── package.json
│
├── frontend/
│   ├── src/
│   │   ├── components/      # React components
│   │   ├── pages/           # Page components
│   │   ├── hooks/           # Custom hooks
│   │   ├── store/           # Zustand stores
│   │   ├── services/        # API client
│   │   └── types/           # TypeScript types
│   └── package.json
│
└── docker-compose.yml       # Local development setup

Environment Variables

Backend (.env)

DATABASE_URL=postgresql://postgres:postgres@localhost:5432/agentforge
PORT=3001
NODE_ENV=development
FRONTEND_URL=http://localhost:3000
JWT_SECRET=your-secret-key
SOLANA_RPC_ENDPOINT=https://api.devnet.solana.com
COINBASE_API_KEY=your-coinbase-api-key

Frontend (.env)

VITE_API_URL=http://localhost:3001

Development Workflow

1. Before Starting Work

   • Read AGENTS.md for coding guidelines
   • Check existing implementations
   • Plan the complete solution

2. During Implementation

   • Write real, working code (no placeholders)
   • Add proper error handling
   • Follow TypeScript best practices

3. Before Committing

   # Backend
   cd backend
   npm run lint
   npm run typecheck
   npm test
   
   # Frontend
   cd frontend
   npm run lint
   npm run typecheck
   npm run build

API Documentation

Authentication

• POST /auth/phantom/login - Login with Phantom wallet
• POST /auth/telegram/login - Login with Telegram
• GET /auth/me - Get current user
• POST /auth/logout - Logout

Credits

• GET /api/credits/balance - Get credits balance
• GET /api/credits/usage - Get usage statistics
• GET /api/credits/transactions - Get transaction history

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Dark Research Model

We follow the Dark Research open source strategy:

• Core infrastructure is open source
• Contributors can earn via Merit system
• Partnership model with ecosystem providers

Roadmap

Phase 1: MVP (✅ COMPLETE)

• ✅ n8n-style workflow builder with 27+ blocks
• ✅ AI Agent with visual tool connections
• ✅ AI Assistant for workflow generation
• ✅ Workflow activation system (Telegram + Webhook triggers)
• ✅ Environment variables with security features
• ✅ x402 prepayment system
• ✅ Session keys for secure trading
• ✅ Real-time execution tracking

Phase 2: Enhanced Integrations

• 🔲 Browser extensions
• 🔲 Website widgets
• 🔲 Discord bot deployment
• 🔲 Community block marketplace

Phase 3: Team Features

• 🔲 Multi-user teams
• 🔲 Advanced permissions
• 🔲 CI/CD integration
• 🔲 Self-hosted facilitator

Phase 4: Enterprise

• 🔲 Mobile app
• 🔲 Enterprise SLA
• 🔲 Custom AI model fine-tuning

Security

• Never commit secrets or API keys
• Use environment variables for sensitive data
• Validate all user input on backend
• Encrypt session keys
• Review SECURITY.md for details

License

MIT License - see LICENSE file for details

Support

• Documentation: docs.agentforge.app
• Discord: Join our community
• Issues: GitHub Issues
• Email: support@agentforge.app

🤝 Partnership: Built on Dark Research Mallory

AgentForge is built on the Dark Research open source strategy and integrates with Mallory, the open-source x402 primitives framework.

Why Mallory?

Dark Research demonstrated that software IP is trending to $0 - the real value is in ecosystem and infrastructure.

AgentForge follows their playbook:

• ✅ Core infrastructure 100% open source (MIT license)
• ✅ Community-driven development
• ✅ Partnership model with ecosystem providers
• ✅ Revenue through hosted SaaS + premium features

Mallory Integration

AgentForge uses Mallory for:

• x402 protocol implementation (payment verification, settlement)
• Open-source primitives for agent-to-agent payments
• Best practices in Web3 infrastructure

Contributing

We follow Dark Research's contribution model:

1. Fork the repository
2. Create feature branch
3. Submit PR with detailed description
4. Community review
5. Merge and deploy

Contributors can earn through the Merit system (see CONTRIBUTING.md)

Acknowledgments

• Inspired by Dark Research's open source philosophy
• Using Mallory framework for x402 primitives
• Partnering with Solana Foundation
• Community-driven development

---

More about Dark Research
Mallory Framework

---

Built with ❤️ for the Solana community