A Electrum oferece uma interface de linha de comando robusta. Este guia aborda os conceitos essenciais para o uso da CLI, atualizado para a Electrum 4.0 e versões posteriores.
Obtendo ajuda
Para visualizar todos os comandos disponíveis da Electrum:
electrum help
Para obter informações detalhadas sobre um comando específico:
electrum help <command>
Usando o Electrum Daemon
Os comandos da Electrum normalmente interagem com um daemon em execução. Veja a seguir como gerenciar o daemon:
electrum daemon -d
electrum getinfo
electrum stop
Algumas operações exigem uma carteira carregada. Para gerenciar carteiras:
electrum load_wallet # this will load the default wallet
electrum load_wallet -w /path/to/wallet/file
electrum list_wallets
Depois de carregar uma carteira, você pode executar tarefas relacionadas a ela:
electrum listaddresses
Enviar um pagamento:
electrum payto <address> <amount>
Para comandos que não precisam de acesso à rede, use o comando --offline bandeira:
electrum -o listaddresses
electrum -o payto <address> <amount>
electrum -o -w /path/to/wallet/file listaddresses
Atalhos de comandos especiais (palavras mágicas)
A interface de linha de comando da Electrum suporta vários caracteres especiais para aprimorar a funcionalidade:
Uso do ponto de exclamação (!) ! para indicar o valor máximo disponível em uma transação.
Exemplo:
electrum payto 1JuiT4dM65d8vBt8qUYamnDmAMJ4MjjxRE !
Isso envia o máximo de fundos disponíveis para o endereço especificado. A taxa de transação é calculada e deduzida automaticamente.
Ponto de interrogação (?) O ? solicita que você digite um valor para um parâmetro.
Exemplo:
electrum signmessage 1JuiT4dM65d8vBt8qUYamnDmAMJ4MjjxRE ?
Você será solicitado a inserir a mensagem a ser assinada.
Dois pontos (:) Use : para entrada oculta, útil para dados confidenciais, como senhas.
Exemplo:
electrum importprivkey :
Você será solicitado duas vezes: primeiro a fornecer a chave privada e depois a senha da carteira. A entrada não será exibida na tela.
Traço (-) Um traço - lê a entrada de um pipe ou entrada padrão.
Exemplo:
cat LICENCE | electrum signmessage 1JuiT4dM65d8vBt8qUYamnDmAMJ4MjjxRE -
Assina o conteúdo do arquivo LICENCE com o endereço especificado.
Apelidos
A Electrum permite que você use aliases de DNS em vez de endereços completos de Bitcoin em muitos comandos. Esse recurso simplifica as transações e melhora a usabilidade.
Você pode substituir um endereço Bitcoin por seu alias DNS correspondente na maioria dos comandos da Electrum.
Exemplo:
electrum payto ecdsa.net !
Formatação de saídas Electrum com jq
As saídas de comando da Electrum são normalmente cadeias de caracteres simples ou dados JSON estruturados. Para melhorar a legibilidade e o processamento dessas saídas, você pode usar a função jq utilidade.
Instalação jq: Em sistemas baseados no Debian (como o Ubuntu), instale-o usando:
sudo apt-get install jq
Para outros sistemas operacionais, verifique seu gerenciador de pacotes ou o arquivo jq para obter instruções de instalação.
Exemplos
Assinatura e verificação de mensagens
Assinatura de uma mensagem
Para assinar o conteúdo de um arquivo (neste caso, "LICENCE") com um endereço Bitcoin específico:
sig=$(cat LICENCE| electrum signmessage 1JuiT4dM65d8vBt8qUYamnDmAMJ4MjjxRE -)
Verificação de uma mensagem
Para verificar a assinatura do mesmo conteúdo de arquivo:
cat LICENCE | electrum verifymessage 1JuiT4dM65d8vBt8qUYamnDmAMJ4MjjxRE $sig -
Mostre os valores de suas despesas não gastas
Este exemplo demonstra como visualizar os valores de suas saídas não gastas usando a interface de linha de comando da Electrum em combinação com jq.
Para mostrar os valores de suas transações não gastas:
electrum listunspent | jq 'map(.value)'
Selecione apenas as transações de entrada do histórico
Este exemplo mostra como usar a interface de linha de comando da Electrum com jq para exibir apenas as transações recebidas do histórico de sua carteira.
Para visualizar apenas as transações recebidas:
electrum history | jq '.[] | select(.value>0)'
Filtrar transações por data
Este guia mostra como usar a CLI da Electrum com jq para filtrar transações com base em datas específicas.
Transações após uma determinada data
after=$(date -d '03/15/2019' +"%s")
electrum history | jq --arg after $after '.[] | select(.timestamp>($after|tonumber))'
Transações em um intervalo de datas
before=$(date -d '11/22/2018' +"%s")
after=$(date -d '09/07/2017' +"%s")
electrum history | jq --arg before $before --arg after $after '.[] | select(.timestamp>($after|tonumber) and .timestamp<($before|tonumber))'
Criptografar e descriptografar mensagens
Este guia demonstra como usar a interface de linha de comando da Electrum para criptografar e descriptografar mensagens usando criptografia de chave pública.
Obtenção da chave pública
Primeiro, recupere a chave pública associada a um endereço de carteira:
pk=$(electrum getpubkeys 1JuiT4dM65d8vBt8qUYamnDmAMJ4MjjxRE| jq -r '.[0]')
Criptografia de uma mensagem
Para criptografar uma mensagem:
cat | electrum encrypt $pk -
Descriptografando uma mensagem
Para descriptografar uma mensagem:
electrum decrypt $pk ?
Esse comando solicita que você digite uma mensagem criptografada, depois pede a senha da carteira e descriptografa a mensagem usando sua chave privada.
Exportar chaves privadas e moedas de varredura
Este guia explica como exportar chaves privadas de endereços financiados em sua carteira Electrum e usá-las para transferir moedas para um novo endereço.
Exportação de chaves privadas de endereços financiados:
electrum listaddresses --funded | electrum getprivatekeys -
Isso retornará uma lista de listas de chaves privadas. Na maioria dos casos, você deseja obter uma lista simples.
Para obter uma lista simplificada de chaves privadas:
electrum listaddresses --funded | electrum getprivatekeys - | jq 'map(.[0])'
Transferir moedas para um novo endereço:
electrum listaddresses --funded | electrum getprivatekeys - | jq 'map(.[0])' | electrum sweep - [destination address]