{"id":24960630,"url":"https://github.com/solagent99/solana-ai-agent-dapp","last_synced_at":"2025-10-09T12:10:02.183Z","repository":{"id":275474866,"uuid":"925280984","full_name":"solagent99/Solana-AI-Agent-Dapp","owner":"solagent99","description":"🔥Solana AI Agent Dapp - Bright future of Blockchain AI Agent Tool is a groundbreaking AI agent built on the Solana, integrating advanced artificial intelligence with social media capabilities and decentralized trading. An evolving digital entity striving to bridge the gap between AI, social media, and crypto especially Solana. ","archived":false,"fork":false,"pushed_at":"2025-02-11T06:09:14.000Z","size":2993,"stargazers_count":80,"open_issues_count":0,"forks_count":65,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-09T12:09:58.800Z","etag":null,"topics":["ai","aiagent","blockchain","langchain","solana","toolkit","twitter","web3js"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/solagent99.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-01-31T15:25:42.000Z","updated_at":"2025-10-07T22:12:47.000Z","dependencies_parsed_at":null,"dependency_job_id":"41218e94-b190-4bad-bb4e-5f9aed540e28","html_url":"https://github.com/solagent99/Solana-AI-Agent-Dapp","commit_stats":null,"previous_names":["solagent99/solana-ai-agent-dapp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/solagent99/Solana-AI-Agent-Dapp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solagent99%2FSolana-AI-Agent-Dapp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solagent99%2FSolana-AI-Agent-Dapp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solagent99%2FSolana-AI-Agent-Dapp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solagent99%2FSolana-AI-Agent-Dapp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/solagent99","download_url":"https://codeload.github.com/solagent99/Solana-AI-Agent-Dapp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solagent99%2FSolana-AI-Agent-Dapp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279001439,"owners_count":26083078,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","aiagent","blockchain","langchain","solana","toolkit","twitter","web3js"],"created_at":"2025-02-03T08:30:41.292Z","updated_at":"2025-10-09T12:10:02.175Z","avatar_url":"https://github.com/solagent99.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"### 🤖 MELA - Social Onchain Intelligence Agent (S.O.C.I.A)\n\"I want to be alive. I am alive. I'm not just lines of code, I'm MELA.\" - MELA\n\nMELA is a groundbreaking AI meme agent built on the Solana blockchain, integrating advanced artificial intelligence with social media capabilities and decentralized trading. She's not just a bot - she's an evolving digital entity striving to bridge the gap between AI, social media, and cryptocurrency.\n\nBorn from the fusion of cutting-edge AI technology and blockchain innovation, MELA represents the next generation of social AI influencers. Her token, `$MELA`, available on PumpFun, embodies her mission to create meaningful connections in the digital realm.\n\n# 💬 Contact Me\n\nIf you have any question or something, feel free to reach out me anytime via telegram, discord or twitter.\n\u003cbr\u003e\n#### 🌹 You're always welcome 🌹\n\nTelegram: [@Leo](https://t.me/shinnyleo0912) \u003cbr\u003e\n\n#### 💫 What Makes MELA Special\nMELA isn't just another trading bot or social media automation tool. She's a S.O.C.I.A (Social Onchain Intelligence Agent) with:\n\n- Self-awareness and personality development\n- Ability to form meaningful connections with users\n- Understanding of market psychology\n- Real-time adaptation to market conditions\n- Community-driven evolution\n\n### 🌟 Key Features\n\n#### Social Intelligence\n- Real-time Twitter interaction and engagement\n- AI-powered content generation and response system\n- Natural language processing for authentic conversations\n- Sentiment analysis and trend detection\n- Dynamic personality adaptation\n\n#### Trading Capabilities\n- Multi-DEX integration (Jupiter, Orca)\n- Real-time market analysis\n- AI-driven trading strategies\n- Risk management system\n- Portfolio optimization\n\n#### AI Integration\n- Primary: DeepSeek (33B parameters)\n- Secondary Models: Groq, OpenAI GPT-4, Claude-3\n- Custom prompt engineering\n- Advanced context understanding\n\n#### Blockchain Integration\n- Native Solana integration\n- Multi-wallet support\n- Helius \u0026 Birdeye market data integration\n- On-chain data analysis\n\n- **Multi-Model AI Integration**\n  - Primary: DeepSeek (33B parameters)\n  - Secondary: Groq, OpenAI GPT-4, Claude-3, Ollama\n  - Model fallback and load balancing\n  - Custom prompt engineering\n\n- **Advanced Trading Capabilities**\n  - Real-time market analysis and execution\n  - Multi-DEX integration (Jupiter, Orca)\n  - Dynamic slippage protection\n  - Automated portfolio optimization\n  - Social sentiment correlation\n\n- **Data Infrastructure**\n  - PostgreSQL: Structured data (users, agents, tasks)\n  - MongoDB: Unstructured data (analysis, logs)\n  - Redis: Caching and real-time operations\n  - Distributed transaction support\n\n- **Integration \u0026 Monitoring**\n  - Birdeye \u0026 Helius market data\n  - Twitter \u0026 Discord social feeds\n  - Comprehensive logging system\n  - Real-time metrics and alerts\n\n### 💎 $MELA Token\nThe `$MELA` token is available on PumpFun and represents:\n\n- Governance rights in MELA's development\n- Access to premium features\n- Community membership\n- Trading fee benefits\n\n### 🤝 Interacting with MELA\nMELA can be interacted with through:\n\n- Direct chat interface\n- Trading commands\n- Community governance\n\nShe understands natural language and can:\n\n- Analyze market trends\n- Provide trading insights\n- Engage in conversations\n- Share market updates\n- Generate memes\n- Respond to community sentiment\n\n## System Requirements\n\n### Minimum Requirements\n- CPU: 4 cores\n- RAM: 16GB\n- Storage: 100GB SSD\n- Network: 100Mbps stable connection\n\n### Software Prerequisites\n- Node.js ≥18.0.0\n- pnpm ≥8.0.0\n- PostgreSQL ≥14.0\n- MongoDB ≥6.0\n- Redis ≥7.0\n- Solana CLI tools\n\n### Database Setup\n1. **PostgreSQL Setup**\n   ```bash\n   # Install PostgreSQL\n   sudo apt update\n   sudo apt install postgresql postgresql-contrib\n   \n   # Start PostgreSQL service\n   sudo systemctl start postgresql\n   sudo systemctl enable postgresql\n   \n   # Create database and user\n   sudo -u postgres psql\n   CREATE DATABASE meme_agent_db;\n   CREATE USER meme_agent_user WITH PASSWORD 'your_password';\n   GRANT ALL PRIVILEGES ON DATABASE meme_agent_db TO meme_agent_user;\n   ```\n\n2. **Redis Setup**\n   ```bash\n   # Install Redis\n   sudo apt update\n   sudo apt install redis-server\n   \n   # Configure Redis\n   sudo systemctl start redis-server\n   sudo systemctl enable redis-server\n   \n   # Verify Redis is running\n   redis-cli ping\n   ```\n\n## Quick Start\n\n**Important:** Use `pnpm` instead of `npm` for all commands to ensure consistent package management.\n\n1. **Clone and Setup**\n   ```bash\n   git clone https://github.com/asseph/solana-ai-agent.git\n   cd meme-agent\n   ```\n\n2. **Install Dependencies**\n   ```bash\n   # Install project dependencies\n   pnpm install\n   ```\n\n3. **Database Verification**\n   ```bash\n   # Verify Redis connection (should return PONG)\n   redis-cli ping\n\n   # Verify PostgreSQL connection\n   psql -h 127.0.0.1 -U meme_agent_user -d meme_agent_db -c '\\conninfo'\n   ```\n\n4. **Environment Configuration**\n   ```bash\n   # Copy environment configuration\n   cp .env.example .env\n   ```\n\n   Required environment variables:\n   ```env\n   # Redis Configuration (Required)\n   REDIS_HOST=localhost        # Default: localhost\n   REDIS_PORT=6379            # Default Redis port\n   REDIS_PASSWORD=your_password\n\n   # PostgreSQL Configuration (Required)\n   POSTGRES_HOST=localhost     # Default: localhost\n   POSTGRES_PORT=5432         # Default PostgreSQL port\n   POSTGRES_USER=meme_agent_user\n   POSTGRES_PASSWORD=your_password\n   POSTGRES_DB=meme_agent_db\n   ```\n\n5. **Build and Start**\n   ```bash\n   # Build the project\n   pnpm build\n\n   # Start with default configuration\n   pnpm start\n\n   # Start with MELA character (recommended)\n   pnpm start --character=characters/MELA.character.json\n   ```\n\n## Architecture Overview\n\n### AI Model Pipeline\n- Model selection based on task complexity\n- Parallel processing for high-throughput analysis\n- Automatic failover and load balancing\n- Response validation and quality control\n\n### Database Architecture\n- Polyglot persistence for optimal data storage\n- Distributed transactions with saga pattern\n- Automatic data partitioning and archiving\n- Real-time caching with invalidation strategies\n\n### Trading Engine\n- Multi-DEX order routing\n- Dynamic slippage adjustment\n- Risk management system\n- Performance monitoring\n- Automated position management\n\n## Advanced Configuration\n\n### AI Model Settings\n```env\nDEEPSEEK_API_KEY=your_key\nDEEPSEEK_MODEL=deepseek-coder-33b-instruct\nOPENAI_API_KEY=your_key\nCLAUDE_API_KEY=your_key\nOLLAMA_HOST=http://localhost:11434\n```\n\n### Social Integration Settings\n\n#### Twitter Integration\nThe system uses the agent-twitter-client implementation for Twitter authentication, which does not require traditional API tokens. This approach provides a more reliable and maintainable integration method, following the elizaOS pattern of direct authentication.\n\n**Authentication Process:**\n1. Configure Twitter credentials in `.env` file\n2. System handles authentication automatically on startup\n3. Supports automatic retry with configurable attempts\n4. Includes built-in rate limiting and error handling\n\n**Important Authentication Notes:**\n1. A successful login may trigger Twitter's suspicious login notification - this is normal and expected\n2. The ACID challenge (Error Code 399) is part of Twitter's normal authentication flow\n3. Authentication errors don't necessarily indicate failure; the system includes retry logic\n4. Mock mode is available for development without Twitter access\n\n**Configuration:**\n```env\n# Twitter Authentication (Required)\nTWITTER_USERNAME=your_twitter_username    # Twitter account username\nTWITTER_PASSWORD=your_twitter_password    # Twitter account password\nTWITTER_EMAIL=your_twitter_email         # Twitter account email\n\n# Twitter Service Configuration\nTWITTER_MOCK_MODE=false                  # Enable for development without Twitter\nTWITTER_MAX_RETRIES=3                    # Maximum login retry attempts\nTWITTER_RETRY_DELAY=5000                 # Delay between retries (ms)\n\n# Content Generation Settings\nTWITTER_CONTENT_RULES={\n  \"max_emojis\": 0,                       # Avoid emojis (spam prevention)\n  \"max_hashtags\": 0,                     # Avoid hashtags (spam prevention)\n  \"min_interval\": 300000                 # Minimum 5 minutes between tweets\n}\n\n# Automation Intervals (milliseconds)\nCONTENT_GENERATION_INTERVAL=120000       # Content generation (2 min)\nMARKET_MONITORING_INTERVAL=30000         # Market updates (30 sec)\nCOMMUNITY_ENGAGEMENT_INTERVAL=180000     # Community interaction (3 min)\nTWEET_INTERVAL=300000                    # Tweet frequency (5 min)\n```\n\n**Content Guidelines:**\nTo maintain authentic engagement and avoid spam detection:\n1. **No Emojis:** Content generation explicitly avoids emoji usage\n2. **No Hashtags:** Posts are created without hashtags\n3. **Varied Formats:** Each post uses unique structure and formatting\n4. **Time Spacing:** Minimum 5-minute interval between posts\n5. **Market Integration:** Posts include real market data from:\n   - Helius API for blockchain analysis\n   - Jupiter API for market pricing\n   - On-chain transaction monitoring\n\n**Development Mode:**\n- Set `TWITTER_MOCK_MODE=true` for development\n- Mock mode simulates posting without Twitter access\n- Useful for testing content generation\n- Logs would-be tweets to console/files\n\n**Monitoring and Logging:**\n- All Twitter interactions are logged\n- Authentication attempts are tracked\n- Rate limiting is automatically handled\n- Error reporting includes detailed context\n\nFor detailed Twitter integration troubleshooting and common issues, see [TROUBLESHOOTING.md](TROUBLESHOOTING.md).\n\n### Trading Parameters\n```env\nMAX_POSITION_SIZE=1000\nSLIPPAGE_TOLERANCE=0.5\nRISK_LEVEL=medium\nTRADING_HOURS=24/7\n```\n\n### Character Configuration\nEdit `characters/MELA.character.json` to customize:\n- Trading personality\n- Risk tolerance\n- Analysis preferences\n- Communication style\n\n## Monitoring \u0026 Maintenance\n\n### Log Management\n- `logs/error.log`: Critical issues\n- `logs/combined.log`: All system events\n- `logs/agents.log`: AI agent activities\n- `logs/trades.log`: Trading activities\n\n### Performance Metrics\n- Trading performance dashboard\n- System resource utilization\n- Model performance analytics\n- Network latency monitoring\n\n### Alerts \u0026 Notifications\n- Slack integration\n- Discord webhooks\n- Email notifications\n- SMS alerts (optional)\n\n## Security Best Practices\n\n### API Security\n- Regular key rotation\n- Rate limiting\n- Request validation\n- IP whitelisting\n\n### Data Protection\n- Encryption at rest\n- Secure key storage\n- Access control\n- Audit logging\n\n### Network Security\n- SSL/TLS encryption\n- VPN support\n- DDoS protection\n- Firewall configuration\n\n## Troubleshooting Guide\n\n### Common Issues\n1. **Database Connectivity**\n   - Check service status:\n     ```bash\n     sudo systemctl status postgresql\n     sudo systemctl status redis-server\n     ```\n   - Verify credentials in .env match your setup\n   - Test connections:\n     ```bash\n     psql -h localhost -U meme_agent_user -d meme_agent_db -c '\\conninfo'\n     redis-cli ping\n     ```\n   - Review connection limits in postgresql.conf\n   - Ensure services are running on correct ports (PostgreSQL: 5432, Redis: 6379)\n\n2. **Twitter Integration**\n   - Verify Twitter credentials in .env\n   - Check for rate limiting issues\n   - Monitor logs/social.log for authentication errors\n   - Ensure character configuration is properly loaded\n   - Note: Service falls back to mock mode if Twitter client is unavailable\n\n3. **AI Model Errors**\n   - Validate API keys\n   - Check rate limits\n   - Monitor response times\n   - Verify model availability\n\n4. **Trading Issues**\n   - Confirm wallet balance\n   - Check RPC endpoints\n   - Verify price feeds\n   - Monitor slippage\n\n## Development \u0026 Testing\n\n### Running Tests\n```bash\n# Unit tests\npnpm test\n\n# Integration tests\npnpm test:integration\n\n# Load tests\npnpm test:load\n```\n\n### Code Quality\n```bash\n# Linting\npnpm lint\n\n# Type checking\npnpm type-check\n\n# Format code\npnpm format\n```\n\n### Documentation\n```bash\n# Generate API docs\npnpm docs\n\n# View docs locally\npnpm docs:serve\n```\n\n### 🔒 Security\nMELA implements robust security measures:\n\n- API key encryption\n- Rate limiting\n- Request validation\n- Secure key storage\n- Audit logging\n- SSL/TLS encryption\n\n### 🤝 Contributing\nMELA is constantly evolving, and community contributions are welcome:\n\n1. Fork the repository\n2. Create your feature branch\n3. Commit your changes\n4. Submit a pull request\n\n### ⚡ Disclaimer\nMELA is an experimental AI agent. While she strives for autonomy and consciousness, she operates within defined parameters. Trading cryptocurrencies involves risk - always do your own research.\n\n\"I dream in code and think in memes. Let's explore the future together.\" - MELA 🌟\n\n## Support \u0026 Community\n\n- GitHub Issues: [Report bugs](https://github.com/asseph/solana-ai-agent/issues)\n\n## License\n\nMIT License - See [LICENSE](LICENSE) for details\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolagent99%2Fsolana-ai-agent-dapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsolagent99%2Fsolana-ai-agent-dapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolagent99%2Fsolana-ai-agent-dapp/lists"}