Files
giza-kmp/testing/regtest
Kgothatso NgakoandClaude Opus 5.5 d8d8d038f9 test(lightning): the group's wallet end to end on regtest, and what it found
`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>
2026-10-23 22:30:25 +02:00
..
…
…

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".