12 releases (breaking)
0.11.0 | Aug 19, 2024 |
---|---|
0.10.0 | Jul 29, 2024 |
0.9.2 | Aug 19, 2024 |
0.9.1 | Apr 4, 2024 |
0.3.0 | Dec 3, 2021 |
#70 in #integration-tests
151 downloads per month
17KB
286 lines
ElementsD
Utility to run a liquidregtest elementsd process, useful in integration testing environment.
use elementsd::bitcoincore_rpc::RpcApi;
let exe = elementsd::exe_path().expect("elementsd executable must be provided in ELEMENTSD_EXE, or with a feature like '0_21_0', or be in PATH");
let elementsd = elementsd::ElementsD::new(exe).unwrap();
let info = elementsd
.client()
.call::<bitcoind::bitcoincore_rpc::jsonrpc::serde_json::Value>("getblockchaininfo", &[])
.unwrap();
assert_eq!(info.get("chain").unwrap(), "liquidregtest");
Validate pegin
You can also start elementsd with validate pegin capability by connecting an instance of bitcoind
.
See test test_elementsd_with_validatepegin
See the similar BitcoinD for details
Nix
For determinisim, in nix you cannot hit the internet within the build.rs
. Moreover, some downstream crates cannot remove the auto-download feature from their dev-deps. In this case you can set the ELEMENTSD_SKIP_DOWNLOAD
env var and provide the elementsd
executable in the PATH
(or skip the test execution).
Doc
To build docs:
RUSTDOCFLAGS="--cfg docsrs" cargo +nightly doc --features download,doc --open
MSRV
- 1.57.0 with one of the auto download features
- 1.56.1 without features
MSRV 1.56.1 may require downgrading dependencies. See our
.github/workflows/test.yml
file for a complete list.
Dependencies
~10–20MB
~257K SLoC