rust-miniscript
Reference implementation of Miniscript + descriptor language in Rust.
Repo: github.com/rust-bitcoin/rust-miniscript.
Install
[dependencies]
miniscript = "13"
As of September 2026 the current line is 13.1.0 (June 2026); 13.0.0
landed October 2025. The 12.x line still gets patches (12.3.7, May
2026) but is no longer the current major. MSRV is Rust 1.63.0. Policy
compilation lives behind the non-default compiler cargo feature.
Quick examples
Parse descriptor
use miniscript::Descriptor;
use bitcoin::secp256k1::Secp256k1;
let desc_str = "wpkh([d34db33f/84h/0h/0h]xpub.../<0;1>/*)";
let desc: Descriptor<_> = desc_str.parse()?;
let secp = Secp256k1::new();
for i in 0..10 {
let script = desc.at_derivation_index(i)?.script_pubkey();
println!("script[{}]: {}", i, script);
}
Compile policy → miniscript → script
use miniscript::policy::Concrete;
use miniscript::Segwitv0;
let policy: Concrete<bitcoin::PublicKey> =
"and(pk(02abc...),older(144))".parse()?;
let ms = policy.compile::<Segwitv0>()?; // `compiler` feature
let script = ms.encode();
Satisfy
use miniscript::Satisfier;
let satisfier = ...;
let witness = ms.satisfy(&satisfier)?;
Descriptor types supported
pkh,wpkh,sh(wpkh),wsh(),tr().multi,sortedmulti,multi_a.addr,raw,combo.- Multipath descriptors (
<0;1>).
Use cases
- Wallet that supports complex spending conditions.
- Coordinator for multisig / vault / time-locked schemes.
- Static analysis of scripts (sigops, max sat size).
Common pitfalls
- Miniscript version mismatch with rust-bitcoin: pin compatible
versions. As of September 2026 the pairing is miniscript 13.x and
12.x ->
bitcoin = "0.32"(13.1.0 pins^0.32.6), 11.x ->0.31, 10.x ->0.30. The 13.0.0 break was miniscript's own API, not a rust-bitcoin bump. - Tapscript miniscript different fragment set vs legacy.
- Descriptor checksum: re-add after modifications.