{"id":31183772,"url":"https://github.com/alphazee09/alphazee_trc","last_synced_at":"2026-07-07T09:31:42.101Z","repository":{"id":310127447,"uuid":"1038797748","full_name":"alphazee09/alphazee_trc","owner":"alphazee09","description":null,"archived":false,"fork":false,"pushed_at":"2025-08-16T21:45:20.000Z","size":15954,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-19T18:49:18.663Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/alphazee09.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}},"created_at":"2025-08-15T20:48:19.000Z","updated_at":"2025-08-16T21:45:16.000Z","dependencies_parsed_at":"2025-08-15T23:50:18.343Z","dependency_job_id":null,"html_url":"https://github.com/alphazee09/alphazee_trc","commit_stats":null,"previous_names":["alphazee09/alphazee_trc"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/alphazee09/alphazee_trc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphazee09%2Falphazee_trc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphazee09%2Falphazee_trc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphazee09%2Falphazee_trc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphazee09%2Falphazee_trc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alphazee09","download_url":"https://codeload.github.com/alphazee09/alphazee_trc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphazee09%2Falphazee_trc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35223382,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-07T02:00:07.222Z","response_time":90,"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":[],"created_at":"2025-09-19T18:17:50.831Z","updated_at":"2026-07-07T09:31:42.008Z","avatar_url":"https://github.com/alphazee09.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Alphazee09 - Professional Crypto Wallet\n\n## Overview\n\nAlphazee09 is a complete, professional-grade cryptocurrency wallet application built with Flutter for the frontend and Flask for the backend. It provides a secure, user-friendly interface for managing cryptocurrency assets with real-time market data, KYC verification, and advanced security features.\n\n## Features\n\n### 🔐 Security \u0026 Authentication\n- **User Registration \u0026 Login**: Secure account creation and authentication\n- **Biometric Authentication**: Fingerprint and face recognition support\n- **JWT Token-based Security**: Secure API communication\n- **Password Encryption**: Industry-standard password hashing\n\n### 💰 Wallet Management\n- **Multi-Currency Support**: Bitcoin (BTC), Ethereum (ETH), Tether (USDT)\n- **Wallet Address Generation**: Automatic generation of unique wallet addresses\n- **Balance Tracking**: Real-time balance updates\n- **Transaction History**: Complete transaction records with blockchain-like details\n\n### 📊 Real-Time Market Data\n- **Live Crypto Prices**: Real-time cryptocurrency price feeds\n- **Market Statistics**: Market cap, 24h volume, price changes\n- **Price Charts**: Visual price trend analysis\n- **Top Gainers/Losers**: Market performance insights\n\n### 💸 Transaction Features\n- **Send Cryptocurrency**: Send BTC, ETH, and USDT to any address\n- **Receive Cryptocurrency**: Generate QR codes for receiving payments\n- **Transaction Details**: Comprehensive transaction information including:\n  - Transaction hash and block details\n  - Gas fees and network information\n  - Smart contract addresses\n  - Confirmation status\n\n### 📋 KYC Verification\n- **Identity Verification**: Complete KYC process\n- **Document Upload**: Support for ID documents and selfies\n- **Verification Status**: Real-time verification progress\n- **Compliance**: Regulatory compliance features\n\n### 🎨 User Interface\n- **Modern Design**: Futuristic, professional UI/UX\n- **Dark Theme**: Eye-friendly dark mode interface\n- **Responsive Layout**: Optimized for all screen sizes\n- **Smooth Animations**: Fluid transitions and interactions\n\n## Technical Architecture\n\n### Backend (Flask)\n- **Framework**: Flask with SQLAlchemy ORM\n- **Database**: SQLite (production-ready)\n- **Authentication**: JWT tokens\n- **API**: RESTful API design\n- **External APIs**: CoinGecko for real-time crypto data\n- **Deployment**: Production-ready deployment on Manus Cloud\n\n### Frontend (Flutter)\n- **Framework**: Flutter with Dart\n- **State Management**: Provider pattern\n- **HTTP Client**: Dio for API communication\n- **Local Storage**: Hive and SharedPreferences\n- **Security**: Local authentication and secure storage\n- **UI Components**: Custom widgets with Material Design\n\n## API Endpoints\n\n### Authentication\n- `POST /api/register` - User registration\n- `POST /api/login` - User login\n- `GET /api/profile` - Get user profile\n- `PUT /api/profile` - Update user profile\n\n### Wallet Management\n- `GET /api/wallets` - Get user wallets\n- `POST /api/wallets` - Create new wallet\n- `GET /api/wallets/{id}/balance` - Get wallet balance\n- `GET /api/wallets/{id}/transactions` - Get transaction history\n\n### Transactions\n- `POST /api/transactions/send` - Send cryptocurrency\n- `GET /api/transactions/{id}` - Get transaction details\n- `POST /api/transactions/receive` - Generate receive address\n\n### Market Data\n- `GET /api/crypto/prices` - Get current crypto prices\n- `GET /api/crypto/price/{symbol}` - Get specific crypto price\n- `GET /api/crypto/market-stats` - Get market statistics\n\n### KYC\n- `POST /api/kyc/submit` - Submit KYC documents\n- `GET /api/kyc/status` - Get KYC verification status\n- `PUT /api/kyc/update` - Update KYC information\n\n## Installation \u0026 Setup\n\n### Backend Setup\n1. Navigate to the backend directory:\n   ```bash\n   cd alphazee09_backend\n   ```\n\n2. Create and activate virtual environment:\n   ```bash\n   python -m venv venv\n   source venv/bin/activate  # On Windows: venv\\Scripts\\activate\n   ```\n\n3. Install dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. Run the application:\n   ```bash\n   python src/main.py\n   ```\n\n### Flutter App Setup\n1. Navigate to the Flutter app directory:\n   ```bash\n   cd alphazee09_app\n   ```\n\n2. Install Flutter dependencies:\n   ```bash\n   flutter pub get\n   ```\n\n3. Run the application:\n   ```bash\n   flutter run\n   ```\n\n## Configuration\n\n### Backend Configuration\n- **Database**: SQLite database automatically created\n- **Secret Key**: Configured in `src/main.py`\n- **CORS**: Enabled for cross-origin requests\n- **File Upload**: 16MB maximum file size\n\n### Flutter Configuration\n- **API Base URL**: Configured in `lib/core/constants/app_constants.dart`\n- **Supported Currencies**: BTC, ETH, USDT\n- **Theme**: Dark theme with custom colors\n- **Animations**: Configurable animation durations\n\n## Security Features\n\n### Backend Security\n- **Password Hashing**: Werkzeug security for password hashing\n- **JWT Tokens**: Secure token-based authentication\n- **Input Validation**: Comprehensive input validation\n- **SQL Injection Protection**: SQLAlchemy ORM protection\n- **CORS Configuration**: Secure cross-origin resource sharing\n\n### Frontend Security\n- **Biometric Authentication**: Local biometric verification\n- **Secure Storage**: Encrypted local storage for sensitive data\n- **Token Management**: Automatic token refresh and validation\n- **Input Sanitization**: Client-side input validation\n\n## Database Schema\n\n### Users Table\n- `id`: Primary key\n- `username`: Unique username\n- `email`: Unique email address\n- `password_hash`: Encrypted password\n- `first_name`, `last_name`: User names\n- `phone`: Phone number\n- `profile_image`: Profile image URL\n- `fingerprint_enabled`: Biometric setting\n- `is_verified`: KYC verification status\n- `created_at`, `updated_at`: Timestamps\n\n### Wallets Table\n- `id`: Primary key\n- `user_id`: Foreign key to users\n- `currency`: Cryptocurrency type\n- `address`: Wallet address\n- `private_key`: Encrypted private key\n- `balance`: Current balance\n- `created_at`: Creation timestamp\n\n### Transactions Table\n- `id`: Primary key\n- `user_id`: Foreign key to users\n- `wallet_id`: Foreign key to wallets\n- `transaction_type`: Send/Receive\n- `amount`: Transaction amount\n- `fee`: Network fee\n- `to_address`: Recipient address\n- `from_address`: Sender address\n- `tx_hash`: Transaction hash\n- `block_number`: Block number\n- `status`: Transaction status\n- `created_at`: Transaction timestamp\n\n### KYC Records Table\n- `id`: Primary key\n- `user_id`: Foreign key to users\n- `document_type`: Type of document\n- `document_url`: Document file URL\n- `status`: Verification status\n- `submitted_at`: Submission timestamp\n\n## Deployment\n\n### Backend Deployment\nThe backend is deployed on Manus Cloud and accessible at:\n**https://zmhqivcm6ly1.manus.space**\n\n### Flutter App Deployment\nThe Flutter app can be built for multiple platforms:\n\n#### Android\n```bash\nflutter build apk --release\n```\n\n#### iOS\n```bash\nflutter build ios --release\n```\n\n#### Web\n```bash\nflutter build web --release\n```\n\n## Testing\n\n### Backend Testing\nTest the API endpoints using curl:\n\n```bash\n# Register a new user\ncurl -X POST https://zmhqivcm6ly1.manus.space/api/register \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"username\":\"testuser\",\"email\":\"test@example.com\",\"password\":\"TestPass123\"}'\n\n# Login\ncurl -X POST https://zmhqivcm6ly1.manus.space/api/login \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"username\":\"testuser\",\"password\":\"TestPass123\"}'\n\n# Get crypto prices\ncurl -X GET https://zmhqivcm6ly1.manus.space/api/crypto/prices\n```\n\n### Flutter App Testing\n```bash\nflutter test\n```\n\n## Key Features Implementation\n\n### Real-Time Crypto Prices\n- Integration with CoinGecko API\n- Automatic price updates every 30 seconds\n- Support for 8+ major cryptocurrencies\n- Market cap and volume data\n\n### Wallet Address Generation\n- Secure random address generation\n- Support for Bitcoin, Ethereum, and USDT (ERC-20)\n- Unique addresses for each user and currency\n- Private key encryption and storage\n\n### Transaction Processing\n- Simulated blockchain transactions\n- Real-time transaction status updates\n- Comprehensive transaction details\n- Network fee calculations\n\n### KYC Verification Process\n- Document upload functionality\n- Identity verification workflow\n- Status tracking and notifications\n- Compliance with regulatory requirements\n\n### Biometric Security\n- Fingerprint authentication\n- Face recognition support\n- Secure local authentication\n- Fallback to PIN/password\n\n## Performance Optimizations\n\n### Backend Optimizations\n- Database query optimization\n- Efficient API response caching\n- Minimal data transfer\n- Asynchronous processing\n\n### Frontend Optimizations\n- Lazy loading of screens\n- Image caching and optimization\n- Efficient state management\n- Smooth animations and transitions\n\n## Future Enhancements\n\n### Planned Features\n- **Multi-language Support**: Internationalization\n- **Advanced Charts**: Detailed price analysis\n- **DeFi Integration**: Decentralized finance features\n- **NFT Support**: Non-fungible token management\n- **Staking Rewards**: Cryptocurrency staking\n- **News Feed**: Crypto news integration\n- **Portfolio Analytics**: Investment tracking\n- **Social Features**: Community integration\n\n### Technical Improvements\n- **Real Blockchain Integration**: Actual blockchain connectivity\n- **Advanced Security**: Hardware security module integration\n- **Performance Monitoring**: Application performance insights\n- **Automated Testing**: Comprehensive test coverage\n- **CI/CD Pipeline**: Continuous integration and deployment\n\n## Support \u0026 Maintenance\n\n### Error Handling\n- Comprehensive error logging\n- User-friendly error messages\n- Automatic error reporting\n- Graceful failure handling\n\n### Monitoring\n- Application performance monitoring\n- API endpoint monitoring\n- User activity tracking\n- System health checks\n\n### Updates\n- Regular security updates\n- Feature enhancements\n- Bug fixes and improvements\n- Compatibility updates\n\n## Conclusion\n\nAlphazee09 represents a complete, professional-grade cryptocurrency wallet solution with enterprise-level features and security. The application demonstrates modern mobile development practices, secure backend architecture, and user-centric design principles.\n\nThe project showcases:\n- **Full-stack development** with Flutter and Flask\n- **Real-time data integration** with external APIs\n- **Secure authentication** and authorization\n- **Professional UI/UX design** with modern aesthetics\n- **Comprehensive feature set** for cryptocurrency management\n- **Production-ready deployment** with scalable architecture\n\nThis implementation serves as a solid foundation for a commercial cryptocurrency wallet application, with all the essential features and security measures required for handling digital assets safely and efficiently.\n\n---\n\n**Developed by Manus AI**  \n**Version**: 1.0.0  \n**Last Updated**: August 15, 2025\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falphazee09%2Falphazee_trc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falphazee09%2Falphazee_trc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falphazee09%2Falphazee_trc/lists"}