`testing/regtest/` builds bitcoind, electrs, an eclair v0.14.4 LSP set up as a Phoenix LSP, and a payer. `GroupLightningRegtestJvmTest` (run with BENNU_REGTEST=1) drives four devices through it with a real lightning-kmp node: open, receive on a channel opened on the fly, pay through the LSP's trampoline, close mutually, then force-close a second channel and sweep its delayed output with a FROST script-path spend. It passes from a fresh network in about thirty seconds. The run found four bugs in the operator's node, fixed here: - It learned the chain's height only at the next block, and until then could answer no invoice request and take no payment. It now asks as it starts. - It turned down every on-the-fly channel, because lightning-kmp's default liquidity policy caps fees at 2,000 sats and the statement's signed `maxLiquidityFeeSat` never reached it. The node's policy is now the statement's. - A channel could ask for round one before the pool held it. The node now waits for a minimum pool before connecting, and otherwise refuses and retries. - A force close waited forever for feerates, which lightning-kmp fetches only once. The node now refreshes them, and takes a flat rate on regtest. Public eclair cannot route a Bolt11 payment to a wallet by its peer-id route hint, so the run pays the group's Bolt12 offer. The offer is now part of the wallet: every snapshot carries it, every member keeps it only if its own copy of the seed derives it, and the receive screen shows it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Regtest network for the group Lightning wallet
regtest.sh up builds it from nothing: bitcoind 31.1, electrs, an eclair LSP configured as a Phoenix
LSP (lsp.conf), and a second eclair that pays the group and is paid by it (payer.conf), with a
channel from the payer to the LSP. Every port is on localhost: bitcoind RPC 28443, electrs 28001, the
LSP 29735 and its API 28080, the payer's API 28081.
./regtest.sh up
BENNU_REGTEST=1 ../../gradlew -p ../.. :composeApp:jvmTest --tests '*GroupLightningRegtestJvmTest'
./regtest.sh down
./regtest.sh mine 6, ./regtest.sh btc <rpc>, ./regtest.sh lsp <method> -d k=v and
./regtest.sh payer <method> -d k=v reach each piece by hand. What the run does, and what each LSP
setting is for, is in docs/group-lightning-wallet.md, "The regtest run".