AlienTek - Solana Vanity Wallet Generator

A privacy-first, client-side Solana vanity wallet generator with token-gated pricing.

✨ Features

• 🔒 100% Client-Side: All key generation happens in your browser using Web Workers
• 🚫 Zero Server Storage: Your private keys never leave your browser
• 👛 Wallet Support: Connect with Phantom or Solflare
• 💎 Token-Gated Tiers: 3-tier holder system with 40-100% discounts off all services
• ⚡ High Performance: Multi-threaded generation with real-time progress tracking
• 🎯 Secure: Generate vanity addresses with 3 or 4 custom characters (prefix or suffix)
• 📊 Progress Tracking: Real-time attempts, rate, and ETA with pause/resume controls

💰 Pricing

Length	Standard Price	Tier 3 (1M+ tokens, 40% off)	Tier 2 (5M+ tokens, 80% off)	Tier 1 (10M+ tokens)
3 Characters	0.15 SOL	0.09 SOL	0.03 SOL	FREE
4 Characters	0.20 SOL	0.12 SOL	0.04 SOL	FREE

🚀 Getting Started

Prerequisites

• Node.js 18 or higher
• npm or yarn package manager
• Phantom or Solflare wallet browser extension

Installation

# Clone the repository
git clone https://github.com/NextLevel333/AlienTek.git
cd AlienTek

# Install dependencies
npm install

Development

# Start development server
npm run dev

Open http://localhost:3000 to view the application.

Production Build

# Create optimized production build
npm run build

# Start production server
npm start

⚙️ Configuration

Required before production deployment:

Update the following constants in src/config/constants.ts:

// Replace placeholders with actual values
export const CONFIG = {
  TREASURY_ADDRESS: new PublicKey('YOUR_ACTUAL_TREASURY_WALLET_ADDRESS'),
  SOLGEN_MINT_ADDRESS: new PublicKey('YOUR_ACTUAL_TOKEN_MINT_ADDRESS'),
  // ... other config
}

Configuration Options

• TREASURY_ADDRESS: Your Solana wallet address for receiving payments
• SOLGEN_MINT_ADDRESS: Your AlienTek SPL token mint address
• RPC_ENDPOINT: Solana RPC endpoint (default: mainnet-beta)
• PRICING: Pricing structure for 3 and 4 character vanity addresses

📖 How It Works

1. Connect Wallet: Connect your Phantom or Solflare wallet
2. Choose Length: Select 3 or 4 character vanity pattern
3. Configure Pattern: Choose prefix or suffix and enter desired characters
4. Pay Fee: Submit payment (automatically discounted for AlienTek token holders)
5. Generate: Wait for client-side generation to complete
6. Save Keys: Securely download and backup your new wallet keys

🏗️ Technology Stack

• Framework: Next.js 15.5.12 with TypeScript
• Styling: Tailwind CSS with custom Solana theme
• Blockchain: Solana Web3.js 1.87.6, Wallet Adapter
• SPL Tokens: @solana/spl-token 0.3.9
• Generation: Web Workers for parallel processing
• Crypto: tweetnacl 1.0.3 for keypair generation

🔒 Security

✅ Production Ready - All security vulnerabilities addressed

• All keypair generation happens client-side
• Private keys are never transmitted or stored on any server
• Next.js updated from 14.0.4 to 15.5.12 (37 CVEs patched)
• CodeQL scan: 0 vulnerabilities
• Code review: All issues resolved
• Always backup your private keys securely
• Never share your private keys with anyone

For detailed security information, see SECURITY.md.

📚 Documentation

• TESTING.md - Testing procedures and checklist
• DEPLOYMENT.md - Production deployment guide
• IMPLEMENTATION.md - Technical implementation details
• SECURITY.md - Security audit and compliance

💎 About AlienTek Token

AlienTek is the native utility token offering 50% discount on all vanity address generation fees.

• Status: Launched on pump.fun with LP
• Contract Address: To be updated
• Discount: Any wallet holding AlienTek tokens automatically qualifies

🎨 UI/UX

• Theme: Dark mode with Solana gradient accents (purple to green)
• Responsive: Mobile-friendly design
• Intuitive: Step-by-step guided flow
• Accessible: Clear instructions and security warnings
• Performance: Optimized bundle size (215 kB first load)

🔧 Development

Project Structure

src/
├── components/       # React components
├── config/          # Configuration constants
├── pages/           # Next.js pages
├── styles/          # Global styles
├── utils/           # Utility functions
└── workers/         # Web Workers for generation

Available Scripts

npm run dev      # Start development server
npm run build    # Create production build
npm start        # Start production server
npm run lint     # Run ESLint

🌐 Deployment

Supports multiple deployment options:

• Vercel (recommended) - One-click deployment
• Netlify - Static site deployment
• Self-hosted - Docker or traditional hosting
• See DEPLOYMENT.md for detailed instructions

🤝 Contributing

Contributions are welcome! Please ensure:

1. Code follows existing style
2. All tests pass
3. Security best practices followed
4. Documentation updated

📄 License

MIT License - see LICENSE file for details

⚠️ Disclaimer

This tool is provided as-is without warranty. Always verify you've securely saved your keys before transferring any funds to generated addresses. The developers are not responsible for lost funds due to misuse or loss of private keys.

📞 Support

• Issues: GitHub Issues
• Documentation: See docs folder
• Security: See SECURITY.md for security policies

---

Built with ❤️ for the Solana ecosystem