Files
giza-kmp/testing/regtest/compose.yml
T
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

67 lines
2.0 KiB
YAML

# A regtest network for the group Lightning wallet's end-to-end run (docs/group-lightning-wallet.md,
# "The regtest run"): bitcoind, electrs for the group's Electrum client, an eclair LSP speaking
# Phoenix's taproot channels and on-the-fly funding, and a second eclair that pays the group and is
# paid by it. Every port is bound to localhost, in a range nothing else on a development machine uses.
name: bennu-regtest
services:
bitcoind:
image: bitcoin/bitcoin:31.1
command:
- -printtoconsole
- -regtest=1
- -server=1
- -txindex=1
# foo:bar for eclair and the scripts; the cookie, readable by all, for electrs.
- -rpcauth=foo:abd66bf47451e26a7809d47370140dc9$$101b2636d908b296314aaad45c40bb42e0bbf631ea37b3f7767319e638e1662e
- -rpccookieperms=all
- -rpcallowip=0.0.0.0/0
- -rpcbind=0.0.0.0
- -fallbackfee=0.0002
- -listen=1
- -bind=0.0.0.0
- -zmqpubhashblock=tcp://0.0.0.0:29000
- -zmqpubrawtx=tcp://0.0.0.0:29001
volumes:
- bitcoind:/home/bitcoin/.bitcoin
ports:
- "127.0.0.1:28443:18443"
electrs:
image: getumbrel/electrs:v0.11.1
# bitcoind's data directory is its own; root is what reads the cookie in it.
user: root
command:
- --network=regtest
- --daemon-rpc-addr=bitcoind:18443
- --daemon-p2p-addr=bitcoind:18444
- --electrum-rpc-addr=0.0.0.0:50001
- --cookie-file=/bitcoin/regtest/.cookie
- --db-dir=/tmp/electrs
depends_on: [bitcoind]
volumes:
- bitcoind:/bitcoin:ro
ports:
- "127.0.0.1:28001:50001"
lsp:
image: acinq/eclair:v0.14.4
depends_on: [bitcoind]
volumes:
- ./lsp.conf:/data/eclair.conf:ro
ports:
- "127.0.0.1:29735:9735"
- "127.0.0.1:28080:8080"
payer:
image: acinq/eclair:v0.14.4
depends_on: [bitcoind]
volumes:
- ./payer.conf:/data/eclair.conf:ro
ports:
- "127.0.0.1:29736:9735"
- "127.0.0.1:28081:8080"
volumes:
bitcoind: