Setup LiquidOps on Voltage nodes (agent based - push)

This page describes the configuration process of LiquidOps with macaroons for nodes hosted on Voltage.

In order to fully leverage the capabilities of LiquidOps with a Voltage node, it is essential to utilize our open source agent. Since Voltage does not support direct installation of bolt.observer, the recommended approach is to install the agent on a separate server, which can seamlessly operate alongside a Voltage node.

Recommended setup

In this tutorial, we will explain how to configure our open-source agent to work with a Voltage node. Refer to the chart below for a visual representation:

Agent and Lightning node running on separate machines

Machine 1: Voltage node

Machine 2: a secondary server where the agent can be installed

For the agent installation, you can find more information in Agent based - push and in the repository.

Voltage setup

LiquidOps provides extensive automation capabilities for a wide array of operations, including connectivity, node status notifications, and liquidity management through auto swaps. Liquidity management specifically requires on-chain and off-chain permissions, as well as access to addresses, invoices, and read/write permissions.

After logging into your Voltage account, navigate your "home" page. Scroll down the page and download the Admin macaroon and the TLS certificate onto the machine where you plan to install the agent. In this case, it would be Machine 2, as mentioned in the previous instructions#agent-setup.

Agent installation

Install the agent by following the instructions under github repository.

Agent options

Ensure the following options are properly configured in the agent:

Apikey

Log into your account on bolt.observer, and from your node page and click on "Enroll in LiquidOps"

LiquidOps setup with agent

Generate an API key and copy its value.

Add the API key as an option in your command line:

--apikey a3fxxxxxxxxxxxxxxxxxxxxxxxxxx

Macaroon path

Specify the path to the admin macaroon file using the following option:

--macaroonpath /some/path/to/file.macaroon

TLS Certificate path

Specify the path to the TLS certificate file using the following option:

--tlscertpath /some/path/to/tls.cert

RPC server

Set the RPC server address using the following option:

--rpcserver demo.m.voltageapp.io:10009

The complete command line with all options is shown below:

bolt-agent --apikey a3fxxxxxxxxxxx --macaroonpath /some/path/to/file.macaroon --tlscertpath /some/path/to/tls.cert --rpcserver demo.m.voltageapp.io:10009

Command line agent configuration

For additional options

Verification

Once the bolt-agent is running correctly, refresh your node page, and you should see "LiquidOps enabled" and the data source displayed in the top right corner of the page.

From this point, you can Create a workflow with auto swaps and starts enjoying the benefits of LiquidOps.