qusal/salt/sys-electrumx
Ben Grande f9ead06408 fix: remove extraneous package repository updates
Updates happens multiple times, normally 2 to 3, even if we consider a
state without includes. On states with multiple includes, it could
easily get approximately 10 updates being ran. This behavior leads to
unnecessary network bandwidth being spent and more time to run the
installation state. When the connection is slow and not using the
cacher, such as torified connections on Whonix, the installation can
occurs much faster.

Adding external repositories has to be done prior to update to ensure it
is also fetched.

Fixes: https://github.com/ben-grande/qusal/issues/29
2024-03-18 17:51:36 +01:00
..
files feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01: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: prefix qubesctl with sudo 2024-02-23 16:55:11 +01: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
  • 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

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