nbd-wtf / lnunit

C# Lightning Networking Unit Testing Library

LNUnit

---

LNUnit is a unit-testing framework for Bitcoin Lightning network systems. It provides an easy-to-use interface for developers to write tests that check the functionality and performance of their Lightning network applications.

Package	Version
LNUnit.LND
LNUnit

Features

---

• Support for Bitcoin Lightning network systems (LND more to come)
• Test cases can be written in C#
• Automated test discovery
• Test fixtures for setting up and tearing down test environments
• Integration with NUnit for continuous integration and coverage reporting
• Channel Acceptor
• HTLC Interception
• MIT License

Notes

---

MacOS Users

To run the containerized tests we need to connect directly to the docker containers, but if you're using MacOS you won't be able to, thanks to the way Docker for Mac is implemented.

We're using Docker Mac Net Connect due to it's simplicity. Just run:

# Install via Homebrew
$ brew install chipmk/tap/docker-mac-net-connect

# Run the service and register it to launch at boot
$ sudo brew services start chipmk/tap/docker-mac-net-connect

lnunit's Issues

Better LND is really ready checks, still have failures on overtaxed runners

These tests (and likely whole setup) need better wait until LND ready checks.