PDA Vanity Token Creator

A high-performance Solana program and utility suite for generating and creating SPL Tokens with vanity Program Derived Addresses (PDAs).

Overview

This project allows you to create SPL Token Mints where the address ends with a specific suffix (e.g., pump). It consists of two main components:

1. Off-chain Search Tool: A multi-threaded Rust utility that brute-forces seeds to find a PDA matching your desired suffix.
2. On-chain Program: An Anchor program that initializes the token mint and enforces the vanity suffix requirement on-chain.

Features

• High Performance Search: Utilizes all available CPU cores to search millions of seeds per second.
• On-Chain Enforcement: The smart contract verifies that the generated address actually matches the required pattern before allowing creation.
• Anchor Framework: Built with modern Solana development standards.

Prerequisites

• Rust & Cargo
• Solana CLI
• Anchor CLI
• Node.js & Yarn/PNPM

Installation

1. Clone the repository:

   git clone <repo-url>
   cd pda-vanity

2. Install dependencies:

   pnpm install

Usage

1. Find a Vanity Seed

Use the included Rust binary to search for a seed that generates a PDA with your desired suffix.

cd programs/pda-vanity
cargo run --release --bin search -- --suffix "pump"

Options:

• -s, --suffix <SUFFIX>: The suffix to search for (default: "pump").
• -t, --threads <THREADS>: Number of threads to use (default: all cores).
• -p, --program-id <ID>: Target Program ID.

Example:

cargo run --release --bin search -- --suffix "moon" --threads 16

Output example:

Searching for seed for suffix 'pump' with 14 threads...
Found seed: 5270498306774619999
PDA: HZTPCxeTBLEr5FfUkjzLixXduWCzhgzjhvoNrKVspump
Bump: 255
Time: 197.830958ms

2. Create the Token

Once you have the seed, you can call the program to create the token.

Testing: Update the seed in tests/pda-vanity.ts and run:

anchor test

Production: You can integrate the client-side logic into your dApp using the IDL.

await program.methods
  .createVanityToken(new BN("5270498306774619999"), 6) // seed, decimals
  .accounts({
    payer: wallet.publicKey,
  })
  .rpc();

Technical Details

PDA Derivation

The program uses a standard PDA derivation scheme:

seeds = [vanity_seed.to_le_bytes().as_ref()]

Optimization

The search tool is heavily optimized for speed:

• Zero-Allocation Check: Performs a math-based suffix check on the hash bytes, avoiding expensive Base58 string allocation.
• Hash-First Strategy: Defers the expensive Elliptic Curve check (is_on_curve) until after the suffix matches. Since the suffix match is rare, this skips 99.9% of curve checks.
• Multi-threading: Uses all available CPU cores with manual thread spawning for maximum throughput.
• Canonical Bump Optimization: Only checks bump 255 to avoid the find_program_address loop.

Performance:

• Single-core speed: ~2.8 million seeds/sec (vs ~330k/sec unoptimized).
• ~8.5x speedup compared to standard approaches.

Contributing

Contributions are welcome! Please check out the CONTRIBUTING.md file for guidelines on how to proceed.

We also have a Code of Conduct that we expect all contributors to adhere to.

License

This project is licensed under the MIT License - see the LICENSE file for details.