Opal

Opal is the simplest way to create AI agents — smart automations that integrate with all your channels, from Telegram to Discord, to save you hours a week and help you grow your community.

Core Purpose:

• Enables users to create and manage AI-powered social bots without coding
• Provides DeFi analytics and multi-platform bot management
• Facilitates intelligent data processing and GraphQL query handling

Bot Integration:

• Multi-platform support (Telegram, Discord)
• Automated bot configuration and management
• Real-time transaction and wallet tracking
• AI-powered responses using gpt-4o-mini

DeFi Features:

• Uniswap subgraph data analytics integration
• Real-time trading volume and statistics
• GraphQL query debugging and optimization
• Coinbase AgentKit integration for USDC transactions

Key Features:

• No-code bot creation interface
• Real-time DeFi analytics dashboard
• Multi-platform bot management
• Automated polling and giveaway systems
• AI-powered response generation
• USDC transaction handling
• Advanced GraphQL query management

The project combines social bot management, DeFi analytics, and AI capabilities into a unified platform, allowing users to create and manage sophisticated bots without coding knowledge while accessing real-time blockchain data and analytics.

Frontend Architecture:

• Built with React + TypeScript for type safety
• Uses shadcn/ui for a comprehensive component library (40+ components)
• State management: Combination of React Query for server state and Zustand for local state
• Form handling through react-hook-form with Zod validation
• Custom wizard component for guided bot creation

Backend Structure:

• Express.js with TypeScript
• PostgreSQL with Drizzle ORM for type-safe database operations
• Session management using express-session with PostgreSQL store
• Authentication via Passport.js with local strategy

Bot Platform Integration:

• Telegram integration using Telegraf framework
• Multi-bot orchestration through bot-manager.ts service
• Real-time updates via WebSocket (ws package)
• Scheduled tasks using node-schedule

DeFi & Blockchain Integration:

• Coinbase AgentKit integration for USDC transactions
• Direct Uniswap subgraph querying via GraphQL
• Custom GraphQL query generation and optimization
• Ethers.js and Viem for blockchain interactions

Notable Technical Decisions:

Query Management:

• Custom GraphQL query builder in graph-service.ts
• Query caching and rate limiting implementation
• Error handling and retry mechanisms

Bot Management:

• Modular bot architecture allowing easy platform expansion
• Shared state management between bots
• Dynamic bot configuration loading

Security & Performance:

• Rate limiting on API endpoints
• WebSocket connection pooling
• Prepared statements for SQL queries
• Session security with secure cookies

Dynamic Query Generation:

• Built a custom natural language to GraphQL query transformer
• Uses pattern matching and template literals for query construction
• Handles edge cases through fallback mechanisms

Bot State Management:

• Implemented a custom state machine for bot conversations
• Uses Redis-like in-memory storage with PostgreSQL backup
• State recovery mechanism for crashed bots

USDC Transaction Handling:

• Custom retry mechanism for failed transactions
• Gas estimation optimization
• Transaction batching for multiple payouts

Partner Technologies & Benefits:

Coinbase AgentKit & Base:

• Simplified USDC transaction handling
• Reduced implementation complexity for wallet operations
• Built-in security features

The Graph Protocol:

• Real-time DeFi data access
• Reduced backend complexity
• Optimized query performance

Telegram Bot API:

• Rich message formatting
• Inline keyboards and commands
• Webhook support for real-time updates

This architecture allows for scalable bot management, reliable DeFi operations, and a smooth user experience while maintaining code quality and type safety throughout the stack.