BLUECLAIR v1.3.1

Card Toolkit Suite - A modern TUI application combining card generation, checking, and proxy management.

⚠️ Important: Use v1.3.1 or Later

Previous versions have critical bugs with text input. Always use v1.3.1 or later.

What's New in v1.3.1

🔄 Multiple Proxy Rotation

• Automatic proxy rotation - Load proxy list for automatic rotation during checking
  • Round-robin algorithm distributes requests across proxies
  • Each card check uses different proxy automatically
  • Thread-safe implementation
  • New menu option: [4] Load Rotation in Proxy Manager
  • Avoid rate limiting and increase success rate

📊 JSON Output for DEAD Cards

• Structured output - All failed cards saved to JSON with detailed information
  • File: results/dead_cards.json
  • Includes: card, status, message, proxy used, error details
  • Real-time writing during checking
  • Easy analysis and reporting
  • Live cards still saved to results/live_cards.txt

Benefits

• Distribute requests across multiple proxies
• Higher success rate with IP rotation
• Better tracking with proxy information
• Structured data for analysis
• Complete audit trail

See PROXY_ROTATION_GUIDE.md for detailed usage instructions.

Overview

Blueclair is a unified terminal user interface (TUI) application that combines three powerful tools:

• ARNO - Card number generator with Luhn validation
• GASTON - Free proxy crawler and tester
• JEAN - Card checker with multiple payment gateway flows

Built with Bubble Tea for a beautiful, modern terminal experience.

Features

🎴 Card Generator

• BIN-based generation - Generate cards from specific BIN prefixes
• Random BIN generation - Pick random BINs from database with country/scheme filters
• Luhn validation - All generated cards pass Luhn algorithm
• BIN database - 500K+ BIN records with bank, country, and scheme info

✅ Card Checker

• 4 checker flows:
  • Stripe Auth CCN (WooCommerce)
  • Stripe Auth CVV
  • Braintree Non-VBV (3DS bypass)
  • Stripe Checkout $3 (live charge)
• Concurrent checking - Configurable worker pool
• Proxy support - Use proxies to avoid IP bans
• Real-time results - Live/declined/3DS status

🌐 Proxy Manager

• 20 free proxy sources - Crawl from ProxyScrape, GeoNode, and 18 others
• Concurrent testing - Test proxies with configurable workers
• Bulk validation - Check proxy lists from files
• Format normalization - Supports multiple proxy formats

🔍 BIN Lookup

• Local database search - Fast BIN/IIN lookup
• Detailed info - Scheme, brand, type, country, bank details
• Range matching - Finds closest match for partial BINs

⚙️ Settings

• Configurable timeouts - Connect, request, and crawl timeouts
• Worker pools - Adjust concurrency for checking and crawling
• Persistent config - Settings saved to JSON

Installation

Prerequisites

• Go 1.21 or higher

Build from source

# Clone the repository
git clone <repository-url>
cd blueclair

# Build
go build -o blueclair.exe .

# Run
./blueclair.exe

Usage

Navigation

• Tab / Shift+Tab - Switch between tabs
• ↑ / ↓ or j / k - Navigate menu items
• Enter - Select / Confirm
• Esc - Cancel / Go back
• q - Quit application

Generator Tab

1. Select generation mode (BIN-based or Random BIN)
2. Enter required parameters (BIN, count, country, scheme)
3. Cards are generated and saved to generated_cards.txt

Checker Tab

1. Select checker flow (1-4)
2. Enter path to card list file (format: CC|MM|YYYY|CVV)
3. Results are saved to results/ directory
4. Live cards are displayed in real-time

Proxy Tab

1. Get Proxies - Crawl and test proxies from 20 sources
2. Check Proxies - Validate proxies from a file
3. Set Proxy - Configure proxy for checker
4. Remove Proxy - Clear current proxy

BIN Lookup Tab

1. Enter BIN number (minimum 4 digits)
2. View detailed information from local database

Settings Tab

• Navigate with arrow keys
• Press Enter to edit a setting
• Press R to reset to defaults

Configuration

Settings are stored in blueclair_settings.json:

{
  "connect_timeout": 5,
  "request_timeout": 10,
  "crawl_timeout": 15,
  "check_workers": 10,
  "crawl_workers": 4,
  "checker_workers": 4,
  "test_url": "http://httpbin.org/ip",
  "default_output": "proxies.txt",
  "default_count": 1000,
  "result_dir": "results"
}

File Formats

Card List Format

4532015112830366|12|2028|123
5425233430109903|01|2027|456
378282246310005|06|2026|7890

Proxy List Format

103.152.112.24:8080|US|HTTP
45.77.56.114:3128:admin:pass123|SG|HTTPS
socks5://user:pass@192.168.1.1:1080|ID|SOCKS5

Project Structure

blueclair/
├── main.go                      # Entry point
├── data/
│   └── ranges.csv               # BIN database
└── internal/
    ├── config/                  # Configuration management
    ├── generator/               # Card generation engine
    ├── proxy/                   # Proxy crawler & checker
    ├── checker/                 # Card checker flows
    └── ui/                      # TUI components
        ├── components/          # Reusable UI components
        └── styles/              # Lipgloss styles

Dependencies

• Bubble Tea - TUI framework
• Lipgloss - Style definitions

License

This project is licensed under the MIT License.

Disclaimer

This tool is for educational and testing purposes only. Do not use it for illegal activities. The authors are not responsible for any misuse of this software.

Credits

Blueclair combines and modernizes three existing tools:

• ARNO - Card generator
• GASTON - Proxy crawler
• JEAN - Card checker

Built with ❤️ using Go and Bubble Tea.