Localização atual: Início / Segurança, Backup e Prevenção / Texto do artigo

Trezor: Guia Prático de Scripts para Recuperação de Acesso (BIP39)

[DIR] Segurança, Backup e Prevenção [TIME] 2026.10.07 08:59

Aviso legal e ético: este artigo trata exclusivamente da recuperação de acesso a uma carteira sua, cuja seed, PIN ou passphrase você perdeu ou esqueceu parcialmente. Executar qualquer script contra credenciais de terceiros é crime na maioria das jurisdições. Se os fundos não são seus, pare aqui.

1. Antes do código: o que exatamente se perdeu?

Um usuário de Trezor pode perder três coisas diferentes, e cada uma exige uma abordagem distinta:

| O que se perdeu | Onde é validado | Recuperação por script? |
| --- | --- | --- |
| PIN | No próprio dispositivo | Sim, mas apenas via reset com a seed |
| Passphrase (BIP39) | Off-chain, deriva uma carteira oculta | Sim, com ataque de dicionário |
| Seed (12/24 palavras) | Off-chain, define a carteira raiz | Parcialmente, se faltarem poucas palavras |

O ponto central é entender que a seed e a passphrase nunca passam pelo servidor da Trezor. Toda a matemática acontece localmente, o que significa que um script em Python pode validar hipóteses sem nunca tocar no dispositivo.

2. Fundamentos técnicos que o script precisa respeitar

2.1 BIP39 e o checksum

A seed é uma frase de 12, 18 ou 24 palavras retiradas de uma lista fixa de 2048 palavras (wordlist inglesa, na maioria dos casos). A última palavra carrega um checksum derivado de SHA-256, o que permite descartar imediatamente qualquer combinação inválida. Em uma frase de 12 palavras, o checksum ocupa 4 bits; em 24 palavras, 8 bits.

2.2 Da frase à chave mestra

O padrão usa PBKDF2-HMAC-SHA512 com 2048 iterações:

  • Salt: a string "mnemonic" concatenada com a passphrase do usuário
  • Saída: 64 bytes de seed mestra

Esse custo de 2048 iterações é o que torna ataques de dicionário lentos — e é exatamente por isso que a passphrase é uma camada de segurança tão eficaz quanto a própria seed.

2.3 Derivação de endereços

Da seed mestra, o BIP32 gera chaves filhas seguindo caminhos hierárquicos (BIP44, BIP49, BIP84 ou BIP86). O script precisa comparar o endereço resultante com um endereço conhecido da carteira original — por exemplo, o primeiro endereço de recebimento em m/84'/0'/0'/0/0.

3. Preparando o ambiente

Trabalhe em uma máquina offline, idealmente com um live USB (Tails ou similar) e sem rede. Instale as dependências:

python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate

![recuperação de seed](/asset/upload/16/3c2f0e5582a01b9acafeb027e522879e_800_600.jpg)

pip install mnemonic bip_utils trezorlib
  • mnemonic — validação de frases e wordlist oficial
  • bip_utils — derivação BIP32/44/49/84/86 e geração de endereços
  • trezorlib — comunicação opcional com o dispositivo para conferência final

4. Etapa 1 — Validando a frase semente

Antes de qualquer força bruta, confirme se a frase que você lembra é, ao menos, estruturalmente válida:

from mnemonic import Mnemonic

mnemo = Mnemonic("english")
frase = "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"

print(mnemo.check(frase))      # True se o checksum bater
print(mnemo.to_seed(frase))    # bytes da seed mestra

Se o checksum falhar e você tem certeza de todas as palavras, o problema está na ordem ou no idioma da wordlist (existem wordlists em português, espanhol, francês e outras).

5. Etapa 2 — Uma única palavra desconhecida

Esse é o cenário mais comum e o mais trivial: 2048 combinações, resolvido em menos de um segundo.

from mnemonic import Mnemonic
from bip_utils import Bip39SeedGenerator, Bip84, Bip84Coins, Bip44Changes

mnemo = Mnemonic("english")
modelo = "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon {p} about"
alvo = "bc1q..."  # primeiro endereço conhecido da sua carteira

for palavra in mnemo.wordlist:
    frase = modelo.format(p=palavra)
    if not mnemo.check(frase):
        continue
    seed = Bip39SeedGenerator(frase).Generate("")
    conta = Bip84.FromSeed(seed, Bip84Coins.BITCOIN).Purpose().Coin().Account(0).Change(Bip44Changes.CHAIN_EXT).AddressIndex(0)

![script Python](/asset/upload/16/b12768bcdc61b69c67347caeceeba927_800_600.jpg)

    if conta.PublicKey().ToAddress() == alvo:
        print("Encontrado:", frase)
        break

