Este documento describe cómo configurar un Ledger Nano S o un Ledger Nano X con el software Ledger Live .

Una vez que se completen los pasos de configuración que se muestran a continuación y la aplicación Solana esté instalada en su dispositivo Nano, los usuarios tienen varias opciones sobre cómo usar el Nano para interactuar con la red Solana.

Empezando

• Solicite un Nano S o Nano X de Ledger.
• Siga las instrucciones para la configuración del dispositivo incluidas en el paquete o en la página de inicio de Ledger
• Instalar el software de escritorio Ledger Live
  • Si ya tiene Ledger Live instalado, actualice a la última versión de Ledger Live, que permite las actualizaciones de firmware y aplicaciones más recientes.
• Conecte su Nano a su computadora y siga las instrucciones en pantalla.
• Actualice el firmware de su nuevo Nano. Esto es necesario para garantizar que pueda instalar la última versión de la aplicación Solana.
  • Actualizar el firmware de Nano S
  • Actualizar el firmware de Nano X

Instale la aplicación Solana en su Nano

• Abrir libro mayor en vivo
• Haga clic en «Administrador» en el panel izquierdo de la aplicación y busque «Solana» en el Catálogo de aplicaciones, luego haga clic en «Instalar».
  • Asegúrese de que su dispositivo esté conectado a través de USB y esté desbloqueado con su PIN
• Es posible que se le solicite en el Nano que confirme la instalación de la aplicación Solana.
• «Solana» ahora debería aparecer como «Instalado» en Ledger Live Manager

Actualice a la última versión de la aplicación Solana

Para asegurarse de tener la última funcionalidad, si está utilizando una versión anterior de la aplicación Solana, actualice a la versión v1.0.1siguiendo estos pasos.

• Asegúrese de tener Ledger Live versión 2.10.0 o posterior.
  • Para verificar su versión de Ledger Live, haga clic en el botón Configuración en la esquina superior derecha, luego haga clic en «Acerca de». Si hay una versión más nueva de Ledger Live disponible, debería ver un banner que le solicita que actualice cuando abra Ledger Live por primera vez.
• Actualiza el firmware de tu Nano
  • Actualizar el firmware de Nano S
  • Actualizar el firmware de Nano X
• Después de una actualización de firmware exitosa, la aplicación Solana debería reinstalarse automáticamente con la última versión de la aplicación.

Interactuar con la red Solana

Los usuarios pueden usar cualquiera de las siguientes opciones para usar su Nano para interactuar con Solana:

• SolFlare.com es una billetera web sin custodia creada específicamente para Solana y admite transferencias básicas y operaciones de participación con el dispositivo Ledger. Consulte nuestra guía para usar un Nano con SolFlare .
• Los desarrolladores y usuarios avanzados pueden usar un Nano con las herramientas de línea de comandos de Solana . Las nuevas funciones de billetera casi siempre son compatibles con las herramientas de línea de comandos nativas antes de ser compatibles con billeteras de terceros.

Problemas conocidos

• A veces, Nano X no puede conectarse a carteras web mediante el sistema operativo Windows. Es probable que esto afecte a cualquier billetera basada en navegador que use WebUSB. El equipo de Ledger está trabajando para resolver esto.

Utilice Ledger Nano con Solana CLI

1. Asegúrese de que la aplicación Ledger Live esté cerrada
2. Conecte su Nano al puerto USB de su computadora
3. Ingrese su PIN e inicie la aplicación Solana en el Nano
4. Asegúrese de que la pantalla muestre «La aplicación está lista».

Ver su número de identificación de Wallet

En su computadora, ejecute:

Esto confirma que su dispositivo Ledger está conectado correctamente y en el estado correcto para interactuar con la CLI de Solana. El comando devuelve la ID de billetera única de su Ledger . Cuando tiene varios dispositivos Nano conectados a la misma computadora, puede usar su ID de billetera para especificar qué billetera de hardware Ledger desea usar. Si solo planea usar un solo Nano en su computadora a la vez, no es necesario que incluya la identificación de la billetera. Para obtener información sobre cómo usar la ID de billetera para usar un libro mayor específico, consulte Administrar varias billeteras de hardware .

Ver las direcciones de su billetera

Su Nano admite una cantidad arbitraria de direcciones de billetera y firmantes válidos. Para ver cualquier dirección, use el solana-keygen pubkeycomando, como se muestra a continuación, seguido de una URL de par de claves válida .

Varias direcciones de billetera pueden ser útiles si desea transferir tokens entre sus propias cuentas para diferentes propósitos, o usar diferentes pares de claves en el dispositivo como autoridades de firma para una cuenta de participación, por ejemplo.

Todos los siguientes comandos mostrarán direcciones diferentes, asociadas con la ruta del par de claves proporcionada. ¡Pruébalos!

• NOTA: los parámetros de la URL del par de claves se ignoran en zsh; 

