nirholas Solana Wallet Toolkit Guide
A Solana development toolkit using official Solana Labs libraries. Features vanity address generation with parallel, multi-threaded search across all CPU cores in both Rust and TypeScript.
Features
| Feature | Description | Implementation |
|---|---|---|
| Vanity Addresses | Custom wallet address prefixes | Rust (fastest) + TypeScript |
| Multi-threaded | Parallel search using all CPU cores | Rust + Node.js workers |
| Wallet Generation | Standard Solana wallet creation | TypeScript |
| Key Management | Keypair import/export | TypeScript |
| MCP Server | AI agent interface | TypeScript |
Vanity Address Generation
What Are Vanity Addresses?
Custom Solana addresses that start with a specific prefix:
SPA...— Brand your Sperax walletDeFi...— DeFi-themed addressChad...— Flex address
Rust Implementation (Fastest)
# Build
cargo build --release
# Generate address starting with "SPA"
./target/release/solana-vanity --prefix SPA --threads 16
Performance comparison for 3-character prefix:
| Threads | Time (avg) |
|---|---|
| 1 | ~45 seconds |
| 4 | ~12 seconds |
| 8 | ~6 seconds |
| 16 | ~3 seconds |
TypeScript Implementation
# Install
npm install @nirholas/solana-wallet-toolkit
# Generate vanity address
npx solana-vanity --prefix SPA
import { generateVanityAddress } from '@nirholas/solana-wallet-toolkit';
const result = await generateVanityAddress({
prefix: 'SPA',
threads: 8,
caseSensitive: false
});
console.log(`Address: ${result.publicKey}`);
console.log(`Found in: ${result.attempts} attempts`);
Difficulty Scaling
Solana uses Base58 encoding. Expected attempts for a prefix:
| Prefix Length | Avg Attempts | Time (8 threads) |
|---|---|---|
| 1 char | ~58 | < 1 second |
| 2 chars | ~3,364 | < 1 second |
| 3 chars | ~195,112 | ~3 seconds |
| 4 chars | ~11.3M | ~3 minutes |
| 5 chars | ~656M | ~3 hours |
| 6 chars | ~38B | ~7 days |
Wallet Generation
import { Wallet } from '@nirholas/solana-wallet-toolkit';
// Create new wallet
const wallet = Wallet.create();
console.log(wallet.publicKey.toBase58());
// From seed phrase
const restored = Wallet.fromMnemonic('your twelve words here');
// Export keypair
const keypair = wallet.exportKeypair();
MCP Integration
{
"mcpServers": {
"solana-toolkit": {
"command": "npx",
"args": ["@nirholas/solana-wallet-toolkit", "mcp"]
}
}
}
Tools:
generateWallet— Create new Solana walletgenerateVanityAddress— Generate vanity addressgetBalance— Check SOL/SPL token balancegetTokenAccounts— List token holdings
Use Cases
Brand Identity
Generate a branded wallet address for your project that's recognizable and memorable.
Security Research
Test address generation performance and entropy distribution.
Portfolio Tracking
Use the toolkit to create and manage multiple Solana wallets for different purposes.
Links
- GitHub: https://github.com/nirholas/solana-wallet-toolkit
- Solana Docs: https://docs.solana.com
- Sperax (multi-chain DeFi): https://app.sperax.io