RaspiBlitz

https://docs.raspiblitz.org/
Admin
RaspiBlitz is an open-source DIY project that enables you to run a full Bitcoin node and Lightning...
Tokens:28,468
Snippets:460
Trust Score:7.8
Update:6 months ago
Show doc for...
Tokens:
Raw
### WIF Output Example

Source: https://docs.raspiblitz.org/docs/faq/cl

Example of the converted WIF private key.

```text
KwFvTne98E1t3mTNAr8pKx67eUzFJWdSNPqPSfxMEtrueW7PcQzL  
```

--------------------------------

### Install Core Lightning Summary Plugin

Source: https://docs.raspiblitz.org/docs/faq/cl

Install and show the output of the summary plugin for Core Lightning. Can be run once or persistently for a specified network.

```bash
cl-plugin.summary.sh [testnet|mainnet|signet] [runonce]
```

--------------------------------

### Install Core-Lightning-REST

Source: https://docs.raspiblitz.org/docs/faq/cl

Core-Lightning-REST install script for managing REST API instances. Supports enabling/disabling, connecting, and configuring instances for different networks.

```bash
cl.rest.sh [on|off|connect] <mainnet|testnet|signet> [?key-value]
```

--------------------------------

### Start VNC Server

Source: https://docs.raspiblitz.org/docs/faq

Start the VNC server. By default, it runs on display number 1. You can specify a different display number if needed.

```bash
vncserver
```

```bash
vncserver :<display-number>
```

--------------------------------

### Manage Core Lightning Installation

Source: https://docs.raspiblitz.org/docs/faq/cl

Core Lightning install script for managing installations, updates, and displaying seeds. Supports installing, starting/stopping instances, updating to specific versions or PRs, and showing seeds.

```bash
cl.install.sh install
```

```bash
cl.install.sh on <mainnet|testnet|signet>
```

```bash
cl.install.sh off <mainnet|testnet|signet> <purge>
```

```bash
cl.install.sh [update <version>|testPR <PRnumber>]
```

```bash
cl.install.sh display-seed <mainnet|testnet|signet>
```

--------------------------------

### Build Minimal RaspiBlitz SD Card Image

Source: https://docs.raspiblitz.org/docs/faq/dev

Downloads and executes the build script for a headless RaspiBlitz installation. Replace `[BRANCH]` with the desired release branch. The `-f 0` flag indicates no initial setup.

```bash
wget --no-cache https://raw.githubusercontent.com/raspiblitz/raspiblitz/[BRANCH]/build_sdcard.sh && sudo bash build_sdcard.sh -u raspiblitz -b [BRANCH] -f 0 -d headless
```

--------------------------------

### Install Spark Wallet for Core Lightning

Source: https://docs.raspiblitz.org/docs/faq/cl

Install, remove, or get information about the Spark Wallet for Core Lightning. This script manages the Spark Wallet plugin.

```bash
./cl.spark.sh -h
```

--------------------------------

### Manage Sparko Core Lightning Plugin

Source: https://docs.raspiblitz.org/docs/faq/cl

Install, remove, connect, or get information about the Sparko plugin for Core Lightning. Supports specifying the network and whether to restart.

```bash
cl-plugin.sparko.sh [on|off|menu|connect] [testnet|mainnet|signet] [norestart]
```

--------------------------------

### Manage CLBOSS Core Lightning Plugin

Source: https://docs.raspiblitz.org/docs/faq/cl

Install or remove the CLBOSS Core Lightning plugin. Provides options to turn it on/off or get information about its status.

```bash
cl-plugin.clboss.sh [on|off] [testnet|mainnet|signet]
```

```bash
cl-plugin.clboss.sh [info]
```

--------------------------------

### Install Standard Python Plugins for Core Lightning

Source: https://docs.raspiblitz.org/docs/faq/cl

Install and show output for specified Python plugins for Core Lightning. Supports 'runonce' or persistent modes and requires network selection.

```bash
cl-plugin.standard-python.sh on [plugin-name] <testnet|mainnet|signet> <persist|runonce>
```

--------------------------------

### Execute Packer Build

Source: https://docs.raspiblitz.org/docs/faq/dev

Starts the image build process with required architecture and packaging parameters.

```bash
sudo bash ./packer.sh
```

--------------------------------

### Install Feeadjuster Plugin

Source: https://docs.raspiblitz.org/docs/faq/cl

