Skip to content

x402agent/SolanaOS / skills/pump-rust-vanity

pump-rust-vanity

Verified

Production-grade multi-threaded Rust vanity address generator for Solana — 100K+ keys/sec using Rayon parallel iterators with solana-sdk, Base58 pattern matching, prefix/suffix support, security-hardened file output, and Criterion benchmarks.

Rust Vanity Generator — High-Performance Solana Address Mining

Production-grade Rust binary achieving 100K+ keys/sec using Rayon parallel iterators with security-hardened file output and Solana CLI compatibility.

Architecture

CLI Args ──► VanityConfig ──► VanityGenerator
                                    │
                              Rayon par_iter
                              ┌─────┼─────┐
                            Thread Thread Thread ...
                              │     │     │
                           Keypair::new() per iteration
                              │     │     │
                           Base58 encode + match
                              │     │     │
                              └─────┼─────┘
                                    │
                              AtomicBool found
                                    │
                              SecureOutput (0o600)

CLI Arguments

ArgumentDescription
--prefixRequired Base58 prefix to match
--suffixOptional Base58 suffix
--outputOutput file path (default: stdout)
--threadsNumber of threads (default: all CPUs)

Core Types

struct VanityConfig {
    prefix: String,
    suffix: Option<String>,
    output: Option<PathBuf>,
    threads: Option<usize>,
}

struct GeneratedAddress {
    keypair: Keypair,
    address: String,
    attempts: u64,
}

Generation Engine

fn generate(config: &VanityConfig) -> Result<GeneratedAddress> {
    let found = AtomicBool::new(false);
    let result = (0..num_cpus::get())
        .into_par_iter()
        .find_map_any(|_| {
            let mut attempts = 0u64;
            loop {
                if found.load(Ordering::Relaxed) { return None; }
                attempts += 1;
                let keypair = Keypair::new();
                let address = keypair.pubkey().to_string();
                if matches_pattern(&address, &config) {
                    found.store(true, Ordering::Relaxed);
                    return Some(GeneratedAddress { keypair, address, attempts });
                }
            }
        });
    result.ok_or_else(|| anyhow!("No match found"))
}

Security Features

FeatureImplementation
CSPRNGOsRng via solana-sdk
Memory cleanupZeroize trait on secret key bytes
File permissions0o600 via std::fs::set_permissions
No networkPure offline operation

Dependencies

CratePurpose
solana-sdkKeypair generation, Base58, signing
rayonData-parallel iteration
clapCLI argument parsing
anyhowError handling
criterionBenchmarking

Testing

cargo test                            # Unit + integration tests
cargo test --test security_tests      # Security-focused tests
cargo bench                           # Criterion benchmarks

Patterns to Follow

  • Only use solana-sdk for cryptographic operations
  • Use Zeroize on all key material
  • Set file permissions to 0o600 immediately after writing
  • Use AtomicBool for cross-thread termination signaling
  • Use find_map_any for early termination on first match

Common Pitfalls

  • Base58 is case-sensitive — pump ≠ Pump
  • Longer prefixes grow exponentially harder (~58× per character)
  • Keypair::new() uses OS entropy — do not seed with user input
  • rayon thread pool size should match CPU cores for optimal throughput
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 467kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 467kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 467kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 193kUpdated Claude CodeCodexVerifiedInstall