Cómo navegar rutas de derivación en Tangem Wallet

Al importar una frase semilla desde una billetera de terceros que admite múltiples cuentas, es decir, billeteras que crean nuevas direcciones para una moneda después de cada transacción, solo verás el saldo de la primera dirección, cuyo saldo puede ser 0.

Para solucionar este problema, tienes que crear un token personalizado con la misma ruta de derivación de la billetera desde la cual se importó la frase semilla.

¿Qué es una ruta de derivación?

La derivación de ruta se refiere a generar una dirección o clave pública específica a partir de una semilla maestra o clave raíz. Esto se realiza aplicando una ruta de derivación, una secuencia de números y barras (/) que define la jerarquía de claves.

La ruta de derivación crea una estructura tipo árbol, donde cada nivel representa un nuevo par de claves. La ruta define la rama específica a seguir para obtener el par de claves deseado.

Esto permite generar múltiples direcciones y claves desde una sola semilla maestra, facilitando la gestión y organización de direcciones para diferentes propósitos o cuentas.

Por ejemplo, la ruta de derivación "m/44'/0'/0" generará una dirección específica comenzando desde la semilla maestra (m), luego derivando un par de claves en el nivel 44' (clave endurecida), luego en el nivel 0' (otra clave endurecida) y finalmente en el nivel 0 (clave no endurecida).

La estructura típica de una ruta de derivación es la siguiente:

m/purpose'/coin_type'/account'/change/address_index

• m: representa la clave maestra (o clave raíz)
   
• Purpose: Este campo, añadido a través de BIP43, indica el estándar de la ruta de derivación. Puede incluir 0 o 44 haciendo referencia por defecto a BIP44 P2PKH / direcciones ‘1’ legacy, 45 para BIP45 billeteras multifirma (propuesta), 47 para BIP47 códigos de pago reutilizables (borrador), 48 para billeteras hardware multisig (sin BIP o propuesta estándar), 49 para BIP49 P2WPKH-anidado-en-P2SH / direcciones ‘3’ SegWit, o 84 para BIP84 P2WPKH / direcciones ‘bc1’ SegWit nativas. 

Tangem Wallet supports only Legacy BIP44 (P2PKH) and SegWit BIP84, (P2WPKH).

• Coin type: Este campo indica qué criptomoneda se está utilizando en una billetera multicripto. Todas las monedas, incluido bitcoin testnet, tienen un número constante asignado. Por ejemplo, una ruta de derivación para una cuenta de Hedera (HBAR) sería m/44'/3030'. BIP45 designaría este nivel como ‘Cosigner Index’.
   
• Account: En una billetera con varias cuentas, este campo indica la identidad o colección de direcciones, lo que permite a los usuarios separar fondos para distintos fines (por ejemplo, ahorros, donaciones). Nota que BIP45 no incluye este campo. BIP47 lo denomina ‘Identity’, aunque es equivalente a ‘Account’.
   
• Change: Si el valor constante es 0, indica direcciones de “cadena externa” (regulares); si es 1, son direcciones de “cadena interna” o de cambio. Nota: BIP47 utiliza este nivel para claves de notificación y códigos de pago efímeros.
   
• Address Index: Este campo indica el número específico de dirección dentro de una cuenta en la secuencia.

‘Account’ y ‘Address Index’ comienzan en cero (0). Esto se debe a que utilizan numeración basada en cero, igual que el “planta baja” en los edificios europeos se considera nivel cero, en vez del primer piso como en Estados Unidos.

For example, si tienes una billetera Bitcoin compatible con BIP44 y deseas encontrar la segunda dirección de cambio en tu tercera cuenta. La ruta de derivación para la segunda dirección de cambio en la tercera cuenta sería: m/44'/0'/2'/1/1.

Aquí tienes una tabla formateada para rutas de Bitcoin según la información proporcionada:

¿Qué blockchains requieren una ruta de derivación específica?