Installs the Feeadjuster plugin on your node. This is the first step before configuring its settings.

```bash
config.scripts/cl-plugin.feeadjuster.sh on

```

--------------------------------

### Electrum Import Prefix

Source: https://docs.raspiblitz.org/docs/faq/cl

Example of the formatted string required for Electrum import.

```text
p2wpkh:KxacygL6usxP8T9cFSM2SRW5QsEg66bUQUEn997UWwCZANEe7NLT  
```

--------------------------------

### Example Node Check for Onchain Liquidity

Source: https://docs.raspiblitz.org/docs/faq/cl

An example of checking a specific node's details to determine if it offers on-chain liquidity for dual-funded channels.

```bash
lightning-cli listnodes 02cca6c5c966fcf61d121e3a70e03a1cd9eeeea024b26ea666ce974d43b242e636  

```

--------------------------------

### Install Rust Teos Watchtower Client Plugin

Source: https://docs.raspiblitz.org/docs/faq/cl

Install the rust-teos watchtower-client plugin for CLN. Supports enabling/disabling the plugin, purging it, and checking its info.

```bash
cl-plugin.watchtower-client.sh on <testnet|mainnet|signet>
```

```bash
cl-plugin.watchtower-client.sh off <testnet|mainnet|signet> <purge>
```

```bash
cl-plugin.watchtower-client.sh info
```

--------------------------------

### Prepare SD Card for Manual Provisioning (Raspberry Pi)

Source: https://docs.raspiblitz.org/docs/faq/dev

Create a 'stop' file on the root of the boot partition of an SD card. This flag prevents the `_bootstrap.sh` script from making automatic setup changes, allowing for manual SSH provisioning.

```bash
# Create an empty file named 'stop' on the bootfs drive
touch stop

```

--------------------------------

### Start or Restart CLN Plugin

Source: https://docs.raspiblitz.org/docs/faq/cl

Commands to manually start a plugin or restart the daemon to load plugins from the enabled directory.

```bash
lightning-cli plugin start /home/bitcoin/cl-plugins-enabled/PLUGIN_NAME  
```

```bash
sudo systemctl restart lightningd  
```

--------------------------------

### Install Core Lightning Systemd Service

Source: https://docs.raspiblitz.org/docs/faq/cl

Sets up or updates the Core Lightning systemd service. Ensure you specify the correct network (mainnet, testnet, or signet).

```bash
/home/admin/config.scripts/cl.install-service.sh <mainnet|testnet|signet>
```

--------------------------------

### Install Recovery File

Source: https://docs.raspiblitz.org/docs/faq/cl

Moves the recovery file to the lightning directory and sets correct ownership.

```bash
sudo cp /home/admin/emergency.recover /home/bitcoin/.lightning/bitcoin/  
sudo chown bitcoin:bitcoin /home/bitcoin/.lightning/bitcoin/emergency.recover  
```

--------------------------------

### Install Core Lightning Fee Adjuster Plugin

Source: https://docs.raspiblitz.org/docs/faq/cl

Install the feeadjuster plugin for Core Lightning. This script allows enabling or disabling the plugin for a specified network.

```bash
cl-plugin.feeadjuster.sh [on|off] <testnet|mainnet|signet>
```

--------------------------------

### Template for Adding a New App

Source: https://docs.raspiblitz.org/docs/faq/dev

Use the bonus.template.sh script as a guide to create and adapt your own application for inclusion in RaspiBlitz. Fork the repo, copy/adapt the template, test, and submit a PR.

```bash
# Reference to the template script
/home/admin/config.scripts/bonus.template.sh

```

--------------------------------

### Manage c-lightning-http-plugin

Source: https://docs.raspiblitz.org/docs/faq/cl

Install, remove, or connect the c-lightning-http-plugin. This plugin is implemented for mainnet only and can be controlled with or without restarting the service.

```bash
cl-plugin.http.sh [on|off|connect] <norestart>
```

--------------------------------

### Build RaspiBlitz on Debian

Source: https://docs.raspiblitz.org/docs/faq/dev

Command to download and execute the build script on a fresh Debian installation.

```bash
wget --no-cache https://raw.githubusercontent.com/raspiblitz/raspiblitz/dev/build_sdcard.sh && bash build_sdcard.sh -u raspiblitz -b dev -f 0 -d headless
```

--------------------------------

### Feeadjuster Configuration Options

