Skip to content

nbd-wtf/LNUnit

Repository files navigation

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

Build & Tested

Deploy Nuget Package

Package Version
LNUnit.LND NuGet version (LNUnit.LND)
LNUnit NuGet version (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