mirror of
https://github.com/aljazceru/breez-sdk-liquid.git
synced 2026-01-14 11:34:20 +01:00
f437c9194e
* Add regtest end-to-end tests * Check that regtest environment is set up * Add todo comment * Add missing gloo-timers feature * Link GH issues * Update DEVELOPMENT.md * Update boltz submodule * Fix after rebase
Regtest environment for Breez SDK - Nodeless (Liquid Implementation)
Based on Boltz Regtest (included as a submodule in ./boltz)
Prerequisites
- Git submodules
git submodule update --init
- Docker or Orbstack for Apple Silicon based Macs.
When using OrbStack on macOS, set
export DOCKER_DEFAULT_PLATFORM=linux/amd64before starting.
Usage
Starting and stopping the regtest setup. On start up, look out for unhealthy containers, which may happen occasionally.
./start.sh
./stop.sh
To control the regtest nodes, some useful aliases are provided.
source boltz/aliases.sh
After setting up the aliases, you can access the following commands:
# Mine blocks on both Bitcoin and Elements chains
mine-block
# Interact with bitcoind
bitcoin-cli-sim-client getblockchaininfo
# Interact with elements
elements-cli-sim-client getblockchaininfo
# Interact with Lightning nodes
lightning-cli-sim 1 getinfo
lncli-sim 1 getinfo
Useful commands for trying out the SDK:
# Get a bolt11 invoice
lncli-sim 1 addinvoice <amount_sat>
# Pay a bolt11 invoice
lncli-sim 1 payinvoice --force <invoice>
# Get a Bitcoin address
bitcoin-cli-sim-client getnewaddress
# Send bitcoin to a Bitcoin address
bitcoin-cli-sim-client sendtoaddress <address> <amount_btc>
# Get a Liquid address
elements-cli-sim-client getnewaddress
# Send L-BTC to a Liquid address
elements-cli-sim-client sendtoaddress <address> <amount_lbtc>
See Boltz Regtest README for more info.