Electrum oferece uma interface de linha de comando robusta. Este guia cobre conceitos essenciais para usar a CLI, atualizado para Electrum 4.0 e versões posteriores.
Obter ajuda
Para ver todos os comandos Electrum disponíveis:
electrum help
Para obter informações pormenorizadas sobre um comando específico:
electrum help <command>
Usando o Electrum Daemon
Os comandos Electrum normalmente interagem com um daemon em execução. Aqui está como gerenciar o daemon:
electrum daemon -d
electrum getinfo
electrum stop
Algumas operações requerem uma carteira carregada. Para gerir as 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, pode efetuar tarefas relacionadas com a carteira:
electrum listaddresses
Enviar um pagamento:
electrum payto <address> <amount>
Para comandos que não necessitam de acesso à rede, utilize a opção --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 melhorar a funcionalidade:
Uso do ponto de exclamação (!) ! para indicar o montante máximo disponível numa transação.
Exemplo:
electrum payto 1JuiT4dM65d8vBt8qUYamnDmAMJ4MjjxRE !
Isto envia o máximo de fundos disponíveis para o endereço especificado. A taxa de transação é automaticamente calculada e deduzida.
Ponto de interrogação (?) O ? pede-lhe para introduzir um valor para um parâmetro.
Exemplo:
electrum signmessage 1JuiT4dM65d8vBt8qUYamnDmAMJ4MjjxRE ?
Ser-lhe-á pedido que introduza a mensagem a assinar.
Dois pontos (:) Utilizar : para introdução oculta, útil para dados sensíveis como palavras-passe.
Exemplo:
electrum importprivkey :
Ser-lhe-ão pedidas duas vezes: primeiro a chave privada e depois a palavra-passe da carteira. A entrada não será apresentada no ecrã.
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 ficheiro LICENCE com o endereço especificado.
Pseudónimos
Electrum permite-lhe usar aliases DNS em vez de endereços Bitcoin completos em muitos comandos. Esta caraterística simplifica as transacções e melhora a usabilidade.
Você pode substituir um endereço Bitcoin pelo seu alias DNS correspondente na maioria dos comandos Electrum.
Exemplo:
electrum payto ecdsa.net !
Formatação de saídas Electrum com jq
Os resultados dos comandos 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 o jq utilidade.
Instalação jq: Em sistemas baseados em Debian (como o Ubuntu), instale-o usando:
sudo apt-get install jq
Para outros sistemas operativos, verifique o seu gestor de pacotes ou o jq para obter instruções de instalação.
Exemplos
Assinatura e verificação de mensagens
Assinar uma mensagem
Para assinar o conteúdo de um ficheiro (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 ficheiro:
cat LICENCE | electrum verifymessage 1JuiT4dM65d8vBt8qUYamnDmAMJ4MjjxRE $sig -
Mostrar os valores das suas despesas não efectuadas
Este exemplo demonstra como visualizar os valores das suas saídas não gastas utilizando a interface de linha de comandos da Electrum em combinação com jq.
Para mostrar os valores das suas transacções não gastas:
electrum listunspent | jq 'map(.value)'
Selecionar apenas transacções recebidas do histórico
Este exemplo mostra como usar a interface de linha de comando da Electrum com jq para apresentar apenas as transacções recebidas do histórico da sua carteira.
Para ver apenas as transacções recebidas:
electrum history | jq '.[] | select(.value>0)'
Filtrar transacções por data
Este guia mostra como usar a CLI da Electrum com jq para filtrar transacções com base em datas específicas.
Transacçõ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 dentro de 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))'
Encriptar e desencriptar mensagens
Este guia demonstra como usar a interface de linha de comando da Electrum para encriptar e desencriptar mensagens usando criptografia de chave pública.
Obter a chave pública
Primeiro, recupere a chave pública associada a um endereço de carteira:
pk=$(electrum getpubkeys 1JuiT4dM65d8vBt8qUYamnDmAMJ4MjjxRE| jq -r '.[0]')
Encriptar uma mensagem
Para encriptar uma mensagem:
cat | electrum encrypt $pk -
Desencriptar uma mensagem
Para desencriptar uma mensagem:
electrum decrypt $pk ?
Este comando pede-lhe para introduzir uma mensagem encriptada e, em seguida, pede a palavra-passe da sua carteira e desencripta a mensagem utilizando a sua chave privada.
Exportar chaves privadas e moedas de varrimento
Este guia explica como exportar chaves privadas de endereços financiados na sua carteira Electrum e usá-las para varrer 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, o objetivo é 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]