TronWif no Electrum: Extraia Chaves BTC com 1 Clique
TL;DR
- O TronWif transforma o Electrum numa toolbox dupla: mostra os endereços TRX derivados das suas chaves Bitcoin e exporta as chaves privadas de endereços BTC com movimentação.
- Derivação até 80× mais rápida com libsecp256k1 nativa — validada com benchmark em mais de 10 mil endereços, sem travar a interface.
- Suas chaves nunca saem do computador: a única comunicação externa é HTTPS com a API pública TronGrid, enviando só endereços públicos.
Nota Técnica: Este plugin lida diretamente com chaves privadas Bitcoin e Tron. Teste sempre em uma carteira de exemplo antes de usar com fundos reais. O @CanalQb não se responsabiliza por danos, perdas ou vazamento de chaves decorrentes do uso indevido — leia o bloco de segurança antes do primeiro uso.
10.999 endereços derivados na mão levariam a tarde toda — aqui leva segundos.
Foi assim que testei o TronWif: importei uma carteira Electrum cheia de chaves antigas só para ver quanto tempo a derivação Bitcoin → TRON levaria rodando em Python puro. O plugin cravou o benchmark completo antes de eu terminar o café. O que eu não esperava era o motivo — e ele está escondido numa única biblioteca C que a maioria dos plugins de carteira nem tenta usar. Você vai entender exatamente onde isso importa lá na seção de instalação "from source".
O que o TronWif faz dentro do Electrum?
O TronWif adiciona duas abas novas (Endereços TRX e Histórico TRX), um botão de extração na aba Bitcoin original e um item de menu "TRX toolbox" — tudo isso sem exigir nenhuma conta externa ou serviço pago. Ele deriva o endereço Tron de cada chave privada Bitcoin já presente na sua carteira e consulta saldo TRX e tokens TRC20 (como USDT e USDC) automaticamente.
Na prática, isso resolve um problema chato de quem migrou fundos entre as duas redes: descobrir se alguma chave Bitcoin antiga também tem saldo Tron esquecido, sem precisar copiar chave por chave num conversor manual.
| Recurso | Onde aparece | O que entrega |
|---|---|---|
| Aba "Endereços TRX" | Aba própria da carteira | Deriva o endereço TRX de cada chave BTC e consulta saldo TRX + TRC20 em tempo real |
| Aba "Histórico TRX" | Aba própria | Histórico de transações TRX/TRC20 por endereço, com link direto pro TronScan |
| Botão "Extrair chaves BTC" | Toolbar da aba Bitcoin | Exporta endereços com movimentação junto do WIF comprimido, não-comprimido e hex |
| Comandos RPC | Linha de comando | tron_address e tron_balance |
Quais são os pré-requisitos antes de instalar o TronWif?
Você precisa do Electrum 4.8.2 baixado só do site oficial electrum.org, de uma carteira que permita exportar chaves privadas (arquivo .wallet comum) e de acesso Administrador no Windows, já que a instalação grava dentro de C:\Program Files.
- Electrum 4.8.2 baixado apenas em electrum.org — espelhos e sites de terceiros podem distribuir versão adulterada.
- Carteira comum, com ou sem senha — watch-only e hardware wallets (Trezor, Ledger) não funcionam, por desenho: elas nunca expõem a chave privada.
- PowerShell com privilégio de Administrador disponível no Windows.
Como instalar o TronWif no Electrum oficial (passo a passo)?
São cinco passos: fechar o Electrum, baixar a pasta tronwif, abrir o PowerShell como Administrador, copiar a pasta para dentro da instalação e validar abrindo o Electrum de novo. O processo inteiro leva menos de cinco minutos.
Feche o Electrum completamente
Ação exata: Feche a janela do Electrum e verifique o ícone perto do relógio, na bandeja do Windows — se ainda estiver lá, clique direito → Sair.
Por que é necessário: o Python carrega os arquivos do plugin na memória assim que o Electrum abre. Copiar por cima de um plugin em execução falha ou grava metade do arquivo.
Resultado esperado: nenhum processo electrum.exe visível no Gerenciador de Tarefas (Ctrl+Shift+Esc).
Baixe a pasta tronwif do repositório
Ação exata: clique em "Code" → "Download ZIP" no repositório, ou clone via terminal:
cd tronwif-plugin
O que faz: traz para o seu computador os 6 arquivos que compõem o plugin: __init__.py, tron.py, qt.py, trx_address_list.py, trx_history_list.py e manifest.json.
Por que é necessário: os 6 arquivos dependem uns dos outros e o manifest.json é o que o Electrum lê para registrar o plugin — falta um, nada carrega.
Resultado esperado: pasta tronwif-plugin extraída com a subpasta tronwif contendo os 6 arquivos.
Abra o PowerShell como Administrador
Ação exata: Menu Iniciar → digite "PowerShell" → clique direito → "Executar como administrador" → confirme no aviso do Windows.
Por que é necessário: desde o Windows Vista, C:\Program Files é protegida pelo sistema — qualquer gravação sem elevação é bloqueada antes mesmo de tocar no disco.
Resultado esperado: janela do PowerShell abrindo com "Administrador" no título.
Copie a pasta do plugin para dentro da instalação
Ação exata: execute no PowerShell:
O que faz: cria ou substitui a pasta tronwif dentro do local onde o Electrum instalado guarda os plugins.
Resultado esperado: nenhuma mensagem de erro. Confirme com:
Get-ChildItem "C:\" -Recurse -Filter "electrum.exe" e ajuste o caminho do comando.Abra o Electrum e valide a instalação
Ação exata: abra o Electrum, carregue sua carteira e confira, nesta ordem: (1) o item "TRX toolbox" no menu Carteira e (2) as abas "Endereços TRX" e "Histórico TRX" ao lado das abas originais.
Por que é necessário: se a senha da carteira for pedida nesse momento, é a derivação automática rodando pela primeira vez — normal, digite uma vez só.
Resultado esperado: a barra da aba mostra "Consultando saldos: X/N" subindo até virar "N endereços TRX · atualizado às HH:MM".
[ESPAÇO PARA IMAGEM 1 — Aba "Endereços TRX" preenchida no Electrum]
Como instalar o TronWif rodando o Electrum "from source"?
Para quem roda o Electrum direto do código-fonte oficial, o processo muda: clone o repositório do Electrum, faça checkout da tag 4.8.2, copie a pasta tronwif para dentro de electrum\plugins\ e rode com python ./run_electrum — sem precisar de Administrador.
cd electrum
git checkout 4.8.2
Aqui está o detalhe que quase ninguém percebe: no Windows, a biblioteca libsecp256k1 não compila sozinha como acontece no Linux. Sem ela, o plugin continua funcionando normalmente, mas cai no fallback de derivação em Python puro — cerca de 80× mais lento para lotes grandes de endereços. Para evitar isso, rode o utilitário contrib/make_libsecp256k1.sh ou baixe o wheel electrum_ecc e extraia as DLLs para packages/electrum_ecc/.
Como usar a aba Endereços TRX e a aba Histórico TRX?
A aba Endereços TRX preenche sozinha ao abrir a carteira, pedindo a senha uma única vez por sessão. Duplo clique num endereço abre o histórico dele; clique direito oferece copiar, ver no TronScan ou remover da lista.
E o melhor? Você não precisa refazer a consulta de saldo toda vez — cada endereço é consultado uma vez por sessão. Só clique em "Atualizar saldos" quando quiser forçar uma nova checagem. Os botões "Exportar com saldo" e "Exportar com TX" geram um CSV com endereço TRX, chave hex, WIF, rótulo e saldo, prontos para planilha.
[ESPAÇO PARA IMAGEM 2 — Aba "Histórico TRX" com transações e link para o TronScan]
Como extrair as chaves privadas dos endereços Bitcoin com movimentação?
Abra a aba Endereços da carteira, clique em "Extrair chaves BTC", digite a senha se houver, e o plugin lista todos os endereços com pelo menos uma transação confirmada — cada um com WIF comprimido, WIF não-comprimido e a chave hexadecimal, prontos para copiar ou salvar em CSV.
Extrair chaves BTC — passo a passo
Ação exata: aba Endereços → botão "Extrair chaves BTC" na barra de botões → senha da carteira, se ela tiver.
O que faz: filtra apenas endereços com histórico confirmado e monta uma tabela com saldo, WIF comprimido (prefixo K/L), WIF não-comprimido (prefixo 5) e a chave em hexadecimal.
Por que é necessário: exportar só endereços com movimentação evita gerar um CSV gigante e inútil com milhares de chaves que nunca receberam fundos.
Resultado esperado: diálogo com "Copiar" (área de transferência) e "Salvar CSV" (colunas address, balance, wif_compressed, wif_uncompressed, private_key_hex).
[ESPAÇO PARA IMAGEM 3 — Diálogo do botão "Extrair chaves BTC" com WIF e chave hex]
Quais cuidados de segurança são obrigatórios antes do primeiro uso?
Trate qualquer CSV exportado como dinheiro físico, use sempre uma carteira com senha (sem senha, as chaves TRX ficam gravadas em texto puro no arquivo default_wallet) e desconfie de qualquer tela que peça sua seed mnemônica — o plugin nunca pede isso.
- O CSV exportado tem chaves privadas em texto puro. Um arquivo desses na nuvem ou no e-mail é dinheiro esperando alguém achar.
- A chave hexadecimal de cada endereço TRX fica gravada dentro do arquivo da carteira. Só é criptografada se a carteira tiver senha.
- Nenhuma tela, site ou comando do plugin pede sua seed mnemônica. As consultas externas são só de saldo/histórico por endereço público, via HTTPS na TronGrid.
- O plugin não é afiliado ao Electrum nem à Tron Foundation. Use por sua conta e risco — quem guarda as chaves é o dono delas.
Como atualizar ou desinstalar o TronWif?
Para atualizar, feche o Electrum e repita os passos 3 e 4 da instalação — os arquivos novos substituem os antigos automaticamente. Para desinstalar, feche o Electrum e remova a pasta do plugin com um único comando no PowerShell.
Os rótulos e saldos salvos ficam gravados no arquivo da própria carteira e somem junto com o plugin — a sua carteira Bitcoin em si nunca é tocada por essa remoção.
Perguntas Frequentes
O TronWif funciona com hardware wallet como Trezor ou Ledger?
Minhas chaves privadas são enviadas para algum servidor?
Por que a aba Endereços TRX pede a senha da carteira?
O plugin funciona em qualquer versão do Electrum?
É seguro salvar o CSV com as chaves extraídas no computador?
Por que a derivação fica 80× mais lenta em algumas instalações?
Fontes e Referências:
Repositório oficial do TronWif no GitHub
Electrum Bitcoin Wallet — site oficial
TronGrid — API pública da rede Tron
Gostou do TronWif? O código-fonte completo está aberto no GitHub do @CanalQb — dúvidas, sugestões ou bugs, abra uma issue por lá. Mais tutoriais assim no @CanalQb no YouTube.
