Jest Integration Testing with `pyln` and `gl-testing` Network Setup

[ShahanaFarooqui]

Summary

Enable Jest integration tests to run against a real Greenlight test network by reusing the existing Python test infrastructure (pyln.testing + gl-testing).

Motivation

The Python test suite already handles spinning up full ephemeral networks — bitcoind, the Greenlight scheduler, CLN nodes, GL nodes, and an LSP — via pyln and gl-testing. The gl-sdk-napi currently has no equivalent, making true end-to-end and integration testing impossible from the JS/TS side. Reimplementing this orchestration in TypeScript would duplicate complex, already-proven logic.

Proposed Solution

• Add a thin setup_network.py script, invoked by Jest globalSetup, that:
  • Starts a full Greenlight test network using existing pyln.testing and gl-testing fixtures
  • Registers GL nodes with the scheduler and starts their signer threads
  • Writes a JSON config file with all connection info (GL_* env vars, endpoints, cert paths, node IDs)
  • Keeps all processes alive for the duration of the Jest run
  • Use globalTeardown to cleanly stop all processes once the test suite finishes.

Acceptance Criteria

• Network includes bitcoind, scheduler, 2 CLN nodes, 2 GL nodes, and 1 LSP Server
• GL nodes are registered with the scheduler and operational (signer threads running)
• Jest tests consume the generated JSON config and pass
• globalTeardown cleanly shuts down all processes
• Documentation updated if needed

[ShahanaFarooqui]

[ ] Network includes bitcoind, scheduler, 2 CLN nodes, 2 GL nodes, and 1 LSP Server

test_setup only starts the Bitcoin node and an LSP server. It does not register any GL nodes with the scheduler or start signer threads. GL node scheduler registration and signer startup should be handled per test (/beforeEach), not in the global setup. Also, no CLN node was set up since none of the tests require it yet.

[ ] Jest tests consume the generated JSON config and pass

Setup writes a .env file rather than JSON, which has no functional impact.