ALICE (Advanced Ledger Intelligence Collection Engine) is a high-performance BSC scanner bot designed for extracting token transfer transaction data from BSCScan with sub-second execution times and professional debugging capabilities.
alice_bot/
├── base.py # CLI Entry Point & Main Controller
├── core/
│ ├── scanner.py # BSC Scanner Core Logic
│ ├── config.py # Secure Configuration Manager
│ └── utils.py # Utility Functions & Formatters
├── interface/
│ └── terminal.py # Professional Terminal Interface
├── credentials/
│ └── bscscan_key.json # API Key Storage (Secure)
├── result/ # Output Directory
├── requirements.txt # Python Dependencies
└── README.md # This Documentation
- Ultra-Fast Execution: Sub-second transaction processing with optimized algorithms
- Dual Output Modes: Full transaction data or wallet addresses only
- Professional Debugging: Color-coded terminal output with step-by-step process tracking
- Critical Error Handling: Comprehensive error management with detailed solutions
- Rate Limiting: Intelligent API rate limiting for optimal performance
- Data Validation: Complete input validation and sanitization
- Execution Time: < 1 second per API request
- Rate Limiting: 5 requests/second (configurable)
- Error Recovery: Automatic retry with exponential backoff
- Memory Optimization: Efficient data processing for large datasets
- Security: Secure credential management and input sanitization
- Python 3.8+
- Windows/Linux/MacOS
- Internet connection
- BSCScan API key
pip install -r requirements.txt-
Clone/Download the project to your desired location:
C:\Users\xeaon\Pictures\alice_bot\ -
Install Dependencies:
cd alice_bot pip install -r requirements.txt -
Configure API Key:
- The API key is pre-configured in
credentials/bscscan_key.json - Modify if needed:
"bscscan_api_key": "YOUR_API_KEY"
-
Create Required Directories:
mkdir result
python base.py <command> <wallet_address> <action> <version> <output_file>sc|scan- Start wallet scanningh|help- Display help information
p|print- Print results to file
Vv- Full version (hash + method + age + from + to + token)Vf- From version (wallet addresses only)
Full Transaction Data:
python base.py sc 0xc51beb5b222aed7f0b56042f04895ee41886b763 p Vv wallet.txtWallet Addresses Only:
python base.py sc 0xc51beb5b222aed7f0b56042f04895ee41886b763 p Vf wallet.txtHelp:
python base.py help- Initialization: Bot loads configuration and initializes components
- Welcome Screen: Professional welcome interface with documentation
- User Confirmation: Scan confirmation prompt (y/n)
- Data Processing:
- Wallet validation
- API requests with rate limiting
- Transaction processing
- Data formatting
- Output Generation: Results saved to
result/directory - Completion Report: Success confirmation with statistics
Hash: 0x123...abc
Method: transfer
Age: 2 hours ago
From: 0xabc...123
To: 0xdef...456
Token: 1000.000000 USDT (Tether USD)
0xabc123def456...
0x789abc012def...
0xfed321cba987...
- 🔵 BLUE: Process steps and information
- 🟢 GREEN: Success messages and confirmations
- 🟡 YELLOW: Warnings and user prompts
- 🔴 RED: Errors and critical issues
- 🟣 MAGENTA: Data output and results
- 🔷 CYAN: API communications and system info
[INIT]- Initialization processes[SCAN]- Scanning operations[API]- API communications[PROCESS]- Data processing[SAVE]- File operations[ERROR]- Error handling
- Connection pooling for HTTP requests
- Concurrent processing for large datasets
- Memory-efficient data structures
- Optimized JSON parsing
- Intelligent caching mechanisms
- Dynamic rate adjustment
- Request queuing system
- Automatic retry logic
- Performance monitoring
- Secure API key storage
- Input sanitization
- Address validation
- Error message sanitization
- No hardcoded credentials
- Secure file permissions
- Network timeout protection
- Memory cleanup
- NETWORK_ERROR: Connection issues
- API_ERROR: BSCScan API problems
- TIMEOUT_ERROR: Request timeouts
- VALIDATION_ERROR: Invalid input data
- FILE_ERROR: File system issues
- Automatic retry with backoff
- Graceful degradation
- Detailed error reporting
- Solution suggestions
- Free Tier: 5 requests/second
- Standard: 10 requests/second
- Pro: 20 requests/second
- Use appropriate rate limiting
- Implement request batching
- Cache frequently accessed data
- Monitor API usage
- Valid Wallet Address: Standard BSC address
- Invalid Address: Malformed address handling
- Empty Results: Wallets with no transactions
- Rate Limiting: API limit testing
- Network Issues: Connection failure handling
- Initialization: < 0.1 seconds
- API Request: < 1.0 seconds
- Data Processing: < 0.5 seconds
- File Writing: < 0.1 seconds
{
"bscscan_api_key": "YOUR_API_KEY",
"rate_limit": 5,
"timeout": 30,
"max_retries": 3,
"base_url": "https://api.bscscan.com/api"
}- Rate limiting parameters
- Timeout values
- Output formatting
- Debug verbosity levels
- Initial release
- Core scanning functionality
- Professional terminal interface
- Comprehensive error handling
- Full documentation
- Follow PEP 8 coding standards
- Implement comprehensive error handling
- Add detailed docstrings
- Include unit tests
- Update documentation
- Zero tolerance for unhandled exceptions
- Performance optimization mandatory
- Security-first approach
- Professional debugging output
- Developer: onex_dv
- GitHub: https://github.com/onexdev
- Version: 1.0 Production Ready
- Check this documentation
- Review error messages and suggestions
- Verify API key and configuration
- Test with different wallet addresses
- Contact support with detailed error logs
This project is licensed under the MIT License - see the LICENSE file for details.
This tool is designed for legitimate blockchain analysis and research purposes. Users are responsible for complying with all applicable laws and regulations. The developers are not responsible for any misuse of this software.
🎉 Enjoy your blockchain analysis with ALICE Bot!
Built with precision engineering and professional standards by onex_dv