User Guide

Complete guide for using sol-safekey interactive commands and operations.

Getting Started

Sol-SafeKey provides an interactive command-line interface for secure Solana wallet management and operations. This guide covers all available features and operations.

Prerequisites

Solana CLI tools installed (for airdrops and verification)
Access to Solana devnet or mainnet RPC endpoints
Terminal with UTF-8 support for proper symbol display

Accessing Interactive Menu

If you're using a bot that integrates sol-safekey:

./your-bot safekey

Or if using the standalone binary:

./build-cache/release/examples/bot_example safekey

Direct Installation (Standalone)

For standalone usage without a bot, install sol-safekey directly:

# Install from crates.io (recommended for latest version)
cargo install sol-safekey --features="full"

# Verify installation
sol-safekey --version

# Start interactive menu
sol-safekey start

This method provides direct access to all sol-safekey features through the interactive menu.

Main Menu

Upon launching, you'll see the language selection:

==================================================
  Language / 语言选择
==================================================

  1.  English
  2.  中文

Select / 选择 [1/2]:

After selecting your language, the main menu appears with all available operations.

📋 Complete Menu Index with Quick Links

Quick overview of all 18 interactive menu operations organized by category. Click any operation to jump to its detailed guide:

🔑 Core Functions (Options 1-3)

1. Create Plaintext Key - Generate and save unencrypted Solana keypair (for testing only)
2. Create Encrypted Key (bot) - Encrypt existing private key and save to keystore
3. Decrypt Key - Decrypt keystore and reveal private key

🔒 Wallet Management (Option U)

U. Unlock Wallet - Unlock wallet for Solana operations

🛡️ Advanced Security Features (Options 4-6)

4. Setup 2FA Authentication - Configure two-factor authentication
5. Generate Triple-Factor Wallet - Create wallet with 3FA (hardware + password + security question + 2FA)
6. Unlock Triple-Factor Wallet - Decrypt 3FA encrypted wallet

💰 Solana On-Chain Operations (Options 7-18)

Balance & Transfer

7. Check SOL Balance - Query wallet SOL balance
8. Transfer SOL - Send SOL to another address

WSOL Operations

9. Create WSOL ATA - Create Wrapped SOL Associated Token Account
10. Wrap SOL → WSOL - Convert SOL to Wrapped SOL
11. Unwrap WSOL → SOL - Convert Wrapped SOL back to SOL
12. Close WSOL ATA - Close WSOL ATA and convert remaining WSOL to SOL

Token Operations

13. Transfer SPL Token - Send SPL tokens to another address

Transaction Tools

14. Create Nonce Account - Create durable nonce for transaction replay protection

DEX Operations

15. Pump.fun Sell Token - Sell tokens on Pump.fun DEX (internal market)
16. PumpSwap Sell Token - Sell tokens on PumpSwap DEX

Cashback Operations

17. Pump.fun Cashback (View & Claim) - View and claim pump.fun cashback (native SOL)
18. PumpSwap Cashback (View & Claim) - View and claim PumpSwap cashback (WSOL)

🎯 Quick Access to Common Tasks

🔑 Unlock Wallet - Unlock wallet to get started
💰 Check Balance - Query SOL balance quickly
🔑 Create Nonce - Create durable nonce for trading bots
🏪 DEX Operations - Access Pump.fun and PumpSwap sell functions

Wallet Operations

1. Create Plain Text Keypair

Purpose: Generate an unencrypted keypair (for testing only)

Warning: NOT recommended for production use. Keys are stored in plain text.

Steps:

Select option 1 from main menu
Choose generation method:
- Option 1: Generate new random keypair
- Option 2: Import existing private key
Choose output format:
- Option 1: Save as JSON file
- Option 2: Display in terminal (base58)

Example:

📝 Plain Text Keypair Options:
  1. Generate new keypair
  2. Import existing private key

Select [1/2]: 1

