qusal/salt/sys-electrumx
Ben Grande 383c840f2f
doc: lint markdown files
Only way to have a unified markdown syntax is to enforce the wanted
syntax by linting the files. Don't rely on the many markdown syntaxes,
be consistent.
2024-07-04 17:27:31 +02:00
..
files feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01: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