md_codec/
lib.rs

1//! # `md-codec`
2//!
3//! Reference implementation of the **Mnemonic Descriptor (MD)** format —
4//! an engravable backup format for [BIP 388 wallet policies][bip388].
5//!
6//! [bip388]: https://github.com/bitcoin/bips/blob/master/bip-0388.mediawiki
7//!
8//! v0.30 wire format: bit-aligned payload, sparse per-`@N` TLV overrides,
9//! 5-bit single-payload header (4-bit version=4 + `divergent_paths` flag),
10//! 6-bit bytecode tag space, decoder auto-dispatch between single and chunked
11//! payloads via the first 5-bit symbol's bit 0, symbol-aligned codex32
12//! wrapping with HRP `"md"`. See `design/SPEC_v0_30_wire_format.md` for the
13//! normative spec.
14
15pub mod bch;
16pub mod bch_decode;
17
18pub mod bitstream;
19pub mod canonical_origin;
20pub mod canonicalize;
21pub mod chunk;
22pub mod codex32;
23pub mod decode;
24pub mod derive;
25pub mod encode;
26pub mod error;
27pub mod header;
28pub mod identity;
29mod nums;
30pub mod origin_path;
31pub mod phrase;
32// The `@N`-template renderer is pure AST string-walking (no miniscript/derive
33// dependency); it sources the NUMS H-point from the ungated `nums` module, so
34// it is unconditional — available with or without the `derive` feature.
35pub mod render;
36pub mod tag;
37pub mod test_vectors;
38pub mod tlv;
39#[cfg(feature = "derive")]
40pub mod to_miniscript;
41pub mod tree;
42pub mod use_site_path;
43pub mod validate;
44pub mod varint;
45
46pub use canonicalize::canonicalize_placeholder_indices;
47pub use chunk::{
48    ChunkHeader, CorrectionDetail, decode_with_correction, derive_chunk_set_id, reassemble, split,
49};
50pub use decode::{decode_md1_string, decode_payload};
51pub use encode::{Descriptor, encode_md1_string, encode_payload};
52pub use error::Error;
53pub use header::Header;
54pub use identity::{
55    Md1EncodingId, WalletDescriptorTemplateId, WalletPolicyId, compute_md1_encoding_id,
56    compute_wallet_descriptor_template_id, compute_wallet_policy_id, validate_presence_byte,
57};
58pub use origin_path::{OriginPath, PathComponent, PathDecl, PathDeclPaths};
59pub use phrase::Phrase;
60pub use render::{RenderError, descriptor_to_template};
61pub use tag::Tag;
62pub use tlv::TlvSection;
63#[cfg(feature = "derive")]
64pub use to_miniscript::{
65    has_hardened_use_site, to_miniscript_descriptor, to_miniscript_descriptor_multipath,
66};
md_codec/lib.rs

md_codec/
lib.rs
