A high-performance, concurrent EVM-compatible wallet recovery tool built in Rust. This tool monitors specified wallets across multiple blockchain networks and automatically transfers funds to a secure destination address to protect assets from compromised wallets.
This tool is designed to help recover funds from potentially compromised wallets on EVM-compatible networks by automatically monitoring balances and transferring funds to a secure destination address. It utilizes Rust's async capabilities and the Tokio runtime for efficient concurrent monitoring of multiple wallets across different networks.
- Concurrent monitoring of multiple wallets
- Support for all EVM-compatible networks
- Efficient gas price optimization
- Automatic balance sweeping
- Rate-limited monitoring (2 second intervals)
- High-performance Rust implementation
- Robust error handling and logging
- Rust (latest stable version)
- Access to EVM-compatible RPC endpoints
- Private keys of the wallets to monitor
- Clone the repository:
git clone https://github.com/codeesura/evm-guardian.git
cd evm-guardian
- Build the project:
cargo build --release
-
Create a private-keys.txt file in the project root:
- Add one private key per line
- Each private key should be in hex format (without 0x prefix)
-
Configure the constants in src/main.rs:
- RPC_URL: Your EVM network RPC endpoint (supports any EVM-compatible network)
- TARGET_ADDRESS: The secure destination address
- CHECK_INTERVAL: Monitoring interval in seconds (default: 2)
- Ensure your configuration is set up correctly
- Run the tool:
cargo run --release
The tool will:
- Load private keys from private-keys.txt
- Monitor each wallet concurrently
- Automatically transfer funds when balance exceeds 0.01 ETH
- Log all operations to stdout
-
WalletManager: Handles individual wallet operations
- Balance checking
- Transaction building
- ETH transfers
-
Concurrent Monitoring: Uses Tokio for async execution
- Each wallet runs in its own task
- Non-blocking operations
- Efficient resource utilization
- Automatically calculates optimal gas prices
- Estimates gas limits for transactions
- Deducts gas costs from transfer amount
- Handles nonce management automatically
- Rate limiting to prevent RPC overload
- Error handling and reporting
- Balance thresholds to prevent dust transfers
- Gas price optimization
- alloy: Ethereum interaction library
- tokio: Async runtime
- eyre: Error handling
- futures: Async utilities
- Store private keys securely
- Use a reliable RPC endpoint
- Monitor the tool's operation
- Keep the destination address secure
- Regularly check logs for any issues
The tool provides real-time logging:
- Success messages include wallet addresses
- Error messages with detailed information
- Transaction status updates
The tool is optimized for:
- Minimal RPC calls
- Efficient memory usage
- Fast transaction processing
- Concurrent wallet monitoring
- Test with small amounts first
- Use a reliable RPC endpoint
- Monitor system resources
- Keep private keys secure
- Regular log checking
The tool implements comprehensive error handling for:
- RPC connection issues
- Transaction failures
- Invalid private keys
- Network problems
- Gas estimation errors
Contributions are welcome! Please follow these steps:
- Fork the repository
- Create a feature branch
- Commit your changes
- Create a pull request
This tool is provided for legitimate recovery operations only. Users are responsible for ensuring they have the right to access and transfer funds from the specified wallets.
For issues and support:
- Open an issue in the repository
- Provide detailed information about the problem
- Include relevant logs and configuration
Note: Always verify addresses and configurations before running the tool with real funds.