Source: https://docs.raspiblitz.org/docs/faq/cl

Example settings for the Feeadjuster plugin, demonstrating various parameters like base fee, per-satoshi fee, imbalance thresholds, and adjustment methods.

```ini
fee-base=0  
fee-per-satoshi=200  
feeadjuster-imbalance=0.2  
feeadjuster-threshold=0.10  
feeadjuster-threshold-abs=0.01btc  
feeadjuster-enough-liquidity=1000000000msat  
feeadjuster-deactivate-fee-update  
feeadjuster-adjustment-method=hard  

```

--------------------------------

### Start Feeadjuster Plugin

Source: https://docs.raspiblitz.org/docs/faq/cl

Manually starts the Feeadjuster Python script as a CLN plugin. It's recommended to run this periodically rather than continuously.

```bash
cl plugin start /home/bitcoin/cl-plugins-available/plugins/feeadjuster/feeadjuster.py  

```

--------------------------------

### Check CLBOSS Version

Source: https://docs.raspiblitz.org/docs/faq/cl

Use this command to verify the installed version of the CLBOSS plugin.

```bash
/home/bitcoin/cl-plugins-enabled/clboss --version  

```

--------------------------------

### Manage Core Lightning Backup Plugin

Source: https://docs.raspiblitz.org/docs/faq/cl

Install, remove, or restore the backup plugin for Core Lightning, which replicates the lightningd.sqlite3 database. Supports compact backups.

```bash
cl-plugin.backup.sh [on|off] [testnet|mainnet|signet]
```

```bash
cl-plugin.backup.sh [restore] [testnet|mainnet|signet] [force]
```

```bash
cl-plugin.backup.sh [backup-compact] [testnet|mainnet|signet]
```

--------------------------------

### Recovery Output Format

Source: https://docs.raspiblitz.org/docs/faq/cl

Example of the JSON output returned upon successful recovery.

```json
{  
   "stubs": [  
      "................",  
   ]  
}  
```

--------------------------------

### Configure Liquidity Ad Settings

Source: https://docs.raspiblitz.org/docs/faq/cl

Example configuration block for dual-funded channels, specifying funder policy, lease fees, and channel fee limits. These settings are added to the CLN configuration file.

```ini
experimental-dual-fund  
funder-policy=match  
funder-policy-mod=100  
lease-fee-base-msat=500sat  
lease-fee-basis=50  
channel-fee-max-base-msat=100sat  
channel-fee-max-proportional-thousandths=2  

```

--------------------------------

### Core Lightning Update Utility

Source: https://docs.raspiblitz.org/docs/faq/cl

Manages interim Core Lightning updates with options for verified or reckless installation.

```bash
./cl.update.sh -h
```

```bash
cl.update.sh [info|verified|reckless]
```

--------------------------------

### Set Liquidity Ad Policy

Source: https://docs.raspiblitz.org/docs/faq/cl

Configures a liquidity ad policy for dual-funded channels using the `funderupdate` command. This example sets a 'match' policy with a modification of 100.

```bash
lightning-cli funderupdate -k policy=match policy_mod=100  

```

--------------------------------

### HSM Tool Error Output

Source: https://docs.raspiblitz.org/docs/faq/cl

Example output when the recovery attempt fails.

```text
Could not find any basepoint matching the provided witness programme.  
Are you sure that the channel used `option_static_remotekey` ?  
*** stack smashing detected ***: terminated  
Aborted  
```

--------------------------------

### HSM Tool Success Output

Source: https://docs.raspiblitz.org/docs/faq/cl

Example output when the recovery attempt succeeds, providing the private key.

```text
bech32      : bc1q......................................  
pubkey hash : 0123456789abcdef0123456789abcdef01234567  
pubkey      : 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef01  
privkey     : 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef  
```

--------------------------------

### Generate Let's Encrypt Certificate via DNS-01 with DuckDNS

Source: https://docs.raspiblitz.org/docs/faq

This command generates a TLS certificate using the DNS-01 challenge, which is useful for wildcard certificates. It requires interaction with your DNS provider. The example uses DuckDNS and includes setting the necessary environment variable for the token.

```bash
export DuckDNS_Token="abcdefgh-0123-56ij-78kl-abcd9012efgh"
~/.acme.sh/acme.sh --issue --keylength ec-256 --dns dns_duckdns -d hostname.duckdns.org -d *.hostname.duckdns.org
```

