Solana-Keygen

Solflare JSON to Base58: How to Fix CLI Compatibility Issues (2025 Guide)

Getting "invalid keypair" errors when using Solflare backups with Solana CLI? You're facing a widespread 2025 issue where Solflare's JSON format clashes with CLI requirements. This guide will show you how to convert Solflare JSON keys to CLI-friendly Base58 format in under 3 minutes.

Why Solflare JSON Keys Fail in CLI

Solflare's 2025 JSON format includes extra metadata that causes Solana CLI compatibility issues:

Format Structure Supported By
Solflare JSON {"version":3,"crypto":{"ciphertext":"...}} Solflare Web/Mobile
Base58 5J3mBb...58a9 Solana CLI, Phantom

Step 1: Convert Solflare JSON to Base58

Time needed: 2 minutes

  1. Visit solana-keygen.com
  2. Choose "JSON to Base58" tool
  3. Upload your Solflare backup file (.json)
  4. Click "Convert" → Copy raw private key
Pro Tip: Solflare's 2025 update changed backup encryption - if conversion fails, use our Phantom error guide for legacy formats.

Step 2: Use in Solana CLI

With your Base58 key:

solana config set --keypair BASE58_KEY_HERE
solana balance  # Verify access

Troubleshooting CLI Key Issues

Error: "Invalid keypair"

Fix:

Error: "Unable to read keypair file"

Solution:

# Save key to file manually
echo "BASE58_KEY_HERE" > ~/.config/solana/cli-keypair.json

Advanced: Manual Conversion via CLI

For developers who prefer terminal workflows:

# Install Solflare parser
npm install -g solflare-key-converter

# Convert to Base58
solflare-convert --input backup.json --format base58

But most users prefer our web converter for simplicity.

2025 Security Alert: JSON Backup Risks

Recent phishing campaigns target Solflare JSON files. Always:

FAQ: Solflare Key Management

Q: Why does Solflare use incompatible JSON format?
A: Their encryption protects against browser-based attacks but sacrifices CLI compatibility.

Q: Can I automate JSON conversions for multiple wallets?
A: Yes! Our pro version supports batch processing for developers.

When to Use Base58 vs JSON

Need to convert back? Use solana-keygen new --outfile to generate CLI JSON from Base58 keys.

Success Story

"Your converter saved our team 20+ hours debugging CLI key issues after Solflare's 2025 update!" - DevLead@Web3Startup