#!/bin/bash # https://github.com/romanz/electrs/blob/master/doc/usage.md # command info if [ $# -eq 0 ] || [ "$1" = "-h" ] || [ "$1" = "-help" ]; then echo "config script to switch the Electrum Rust Server on or off" echo "bonus.electrs.sh [on|off|status|menu]" exit 1 fi source /mnt/hdd/raspiblitz.conf # give status if [ "$1" = "status" ]; then echo "##### STATUS ELECTRS SERVICE" if [ "${ElectRS}" = "on" ]; then echo "configured=1" else echo "configured=0" fi serviceInstalled=$(sudo systemctl status electrs --no-page 2>/dev/null | grep -c "electrs.service - Electrs") echo "serviceInstalled=${serviceInstalled}" if [ ${serviceInstalled} -eq 0 ]; then echo "infoSync='Service not installed'" fi serviceRunning=$(sudo systemctl status electrs --no-page 2>/dev/null | grep -c "active (running)") echo "serviceRunning=${serviceRunning}" if [ ${serviceRunning} -eq 0 ]; then echo "infoSync='Not running - check: sudo journalctl -u electrs'" fi if [ ${serviceRunning} -eq 1 ]; then # Experimental try to get sync Info syncedToBlock=$(sudo journalctl -u electrs --no-pager -n100 | grep "new headers from height" | tail -n 1 | cut -d " " -f 16 | sed 's/[^0-9]*//g') blockchainHeight=$(sudo -u bitcoin ${network}-cli getblockchaininfo 2>/dev/null | jq -r '.headers' | sed 's/[^0-9]*//g') if [ "${syncedToBlock}" = "${blockchainHeight}" ]; then echo "isSynced=1" else echo "isSynced=0" echo "infoSync='Syncing / Building Index (please wait)'" fi # check local IPv4 port localIP=$(ip addr | grep 'state UP' -A2 | tail -n1 | awk '{print $2}' | cut -f1 -d'/') echo "localIP='${localIP}'" echo "publicIP='${publicIP}'" echo "portTCP='50001'" localPortRunning=$(sudo netstat -a | grep -c '0.0.0.0:50001') echo "localTCPPortActive=${localPortRunning}" publicPortRunning=$(nc -z -w6 ${publicIP} 50001 2>/dev/null; echo $?) if [ "${publicPortRunning}" == "0" ]; then # OK looks good - but just means that somethingis answering on that port echo "publicTCPPortAnswering=1" else # no answere on that port echo "publicTCPPortAnswering=0" fi echo "portHTTPS='50002'" localPortRunning=$(sudo netstat -a | grep -c '0.0.0.0:50002') echo "localHTTPSPortActive=${localPortRunning}" publicPortRunning=$(nc -z -w6 ${publicIP} 50002 2>/dev/null; echo $?) if [ "${publicPortRunning}" == "0" ]; then # OK looks good - but just means that somethingis answering on that port echo "publicHTTPSPortAnswering=1" else # no answere on that port echo "publicHTTPSPortAnswering=0" fi # add TOR info if [ "${runBehindTor}" == "on" ]; then echo "TORrunning=1" TORaddress=$(sudo cat /mnt/hdd/tor/electrs/hostname) echo "TORaddress='${TORaddress}'" else echo "TORrunning=0" fi else echo "isSynced=0" fi exit 0 fi if [ "$1" = "menu" ]; then # get status echo "# collecting status info ... (please wait)" source <(sudo /home/admin/config.scripts/bonus.electrs.sh status) if [ ${serviceInstalled} -eq 0 ]; then echo "# FAIL not installed" exit 1 fi if [ ${serviceRunning} -eq 0 ]; then dialog --title "Electrum Service Not Running" --msgbox " The electrum system service is not running. Please check the following debug info. " 8 48 /home/admin/XXdebugInfo.sh echo "Press ENTER to get back to main menu." read key exit 0 fi if [ ${isSynced} -eq 0 ]; then dialog --title "Electrum Index Not Ready" --msgbox " Electrum server is still building its index. Please wait and try again later. This can take multiple hours. " 9 48 exit 0 fi # Options (available without TOR) OPTIONS=( \ CONNECT "How to Connect" \ INDEX "Delete/Rebuild Index" \ STATUS "ElectRS Status Info" ) CHOICE=$(whiptail --clear --title "Electrum Rust Server" --menu "menu" 10 50 4 "${OPTIONS[@]}" 2>&1 >/dev/tty) clear case $CHOICE in CONNECT) echo "######## How to Connect to Electrum Rust Server #######" echo echo "Install the Electrum Wallet App on your laptop from:" echo "https://electrum.org" echo echo "On Network Settings > Server menu:" echo "- deavtivate automatic server selection" echo "- as manual server set '${localIP}' & '${portHTTPS}'" echo "- laptop and RaspiBlitz need to be within same local network" echo echo "To start directly from laptop terminal use:" echo "electrum --oneserver --server ${localIP}:${portHTTPS}:s" if [ ${TORrunning} -eq 1 ]; then echo "" echo "The TOR Hidden Service address for electrs is (see LCD for QR code):" echo "${TORaddress}" echo echo "To connect through TOR open the Tor Browser and start with the options:" echo "electrum --oneserver --server=$TOR_ADDRESS:50002:s --proxy socks5:127.0.0.1:9150" /home/admin/config.scripts/blitz.lcd.sh qr "${TORaddress}" fi echo echo "For more details check the RaspiBlitz README on ElectRS:" echo "https://github.com/rootzoll/raspiblitz" echo echo "Press ENTER to get back to main menu." read key /home/admin/config.scripts/blitz.lcd.sh hide ;; STATUS) sudo /home/admin/config.scripts/bonus.electrs.sh status echo echo "Press ENTER to get back to main menu." read key ;; INDEX) echo "######## Delete/Rebuild Index ########" echo "# stopping service" sudo systemctl stop electrs echo "# deleting index" sudo rm -r /mnt/hdd/app-storage/electrs/db echo "# starting service" sudo systemctl start electrs echo "# ok" echo echo "Press ENTER to get back to main menu." read key ;; esac exit 0 fi # add default value to raspi config if needed if ! grep -Eq "^ElectRS=" /mnt/hdd/raspiblitz.conf; then echo "ElectRS=off" >> /mnt/hdd/raspiblitz.conf fi # stop service echo "making sure services are not running" sudo systemctl stop electrs 2>/dev/null # switch on if [ "$1" = "1" ] || [ "$1" = "on" ]; then echo "*** INSTALL ELECTRS ***" isInstalled=$(sudo ls /etc/systemd/system/electrs.service 2>/dev/null | grep -c 'electrs.service') if [ ${isInstalled} -eq 0 ]; then #cleanup sudo rm -f /home/electrs/.electrs/config.toml echo "" echo "***" echo "Creating the electrs user" echo "***" echo "" sudo adduser --disabled-password --gecos "" electrs cd /home/electrs echo "" echo "***" echo "Installing Rust" echo "***" echo "" sudo -u electrs curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sudo -u electrs sh -s -- --default-toolchain 1.39.0 -y # check Rust version with: $ sudo -u electrs /home/electrs/.cargo/bin/cargo --version # workaround to keep Rust at v1.37.0 # sudo -u electrs /home/electrs/.cargo/bin/rustup install 1.37.0 --force # sudo -u electrs /home/electrs/.cargo/bin/rustup override set 1.37.0 #source $HOME/.cargo/env sudo apt update sudo apt install -y clang cmake # for building 'rust-rocksdb' echo "" echo "***" echo "Downloading and building electrs. This will take ~30 minutes" # ~22 min on an Odroid XU4 echo "***" echo "" sudo -u electrs git clone https://github.com/romanz/electrs cd /home/electrs/electrs sudo -u electrs git reset --hard v0.8.0 sudo -u electrs /home/electrs/.cargo/bin/cargo build --release echo "" echo "***" echo "The electrs database will be built in /mnt/hdd/app-storage/electrs/db. Takes ~18 hours and ~50Gb diskspace" echo "***" echo "" # move old-database if present if [ -d "/mnt/hdd/electrs/db" ]; then echo "Moving existing ElectRS index to /mnt/hdd/app-storage/electrs..." sudo mv -f /mnt/hdd/electrs /mnt/hdd/app-storage/ fi sudo mkdir /mnt/hdd/app-storage/electrs 2>/dev/null sudo chown -R electrs:electrs /mnt/hdd/app-storage/electrs echo "" echo "***" echo "getting RPC credentials from the bitcoin.conf" echo "***" echo "" #echo "Type the PASSWORD B of your RaspiBlitz followed by [ENTER] (needed for Electrs to access the bitcoind RPC):" #read PASSWORD_B RPC_USER=$(sudo cat /mnt/hdd/bitcoin/bitcoin.conf | grep rpcuser | cut -c 9-) PASSWORD_B=$(sudo cat /mnt/hdd/bitcoin/bitcoin.conf | grep rpcpassword | cut -c 13-) echo "Done" echo "" echo "***" echo "generating electrs.toml setting file with the RPC passwords" echo "***" echo "" # generate setting file: https://github.com/romanz/electrs/issues/170#issuecomment-530080134 # https://github.com/romanz/electrs/blob/master/doc/usage.md#configuration-files-and-environment-variables sudo -u electrs mkdir /home/electrs/.electrs 2>/dev/null touch /home/admin/config.toml chmod 600 /home/admin/config.toml || exit 1 cat > /home/admin/config.toml </dev/null | grep -c 'upstream electrs') if [ ${isElectrs} -gt 0 ]; then echo "electrs is already configured with Nginx. To edit manually run \`sudo nano /etc/nginx/nginx.conf\`" elif [ ${isElectrs} -eq 0 ]; then isStream=$(sudo cat /etc/nginx/nginx.conf 2>/dev/null | grep -c 'stream {') if [ ${isStream} -eq 0 ]; then echo " stream { upstream electrs { server 127.0.0.1:50001; } server { listen 50002 ssl; proxy_pass electrs; ssl_certificate /etc/ssl/certs/localhost.crt; ssl_certificate_key /etc/ssl/private/localhost.key; ssl_session_cache shared:SSL-electrs:1m; ssl_session_timeout 4h; ssl_protocols TLSv1 TLSv1.1 TLSv1.2; ssl_prefer_server_ciphers on; } }" | sudo tee -a /etc/nginx/nginx.conf elif [ ${isStream} -eq 1 ]; then sudo truncate -s-2 /etc/nginx/nginx.conf echo " upstream electrs { server 127.0.0.1:50001; } server { listen 50002 ssl; proxy_pass electrs; ssl_certificate /etc/ssl/certs/localhost.crt; ssl_certificate_key /etc/ssl/private/localhost.key; ssl_session_cache shared:SSL-electrs:1m; ssl_session_timeout 4h; ssl_protocols TLSv1 TLSv1.1 TLSv1.2; ssl_prefer_server_ciphers on; } }" | sudo tee -a /etc/nginx/nginx.conf elif [ ${isStream} -gt 1 ]; then echo " Too many \`stream\` commands in nginx.conf. Please edit manually: \`sudo nano /etc/nginx/nginx.conf\` and retry" exit 1 fi fi echo "allow port 50002 on ufw" sudo ufw allow 50002 comment 'electrs-nginx SSL' sudo systemctl enable nginx sudo systemctl restart nginx echo "" echo "***" echo "Installing the systemd service" echo "***" echo "" # sudo nano /etc/systemd/system/electrs.service echo " [Unit] Description=Electrs After=bitcoind.service [Service] WorkingDirectory=/home/electrs/electrs ExecStart=/home/electrs/electrs/target/release/electrs --index-batch-size=10 --electrum-rpc-addr=\"0.0.0.0:50001\" User=electrs Group=electrs Type=simple KillMode=process TimeoutSec=60 Restart=always RestartSec=60 [Install] WantedBy=multi-user.target " | sudo tee -a /etc/systemd/system/electrs.service sudo systemctl enable electrs # manual start: # sudo -u electrs /home/electrs/.cargo/bin/cargo run --release -- --index-batch-size=10 --electrum-rpc-addr="0.0.0.0:50001" echo "" echo "***" echo "Starting ElectRS in the background" echo "***" echo "" else echo "ElectRS is already installed." fi # setting value in raspiblitz config sudo sed -i "s/^ElectRS=.*/ElectRS=on/g" /mnt/hdd/raspiblitz.conf # Hidden Service for electrs if Tor active if [ "${runBehindTor}" = "on" ]; then /home/admin/config.scripts/internet.hiddenservice.sh electrs 50002 50002 50001 50001 fi ## Enable BTCEXP_ADDRESS_API if BTC-RPC-Explorer is active # see /home/admin/config.scripts/bonus.electrsexplorer.sh # run every 10 min by _background.sh echo "" echo "# To connect through SSL from outside of the local network make sure the port 50002 is forwarded on the router" echo "" exit 0 fi # switch off if [ "$1" = "0" ] || [ "$1" = "off" ]; then # setting value in raspiblitz config sudo sed -i "s/^ElectRS=.*/ElectRS=off/g" /mnt/hdd/raspiblitz.conf isInstalled=$(sudo ls /etc/systemd/system/electrs.service 2>/dev/null | grep -c 'electrs.service') if [ ${isInstalled} -eq 1 ]; then echo "#*** REMOVING ELECTRS ***" sudo systemctl stop electrs sudo systemctl disable electrs sudo rm /etc/systemd/system/electrs.service sudo rm -rf /home/electrs/electrs sudo rm -rf /home/electrs/.cargo sudo rm -rf /home/electrs/.rustup sudo rm -rf /home/electrs/.profile if [ "$2" == "deleteindex" ]; then sudo rm -rf /mnt/hdd/app-storage/electrs/ fi echo "# OK ElectRS removed." ## Disable BTCEXP_ADDRESS_API if BTC-RPC-Explorer is active /home/admin/config.scripts/bonus.electrsexplorer.sh else echo "# ElectRS is not installed." fi exit 0 fi echo "FAIL - Unknown Parameter $1" exit 1