ENSHunter is a high-performance Go tool that helps you find available Ethereum Name Service (ENS) domains from a list. It scans domains in parallel, checks their availability directly on the Ethereum blockchain, and saves the available domains to a file.

• 🚀 High Performance: Check multiple domains concurrently using goroutines
• 📊 Progress Visualization: Real-time progress bar showing scan completion
• 🔄 Auto-retry: Automatic retry for failed requests with configurable attempts
• ⏱️ Rate Limiting: Configurable request rate to avoid API throttling
• 🎛️ Configurable: Extensive command-line options for customization
• 🧠 Smart Processing: Handles domains with or without .eth suffix
• 🔐 Secure Configuration: Store API keys securely in config files

• Go 1.18 or higher
• Infura API key (Get one for free here)
• Internet connection to access Ethereum network

The easiest way to install ENSHunter is via Go's module system:

go install github.com/xPOURY4/ENSHunter@latest

After installation, you should be able to run enshunter from your terminal.

For the latest features or to modify the code:

# Clone the repository
git clone https://github.com/xPOURY4/ENSHunter.git

# Navigate to the project directory
cd ENSHunter

# Build the executable
go build -o enshunter

# Optional: Move to your PATH
sudo mv enshunter /usr/local/bin/  # Linux/macOS
# OR
# Add to your PATH manually on Windows

Pre-built binaries for various platforms will be available on the Releases page.

The application requires the following Go packages:

go get github.com/ethereum/go-ethereum
go get github.com/schollz/progressbar/v3
go get github.com/fatih/color
go get github.com/joho/godotenv

ENSHunter supports several ways to configure your API keys and settings:

Create a .env file in the directory where you run the application:

INFURA_KEY=your_infura_key_here
WORKERS=10
RATE_LIMIT=50
RETRIES=3
TIMEOUT=30

ENSHunter will check for a config file at ~/.enshunter/config.json. You can save your current settings with:

enshunter -infura YOUR_INFURA_KEY -workers 10 -save-config

This creates a configuration file like:

{
  "infura_key": "your_infura_key",
  "workers": 10,
  "rate_limit": 50,
  "retries": 3,
  "timeout": 30
}

These override any settings from config files.

enshunter -input domains.txt -output available.txt

enshunter \
  -infura YOUR_INFURA_KEY \
  -input domains.txt \
  -output available.txt \
  -workers 10 \
  -rate 50 \
  -retries 3 \
  -timeout 30 \
  -verbose \
  -save-config

Create a text file with one domain name per line. The domain names can be with or without the .eth suffix:

example
test123
cool-domain.eth
myfavoritename

You can find a sample input file at esn.txt.sample.

When the program completes, you'll see a summary like this:

Summary:
Total domains checked: 150
Available domains: 23
Errors: 2
Available domains saved to: available.txt

The output file will contain a list of available domains with the .eth suffix:

example.eth
test123.eth
myfavoritename.eth

ENSHunter connects directly to the Ethereum blockchain using the Ethereum Name Service (ENS) contracts through Infura's API. For each domain in your input file:

1. The program checks if the domain is already registered
2. If available, it's added to the output file
3. The process continues until all domains are checked

The application uses goroutines to perform multiple checks simultaneously, significantly speeding up the process compared to sequential checking.

• Finding short or memorable ENS domains still available for registration
• Bulk checking domain availability for clients or personal use
• Monitoring domain availability for future registration
• Finding valuable domains before others discover them

• Rate limiting: If you encounter rate limiting errors, increase the -rate value
• Timeout errors: Try increasing the -timeout value or reducing the number of workers
• Missing API key: Ensure your Infura API key is provided via one of the configuration methods

Use the -verbose flag to enable detailed logging, which can help identify issues:

enshunter -input domains.txt -verbose

Future features planned for ENSHunter:

• Price estimation for domain registration
• Domain expiration monitoring
• Web interface for easier use
• Support for additional name services beyond ENS
• Batch domain registration

Contributions, issues, and feature requests are welcome! Feel free to check the issues page for open issues or create a new one.

To contribute:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is MIT licensed.

@TheRealPourya - Twitter

Project Link: https://github.com/xPOURY4/ENSHunter

go install github.com/xPOURY4/ENSHunter@latest

# کلون کردن مخزن
git clone https://github.com/xPOURY4/ENSHunter.git

# رفتن به دایرکتوری پروژه
cd ENSHunter

# ساخت فایل اجرایی
go build -o enshunter

# اختیاری: انتقال به PATH
sudo mv enshunter /usr/local/bin/  # لینوکس/مک
# یا
# اضافه کردن به PATH به صورت دستی در ویندوز

go get github.com/ethereum/go-ethereum
go get github.com/schollz/progressbar/v3
go get github.com/fatih/color
go get github.com/joho/godotenv

INFURA_KEY=کلید_اینفورای_شما
WORKERS=10
RATE_LIMIT=50
RETRIES=3
TIMEOUT=30

enshunter -infura کلید_اینفورای_شما -workers 10 -save-config

{
  "infura_key": "کلید_اینفورای_شما",
  "workers": 10,
  "rate_limit": 50,
  "retries": 3,
  "timeout": 30
}

enshunter -input دامنه‌ها.txt -output دامنه‌های_موجود.txt

enshunter \
  -infura کلید_اینفورای_شما \
  -input دامنه‌ها.txt \
  -output دامنه‌های_موجود.txt \
  -workers 10 \
  -rate 50 \
  -retries 3 \
  -timeout 30 \
  -verbose \
  -save-config

example
test123
cool-domain.eth
myfavoritename

خلاصه:
کل دامنه‌های بررسی شده: 150
دامنه‌های قابل ثبت: 23
خطاها: 2
دامنه‌های قابل ثبت در فایل زیر ذخیره شدند: available.txt

example.eth
test123.eth
myfavoritename.eth

enshunter -input دامنه‌ها.txt -verbose

یک فایل متنی با یک نام دامنه در هر خط ایجاد کنید. نام‌های دامنه می‌توانند با یا بدون پسوند .eth باشند:

example
test123
cool-domain.eth
myfavoritename

خلاصه:
کل دامنه‌های بررسی شده: 150
دامنه‌های قابل ثبت: 23
خطاها: 2
دامنه‌های قابل ثبت در فایل زیر ذخیره شدند: available.txt

• یافتن دامنه‌های ENS کوتاه یا جذاب که هنوز برای ثبت موجود هستند
• بررسی دسته‌ای قابلیت ثبت دامنه برای مشتریان یا استفاده شخصی
• نظارت بر قابلیت ثبت دامنه‌ها برای ثبت در آینده

مشارکت‌ها، گزارش مشکلات و درخواست‌های ویژگی جدید مورد استقبال قرار می‌گیرند! لطفاً صفحه مشکلات را بررسی کنید.

این پروژه تحت مجوز MIT منتشر شده است.

@TheRealPourya - توییتر