--------------------------------

### Configure VM for Manual Provisioning (Proxmox)

Source: https://docs.raspiblitz.org/docs/faq/dev

Add an emulated audio device (with driver=none) to a VM. This action halts the RaspiBlitz bootstrap process, enabling manual SSH provisioning for updated code.

```bash
# Example of adding an audio device in Proxmox VM hardware settings
# Choose any basic emulated audio device, set driver=none

```

--------------------------------

### Create a Reusable Offer for LN Tips

Source: https://docs.raspiblitz.org/docs/faq/cl

Generate a reusable offer that accepts any amount, suitable for receiving Lightning Network tips. This command creates a simple, flexible offer.

```bash
lightning-cli offer any tip
```

--------------------------------

### Fund a Channel with Own Funds

Source: https://docs.raspiblitz.org/docs/faq/cl

Use this command to open a channel by contributing your own funds. Amounts can be specified in sat or btc. It may fail if the offer changes or funds are insufficient.

```bash
lightning-cli fundchannel -k id=NODE_ID amount=OWN_AMOUNTsat request_amt=PEER_CONTRIBUTION_AMOUNTsat compact_lease=COMPACT_LEASE
```

--------------------------------

### CLI Configuration Options

Source: https://docs.raspiblitz.org/docs/faq/cl

A comprehensive list of command-line arguments for configuring network, logging, and Bitcoin daemon connectivity.

```APIDOC
## CLI Configuration Options

### Description
These flags are used to configure the node's behavior, including network connectivity, logging levels, and integration with the Bitcoin daemon.

### Parameters
- **--addr** (string) - Set an IP address (v4 or v6) to listen on and announce.
- **--bind-addr** (string) - Set an IP address to listen on, but not announce.
- **--announce-addr** (string) - Set an IP address or .onion v3 to announce, but not listen on.
- **--disable-ip-discovery** (flag) - Turn off announcement of discovered public IPs.
- **--offline** (flag) - Start in offline-mode.
- **--autolisten** (boolean) - Listen on default port and announce if public interface (default: true).
- **--proxy** (string) - Set a socks v5 proxy IP address and port.
- **--log-level** (string) - Set log level (io, debug, info, unusual, broken) (default: info).
- **--bitcoin-rpcuser** (string) - bitcoind RPC username.
- **--bitcoin-rpcpassword** (string) - bitcoind RPC password.
- **--bitcoin-rpcconnect** (string) - bitcoind RPC host to connect to.
- **--bitcoin-rpcport** (string) - bitcoind RPC host's port.
```

--------------------------------

### Check Advertised Node Settings

Source: https://docs.raspiblitz.org/docs/faq/cl

Fetches your node's information and displays it, including any advertised features like 'option_will_fund'. This can take a few minutes to update after configuration changes.

```bash
lightning-cli listnodes $(lightning-cli getinfo | jq .id)  

```

--------------------------------

### Fund a Dual-Funded Channel with UTXO

Source: https://docs.raspiblitz.org/docs/faq/cl

Open a dual-funded channel using a specific UTXO and miner feerate. List available UTXOs with `lightning-cli listfunds`. The feerate is in perkb by default.

```bash
lightning-cli fundchannel feerate=PERKB_FEERATE utxos='["TRANSACTION_ID:INDEX_NUMBER"]' -k id=NODE_ID amount=OWN_AMOUNTsat request_amt=PEER_CONTRIBUTION_AMOUNTsat compact_lease=COMPACT_LEASE
```

--------------------------------

### Toggle Spark and Network Configuration

Source: https://docs.raspiblitz.org/docs/faq/cl

Configures the Spark interface and network settings for Core Lightning.

```bash
cl.spark.sh [on|off|menu] <testnet|mainnet|signet>
```

--------------------------------

### Handle CLN Database Migration Errors

Source: https://docs.raspiblitz.org/docs/faq/cl

Example of a journalctl error message indicating a database version mismatch during a downgrade attempt.

```text
Refusing to migrate down from version 178 to 176  
```

--------------------------------

### Get SSH Hidden Service Address

Source: https://docs.raspiblitz.org/docs/faq

This command retrieves the .onion address for your SSH hidden service. You will need this address to connect to your RaspiBlitz over Tor.

```bash
sudo cat /mnt/hdd/tor/ssh/hostname
```

--------------------------------

### Configure WiFi via SD Card

