qusal/salt/sys-electrumx
Ben Grande bdd4c789c1
fix: avoid echo usage
Echo can interpret operand as an option and checking every variable to
be echoed is troublesome while with printf, if the format specifier is
present before the operand, printing as string can be enforced.
2024-08-06 18:15:24 +02:00
..
files fix: avoid echo usage 2024-08-06 18:15:24 +02:00
appmenus.sls fix: remove undesired appmenus from builder qubes 2024-06-04 13:54:48 +02:00
appmenus.top fix: remove undesired appmenus from builder qubes 2024-06-04 13:54:48 +02:00
clone.sls feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
clone.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
configure-builder.sls feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
configure-builder.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
configure-client.sls feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
configure-client.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
configure.sls feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
configure.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
create.sls fix: less menu items for bitcoin qubes 2024-02-18 17:08:30 +01:00
create.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
init.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
install-builder.sls fix: remove extraneous package repository updates 2024-03-18 17:51:36 +01:00
install-builder.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
install.sls fix: remove extraneous package repository updates 2024-03-18 17:51:36 +01:00
install.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
README.md doc: lint markdown files 2024-07-04 17:27:31 +02:00
version fix: generate RPM Specs for Qubes Builder V2 2024-06-21 17:00:06 +02:00

sys-electrumx

ElectrumX in Qubes OS.

Table of Contents

Description

Setup an offline Electrumx (Electrum Server) qube named "sys-electrumx", connected to your own full node running on "sys-bitcoin" to index the blockchain to allow for efficient query of the history of arbitrary addresses.

A disposable qube "disp-electrumx-builder" will be created, based on Whonix-Workstation, it will server to install and verify ElectrumX. After the verification succeeds, files are copied to the template "tpl-sys-electrumx". This method was chosen so the server can be always offline.

At least 200GB of disk space is required.

Installation

This formula depends on sys-bitcoin.

  • Top:
sudo qubesctl top.enable sys-electrumx
sudo qubesctl --targets=tpl-electrumx-builder,tpl-sys-electrumx,disp-electrumx-builder,sys-electrumx state.apply
sudo qubesctl top.disable sys-electrumx
sudo qubesctl state.apply sys-electrumx.appmenus
  • State:
sudo qubesctl state.apply sys-electrumx.create
sudo qubesctl --skip-dom0 --targets=tpl-electrumx-builder state.apply sys-electrumx.install-builder
sudo qubesctl --skip-dom0 --targets=tpl-sys-electrumx state.apply sys-electrumx.install
sudo qubesctl --skip-dom0 --targets=disp-electrumx-builder state.apply sys-electrumx.configure-builder
sudo qubesctl --skip-dom0 --targets=sys-electrumx state.apply sys-electrumx.configure
sudo qubesctl state.apply sys-electrumx.appmenus

Usage

You may customize ElectrumX by writing to the file ~/.electrumx/conf.d/electrumx.conf.local.

If you are not using sys-bitcoin, you will need to add the RPC Authentication cookie to the qube sys-electrumx in the file ~/.bitcoin/.cookie. Make sure there is no new line at the end of the cookie file, else ElectrumX will fail to start.

You may want to use the command electrumx-cli to send commands to the ElectrumX server.

Credits