Solflare Wallet Recovery Tool

A comprehensive command-line tool for recovering and managing legacy Solflare wallet keystores, including stake account withdrawals and fund transfers.

• Overview
• Quick Start
• Features
• Detailed Setup Guide
• Usage
• Security
• Support

This tool solves common problems with legacy Solflare wallets:

• Locked out of legacy Solflare wallet
• Can't access Solflare keystore file
• Need to recover funds from https://legacy.solflare.com
• Unable to withdraw staked SOL from old accounts
• Migrating from legacy Solflare to modern wallet

# 1. Clone and install
git clone https://github.com/thijmau/solflare-wallet-recovery.git
cd solflare-wallet-recovery
npm install

# 2. Prepare your files
# Place solflare-keystore.json and password.txt in the project root

# 3. Run the tool
npm start

This tool provides a complete recovery and retrieval solution:

Before you begin, ensure you have:

• Node.js v14.0.0 or higher - https://nodejs.org/
• Solflare keystore file (.json format)
• Wallet password (saved in a text file)

Example files available: Check docs/ directory for sample file formats

• docs/solflare-keystore.example.json
• docs/password.example.txt

Visit https://legacy.solflare.com to access your wallet.

Place these files in the project root directory (same folder as script.js):

1. Password file: Save as password.txt
2. Keystore file: Save as solflare-keystore.json

Expected file structure:

solflare-wallet-recovery/
├── script.js
├── solflare-keystore.json  ← Your keystore here
├── password.txt            ← Your password here
├── lib/
└── ...

Note: You can use different filenames/paths, but you'll need to specify them when prompted or via CLI flags.

Once logged into legacy Solflare, you can find:

• Wallet Address: Found under "Your Address"
• Stake Account Addresses: Listed in "Your staking accounts" section

The default mode guides you through each step with prompts.

Start the tool:

npm start

Process flow:

1. File Input - Provide keystore and password file paths
2. Decryption - Keystore is decrypted and verified
3. Connection - Connect to Solana network
4. Balance Check - View your wallet balance
5. Stake Accounts - Add stake account addresses
6. Withdrawals - Optionally withdraw from stake accounts
7. Transfer - Optionally transfer all funds to new wallet

Note: The tool provides detailed logging with color-coded output:

• [DEBUG] (gray) - Diagnostic information
• [INFO] (blue) - General information
• [SUCCESS] (green) - Successful operations
• [WARN] (yellow) - Warnings and partial failures
• [ERROR] (red) - Errors

Completion Messages:

• "RECOVERY COMPLETE!" - All operations succeeded
• "RECOVERY COMPLETED WITH ERRORS" - Wallet decrypted successfully, but some transfers failed (you may need to transfer manually using the saved keypair)

node script.js [options]

node script.js --password-file password.txt --decrypt-only

export PASSWORD="your-password"
node script.js -p "$PASSWORD"

node script.js -k ./my-keystore.json --password-file ./my-password.txt

node script.js \
  -k solflare-keystore.json \
  -p "$PASSWORD" \
  -s StakeAccount1111111111111111111111111111111 StakeAccount2222222222222222222222222222222 \
  -w DestinationWallet111111111111111111111111111 \
  -t FinalWallet11111111111111111111111111111111111 \
  -y --no-tips

node script.js --help

⚠️ CRITICAL: This tool handles sensitive cryptographic material (private keys).

Before using with real funds:

• Review the complete Security Policy
• Review automated security audit results
• Run npm audit locally and test with small amounts first

Having issues? Check these resources:

• TROUBLESHOOTING - Common problems and solutions

  • Decryption errors
  • Connection issues
  • Transaction failures
  • File format problems

• FAQ - Frequently asked questions

• GitHub Issues - Report bugs or ask for help

If this tool helped you recover your funds, consider supporting the development:

Tips appreciated but never required. This tool is free and open source.

Contributions are welcome!

• For major changes, open an issue first to discuss
• Submit Pull Requests for improvements

• Solflare Documentation - https://docs.solflare.com/
• Solana Documentation - https://docs.solana.com/
• Legacy Solflare Wallet - https://legacy.solflare.com

GPL-3.0 License - LICENSE

NO WARRANTY: This software is provided "as is", without warranty of any kind. Use at your own risk.

The author is NOT responsible for loss of funds, vulnerabilities in dependencies, or issues with external services. You are responsible for auditing code, verifying transactions, and securing your keys.