Source: https://docs.raspiblitz.org/docs/faq

Create a file named 'wifi' in the root directory of the SD card with the SSID on the first line and the password on the second line.

```text
YourWiFiSSID  
YourWiFiPassword  

```

--------------------------------

### Manage CLN gRPC Plugin

Source: https://docs.raspiblitz.org/docs/faq/cl

Install, manage, or update the cln-grpc plugin for CLN. Supports turning the plugin on/off, checking status, and updating from a specified source.

```bash
cl-plugin.cln-grpc.sh install
```

```bash
cl-plugin.cln-grpc.sh on <testnet|mainnet|signet>
```

```bash
cl-plugin.cln-grpc.sh off <testnet|mainnet|signet> <purge>
```

```bash
cl-plugin.cln-grpc.sh status <testnet|mainnet|signet>
```

```bash
cl-plugin.cln-grpc.sh update <source>
```

--------------------------------

### Update CLN Software

Source: https://docs.raspiblitz.org/docs/faq/cl

Commands to update the CLN installation to the latest master branch. Note that experimental updates may not persist across SD card reflashes.

```bash
config.scripts/cl.install.sh update  
```

--------------------------------

### Import GPG public key for authenticity verification

Source: https://docs.raspiblitz.org/docs/faq

Imports the lead developer's public key from the keyserver to enable signature verification.

```bash
curl --tlsv1.2 --proto '=https' https://keys.openpgp.org/vks/v1/by-fingerprint/92A746AE33A3C186D014BF5C1C73060C7C176461 | gpg --import  
```

--------------------------------

### Enable VNC Server on RaspiBlitz

Source: https://docs.raspiblitz.org/docs/faq

Use raspi-config to enable the VNC server. This is the initial step for remote graphical access.

```bash
sudo raspi-config
```

--------------------------------

### Get Latest RaspiBlitz Version Tag

Source: https://docs.raspiblitz.org/docs/security

Use this command to fetch the tag name of the latest RaspiBlitz release from GitHub. Ensure you are running the latest version for security updates.

```bash
curl -s https://api.github.com/repos/rootzoll/raspiblitz/releases/latest|grep tag_name|head -1|cut -d '"' -f4  

```

--------------------------------

### Generate Help Documentation for Scripts

Source: https://docs.raspiblitz.org/docs/faq/cl

Automated process to list all CLN-related scripts and output their help text to the console.

```bash
cd /home/admin/config.scripts/  
ls cl*.sh > clScriptList.txt  
sed -i 's#^#./#g' clScriptList.txt  
sed -i 's#.sh#.sh -h#g' clScriptList.txt  
bash -x clScriptList.txt  
rm clScriptList.txt  
```

--------------------------------

### Create SSH Hidden Service

Source: https://docs.raspiblitz.org/docs/faq

This script command sets up a Tor hidden service for SSH access, allowing you to connect to your RaspiBlitz remotely and anonymously. Ensure you have Tor installed and configured.

```bash
bash /home/admin/config.scripts/tor.onion-service.sh ssh 22 22
```

--------------------------------

### Set Initial User Configuration for SSH

Source: https://docs.raspiblitz.org/docs/faq/dev

Creates a user configuration file with a pre-defined password hash for the 'pi' user. This allows for password-based SSH login with a specific password.

```bash
echo "pi:\$6\$TE7HmruYY9EaNiKP\$Vz0inJ6gaoJgJvQrC5z/HMDRMTN2jKhiEnG83tc1Jsw7lli5MYdeA83g3NOVCsBaTVW4mUBiT/1ZRWYdofVQX0" > userconf
```

--------------------------------

### Import GPG Signing Key

Source: https://docs.raspiblitz.org/docs/faq/dev

Imports a GPG public key from a local file. This key is used to verify the authenticity of signed files.

```bash
gpg --import ./sub.key
```

--------------------------------

### Signet Configuration Aliases

Source: https://docs.raspiblitz.org/docs/faq/cl

Configuration details for the signet environment, including command aliases, daemon service name, config file path, and plugin directory.

```bash
# aliases:
 scl | sclconf | scllog

# daemon service name:
 slightningd

# config file:
/home/bitcoin/.lightningd/signet/config

# plugin directory:
/home/bitcoin/scl-plugins-enabled

```

--------------------------------

### Setup Multiple SSH Tunnels for Port Forwarding on RaspiBlitz