También puede utilizar otros valores para el número siguiente key=. Cualquiera de las direcciones mostradas por estos comandos son direcciones válidas de billetera Solana. La parte privada asociada con cada dirección se almacena de forma segura en el Nano y se utiliza para firmar transacciones desde esta dirección. Simplemente tome nota de la URL del par de claves que utilizó para derivar cualquier dirección que utilizará para recibir tokens.

Si solo planea usar una única dirección / par de claves en su dispositivo, una buena ruta fácil de recordar podría ser usar la dirección en key=0. Ver esta dirección con:

Ahora que tiene una dirección de billetera (o varias direcciones), puede compartir cualquiera de estas direcciones públicamente para que actúe como una dirección de recepción, y puede usar la URL del par de claves asociado como firmante para las transacciones desde esa dirección.

Ver su saldo

Para ver el saldo de cualquier cuenta, independientemente de la billetera que utilice, use el solana balancecomando:

Por ejemplo, si su dirección es 7cvkjYAkUYs4W8XcXsca7cBrEGFeSUjeZmKoNBvEwyri, ingrese el siguiente comando para ver el saldo:

También puede ver el saldo de cualquier dirección de cuenta en la pestaña Cuentas en el Explorador y pegar la dirección en el cuadro para ver el saldo en su navegador web.

Nota: Cualquier dirección con un saldo de 0 SOL, como una recién creada en su Libro mayor, se mostrará como «No encontrada» en el explorador. Las cuentas vacías y las cuentas inexistentes reciben el mismo tratamiento en Solana. Esto cambiará cuando la dirección de su cuenta tenga algo de SOL.

Enviar SOL desde un Nano

Para enviar algunos tokens desde una dirección controlada por su Nano, deberá usar el dispositivo para firmar una transacción, usando la misma URL del par de claves que usó para derivar la dirección. Para hacer esto, asegúrese de que su Nano esté enchufado, desbloqueado con el PIN, que Ledger Live no se esté ejecutando y que la aplicación Solana esté abierta en el dispositivo, mostrando «La aplicación está lista».

El solana transfercomando se usa para especificar a qué dirección enviar tokens, cuántos tokens enviar, y usa el --keypairargumento para especificar qué par de claves envía los tokens, que firmará la transacción y el saldo de la dirección asociada disminuirá.

A continuación se muestra un ejemplo completo. En primer lugar, se visualiza una dirección en una determinada URL de par de claves. En segundo lugar, se comprueba el saldo de esa dirección. Por último, se ingresa una transacción de transferencia para enviar 1SOL a la dirección del destinatario 7cvkjYAkUYs4W8XcXsca7cBrEGFeSUjeZmKoNBvEwyri. Cuando presiona Enter para un comando de transferencia, se le pedirá que apruebe los detalles de la transacción en su dispositivo Ledger. En el dispositivo, use los botones derecho e izquierdo para revisar los detalles de la transacción. Si se ven correctos, haga clic en ambos botones en la pantalla «Aprobar»; de lo contrario, presione ambos botones en la pantalla «Rechazar».

Después de aprobar la transacción en su dispositivo, el programa mostrará la firma de la transacción y esperará el número máximo de confirmaciones (32) antes de regresar. Esto solo toma unos segundos y luego se finaliza la transacción en la red Solana. Puede ver los detalles de esta o cualquier otra transacción yendo a la pestaña Transacción en el Explorador y pegando la firma de la transacción.

Operaciones avanzadas

Gestionar varias carteras de hardware

A veces es útil firmar una transacción con claves de varias carteras de hardware. Firmar con múltiples billeteras requiere URL de pares de claves completamente calificadas . Cuando la URL no está completamente calificada, la CLI de Solana le solicitará las URL completamente calificadas de todas las carteras de hardware conectadas y le pedirá que elija qué cartera usar para cada firma.

En lugar de utilizar las indicaciones interactivas, puede generar URL totalmente calificadas mediante el resolve-signercomando de la CLI de Solana . Por ejemplo, intente conectar un Nano a USB, desbloquéelo con su pin y ejecute el siguiente comando:

Verá una salida similar a:

pero donde BsNsvfXqQTtJnagwFWdBS7FBXgnsK8VZ5CmuznN85swKesta tu WALLET_ID.

Con su URL totalmente calificada, puede conectar varias carteras de hardware a la misma computadora e identificar de forma única un par de claves de cualquiera de ellas. Use la salida del resolve-signercomando en cualquier lugar donde un solanacomando espere que una <KEYPAIR&gt;entrada use esa ruta resuelta como firmante para esa parte de la transacción dada.

Solución de problemas

Los parámetros de URL del par de claves se ignoran en zsh #

El carácter de signo de interrogación es un carácter especial en zsh. Si esa no es una característica que usa, agregue la siguiente línea a su ~/.zshrcpara tratarla como un carácter normal:

Luego reinicie su ventana de shell o ejecute ~/.zshrc:

Si prefiere no deshabilitar el manejo especial de zsh del carácter del signo de interrogación, puede deshabilitarlo explícitamente con una barra invertida en las URL de su par de claves. Por ejemplo: