Topics

#0xfnzero #2fa #3fa #aes-256 #cli #encryption #fnzero #key-management #keystore #nonce-account #private-key #pumpfun #pumpswap #rust #solana #solana-wallet #spl-token #totp #wallet-security #wsol

Language breakdown

Rust 98.8%

Shell 1.2%

▸ Files click to expand

README

🔐 Sol-SafeKey

Secure Solana key management library with AES-256 encryption

Military-grade wallet security with simple bot integration - secure password handling, encrypted keystores, and full Solana operations support.

中文 | English | Website | Telegram | Discord

What This Project Provides

Sol-SafeKey is a Rust CLI and library for Solana wallet key management, encrypted keystore workflows, bot integration, and optional 2FA/3FA protection. It is designed for developers who need a safer local workflow for private keys while still supporting common Solana wallet and trading operations.

| Area | Coverage | |------|----------| | Key storage | AES-256 encrypted keys, keystore files, password-based unlock, hardware fingerprint support | | Authentication | 2FA/TOTP setup, triple-factor wallet generation, 3FA wallet unlock | | Solana operations | SOL balance, SOL transfer, SPL token transfer, WSOL wrap/unwrap/close, durable nonce accounts | | Trading utilities | Pump.fun sell, PumpSwap sell, Pump.fun cashback, PumpSwap cashback | | Integration | CLI menu, Rust library, bot helper APIs, examples, bilingual user guides |

📋 Feature Guide

🚀 Quick Start

Installation → → Unlock Wallet → Check Balance

🔑 Core Functions

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

🔒 Wallet Management

U. Unlock Wallet - Unlock wallet for Solana operations

🛡️ Advanced Security

4. Setup 2FA - Configure two-factor authentication
5. Generate Triple-Factor Wallet - Create 3FA wallet
6. Unlock Triple-Factor Wallet - Decrypt 3FA encrypted wallet

💰 Solana Operations

Balance & Transfer

7. Check Balance - Query SOL balance
8. Transfer SOL - Send SOL

WSOL Operations

9. Create WSOL ATA - Create WSOL ATA
10. Wrap SOL - SOL → WSOL
11. Unwrap WSOL - WSOL → SOL
12. Close WSOL ATA - Close WSOL ATA

Token Operations

13. Transfer SPL Token - Send SPL tokens
14. Create Nonce Account - Create durable nonce

DEX Operations

15. Pump.fun Sell - Sell on Pump.fun DEX
16. PumpSwap Sell - Sell on PumpSwap DEX

Cashback Operations

17. Pump.fun Cashback - View/claim pump.fun cashback (SOL)
18. PumpSwap Cashback - View/claim PumpSwap cashback (WSOL)

📦 Installation

Install from crates.io (Recommended)

The latest stable release is available on crates.io:

# Install with all features enabled
cargo install sol-safekey --features full
Verify installation
sol-safekey --version
Start interactive menu
sol-safekey start

This installs the complete CLI with all features:

🔐 Core encryption - AES-256 password-based encryption
🔑 2FA/TOTP - Two-factor authentication support
🌐 Solana operations - Full Solana transaction support
💱 DEX operations - Pump.fun & PumpSwap trading
💰 Cashback - Claim trading cashback rewards

Install from source

# Clone repository
git clone https://github.com/0xfnzero/sol-safekey.git
cd sol-safekey
Build and install
cargo install --path . --features full

System Requirements

Rust: 1.70+ (install from rustup.rs)
Operating System: Linux, macOS, or Windows
Network: Internet connection for Solana RPC calls

Cargo Feature Flags

full - Enable all features (default for CLI)
cli - Command-line interface with colored output
2fa - Two-factor authentication (TOTP) support
solana-ops - Solana blockchain operations
sol-trade-sdk - Trading operations (Pump.fun, PumpSwap)

📖 Complete Interactive Menu Guide

📖 View Complete Interactive Menu Guide → INTERACTIVE_TUTORIAL.md

Comprehensive step-by-step guide for all interactive menu operations, including detailed instructions, use cases, and example outputs for each of the 18 menu options.

📚 Documentation

Bot Integration Guide - How to integrate sol-safekey into your bot
User Guide - Complete usage instructions and examples

🔐 Security

✅ Password Security: stdin pipe only (never in environment variables)
✅ Encryption: AES-256 with PBKDF2 key derivation
✅ Memory Safety: Immediate password cleanup after use
✅ Hardware Fingerprint: Device-based security layer
✅ 2FA Support: Optional two-factor authentication for enhanced security

🛠️ Available Operations

Wallet Management

Create Wallet - Generate new encrypted wallet with AES-256
Import Wallet - Import existing wallet from private key or seed phrase
Export Wallet - Export wallet to encrypted JSON format
View Address - Display wallet public address

SOL Operations

Query Balance - Check SOL balance in your wallet
Transfer SOL - Send SOL to other addresses
Wrap SOL - Convert SOL to WSOL (Wrapped SOL)
Unwrap WSOL - Convert WSOL back to SOL
Close WSOL ATA - Close WSOL ATA account

Token Operations

Transfer SPL Token - Send SPL tokens to other addresses
Query Token Balance - Check token balances

DEX Operations

🔥 Pump.fun Sell - Interactive token selling on Pump.fun DEX (internal market only)
🔄 PumpSwap Sell - Sell tokens on PumpSwap DEX

Cashback Operations

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

Advanced Features

Durable Nonce Accounts - Create and manage nonce accounts for offline signing
2FA Support - Optional two-factor authentication for enhanced security