Source: https://docs.raspiblitz.org/docs/faq

Configure multiple port forwardings simultaneously by listing them in the command. This allows for forwarding several internal ports to external ports on the public server.

```bash
/home/admin/config.scripts/internet.sshtunnel.py on test@raspiblitz.com "10009<20009" "8080<9090"
```

--------------------------------

### Setup SSH Tunnel for Port Forwarding on RaspiBlitz

Source: https://docs.raspiblitz.org/docs/faq

Use this command on RaspiBlitz to forward internal ports to external ports on a public server via an SSH tunnel. Requires prior SSH server configuration.

```bash
/home/admin/config.scripts/internet.sshtunnel.py on test@raspiblitz.com "10009<20009"
```

--------------------------------

### Convert qcow2 image to vdi format

Source: https://docs.raspiblitz.org/docs/faq/dev

Use this command to convert the downloaded qcow2 image into a VirtualBox-compatible vdi file.

```bash
qemu-img convert -f qcow2 raspiblitz-amd64-debian-lean.qcow2 -O vdi raspiblitz-amd64-debian-lean.vdi
```

--------------------------------

### Export LND Data on RaspiBlitz

Source: https://docs.raspiblitz.org/docs/faq

Use this script to export all LND data, including funds and channels, from a RaspiBlitz. This is useful for migrating or recovering data to a fresh installation. Ensure you are SSH'd into the RaspiBlitz and have exited to the terminal.

```bash
/home/admin/config.scripts/lnd.backup.sh lnd-export-gui
```

--------------------------------

### Configure VNC Authentication

Source: https://docs.raspiblitz.org/docs/faq

Set the Authentication parameter for the VNC server to VncAuth by creating a configuration file.

```bash
sudo echo "Authentication=VncAuth" > /etc/vnc/config.d/common.custom
```

--------------------------------

### Import PGP Key for Rootzoll

Source: https://docs.raspiblitz.org/docs/security

Import the PGP public key for Rootzoll to verify signed commits and tags. This is crucial for ensuring the integrity of downloaded source code.

```bash
curl https://keybase.io/rootzoll/pgp_keys.asc | gpg --import  

```

--------------------------------

### Import LND Data to RaspiBlitz

Source: https://docs.raspiblitz.org/docs/faq

This script is used to import previously exported LND data (funds and channels) onto a new RaspiBlitz installation. Follow the script's instructions to transfer the `lnd-rescue` file and restore your node's state. Be aware of potential risks if the backup is not recent.

```bash
/home/admin/config.scripts/lnd.backup.sh lnd-import-gui
```

--------------------------------

### Connect to a Node

Source: https://docs.raspiblitz.org/docs/faq/cl

Establishes a connection to a specified node using its node ID and IP address or onion address. This is a prerequisite for opening a channel.

```bash
lightning-cli connect nodeID@IP_or.onion  

```

--------------------------------

### Configure Torrent Trackers

Source: https://docs.raspiblitz.org/docs/faq/dev

List of recommended UDP and HTTP trackers for seeding RaspiBlitz image files.

```text
udp://tracker.coppersurfer.tk:6969/announce  
http://tracker.yoshi210.com:6969/announce  
http://open.acgtracker.com:1096/announce  
http://tracker.skyts.net:6969/announce  
udp://9.rarbg.me:2780/announce  
http://tracker2.itzmx.com:6961/announce  
udp://exodus.desync.com:6969/announce  
http://pow7.com:80/announce  
udp://tracker.leechers-paradise.org:6969  
```

--------------------------------

### Feeadjuster Initialization Log

Source: https://docs.raspiblitz.org/docs/faq/cl

This log output shows the Feeadjuster plugin's initialization parameters, including base and PPM fees, imbalance thresholds, and the adjustment method being used.

```log
plugin-feeadjuster.py:  
Plugin feeadjuster initialized (0 base / 200 ppm) with an imbalance of 20%/80%,  
update_threshold: 10%, update_threshold_abs: 1000000000msat,  
enough_liquidity: 1000000000msat, deactivate_fuzz: None,  
forward_event_subscription: False, adjustment_method: get_ratio_hard,  
fee_strategy: get_fees_global, listchannels_by_dst: True  

```

--------------------------------

### Testnet Configuration Aliases

Source: https://docs.raspiblitz.org/docs/faq/cl

Configuration details for the testnet environment, including command aliases, daemon service name, config file path, and plugin directory.

