Cómo navegar las 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 podría ser 0.

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

¿Qué es una ruta de derivación?

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

La ruta de derivación crea una estructura en forma de á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ía 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 que hacen referencia por defecto a BIP44 P2PKH / direcciones ‘1’ legacy, 45 para BIP45 billeteras multifirma P2SH (propuesta), 47 para BIP47 códigos de pago reutilizables (borrador), 48 para billeteras hardware multisig (sin BIP o propuesta estándar), 49 para BIP49 direcciones P2WPKH-anidadas-en-P2SH / ‘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 utiliza en una billetera multicripto. Todas las monedas, incluido bitcoin testnet, tienen un número constante. 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: Este campo, en una billetera con varias cuentas, indica la identidad o conjunto de direcciones, lo que permite a los usuarios separar fondos para diferentes fines (por ejemplo, ahorros, donaciones). Nota que BIP45 no incluye este campo. BIP47 designa este nivel como ‘Identity’, aunque es equivalente a ‘Account’.
   
• Change: Este campo, si el valor constante es 0, indica direcciones de “cadena externa” (regulares); si el valor es 1, indica direcciones de “cadena interna” o de cambio. Nota: BIP47 designa este nivel para las 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’ empiezan en cero (0). Esto se debe a que usan numeración basada en cero, tal como la “planta baja” de los edificios europeos se considera nivel cero, en vez de primer piso/nivel uno como en Estados Unidos.

For example, si tienes una billetera Bitcoin compatible con BIP44 y quieres encontrar la segunda dirección de cambio en tu tercera cuenta, la ruta de derivación para la second change address en la third account 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 partes de las criptomonedas. Para descubrir su ruta de derivación, deberás 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 deberás 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 tienen saldo cero, el problema puede ser que esas direcciones usan una ruta de derivación diferente, la cual is not supported en Tangem. Aquí te explicamos qué hacer usando Bitcoin como ejemplo.

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

La mayoría de las billeteras cripto proporcionan la ruta de derivación de las direcciones de tokens en sus archivos XPUB. Puedes encontrar el archivo XPUB de tu billetera en la configuración 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 o web Trezor Suite.
• 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 quieres obtener el 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 CLI Core Golang y Kaspium usan la ruta de derivación m/44'/111111'/0' con frases semilla de 24 palabras. 
  Note: 972 and 111111 are different coin types.

Las billeteras KDX no son compatibles con BIP-32, por lo que tus tokens no aparecerán automáticamente en la billetera tangem 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 el xpub?

Para obtener una ruta de derivación usando tu xpub (Clave Pública Extendida), puedes utilizar un explorador de blockchain.

Sigue estos pasos:

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

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 Details. 

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

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 empezar con m/ de lo contrario, Tangem Wallet no podrá validar el token. Toca OK.

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

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