Como navegar por caminhos de derivação na Tangem Wallet

Ao importar uma seed phrase de uma carteira de terceiros que suporta múltiplas contas, ou seja, carteiras que criam novos endereços para uma moeda após cada transação, você verá apenas o saldo do primeiro endereço — que pode estar zerado.

Para corrigir esse problema, é necessário criar um token personalizado com o mesmo caminho de derivação da carteira de onde a seed phrase foi importada.

O que é um caminho de derivação?

O caminho de derivação se refere ao processo de gerar um endereço ou chave pública específica a partir de uma master seed ou root key. Isso é feito aplicando um caminho de derivação, uma sequência de números e barras (/) que define a hierarquia das chaves.

O caminho de derivação cria uma estrutura em árvore, em que cada nível representa um novo par de chaves. O caminho define o ramo específico a seguir para o par de chaves desejado.

Dessa forma, é possível gerar múltiplos endereços e chaves a partir de uma única master seed, facilitando o gerenciamento e organização de endereços para diferentes finalidades ou contas.

Por exemplo, o caminho de derivação "m/44'/0'/0" gera um endereço específico começando da master seed (m), depois derivando um par de chaves no nível 44' (chave endurecida), depois no nível 0' (outra chave endurecida) e, por fim, no nível 0 (chave não endurecida).

A estrutura típica de um caminho de derivação é a seguinte:

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

• m: representa a chave mestre (ou root key)
   
• Purpose: Este campo, adicionado pelo BIP43, indica o padrão do caminho de derivação. Pode ser 0 ou 44 para o padrão BIP44 P2PKH / endereços ‘1’ legacy, 45 para BIP45 carteiras multiassinatura P2SH (proposta), 47 para BIP47 códigos de pagamento reutilizáveis (rascunho), 48 para carteiras hardware multisig (sem BIP ou proposta de padrão), 49 para BIP49 P2WPKH-aninhado-em-P2SH / endereços ‘3’ SegWit, ou 84 para BIP84 P2WPKH / endereços ‘bc1’ SegWit nativo. 

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

• Coin type: Este campo indica qual criptomoeda está sendo usada em uma carteira multicripto. Todas as moedas, incluindo o bitcoin testnet, recebem um número constante. Por exemplo, um caminho de derivação para uma conta Hedera (HBAR) seria m/44'/3030'. BIP45 designaria esse nível como ‘Cosigner Index’.
   
• Account: Este campo, em uma carteira com múltiplas contas, indica a identidade ou coleção de endereços, permitindo separar fundos para diferentes finalidades (ex.: poupança, doações). Note que BIP45 não inclui esse campo. BIP47 designa esse nível como ‘Identity’, embora seja equivalente a ‘Account’.
   
• Change: Este campo, se o valor constante 0 estiver presente, indica endereços da “cadeia externa” (normais); se for 1, indica endereços de “cadeia interna” ou de troco. Note: BIP47 designa esse nível para notification keys e payment codes efêmeros.
   
• Address Index: Este campo indica o número do endereço específico dentro de uma conta na sequência.

‘Account’ e ‘Address Index’ começam em zero (0). Isso ocorre porque utilizam numeração iniciada em zero, assim como o “térreo” em prédios europeus é considerado nível zero, enquanto nos Estados Unidos seria o primeiro andar.

Por exemplo, se você tem uma carteira Bitcoin compatível com BIP44 e quer encontrar o segundo endereço de troco na sua terceira conta. O caminho de derivação para o segundo endereço de troco na terceira conta seria: m/44'/0'/2'/1/1.

Veja uma tabela formatada para caminhos Bitcoin com base nas informações acima:

Quais blockchains exigem um caminho de derivação específico?

Algumas blockchains geram um novo endereço para cada transação recebida usando o protocolo UTXO (Unspent Transaction Output). Um UTXO é a quantidade de criptomoeda restante após uma transação. O modelo UTXO permite que os usuários acompanhem a posse de todas as frações de criptomoedas. Para descobrir o caminho de derivação, você precisa encontrar a chave XPUB da blockchain para importar todas as transações automaticamente.

Exemplos de blockchains que usam o modelo UTXO:

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

Sua chave xpub varia para cada blockchain, então será necessário exportá-la separadamente para cada ativo que deseja transferir.
 

Como importar uma carteira com caminho de derivação

Se você importou sua carteira com uma seed phrase, mas alguns tokens estão faltando ou com saldo zero, pode ser que esses endereços de token usem um caminho de derivação diferente, o que is not supported na Tangem. Veja o que fazer usando o Bitcoin como exemplo.

1. Descubra o caminho de derivação da carteira de origem
 

A maioria das carteiras cripto fornece o caminho de derivação dos endereços de token nos arquivos XPUB. Você pode encontrar o arquivo XPUB nas configurações da carteira ou consultar a documentação ou guias do desenvolvedor ou fabricante da carteira. Eles podem ter uma seção sobre caminhos de derivação ou gerenciamento de chaves.

Veja exemplos de como encontrar sua chave xpub de acordo com a carteira:

Trezor:

• Conecte sua carteira Trezor e abra o app Trezor Suite no desktop ou web.
• Selecione a conta desejada no menu lateral.
• Vá até a aba Details e copie a chave de derivação m/84'/0'/0.

Ledger:

• Abra a conta para a qual deseja obter o xpub.
• Clique no ícone de chave inglesa.
• Na janela Edit Account, expanda a seção Advanced Logs.
• Encontre e copie o Address Path, que será parecido com: "44'/0'/0'/0'/1.
   

Kaspa

• KDX/Kaspanet Web Wallet usa o caminho de derivação m/44'/972'/0' com seed phrase de 12 palavras.
• A carteira Core Golang CLI e a Kaspium usam o caminho m/44'/111111'/0' com seed phrase de 24 palavras.
  Note: 972 e 111111 são coin types diferentes.

As carteiras KDX não são compatíveis com BIP-32, então seus tokens não aparecerão automaticamente na tangem wallet, pois o caminho KDX é considerado obsoleto. Você pode exibir esses tokens seguindo os passos abaixo.

Como obter um caminho de derivação usando o xpub

Para obter o caminho de derivação usando seu xpub (Extended Public Key), utilize um explorador de blockchain.

Veja o passo a passo:

1. Acesse https://bitcoinexplorer.org/
2. Digite seu xpub no campo "search".
3. Copie o BIP32 PATH exibido.
    

2. Crie tokens personalizados na Tangem Wallet

Agora, você precisa criar um token personalizado com o caminho de derivação da carteira de origem. Veja como fazer:

1. Abra sua Tangem Wallet e toque nos três pontos no canto superior direito

2. Selecione a carteira desejada na página Details. 

3. Toque em Manage tokens nas configurações da Wallet.

4. Toque no ícone “+” no canto superior direito da lista de tokens para acessar o menu de adição de token personalizado.

5. Selecione a rede, por exemplo, Bitcoin.

6. Toque em Derivation Path.

7. Selecione Custom derivation.

8. Digite o caminho de derivação da sua carteira de origem, por exemplo, m/84'/0'/0. Ao inserir o caminho de derivação, é importante começar com m/ , senão a Tangem Wallet não conseguirá validar o token. Toque em OK.

9. Digite seu código de acesso ou use a biometria e escaneie seu dispositivo Tangem para autorizar as alterações.

10. O token derivado aparecerá na página inicial com o saldo correto.