Recuperación de wallets de Solana desde la línea de comandos: guía con solana-keygen

Perder el acceso a una wallet de Solana no siempre significa perder los fondos. Si conservas la frase semilla (seed phrase) o el archivo de keypair, la CLI oficial de Solana permite reconstruir la clave privada y volver a firmar transacciones. Esta guía explica cómo usar solana-keygen y otros comandos para recuperar una wallet desde la terminal, con énfasis en seguridad y verificación.

Advertencia: nunca compartas tu frase semilla. Cualquier persona que la tenga puede controlar tus fondos. Realiza la recuperación en un equipo de confianza, preferiblemente sin conexión, y verifica que descargas la CLI desde la fuente oficial.

Requisitos

• macOS, Linux o WSL en Windows.
• Frase semilla BIP39 de 12 o 24 palabras, o archivo keypair JSON.
• CLI de Solana instalada.
• Conexión a Internet solo si necesitas consultar saldos; la recuperación puede hacerse offline.

Instala la CLI oficial:

sh -c "$(curl -sSfL https://release.solana.com/stable/install)"

Añade la ruta de binarios a tu PATH si el instalador lo indica y comprueba:

solana --version
solana-keygen --version

Paso 1: recuperar el keypair con solana-keygen recover

El comando principal es:

solana-keygen recover -o ~/wallet-recuperada.json

La terminal pedirá las palabras de la frase semilla una por una. Escríbelas en orden, en minúsculas y con cuidado. Si tu wallet usaba una ruta de derivación específica, indícala:

solana-keygen recover --derivation-path m/44'/501'/0'/0' -o ~/wallet-recuperada.json

La ruta más común en wallets como Phantom o Solflare es m/44'/501'/0'/0'. Algunas wallets antiguas o cuentas adicionales pueden usar m/44'/501'/1'/0', m/44'/501'/0' u otras variantes. Si la dirección recuperada no coincide con la que esperabas, prueba otra ruta.

Paso 2: verificar la dirección pública

Obtén la dirección pública del archivo recuperado:

solana-keygen pubkey ~/wallet-recuperada.json

También puedes usar:

solana address -k ~/wallet-recuperada.json

Compara la dirección con la que tenías guardada. Si no coincide, revisa la frase semilla, el orden de las palabras o la ruta de derivación.

Paso 3: configurar la CLI

Para que la CLI use la wallet recuperada:

solana config set --keypair ~/wallet-recuperada.json
solana config set --url https://api.mainnet-beta.solana.com

Consulta el saldo:

solana balance

Si la wallet está en otra red, cambia la URL por la de devnet o testnet.

Paso 4: firmar y transferir fondos

Con la keypair configurada, puedes firmar transacciones o transferir SOL:

solana transfer <DESTINATARIO> <CANTIDAD> --allow-unfunded-recipient

Antes de mover fondos, prueba con una cantidad pequeña. Si necesitas recuperar tokens SPL, deberás usar herramientas adicionales como spl-token o una interfaz compatible.

Seguridad durante la recuperación

• Trabaja en un entorno limpio y actualizado.
• Desconecta la red si no necesitas consultar la blockchain.
• No guardes la frase semilla en capturas, notas en la nube ni chats.
• Elimina el archivo wallet-recuperada.json si ya no lo necesitas, o guárdalo cifrado.
• Verifica siempre la dirección pública antes de enviar fondos.
• Usa binarios oficiales y comprueba las sumas de verificación cuando sea posible.

Limitaciones de la CLI

solana-keygen recover funciona con frases semilla compatibles con BIP39 y derivación SLIP-0010/ed25519. No puede recuperar wallets de custodia, cuentas sociales, wallets multifirma sin los firmantes necesarios ni casos donde la frase semilla se perdió por completo. Si usaste una passphrase BIP39 adicional, necesitarás una herramienta compatible que la solicite.

Conclusión

La línea de comandos de Solana ofrece una forma directa y auditable de recuperar una wallet a partir de la frase semilla. El proceso se reduce a instalar la CLI, ejecutar solana-keygen recover, verificar la dirección y configurar el keypair. La seguridad es tan importante como el procedimiento: mantén la frase semilla offline, verifica cada paso y no confíes en herramientas de terceros no auditadas.