```bash
# alias:
 tcl | tclconf | tcllog

# daemon service name:
 tlightningd

# config file:
/home/bitcoin/.lightningd/testnet/config

# plugin directory:
/home/bitcoin/tcl-plugins-enabled

```

--------------------------------

### lightningd Configuration

Source: https://docs.raspiblitz.org/docs/faq/cl

Overview of the configuration options for the lightningd daemon. These can be passed as command-line arguments or placed in a configuration file.

```APIDOC
## lightningd Configuration Options

### Description
This documentation covers the configuration parameters for the lightningd daemon. Options can be set via command-line arguments (prefixed with --) or in a configuration file (without the -- prefix).

### Parameters
#### Configuration Options
- **conf** (file) - Optional - Specify configuration file
- **lightning-dir** (dir) - Optional - Set base directory (default: "/home/admin/.lightning")
- **network** (string) - Optional - Select network (bitcoin, testnet, signet, regtest, litecoin, litecoin-testnet) (default: bitcoin)
- **rpc-file** (string) - Optional - Set JSON-RPC socket (default: "lightning-rpc")
- **plugin** (string) - Optional - Add a plugin to be run (can be used multiple times)
- **daemon** (boolean) - Optional - Run in the background, suppress stdout/stderr
- **alias** (string) - Optional - Up to 32-byte alias for node
- **rgb** (string) - Optional - RRGGBB hex color for node
- **wumbo** (boolean) - Optional - Allow channels larger than 0.16777215 BTC
- **funding-confirms** (integer) - Optional - Confirmations required for funding transaction (default: 3)
- **fee-base** (integer) - Optional - Millisatoshi minimum to charge for HTLC (default: 1000)
- **max-concurrent-htlcs** (integer) - Optional - Number of HTLCs one channel can handle concurrently (default: 30)
```

--------------------------------

### Shrink Raspberry Pi Image and Compress

Source: https://docs.raspiblitz.org/docs/faq/dev

Makes the pishrink.sh script executable and then uses it to shrink the raspiblitz.img file. The shrunk image is then compressed using gzip.

```bash
chmod +x ./pishrink.sh | sudo ./pishrink.sh ./raspiblitz.img
gzip -c ./raspiblitz.img > ./raspiblitz-min/fat-vX.X.X-YEAR-MONTH-DAY.img.gz
```

--------------------------------

### List Invoices to Check for Re-use

Source: https://docs.raspiblitz.org/docs/faq/cl

Check for new invoices or track the re-use of offers. The `pay_index` will increase as an offer is reused.

```bash
lightning-cli listinvoices
```

--------------------------------

### Switch Display Output via Console

Source: https://docs.raspiblitz.org/docs/faq

Use these commands in the terminal to toggle between HDMI and LCD output.

```bash
hdmi
```

```bash
lcd
```

--------------------------------

### Enable SSH Access on Boot Partition

Source: https://docs.raspiblitz.org/docs/faq/dev

Creates an empty file named 'ssh' in the root of the boot partition. This action signals the Raspberry Pi to enable SSH access on the next boot.

```bash
touch ssh
```

--------------------------------

### Convert Private Key to WIF

Source: https://docs.raspiblitz.org/docs/faq/cl

Uses bitcoin-tool to convert the recovered hex private key to WIF format for Electrum.

```bash
git clone https://github.com/matja/bitcoin-tool  
cd bitcoin-tool  
make test  
  
./bitcoin-tool \  
 --network bitcoin \  
 --input-type private-key \  
 --input-format hex \  
 --input PASTE_THE_privkey_HERE \  
 --output-type private-key-wif \  
 --output-format base58check \  
 --public-key-compression compressed  
```

--------------------------------

### Check Emergency Recovery Help

Source: https://docs.raspiblitz.org/docs/faq/cl

Displays the help menu for the emergency recovery command.

```bash
lightning-cli help emergencyrecover  
```

--------------------------------

### Restart VNC Server

Source: https://docs.raspiblitz.org/docs/faq

Restart the VNC server to apply the new configuration settings.

```bash
sudo systemctl restart vncserver-x11-serviced
```

--------------------------------

### Turn on Geekworm/Suptronics X708 UPS HAT script

Source: https://docs.raspiblitz.org/docs/faq

Use this command to enable the script for the Geekworm/Suptronics X708 UPS HAT. The tested model was x708v1.2.

