Dimensionless Developments Solana Address Generator

Welcome to the Dimensionless Developments Solana address generator 🚀

This project is a local-first crypto utility that helps you generate custom Solana wallet addresses with your chosen text as a prefix or suffix. It uses a high-performance Rust generator, a lightweight Flask streaming API, and a clean Tailwind-based web UI.

---

✨ Features

• 🔐 Local-first key generation - Private keys are generated on your machine
• 🎯 Vanity patterns - Generate both matching prefix and suffix addresses
• ⚡ Fast Rust core - Solana keypair generation with minimal overhead
• 🌐 Simple web interface - One-page UI with real-time updates
• 📡 SSE streaming - Live progress and result events from backend to browser
• 🧩 CLI + Web modes - Run directly from terminal or use the browser
• 🛡️ Input validation - Base58-safe pattern filtering and chain checks

---

🏗️ Tech Stack

Backend + Core

Layer	Technology	Purpose
Web Server	Flask	Serves UI + provides API endpoints
CORS	Flask-CORS	Browser compatibility for local requests
Generator Engine	Rust	Fast Solana address generation
Solana SDK	solana-sdk	Real keypair + pubkey generation
Encoding	bs58	Base58 private key output
Serialization	serde_json	Streaming JSON event payloads

Frontend

Layer	Technology	Purpose
UI	HTML + Vanilla JavaScript	Interaction and rendering
Styling	Tailwind CSS (CDN)	Utility-first styling
Realtime	Server-Sent Events	Live progress stream

---

🔒 Security & Privacy Model

This project is designed to reduce private-key exposure risk:

• ✅ No database integration
• ✅ No wallet uploads
• ✅ No cloud key generation
• ✅ No external wallet APIs in generation flow
• ✅ Keys are generated locally by your Rust binary

What this protects you from

• Server-side key leaks caused by centralized key generation services
• Database compromise risk from stored key material
• Third-party telemetry exposure of generated key data
• Long-term retention risk from hosted systems keeping old secrets

Your responsibility

• Save private keys securely immediately after generation
• Never share private keys with anyone
• Treat this as a hot-key tool for controlled usage
• Prefer hardware wallet workflows for high-value production funds

---

🚀 Quick Start

1) Prerequisites

Rust

Windows (PowerShell):

winget install rustup
rustup default stable
rustc --version
cargo --version

macOS/Linux:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
rustc --version
cargo --version

Python

Use Python 3.10+ (3.11+ preferred).

python --version

Install backend dependencies:

python -m pip install flask flask-cors

---

2) Build the Rust generator

From the project root:

cargo build --release

Expected binary:

• Windows: target/release/solana-generator.exe
• macOS/Linux: target/release/solana-generator

---

3) Run the web app

Windows (PowerShell)

cd into our Dimensionless-Developments-Solana-Address-Generator

python server.py

macOS/Linux

cd Dimensionless-Developments-Solana-Address-

python3 server.py

Open:

http://localhost:8080

---

4) CLI mode (without browser)

Windows

# Prefix match
.\target\release\solana-generator.exe moon 1 prefix

# Suffix match
.\target\release\solana-generator.exe moon 1 suffix

macOS/Linux

# Prefix match
./target/release/solana-generator moon 1 prefix

# Suffix match
./target/release/solana-generator moon 1 suffix

---

🧠 How It Works

1. User enters a pattern (1-8 Base58 characters)
2. Browser connects to /generate-both via SSE
3. Flask validates input and starts Rust generator subprocesses:
   • one for prefix
   • one for suffix
4. Rust emits JSON progress/found events
5. Flask forwards events to browser in real time
6. UI displays found addresses and private keys

Event flow

Browser (EventSource)
  -> Flask /generate-both
     -> Rust binary (prefix)
     -> Rust binary (suffix)
  <- SSE progress/found/complete

---

📁 Project Structure

Dimensionless-Developments-Solana-Address-Generator/
├── Cargo.toml
├── README.md
├── server.py
├── start.sh
├── src/
│   └── solana_generator.rs
└── web/
    └── index.html

---

⚙️ Configuration Notes

Flask debug mode

server.py reads FLASK_DEBUG:

• FLASK_DEBUG=1 -> debug enabled
• default -> debug disabled

Generator timeout

The backend applies a generator timeout to avoid hanging subprocesses.

---

🧪 API Endpoints

GET /health

Returns service status.

Example response:

{"status":"ok"}

GET /generate-both?chain=solana&pattern=<value>

Starts prefix + suffix generation and streams SSE events.

Validation rules:

• chain must be solana
• pattern must be 1-8 Base58 chars

Possible streamed type values:

• connected
• progress
• found
• error
• complete

---

🧰 Troubleshooting

python server.py exits immediately

Common causes:

• Missing Flask packages
• Wrong Python environment
• Port already in use

Fix:

python -m pip install flask flask-cors
python server.py

Port 8080 already in use

Windows:

netstat -ano | findstr :8080

macOS/Linux:

lsof -i :8080

Browser shows connection error

• Confirm server is running at http://localhost:8080
• Hard refresh the page (Ctrl+Shift+R)
• Check terminal output from server.py

Generation seems slow

• Vanity generation is probabilistic (difficulty increases exponentially)
• Shorter patterns are dramatically faster
• Build with --release for best performance

---

📊 Performance Expectations

Pattern Length	Typical Runtime
1-2 chars	Usually very fast
3-4 chars	Seconds to tens of seconds
5+ chars	Can take much longer

Note: Prefix vs suffix difficulty may vary by randomness and pattern.

---

🧱 Current Constraints

• Solana-only generation path in backend
• Single-page UI (no account/auth system)
• No persistent storage by design

---

🤝 Contributing

Contributions are welcome.

Please keep these principles intact:

• No private-key persistence
• No remote key handling
• Clear warnings around secret handling
• Keep the local-first model

---

Contact

Made by Dimensionless Developments Head to our website https://www.dimensionlessdevelopments.com. email: contact@dimensionlessdevelopments.com

⚠️ Disclaimer

This tool generates real cryptographic private keys.

You are solely responsible for:

• key backup and storage,
• operational security,
• and any resulting asset loss.

Use at your own risk.