aiolabs/bitspire
9
0
Fork 0
Code Issues 52 Pull requests 2 Projects Releases Packages Wiki Activity Actions

docs: document automatic channel setup in unified regtest mode

Browse source 
Add explanation of how dev.sh automatically sets up Lightning channels:
- lnd-1 as hub funds lnd-3 and lnd-4 via channels
- lnd-4 receives payments (Lightning.Pub backend)
- lnd-3 sends payments (ATM funding source)
- Mining ensures channel confirmation and graph propagation

This clarifies that the environment works from a clean Docker slate.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Patrick Mulligan 2026-02-15 17:55:54 -05:00
commit 0b02fb9204
1 changed files with 21 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

21
README.md
View file

@ -90,17 +90,28 @@ lamassu-next/
## Infrastructure Services
The development environment uses a shared regtest stack from `~/dev/local/docker/regtest/`:
| Service | Port | Description |
| ------------------ | ----- | ----------------------------------- |
| ------------------ | ----- | --------------------------------- |
| strfry | 7777 | Nostr relay (ws://localhost:7777) |
| bitcoind | 18443 | Bitcoin regtest node |
| lnd-1 | 10001 | Lightning.Pub's LND node |
| lnd-2 | 10002 | Peer node for channel |
| lnd-3 | 10003 | Funding source (auto-miner rewards) |
| bitcoind | 18443 | Bitcoin regtest node (shared) |
| lnd-1 | 10001 | Hub node (funds lnd-3 and lnd-4) |
| lnd-3 | 10003 | Payment source for ATM funding |
| lnd-4 | 10004 | Lightning.Pub's backend node |
| Lightning.Pub | 1776 | Nostr-native accounts API |
| Withdraw Extension | 1777 | LNURL-withdraw for cash-in |
| PostgreSQL | 5432 | Lightning.Pub database |
**Automatic channel setup**: When `dev.sh up` runs, it automatically:
1. Ensures lnd-1 has funds (mines blocks if needed)
2. Opens a channel from lnd-1 → lnd-4 (so Lightning.Pub can receive payments)
3. Opens a channel from lnd-1 → lnd-3 (so lnd-3 can pay invoices for funding)
4. Mines blocks for channel confirmation and graph propagation
This makes the environment work from a clean Docker slate without manual intervention.
## Testing Cash-In Flow
After starting the environment with `./docker/dev.sh up --fund`: