5 releases
0.1.6 | Aug 2, 2024 |
---|---|
0.1.5 | May 27, 2024 |
0.1.4 | Mar 15, 2024 |
0.1.2 | Jan 9, 2024 |
0.1.0 | Dec 19, 2023 |
#9 in #bitcoind
30 downloads per month
29KB
509 lines
Lnd Integration Test Utility
Utility to run a regtest LND process connected to a given bitcoind instance, useful in integration testing environment.
use lnd::bitcoind::Conf;
use lnd::LndConf;
use lnd::bitcoind::BitcoinD;
use lnd::Lnd;
// Create a bitcoind instance
let mut bitcoin_conf = Conf::default();
#[cfg(feature = "download")]
let bitcoind = BitcoinD::with_conf(lnd::bitcoind::exe_path(), &bitcoin_conf).unwrap();
#[cfg(not(feature = "download"))]
let bitcoind = BitcoinD::with_conf("<local path to exe>", &bitcoin_conf).unwrap();
let lnd_conf = LndConf::default();
// Pass the path, conf, and bitcoind
#[cfg(feature = "download")]
let mut lnd = Lnd::with_conf(lnd::exe_path(), lnd_conf, &bitcoind);
#[cfg(not(feature = "download"))]
let mut lnd = Lnd::with_conf("<path to lnd>", lnd_conf, &bitcoind);
let node_info = lnd.client.lightning().get_info(GetInfoRequest {}).await;
assert!(node_info.is_ok());
Automatic binaries download
In your project Cargo.toml, activate the following features
lnd = { version = "*", features = ["download"] }
To use it:
let bitcoind_exe = lnd::bitcoind::downloaded_exe_path().expect("bitcoind version feature must be enabled");
let bitcoind = lnd::bitcoind::BitcoinD::new(bitcoind_exe).unwrap();
let lnd_exe = lnd::downloaded_exe_path().expect("lnd version feature must be enabled");
let lnd = lnd::Lnd::new(lnd_exe, bitcoind).unwrap();
When the LND_DOWNLOAD_ENDPOINT
/BITCOIND_DOWNLOAD_ENDPOINT
environment variables are set,
lnd
/bitcoind
will try to download the binaries from the given endpoints.
When you don't use the auto-download feature you have the following options:
- have
lnd
executable in thePATH
- provide the
lnd
executable via theLND_EXEC
env var
if let Ok(exe_path) = lnd::exe_path() {
let lnd = lnd::Lnd::new(exe_path, &bitcoind).unwrap();
}
Features
- lnd use a temporary directory as db dir
- A free port is asked to the OS (a very low probability race condition is still possible)
- The process is killed when the struct goes out of scope no matter how the test finishes
Thanks to these features every #[test]
could easily run isolated with its own environment
Dependencies
~28–42MB
~740K SLoC