Algunas blockchains generan una nueva dirección para cada transacción entrante usando el protocolo UTXO (Unspent Transaction Output). Un UTXO es la cantidad de criptomonedas que queda después de una transacción. El modelo UTXO permite a los usuarios rastrear la propiedad de todas las fracciones de criptomonedas. Para descubrir su ruta de derivación, necesitas encontrar la clave XPUB de la blockchain para importar todas las transacciones automáticamente.

Ejemplos de blockchains que usan el modelo UTXO:

• Bitcoin
• Bitcoin Cash
• BitcoinGold
• Dash
• DigiByte
• Dogecoin
• Dash
• Kaspa
• Litecoin

Tu clave xpub varía para cada blockchain, por lo que tendrás que exportarla por separado para cada activo que quieras exportar.
 

¿Cómo importar una billetera con ruta de derivación?

Si ya importaste tu billetera con una frase semilla pero algunos tokens no aparecen o muestran saldo cero, el problema puede ser que esas direcciones de tokens usan una ruta de derivación diferente, la cual no está soportada en Tangem. Esto es lo que debes hacer usando Bitcoin como ejemplo.

1. Descubre la ruta de derivación desde la billetera de origen
 

La mayoría de las billeteras cripto muestran la ruta de derivación de las direcciones de tokens en sus archivos XPUB. Puedes encontrar el archivo XPUB en la configuración de la billetera o consultar la documentación o guías del desarrollador o fabricante. Es posible que tengan una sección sobre rutas de derivación o gestión de claves.

Aquí tienes ejemplos de cómo encontrar tu clave xpub según la billetera.

Trezor:

• Conecta tu billetera Trezor y abre la app de escritorio Trezor Suite o la web app.
• Selecciona la cuenta deseada en el menú lateral.
• Selecciona la pestaña Details y copia la clave de derivación m/84'/0'/0.

Ledger:

• Abre la cuenta para la que deseas obtener la xpub.
• Haz clic en el icono de la llave inglesa.
• En la ventana Edit Account, expande la sección Advanced Logs.
• Busca y copia la Address Path, que se verá así: "44'/0'/0'/0'/1.
   

Kaspa

• KDX/Kaspanet Web Wallet utiliza la ruta de derivación m/44'/972'/0' con frases semilla de 12 palabras.
• La wallet Core Golang CLI y Kaspium usan la ruta de derivación m/44'/111111'/0' con frases semilla de 24 palabras.
  Note: 972 y 111111 son tipos de moneda diferentes.

Las billeteras KDX no son compatibles con BIP-32, por lo que tus tokens no aparecerán automáticamente en Tangem Wallet porque la ruta de derivación KDX se considera obsoleta. Puedes hacer que estos tokens aparezcan siguiendo los pasos que se indican a continuación.

¿Cómo obtener una ruta de derivación usando la xpub?

Para obtener una ruta de derivación usando tu xpub (clave pública extendida), puedes usar un explorador de blockchain.

Aquí tienes una guía paso a paso:

1. Ve a https://bitcoinexplorer.org/
2. Introduce tu xpub en el campo "search".
3. Copia la BIP32 PATH que se muestra.
    

2. Crea tokens personalizados en Tangem Wallet

Ahora tienes que crear un token personalizado con la ruta de derivación de la billetera de origen. Así es como se hace:

1. Abre tu Tangem Wallet y toca los tres puntos en la esquina superior derecha

2. Selecciona la billetera relevante en la página de Details. 

3. Toca Manage tokens en la configuración de Wallet.

4. Toca el ícono “+” en la esquina superior derecha de la lista de tokens para acceder al menú para agregar un token personalizado.

5. Selecciona la red, por ejemplo, Bitcoin.

6. Toca Derivation Path.

7. Selecciona Custom derivation.

8. Ingresa la ruta de derivación de tu billetera de origen, por ejemplo, m/84'/0'/0. Al ingresar la ruta de derivación, es importante comenzar con m/  o Tangem Wallet no podrá validar el token. Toca OK.

9. Ingresa tu código de acceso o identificación biométrica y escanea tu dispositivo Tangem para autorizar estos cambios.

10. El token derivado aparecerá en la página principal con su saldo correcto.