✅ Keypair generated successfully!
📍 Public Key: E7Rmd6piasPNs9jqRBUfS8nvNqDx6j5qPDE6Le7us5bp

Output format:
  1. Save as JSON file
  2. Display base58 private key

Select [1/2]: 1

File path (default: wallet.json): test-wallet.json

✅ Saved to test-wallet.json

2. Create Encrypted Keypair (Recommended)

Purpose: Generate or import a keypair with AES-256 encryption

Security: Military-grade encryption with PBKDF2 key derivation

Steps:

Select option 2 from main menu
Choose generation method:
- Option 1: Generate new keypair and encrypt
- Option 2: Import existing private key and encrypt
Set encryption password (minimum 10 characters)
Confirm password
Choose output format:
- Option 1: Save as Keystore file (recommended)
- Option 2: Display encrypted string

Example:

🔐 Encrypted Keypair Options:
  1. Generate new keypair and encrypt
  2. Import existing private key and encrypt

Select [1/2]: 1

🔒 Set encryption password (min 10 characters):
New password: ************
Confirm password: ************

✅ Password accepted!

Output format:
  1. Save as Keystore file (recommended)
  2. Display encrypted string

Select [1/2]: 1

File path (default: wallet.json): keystore.json

✅ Keystore created successfully!
📍 Public Key: E7Rmd6piasPNs9jqRBUfS8nvNqDx6j5qPDE6Le7us5bp
📁 Location: keystore.json

⚠️  IMPORTANT: Remember your password! It cannot be recovered.

Best Practices:

Use a strong password (16+ characters recommended)
Mix uppercase, lowercase, numbers, and symbols
Never share your password
Store password securely (password manager)
Keep backup of keystore file in secure location

3. Decrypt Encrypted Keypair

Purpose: View or export an encrypted keypair

Steps:

Select option 3 from main menu
Choose source:
- Option 1: Load from Keystore file
- Option 2: Paste encrypted string
Enter decryption password
Choose output format:
- Option 1: Display only
- Option 2: Save as plain JSON

Example:

🔓 Decrypt Encrypted Keypair

Source:
  1. Keystore file
  2. Encrypted string

Select [1/2]: 1

Keystore file path: keystore.json

🔑 Enter decryption password: ************

✅ Decrypted successfully!
📍 Public Key: E7Rmd6piasPNs9jqRBUfS8nvNqDx6j5qPDE6Le7us5bp

Output:
  1. Display only
  2. Save as plain JSON

Select [1/2]: 1

Private Key (base58): 5JW8...

4. Unlock Wallet (Session)

Purpose: Unlock an encrypted wallet for the current session

Benefit: Unlocked once, usable for all subsequent operations in same session

Steps:

Select option U or u from main menu
Enter keystore file path
Enter password
Wallet remains unlocked for session

Example:

🔓 Unlock Wallet

Keystore file path [keystore.json]: keystore.json

🔑 Enter wallet password: ************

✅ Wallet unlocked successfully!
📍 Address: E7Rmd6piasPNs9jqRBUfS8nvNqDx6j5qPDE6Le7us5bp

You can now use all Solana operations without re-entering password.

Solana Operations

All Solana operations require either:

An unlocked wallet (option U), OR
You'll be prompted for keystore path and password each time

5. Query SOL Balance

Purpose: Check SOL balance for an address

Steps:

Select option 4 from main menu
Choose address source:
- Option 1: Current unlocked wallet
- Option 2: Enter any address manually
Select network:
- Option 1: Devnet
- Option 2: Mainnet-beta
View balance

Example:

💰 Query SOL Balance

Address source:
  1. Current wallet
  2. Enter address manually

Select [1/2]: 1

Select network:
  1. Devnet
  2. Mainnet-beta

Select [1/2]: 1

💰 Querying balance...
Address: E7Rmd6piasPNs9jqRBUfS8nvNqDx6j5qPDE6Le7us5bp
Balance: 2.5 SOL

