¿Cómo instalo la aplicación Metal Ledger Nano?

Introducción​

La aplicación Metal Ledger Nano permite a los usuarios almacenar sus activos en un Ledger Nano S y Nano S Plus mientras interactúan con la Blockchain Metal. Desafortunadamente, dado que la Blockchain Metal aún es relativamente nueva, los usuarios deberán instalar manualmente la aplicación en sus dispositivos Ledger. Este es un proceso bastante técnico y puede ser complicado para muchos usuarios.

Para aquellos que desean usar su dispositivo Ledger con la Billetera Metal Blockchain inmediatamente después de nuestro lanzamiento en mainnet, esta guía proporciona un método alternativo para instalar la aplicación Metal en un Ledger Nano S mediante un proceso llamado “sideloading”.
 

Acerca del Sideloading​

Sideloading significa descargar directamente la aplicación Metal Ledger en su computadora y desde ahí cargarla en su dispositivo Ledger sin usar la aplicación Ledger Live. Debido a que el sideloading no requiere soporte de Ledger HQ, es el enfoque típico para integraciones muy nuevas en dispositivos Ledger como la nuestra.

Ledger HQ proporciona un método para hacer sideloading de aplicaciones en dispositivos Ledger, pero es un proceso muy manual que utiliza herramientas basadas en Unix que requieren un poco de conocimiento “bajo el capó” de su computadora. El proceso probablemente será cómodo para un desarrollador de software, pero para otros puede parecer un poco extraño. Sin embargo, haremos nuestro mejor esfuerzo para guiarlo paso a paso. Y al final, puede estar seguro de que una vez que la aplicación esté cargada en su Ledger, no dañará su dispositivo y será tan segura como instalarla mediante Ledger Live.
 

Sideloading en MacOS​

Instalar Homebrew​

Homebrew es un gestor de paquetes para MacOS y será necesario para los otros paquetes que necesitaremos instalar. Omitir este paso si ya tiene Homebrew instalado. Si no, ejecute el comando en la aplicación Terminal a continuación:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Instalar prerrequisitos​

brew install python3 wget

Instalar y configurar virtualenv​

pip3 install virtualenv --user

mkdir -p ~/Metal && python3 -m venv ~/Metal/env

Ahora activamos el entorno virtual para los siguientes pasos:

source ~/Metal/env/bin/activate

Luego podemos instalar la herramienta de sideloading de Ledger HQ llamada “ledgerblue”:

pip3 install ledgerblue

Después ingresamos a la carpeta donde previamente colocamos el código fuente de la aplicación Metal Ledger:

cd ~/Metal

Ahora finalmente estamos listos para hacer el sideload.

En este punto, conecte su Ledger Nano S con su cable USB y desbloquéelo con su PIN. Debería ver el menú del Ledger en la pantalla del dispositivo, donde podría tener una aplicación de Bitcoin o Ethereum si ya instaló alguna.
 

Una vez que el dispositivo Ledger esté conectado y listo, vamos a ejecutar un último comando en Terminal que realizará la instalación por sideload:

Para el Ledger Nano S ejecute el siguiente comando:

wget https://github.com/MetalBlockchain/ledger-app-metal/releases/download/v0.6.0/ledger_nanos.zip
unzip ledger_nanos.zip

python -m ledgerblue.loadApp \
--appFlags 0x00 \
--dataSize $((0x`cat debug/app.map |grep _envram_data | tr -s ' ' | cut -f2 -d' '|cut -f2 -d'x'` - 0x`cat debug/app.map |grep _nvram_data | tr -s ' ' | cut -f2 -d' '|cut -f2 -d'x'`)) \
--tlv \
--curve ed25519 \
--curve secp256k1 \
--curve secp256r1 \
--targetId 0x31100004 \
--delete \
--path '44'\''/60'\''' \
--path '44'\''/9000'\''' \
--fileName bin/app.hex \
--appName Metal \
--appVersion 0.6.0 \
--icon 0100000000ffffff00ffffffffffffffffcff38ff18ff10ff04ff24ffecff3cff3ffffffffffffffff

Para el Ledger Nano S Plus ejecute el siguiente comando:

wget https://github.com/MetalBlockchain/ledger-app-metal/releases/download/v0.6.0/ledger_nanos_plus.zip
unzip ledger_nanos_plus.zip

python -m ledgerblue.loadApp \
--appFlags 0x00 \
--dataSize $((0x`cat debug/app.map |grep _envram_data | tr -s ' ' | cut -f2 -d' '|cut -f2 -d'x'` - 0x`cat debug/app.map |grep _nvram_data | tr -s ' ' | cut -f2 -d' '|cut -f2 -d'x'`)) \
--tlv \
--curve ed25519 \
--curve secp256k1 \
--curve secp256r1 \
--targetId 0x33100004 \
--delete \
--path '44'\''/60'\''' \
--path '44'\''/9000'\''' \
--fileName bin/app.hex \
--appName Metal \
--appVersion 0.6.0 \
--icon 0100000000ffffff00000000000060183807ce817f601bd800868161000000000000

Pasos a seguir en el Ledger​

Ahora empezará a ver texto extraño en Terminal, pero esta vez se le pedirá que confirme algunas cosas en su dispositivo Ledger Nano S (Plus) usando sus botones.

Primero, debería ver:

Deny unsafe manager

No se asuste por este “gestor no seguro” (unsafe manager). Esto es simplemente que su dispositivo Ledger está siendo cauteloso con las aplicaciones cargadas por sideload. En este caso confiamos en lo que estamos cargando, por lo que puede ignorar esta advertencia con seguridad.

Aquí deberá usar el botón derecho del dispositivo para avanzar por algunas pantallas hasta llegar a una donde pueda usar ambos botones para confirmar que desea permitir el “gestor no seguro”, así:

> public key (9 screens) > Allow unsafe manager

Poco después, debería ver en la pantalla de su Ledger:

Loading, please wait

Una vez que la barra de progreso se complete, seguirá con:

Install app Metal

Aquí nuevamente deberá usar el botón derecho del dispositivo para avanzar por algunas pantallas hasta llegar a una donde pueda usar ambos botones para confirmar así:

Version > Identifier (5 screens) > Code Identifier (5 screens) > Perform Installation

Nota: La pantalla “Version” puede que no muestre ninguna información de versión. Nuevamente, esto es normal y esperado para este proceso de sideloading.

Luego se le pedirá que ingrese nuevamente el PIN de su Ledger. Una vez hecho esto, en breve volverá a ver el prompt en Terminal.
 

¡Acaba de completar el sideload!