- Primary Contact: Satyam Gupta
- Telegram Handle: Kristo
- Team: HackxBot
Cryptona - Advanced Multi-Chain Cryptocurrency Wallet Management with AI Integration
Cryptona is an AI-powered multi-chain cryptocurrency portfolio and Wallet manager that connects to Ethereum, Polygon, BSC, Arbitrum, and Hedera networks, allowing users to manage multiple wallets, analyze tokens for security risks, and receive intelligent investment insights through a Model Context Protocol (MCP) interface.
Cryptona revolutionizes cryptocurrency portfolio management by providing a unified interface for managing assets across multiple blockchain networks. The project combines traditional wallet functionality with AI-powered analysis and security features, making it easier for users to track, manage, and secure their crypto investments.
- Ethereum Mainnet - Native ETH and ERC-20 token support
- Polygon Network - MATIC and Polygon-based tokens
- BSC (Binance Smart Chain) - BNB and BEP-20 tokens
- Arbitrum Network - Layer 2 scaling for Ethereum
- Hedera Hashgraph - HBAR and Hedera ecosystem tokens
- Portfolio Analysis - LLaMA 3.1 powered insights via Groq
- Token Security Analysis - AI-driven scam detection
- Investment Recommendations - Personalized advice based on portfolio
- Real-time News Integration - Latest crypto news and Hedera updates
- Market Intelligence - Price tracking and conversion tools
- Token Security Analyzer - Detect honeypots, rug pulls, and suspicious contracts
- Private Key Management - Secure local storage and handling
- Transaction Validation - Multi-layer verification before sending
- Risk Assessment - AI-powered risk scoring for tokens and transactions
- Multi-Wallet AI Control - Unique MCP implementation controlling 4+ wallets simultaneously
- 25+ AI Tools - Comprehensive toolkit for crypto management
- Natural Language Interface - Interact with wallets using plain English
- Cross-Chain Operations - Seamless management across different networks
- FastAPI - High-performance Python web framework
- Web3.py - Ethereum and EVM chain interactions
- Groq API - LLaMA 3.1 model for AI features
- Hedera SDK - Hedera network integration
- SQLite/PostgreSQL - Data persistence
- CORS Middleware - Cross-origin resource sharing
- React 18 - Modern UI framework
- TypeScript - Type-safe JavaScript
- Tailwind CSS - Utility-first styling
- Framer Motion - Smooth animations
- Lucide React - Beautiful icons
- Recharts - Data visualization
- Groq (LLaMA 3.1-8B) - Natural language processing
- Model Context Protocol (MCP) - AI-blockchain interface
- CoinGecko API - Real-time price data
- Custom Security Algorithms - Token risk assessment
- Node.js 18+ and npm/yarn
- Python 3.8+
- Git
-
Clone the Repository
git clone https://github.com/your-username/cryptona.git cd cryptona -
Create Python Virtual Environment
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
-
Install Python Dependencies
pip install -r requirements.txt
-
Install Required Packages
pip install fastapi uvicorn python-dotenv groq web3 requests nacl hashlib pip install mcp # For MCP server functionality
-
Navigate to Frontend Directory
cd frontend # Adjust path as needed
-
Install Dependencies
npm install # or yarn install -
Install Additional Packages
npm install framer-motion lucide-react recharts
Create a .env file in the root directory with the following variables:
# Groq API Configuration
GROQ_API_KEY=your_groq_api_key_here
# Hedera Network Configuration
HEDERA_BASE_URL=https://mainnet-public.mirrornode.hedera.com/api/v1
HEDERA_ACCOUNT_ID=0.0.your_account_id
HEDERA_PRIVATE_KEY=your_hedera_private_key
HEDERA_PUBLIC_KEY=your_hedera_public_key
HEDERA_API_KEY=your_hedera_api_key_optional
# Ethereum/EVM Networks (Optional - defaults provided)
QUICKNODE_URL=https://your-quicknode-endpoint
POLYGON_URL=https://polygon-rpc.com
BSC_URL=https://bsc-dataseed1.binance.org
ARBITRUM_URL=https://arb1.arbitrum.io/rpc
# Security (for production)
SECRET_KEY=your_secret_key_here
DEBUG=False-
Groq API Key
- Sign up at console.groq.com
- Create a new API key
- Add to
GROQ_API_KEY
-
Hedera Account
- Create account on Hedera network
- Get account ID and private key
- Add to respective environment variables
-
QuickNode (Optional)
- Sign up for Ethereum node access
- Add endpoint to
QUICKNODE_URL
# Activate virtual environment
source venv/bin/activate
# Start FastAPI server
uvicorn main:app --reload --host 0.0.0.0 --port 8000# In frontend directory
npm start
# or
yarn start# Run the MCP server for AI integration
python mcp.pycurl "http://localhost:8000/wallet/balance?private_key=your_private_key"curl "http://localhost:8000/llm/checktoken?token_address=0x..."curl "http://localhost:8000/hedera/account/balance"curl "http://localhost:8000/llm/query?q=What are the best DeFi strategies for 2024?"- View all wallet balances across networks
- Real-time USD value calculations
- Token holdings breakdown
- Copy addresses with one click
- Check HBAR balance
- Send HBAR transactions
- View transaction history
- Get Hedera-specific tips and news
- Paste token contract address
- Get AI-powered security analysis
- View known risky tokens
- Security best practices
# Example MCP tool usage
await mcp_server.call_tool("add_wallet", {
"wallet_name": "main_wallet",
"private_key": "your_private_key",
"wallet_type": "ethereum"
})
await mcp_server.call_tool("get_portfolio_overview", {})
await mcp_server.call_tool("analyze_wallet", {
"wallet_name": "main_wallet"
})-
Hedera SDK Integration
- Currently using placeholder implementation
- Real Hedera transactions need full SDK integration
- Transaction signing needs proper implementation
-
MetaMask Integration
- Frontend shows MetaMask wallet but backend integration pending
- Direct MetaMask connection not implemented
- Cross-chain transfers are simulated
-
Price Data Accuracy
- CoinGecko API has rate limits
- Some token prices may not be available
- USD calculations are estimates
-
Transaction History
- Currently stored in localStorage (frontend only)
- No persistent backend storage implemented
- Limited to browser session
-
Error Handling
- Network timeouts not fully handled
- Some API errors need better user feedback
- Recovery mechanisms need improvement
-
Private Key Storage
- Currently handled in memory only
- Production needs secure key management
- Consider hardware wallet integration
-
API Key Exposure
- Ensure
.envis in.gitignore - Use environment-specific configurations
- Rotate keys regularly
- Ensure
-
Multi-Chain Queries
- Parallel API calls can be slow
- Consider implementing caching
- Rate limiting on external APIs
-
Frontend Loading
- Initial portfolio load can be slow
- Need loading states for better UX
- Consider lazy loading components
-
Database Integration
- Persistent transaction history
- User preferences storage
- Portfolio analytics over time
-
Enhanced Security
- Multi-factor authentication
- Hardware wallet support
- Advanced scam detection algorithms
-
Mobile Responsiveness
- Optimize for mobile devices
- Touch-friendly interactions
- Progressive Web App (PWA) features
-
Additional Networks
- Solana integration
- Avalanche support
- Cosmos ecosystem
- Full Hedera SDK integration
- Real-time WebSocket price feeds
- Advanced portfolio analytics
- Mobile application
- Hardware wallet support
- DeFi protocol integrations
- Social trading features
- Advanced AI trading strategies
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
This project is licensed under the MIT License - see the LICENSE file for details.
- Groq for LLaMA 3.1 API access
- Hedera Hashgraph for innovative consensus technology
- Web3.py community for blockchain integration tools
- React team for the amazing frontend framework
- FastAPI for the high-performance backend framework
Built with ❤️ for the crypto community