6. Etapa 3 — Duas ou três palavras desconhecidas

A complexidade cresce de forma quadrática:

| Palavras desconhecidas | Combinações |
| --- | --- |
| 1 | 2.048 |
| 2 | ~4,2 milhões |
| 3 | ~8,6 bilhões |

Com duas palavras o problema ainda é tratável, desde que você use o checksum como filtro (ele elimina cerca de 90% a 97% dos candidatos antes de qualquer derivação cara) e paralelize com multiprocessing. Evite derivar endereços para cada candidato válido: primeiro filtre pelo checksum, depois teste apenas o primeiro endereço de recebimento.

Com três ou mais palavras desconhecidas em posições arbitrárias, a recuperação deixa de ser um problema de software e passa a ser um problema de orçamento energético — na prática, inviável para qualquer pessoa física.

7. Etapa 4 — Passphrase esquecida (ataque de dicionário)

Aqui o gargalo é o PBKDF2. Cada tentativa custa, em Python puro, entre 30 e 200 ms por conta do multiprocessing e do email/hashlib. Multiplique por 100 mil candidatos e você terá dias de execução.

Estratégia recomendada:

  1. Monte uma wordlist pequena e cirúrgica (variações de senhas que você realmente usaria).
  2. Implemente variações algorítmicas: maiúsculas iniciais, sufixos numéricos, substituições previsíveis.
  3. Use concurrent.futures.ProcessPoolExecutor para distribuir os núcleos.
  4. Lembre-se: a passphrase diferencia maiúsculas de minúsculas e espaços contam. "minha frase" é diferente de "MinhaFrase".
from concurrent.futures import ProcessPoolExecutor

def testa(passphrase):
    seed = Bip39SeedGenerator(frase_base).Generate(passphrase)
    # ... derivar e comparar com o endereço alvo
    return passphrase if match else None

with ProcessPoolExecutor() as ex:
    for resultado in ex.map(testa, candidatos):
        if resultado:

![carteira hardware](/asset/upload/16/5d0a35dcf84377bf9e2c9f3a7486c666_800_600.jpg)

            print("Passphrase encontrada:", resultado)
            break

8. Etapa 5 — Conferindo no dispositivo, sem expor a seed

Nunca digite uma seed candidata em um site. Use o próprio Trezor:

  • O Trezor Suite permite fazer uma recuperação de teste (dry-run) e comparar o primeiro endereço exibido com o endereço conhecido.
  • Via trezorlib, você pode abrir uma sessão e usar RecoveryDevice no modo avançado, inserindo as palavras diretamente no dispositivo — elas nunca tocam o teclado do computador.
from trezorlib.client import TrezorClient
from trezorlib.transport import get_transport

# Exemplo conceitual: sempre valide no hardware antes de mover fundos
transporte = get_transport()
cliente = TrezorClient(transporte)

Depois de recuperar o acesso, mova os fundos para uma nova seed gerada do zero. Se a seed antiga foi exposta a um computador, considere-a comprometida.

9. Segurança operacional

  • Rode tudo em máquina offline e descartável.
  • Nunca salve a seed, a passphrase ou os resultados em arquivos sincronizados com a nuvem.
  • Desconecte impressoras, câmeras e serviços de indexação antes de exibir qualquer frase na tela.
  • Destrua o ambiente (live USB) ao final.
  • Desconfie de qualquer "serviço de recuperação" que peça sua seed — é golpe em 100% dos casos.

10. Limites e alternativas

Se o script não for suficiente:

  • btcrecover — ferramenta madura e de código aberto para recuperação de seeds e senhas, com suporte a múltiplas moedas.
  • Suporte oficial da Trezor — não recupera seeds, mas orienta sobre Shamir Backup (SLIP-39) e recuperação avançada.
  • Backup Shamir — se você usou o Model T com SLIP-39, a recuperação exige um número mínimo de shares, e a matemática é diferente do BIP39 padrão.

Conclusão

Escrever um script de recuperação para Trezor é, no fundo, um exercício de entender BIP39, PBKDF2 e BIP32. O código em si é curto; o que consome tempo é a organização correta dos candidatos e a disciplina de segurança durante a execução. Use esse conhecimento apenas na sua própria carteira — e, principalmente, use-o para perceber por que um backup bem feito vale mais do que qualquer script de resgate.

recuperação de carteira Cardanoseed Moneropassphrase BIP39recuperar carteira LitecoinBIP-39xPortalcold walletOKX Web3 Walletrecuperação de seedBlockstream Jadebackupboas práticasbackup carteiraOrient Waltrestaurar carteirarecuperação offlineBIP32Bitcoinphishingsegurança de criptomoedas