tee8z / doppler

A tool for building out and managing bitcoind/lightning clusters for regtest or signet environments
Creative Commons Zero v1.0 Universal
45 stars 7 forks source link
Doppler Radar with Lightning Bolts

Doppler (A Lightning Domain-Specific Language)

The DSL should empower developers to compose a concise script that configures an entire cluster of nodes running a single docker network, even if they are of different implementation types, to suit precise testing requirements. This should provide a sensation similar to working with a set of Lego blocks, where all the necessary components are at your fingertips, ready to be assembled based on the idea at hand.

Additionally, this DSL can be used against a cluster of remote LND nodes (more implementations will follow) to generate activity across them. This could be payments or channel related activity at the moment, but more work can be done to further expand this to include starting and stopping the remote nodes as well as funding them from a configured faucet. Still would not recommend running these doppler files on a mainnet cluster of nodes, but we wont stop you from being reckless :wink:

Installing

Requires:

Download installing script

  curl --proto '=https' --tlsv1.2 -LsSf "https://raw.githubusercontent.com/tee8z/doppler/refs/heads/master/doppler-installer.sh" > doppler_installer.sh
  chmod +x doppler_installer.sh

Execute installer with a release tag

  ./doppler_installer.sh <release tag to install>

Running after install:

To run with UI (navigate to 0.0.0.0:3000 in your browser to view the UI)

  cd $HOME/.doppler/<release tag> && node ./build

To run as cli

  cd $HOME/.doppler && doppler -h

More information on how to use this tool can be found here: USAGE.md

Supports:

Interesting Simulations

Acknowledgments

Disclaimer