```bash
/home/admin/config.scripts/blitz.ups.sh on x708
```

--------------------------------

### List Nodes with Funding Offers

Source: https://docs.raspiblitz.org/docs/faq/cl

Lists all nodes known in the network graph that have active offers to participate in dual-funded channels. The output is filtered to show relevant information.

```bash
lightning-cli listnodes | grep option_will_fund -B20 -A7  

```

--------------------------------

### Configure Custom Plugin Permissions

Source: https://docs.raspiblitz.org/docs/faq/cl

Set the correct ownership and execution permissions for a custom plugin file.

```bash
sudo chown bitcoin:bitcoin /home/bitcoin/cl-plugins-enabled/PLUGIN_NAME  
sudo chmod +x /home/bitcoin/cl-plugins-enabled/PLUGIN_NAME  
```

--------------------------------

### Open Multiple Dual-Funded Channels

Source: https://docs.raspiblitz.org/docs/faq/cl

Initiate multiple dual-funded channels simultaneously using a JSON array of node IDs and amounts, along with a specified feerate. The output includes transaction details and channel IDs.

```bash
lightning-cli multifundchannel '[  
    {  
        "id": "nodeID1",  
        "amount": "amount_in_sats"  
    },  
    {  
        "id": "nodeID2",  
        "amount": "amount_in_sats"  
    },  
    {  
        "id": "nodeID3",  
        "amount": "amount_in_sats"  
    },  
    {  
        "id": "nodeID4",  
        "amount": "amount_in_sats",  
    }  
]' 1000perkb  
```

```json
{
    "tx": "RAW............TX",
    "txid": "TX................ID",
    "channel_ids": [
        {
            "id": "nodeID1",
            "channel_id": "CHANNEL_ID2",
            "outnum": 3
        },
        {
            "id": "nodeID2",
            "channel_id": "CHANNEL_ID1",
            "outnum": 4
        },
        {
            "id": "nodeID3",
            "channel_id": "CHANNEL_ID4",
            "outnum": 1
        },
        {
            "id": "nodeID4",
            "channel_id": "CHANNEL_ID3",
            "outnum": 2
        }
    ],
    "failed": []
}

```

--------------------------------

### Monitor Core Lightning Network

Source: https://docs.raspiblitz.org/docs/faq/cl

Monitor and troubleshoot the c-lightning network status, configuration, info, and wallet details for a specified network.

```bash
cl.monitor.sh [mainnet|testnet|signet] status
```

```bash
cl.monitor.sh [mainnet|testnet|signet] config
```

```bash
cl.monitor.sh [mainnet|testnet|signet] info
```

```bash
cl.monitor.sh [mainnet|testnet|signet] wallet
```

--------------------------------

### Generate Let's Encrypt Certificate via HTTP-01

Source: https://docs.raspiblitz.org/docs/faq

This command initiates the creation of a TLS certificate using the HTTP-01 challenge. Your RaspiBlitz must be accessible from the internet on port 80. This command also handles regular certificate renewals.

```bash
~/.acme.sh/acme.sh --keylength ec-256 --issue -d hostname.example.com -w /var/www/letsencrypt/
```

--------------------------------

### Test a Pull Request on RaspiBlitz

Source: https://docs.raspiblitz.org/docs/faq/dev

Use the 'github' command to select the 'PR' option, enter the pull request number, and sync your scripts to the PR's state for testing. Remember to switch back to 'dev' or the latest release branch when finished.

```bash
github
# Select PR and enter issue number
# ... testing ...
github
# Change BRANCH back to dev or latest release

```

--------------------------------

### Verify SD card image integrity with SHA256

Source: https://docs.raspiblitz.org/docs/faq

Use this command to check that the downloaded file matches the expected hash.

```bash
shasum -a 256 [DOWNLOADED-FILE-TO-CHECK]  
```

--------------------------------

### Query Node Funds and Peers

Source: https://docs.raspiblitz.org/docs/faq/cl

Lists current funds and active peers.

```bash
lightning-cli listfunds  
lightning-cli listpeers  
```

--------------------------------

### Create Stop File on Boot Partition

Source: https://docs.raspiblitz.org/docs/faq/dev

Creates an empty file named 'stop' in the root of the boot partition. This is used to signal a specific state or halt further automated processes on the Raspberry Pi.

```bash
touch stop
```
Tokens:
Raw