DABC Wallet Analyzer

Professional-grade analyzer for Drooling Ape Bus Club (DABC) assets in Counterparty wallets.

🚀 Quick Start

# Clone and setup
git clone <repository>
cd Drooler
pip install -r requirements.txt

# Run analysis
python main.py

✨ Features

• Complete Asset Detection: Identifies all 403 DABC assets in any wallet
• Accurate Quantification: Shows exact quantities per individual asset
• Professional Reporting: Comprehensive analysis with value estimates
• Robust API Integration: Full pagination support for large wallets
• Error Handling: Graceful handling of API failures and network issues
• Configurable: Customizable timeouts, retries, and output options

📊 What You Get

Executive Summary

• Total unique DABC assets owned
• Complete token quantities
• Collection coverage percentage
• Estimated USD/BTC/XCP values

Detailed Breakdown

• Individual asset quantities
• Current market values (when available)
• Asset descriptions and metadata
• Highlighted multiple-quantity holdings

🛠️ Usage Options

1. Simple Interface

python main.py

Interactive prompt for wallet address analysis.

2. Command Line Interface

# Basic analysis
python -m dabc_analyzer.cli 1FZzA4kPgwvN3cCTEntiPgm2Jwq4U4Zrgt

# Custom output file
python -m dabc_analyzer.cli <wallet> --output my_analysis.txt

# Verbose logging
python -m dabc_analyzer.cli <wallet> --verbose

# Custom configuration
python -m dabc_analyzer.cli <wallet> --api-timeout 60 --api-retries 5

3. Python API

from src.dabc_analyzer.analyzer import DABCWalletAnalyzer
from src.dabc_analyzer.config import Config

# Initialize analyzer
analyzer = DABCWalletAnalyzer("1FZzA4kPgwvN3cCTEntiPgm2Jwq4U4Zrgt")

# Run analysis
report = analyzer.analyze()
print(report)

# Save report
output_file = analyzer.save_report(report)
print(f"Saved to: {output_file}")

📁 Project Structure

Drooler/
├── main.py                 # Simple entry point
├── requirements.txt        # Dependencies
├── README.md              # This file
├── src/
│   └── dabc_analyzer/
│       ├── __init__.py    # Package initialization
│       ├── analyzer.py    # Main analyzer class
│       ├── config.py      # Configuration management
│       ├── cli.py         # Command line interface
│       └── exceptions.py  # Custom exceptions
├── data/
│   └── dabc_assets.txt    # Complete DABC asset directory (403 assets)
├── output/                # Analysis reports (auto-created)
├── docs/                  # Documentation
├── tests/                 # Unit tests
└── examples/              # Usage examples

⚙️ Configuration

Environment Variables

export DABC_API_BASE_URL="https://tokenscan.io"
export DABC_API_TIMEOUT="30"
export DABC_API_RETRIES="3"
export DABC_ASSETS_DIRECTORY="data/dabc_assets.txt"
export DABC_OUTPUT_DIRECTORY="output"
export DABC_LOG_LEVEL="INFO"

Custom Configuration

from src.dabc_analyzer.config import Config

config = Config({
    'api_timeout': 60,
    'api_retries': 5,
    'max_page_size': 1000,
    'assets_directory': 'custom/path/to/assets.txt'
})

analyzer = DABCWalletAnalyzer(wallet_address, config)

🔧 API Details

• Data Source: TokenScan.io API
• Pagination: Automatic handling of large wallets (1000+ assets)
• Rate Limiting: Built-in delays to respect API limits
• Retry Logic: Exponential backoff for failed requests
• Timeout Handling: Configurable timeouts with graceful degradation

📋 Requirements

• Python 3.8 or higher
• Internet connection for API access
• Valid Bitcoin wallet address

🤝 Contributing

Contributions welcome! Please read our contributing guidelines and submit pull requests for any improvements.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

If you encounter issues:

1. Check Requirements: Ensure Python 3.8+ and required packages are installed
2. Verify Wallet: Confirm the wallet address is valid and contains Counterparty assets
3. API Status: Check if TokenScan.io is accessible
4. Enable Debug: Run with --verbose flag for detailed logging

📈 Roadmap

• GUI interface
• Historical price tracking
• Portfolio performance analytics
• Multi-wallet batch analysis
• Export to CSV/Excel formats
• Real-time monitoring capabilities

---

Built for the DABC Community 🎯