6. Transfer SOL

Purpose: Send SOL to another address

Prerequisites: Sufficient SOL for amount + fees (~0.000005 SOL)

Steps:

Select option 5 from main menu
If wallet not unlocked, provide keystore and password
Enter recipient address
Enter amount in SOL
Select network
Confirm transaction
View transaction signature

Example:

💸 Transfer SOL

[If not unlocked]
Keystore path: keystore.json
Password: ************

Recipient address: 9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin
Transfer amount (SOL): 0.1

Select network:
  1. Devnet
  2. Mainnet-beta

Select [1/2]: 1

Summary:
  From: E7Rmd6piasPNs9jqRBUfS8nvNqDx6j5qPDE6Le7us5bp
  To: 9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin
  Amount: 0.1 SOL
  Network: Devnet

Confirm transaction? (y/n): y

🚀 Sending transaction...
✅ Transfer successful!
Transaction signature: 5J7W8vN2BxC9K4... (view on explorer)

7. Wrap SOL → WSOL

Purpose: Convert native SOL to wrapped SOL (SPL token)

Use Case: Required for certain DeFi protocols and DEX trading

Steps:

Select option 6 from main menu
If wallet not unlocked, provide keystore and password
Enter amount to wrap
Select network
Confirm transaction
View transaction signature

Example:

📦 Wrap SOL → WSOL

[If not unlocked]
Keystore path: keystore.json
Password: ************

Amount to wrap (SOL): 1.0

Select network:
  1. Devnet
  2. Mainnet-beta

Select [1/2]: 1

Summary:
  Wrapping: 1.0 SOL → 1.0 WSOL
  Network: Devnet

Confirm? (y/n): y

🚀 Creating wrapped SOL account...
✅ Wrap successful!
Transaction signature: 3K9X2nM5DyH8F7...
WSOL Account: 7xF2wD9cN3bV1K...

8. Unwrap WSOL → SOL

Purpose: Convert wrapped SOL back to native SOL

Steps:

Select option 7 from main menu
If wallet not unlocked, provide keystore and password
Enter amount to unwrap
Select network
Confirm transaction
View transaction signature

Example:

📤 Unwrap WSOL → SOL

[If not unlocked]
Keystore path: keystore.json
Password: ************

Amount to unwrap (WSOL): 0.5

Select network:
  1. Devnet
  2. Mainnet-beta

Select [1/2]: 1

Summary:
  Unwrapping: 0.5 WSOL → 0.5 SOL
  Network: Devnet

Confirm? (y/n): y

🚀 Unwrapping...
✅ Unwrap successful!
Transaction signature: 2M8Y1oL4CxG9J6...

9. Transfer SPL Token

Purpose: Send any SPL token to another address

Prerequisites: Sufficient SOL for transaction fees + token balance

Steps:

Select option 8 from main menu
If wallet not unlocked, provide keystore and password
Enter token mint address
Enter recipient address
Enter amount (in token's decimal units)
Select network
Confirm transaction
View transaction signature

Example:

🪙 Transfer SPL Token

[If not unlocked]
Keystore path: keystore.json
Password: ************

Token mint address: So11111111111111111111111111111111111111112
Recipient address: 9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin
Amount: 100

Select network:
  1. Devnet
  2. Mainnet-beta

Select [1/2]: 1

Summary:
  Token: So11111111111111111111111111111111111111112
  To: 9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin
  Amount: 100
  Network: Devnet

Confirm? (y/n): y

🚀 Sending token...
✅ Transfer successful!
Transaction signature: 4L7X3pN6EzH0K8...

10. Create Durable Nonce Account

Purpose: Create a nonce account for offline transaction signing

Use Case: Required for advanced transaction patterns and offline signing

Prerequisites: ~0.00144288 SOL for rent-exempt nonce account

Steps:

Select option 9 from main menu
If wallet not unlocked, provide keystore and password
Select network
Confirm transaction
View nonce account address and transaction signature

Example:

🔢 Create Durable Nonce Account

[If not unlocked]
Keystore path: keystore.json
Password: ************

Select network:
  1. Devnet
  2. Mainnet-beta

Select [1/2]: 1

Summary:
  Creating nonce account...
  Rent: ~0.00144288 SOL
  Authority: E7Rmd6piasPNs9jqRBUfS8nvNqDx6j5qPDE6Le7us5bp
  Network: Devnet

Confirm? (y/n): y

🚀 Creating nonce account...
✅ Nonce account created successfully!
Account: 8yG3wE5dK2mH9L...
Transaction signature: 6N9Z4qO7FyJ1M3...

11. PumpSwap Sell (Token-2022 & Batch Sell Support)

Purpose: Sell tokens on PumpSwap DEX with one click, supports single or batch selling

Use Case: Quick exit from meme tokens or trading positions on PumpSwap, supports selling multiple tokens at once

Prerequisites:

Token balance in your wallet (standard or seed-optimized ATA)
Sufficient SOL for transaction fees
Token must be listed on PumpSwap DEX

Features:

Sells ALL tokens automatically (no amount input needed)
Default 99% slippage for fast execution
Supports both standard and seed-optimized Associated Token Accounts (seed optimization enabled by default)
Batch Selling: Support multiple mint addresses separated by commas or spaces
Smart Confirmation: Single confirmation for batch selling, individual confirmation for single token
Bilingual interface (English/Chinese)
Token-2022 program support

Steps:

Select option 12 or 15 from main menu (depending on 2FA setup)
If wallet not unlocked, provide keystore and password
Enter RPC URL (e.g., https://api.mainnet-beta.solana.com)
Choose seed optimization (default yes, just press Enter):
- Enter or y: Use seed-optimized ATA (lower fees, recommended)
- n: Use standard ATA
Enter token mint address(es) (supports multiple, separated by commas or spaces)
Confirm once for batch selling, or individually for single token
View transaction signatures

Single Token Sell Example:

🔥 PumpSwap Sell Tokens

[If not unlocked]
Keystore path: keystore.json
Password: ************

Enter RPC URL: https://api.mainnet-beta.solana.com

❓ Enable Seed Optimization? (yes/no, default: yes): [Press Enter]
✅ Seed optimization enabled

Token Mint Address: TokenMintAddressHere...

📋 Found 1 token(s) to sell:
   1. TokenMintAddressHere...

📊 Slippage tolerance: 99%

💰 Checking token balance...
✅ Token balance: 1,000,000 tokens (6 decimals)

❓ Confirm sell all? (yes/no, default: yes): [Press Enter]

📊 Fetching PumpSwap pool parameters...
✅ Pool found!

🚀 Sending transaction...
✅ Sell successful!
   Transaction signature: 5J7W8vN2BxC9K4...

Batch Sell Example:

🔥 PumpSwap Sell Tokens

Enter RPC URL: https://api.mainnet-beta.solana.com

❓ Enable Seed Optimization? (yes/no, default: yes): [Press Enter]
✅ Seed optimization enabled

💡 You can enter multiple mint addresses separated by commas or spaces
   Tokens will be sold in the order entered

Token Mint Address(es): Token1Address..., Token2Address..., Token3Address...

📋 Found 3 token(s) to sell:
   1. Token1Address...
   2. Token2Address...
   3. Token3Address...

📊 Slippage tolerance: 99%

⚠️  You are about to sell 3 tokens
   All tokens will be sold automatically without individual confirmation

❓ Confirm batch sell? (yes/no, default: yes): [Press Enter]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚀 Processing token 1/3
   Mint: Token1Address...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💰 Token Balance: 500,000 tokens
✅ Token 1/3 sold successfully

⏳ Waiting 2 seconds before next transaction...

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚀 Processing token 2/3
   Mint: Token2Address...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💰 Token Balance: 1,000,000 tokens
✅ Token 2/3 sold successfully

⏳ Waiting 2 seconds before next transaction...

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚀 Processing token 3/3
   Mint: Token3Address...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💰 Token Balance: 250,000 tokens
✅ Token 3/3 sold successfully

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎉 All transactions completed!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Advanced Options:

Seed-Optimized ATA:

Lower transaction fees
Recommended for all users (enabled by default)
Automatically detects both standard and seed-optimized ATAs

Batch Selling:

Support multiple mint addresses at once
Separate addresses with commas (,) or spaces
Tokens are sold in the order entered
Single confirmation for batch operations
Automatic 2-second delay between tokens
Individual token failure doesn't affect subsequent tokens

Slippage:

Default: 99% (9900 basis points)
Ensures fast execution even in volatile markets
Protects against MEV sandwich attacks by accepting any price within 99%

Token-2022 Support:

Automatically detects Token-2022 program tokens
No manual configuration needed
Works with both standard SPL tokens and Token-2022 tokens

Important Notes:

This operation sells ALL your tokens in one transaction
Transaction may use multiple signatures for SWQOS (Solana Write Queue Optimization System)
Always verify token mint address before confirming
Test on devnet first with small amounts
Check pool liquidity before large sells

12. Pump.fun Sell

Sell tokens on Pump.fun internal market (bonding curve) for native SOL. Use this when the token is still on Pump.fun (not yet migrated to Raydium); for migrated tokens use PumpSwap Sell (section 11) instead.

Purpose: One-click sell of Pump.fun tokens on the bonding curve, receiving SOL directly.

Prerequisites:

Unlocked wallet with the token in an ATA
Token must be a Pump.fun bonding-curve token (mint on Pump.fun program)
Sufficient SOL for transaction fees

Features:

Sells all token balance in one transaction
Optional seed-optimized ATA (same as PumpSwap; reduces fees)
Token-2022 support (auto-detected)
Bilingual prompts (English/Chinese)

Steps:

Run sol-safekey (or ./your-bot safekey) and unlock your wallet.
Choose 13 (Pump.fun Sell) or 16 (Pump.fun Sell, no 2FA prompt).
Enter RPC URL when prompted (or use default).
Choose whether to use seed-optimized ATA when asked.
Enter the token mint address (Pump.fun token).
Confirm the amount and sign. Transaction is sent and signature is printed.

Example (CLI):

./your-bot safekey pumpfun-sell --mint <MINT_ADDRESS>

Important Notes:

Only for tokens still on Pump.fun bonding curve. Migrated tokens should use PumpSwap Sell.
Always verify the mint address before confirming.
Test on devnet with small amounts first when possible.

Tips and Best Practices

Wallet Security

Strong Passwords:
- Minimum 16 characters
- Mix uppercase, lowercase, numbers, symbols
- Use a password manager
- Never reuse passwords
Backup Strategy:
- Keep encrypted keystore in multiple secure locations
- Store password separately from keystore
- Consider hardware wallet for large amounts
- Test recovery procedure on devnet
Network Safety:
- Always test on devnet first
- Double-check recipient addresses
- Start with small amounts
- Verify transaction signatures on explorer

Session Management

Unlock Wallet once per session for convenience
Operations become faster without repeated password entry
Wallet unlocked only for current process
Re-lock by exiting and restarting

Testing Workflow

Create test wallet on devnet
Get devnet SOL: solana airdrop 2 <address> --url devnet
Test all operations on devnet
Verify on devnet explorer: https://explorer.solana.com/?cluster=devnet
Only use mainnet after thorough testing

Transaction Fees

SOL transfer: ~0.000005 SOL
Token transfer: ~0.00001 SOL
Wrap/Unwrap: ~0.00001 SOL
Create nonce: ~0.00144288 SOL (rent-exempt)

Common Workflows

Daily Trading Bot:

Start bot with ./bot safekey
Select U to unlock wallet
Enter password once
Exit menu to let bot run
Bot can sign transactions without password

One-Time Transfer:

Launch safekey
Select transfer operation
Enter keystore path and password when prompted
Complete transaction
Exit

Portfolio Management:

Unlock wallet (U)
Check balance (4)
Perform multiple operations as needed
No password re-entry required

Troubleshooting

"Failed to decrypt keystore"

Cause: Incorrect password or corrupted file Solution: Verify password, try backup keystore file

"Connection refused" / "RPC error"

Cause: Network issues or RPC node down Solution: Check internet, try different network, use different RPC endpoint

"Insufficient funds"

Cause: Not enough SOL for transaction + fees Solution:

Check balance
Get devnet SOL: solana airdrop 2 <address> --url devnet
For mainnet: transfer SOL to account

"Transaction failed"

Cause: Network congestion, invalid transaction, or account issues Solution:

Wait and retry
Check recipient address is valid
Ensure account has token account for SPL transfers
Verify sufficient balance for amount + fees

"Account not found"

Cause: Address has never received SOL (not initialized) Solution: Send a small amount of SOL first to initialize

Terminal display issues

Cause: Terminal doesn't support UTF-8 or emojis Solution: Use modern terminal emulator (iTerm2, Windows Terminal, etc.)

Advanced Usage

Scripting with Stdin

You can automate password input via stdin for bot deployment:

# Create startup script
echo "your-password" | ./your-bot

Security Note: Only use this in secure environments. Never hardcode passwords.

Multiple Wallets

Create separate keystores for different purposes:

# Trading wallet
./bot safekey
# Create encrypted → keystore-trading.json

# Holding wallet
./bot safekey
# Create encrypted → keystore-holding.json

# Use specific wallet
./bot safekey
# Unlock → keystore-trading.json

Batch Operations

After unlocking wallet once, perform multiple operations without re-entering password:

Unlock wallet (U)
Check balance (4)
Transfer SOL (5)
Wrap SOL (6)
Transfer tokens (8)
All without password prompts

Getting Help

Documentation: Check Bot Integration Guide
Examples: Review examples/bot_example.rs
Explorer: Verify transactions on https://explorer.solana.com
Solana Docs: https://docs.solana.com

Remember:

Always test on devnet first
Keep keystores and passwords secure
Backup everything before mainnet use
Start with small amounts
Verify all addresses carefully

FilesExpand file tree

USER_GUIDE.md

Latest commit

History

USER_GUIDE.md

File metadata and controls

User Guide

Getting Started

Prerequisites

Accessing Interactive Menu

Direct Installation (Standalone)

Main Menu

📋 Complete Menu Index with Quick Links

🔑 Core Functions (Options 1-3)

🔒 Wallet Management (Option U)

🛡️ Advanced Security Features (Options 4-6)

💰 Solana On-Chain Operations (Options 7-18)

Balance & Transfer

WSOL Operations

Token Operations

Transaction Tools

DEX Operations

Cashback Operations

🎯 Quick Access to Common Tasks

Wallet Operations

1. Create Plain Text Keypair

2. Create Encrypted Keypair (Recommended)

3. Decrypt Encrypted Keypair

4. Unlock Wallet (Session)

Solana Operations

5. Query SOL Balance

6. Transfer SOL

7. Wrap SOL → WSOL

8. Unwrap WSOL → SOL

9. Transfer SPL Token

10. Create Durable Nonce Account

11. PumpSwap Sell (Token-2022 & Batch Sell Support)

12. Pump.fun Sell

Tips and Best Practices

Wallet Security

Session Management

Testing Workflow

Transaction Fees

Common Workflows

Troubleshooting

"Failed to decrypt keystore"

"Connection refused" / "RPC error"

"Insufficient funds"

"Transaction failed"

"Account not found"

Terminal display issues

Advanced Usage

Scripting with Stdin

Multiple Wallets

Batch Operations

Getting Help