Introduction to Ethereum Wallet Tracking
The Ethereum Wallet Tracker is a powerful bot designed to monitor your Ethereum wallet activity and send instant notifications when new transactions occur. Whether you're tracking standard transfers, internal transactions, ERC-20 token movements, or ERC-721 NFT transactions, this tool keeps you informed through Line Notify or Discord alerts.
Key features of this wallet tracker:
- Supports both Ethereum mainnet and Goerli testnet
- Comprehensive transaction type coverage
- Multiple notification channels available
- Easy self-hosting setup
๐ Start tracking your Ethereum wallet today
Getting Started with the Ethereum Wallet Tracker
Self-Hosting Guide
To deploy your own instance of the Ethereum Wallet Tracker:
- Download the latest release from the GitHub repository
- Extract the files and configure the
config.ymlfile using a proper text editor - Fill in all required API keys and access tokens
- Launch the
WalletTracker.exeapplication - Connect your preferred notification service (Line or Discord)
- Begin monitoring your wallet addresses
Configuration Breakdown
The config.yml file contains several critical sections:
webhook:
url: ''
port: 5000
api_keys:
etherscan: ''
alchemy: ''
notification:
line:
bot_token: ''
channel_secret: ''
notify:
client_id: ''
client_secret: ''Each section requires specific credentials that you'll need to obtain from their respective services.
Essential Service Integrations
Obtaining Required API Keys
Etherscan API Key:
- Create an account on Etherscan.io
- Navigate to the API keys section
- Generate a new key for your wallet tracker
Alchemy Web Services:
- Sign up for an Alchemy account
- Create a new app in the dashboard
- Retrieve your API key and webhook authentication token
Notification Service Setup
Line Integration:
- Register as a Line developer
- Create a new messaging channel
- Configure webhook settings with your server URL
- Obtain channel access tokens and secrets
Discord Integration:
- Create a new application in the Discord Developer Portal
- Add a bot to your application
- Configure the necessary intents and permissions
- Copy your bot token for configuration
๐ Learn more about blockchain wallet security
Technical Implementation Details
Webhook Configuration
Your webhook URL serves as the communication endpoint between notification services and your tracker. For development purposes, you can use ngrok to create a secure tunnel to your local server:
- Sign up for an ngrok account
- Download and configure the ngrok client
- Create a static domain for your webhook
- Configure the tunnel to forward to your local port
Project Architecture
The Ethereum Wallet Tracker utilizes several Python libraries:
- PyYAML for configuration management
- Requests for API communication
- Line SDK for messaging integration
- FastAPI for webhook handling
- Uvicorn as the ASGI server
Contribution Guidelines
We welcome contributions to improve the Ethereum Wallet Tracker:
- Fork the repository
- Create a feature branch
- Implement your changes following coding standards
- Submit a pull request
Coding Standards
- Maintain 100-character line limits
- Use snake_case naming convention
- Include comprehensive docstrings
- Follow Google-style TODO comments
- Keep imports optimized and organized
Frequently Asked Questions
How often does the tracker check for new transactions?
The bot continuously monitors the blockchain and triggers notifications immediately when transactions are detected.
Can I track multiple wallets with one instance?
Yes, the tracker supports monitoring multiple Ethereum addresses simultaneously.
What types of transactions are supported?
The system detects standard transfers, internal transactions, ERC-20 token transfers, and ERC-721 NFT movements.
Is there a mobile version available?
Currently, the tracker runs as a desktop application but can be hosted on a server for remote access.
How secure are my wallet credentials?
The tracker only requires read-only access through API keys and never stores private keys.
Support and Maintenance
If you encounter issues or have feature requests:
- Open an issue on GitHub
- Join our Discord community for support
- Consider starring the repository to show your support
For those wishing to contribute financially, donations can be sent to:
Ethereum address: hot.happygroup.eth
License Information
This project is open-source under the MIT License. See the LICENSE file for complete details.